• 创建集群
  • 批量删除集群
  • 删除集群
  • 更新集群
  • 查询集群

    创建集群

    • API: POST /api/{version}/set/{bk_biz_id}
    • API 名称：create_set

    • 功能说明：

      • 中文： 新建集群
      • English：create set

    • input body

      1. {
      3.   "bk_set_name":"",
      4.   "bk_parent_id":0,
      5.   "bk_supplier_account":"",
      6.   "bk_biz_id":1,
      7.   "default":0
      8. }

    注:以上 JSON 数据中各字段为必填字段或内置字段，它们在示例中的值仅为示例数据。

    • input 参数说明
    字段 类型 必填 默认值 说明 Description
    bk_set_id int 是 无 集群ID the set id
    bk_parent_id int 是 无 父节点的ID the parent inst identifier
    bk_biz_id int 是 无 业务ID business ID
    bk_supplier_account string 是 无 开发商账号 supplier account code
    bk_set_name string 是 无 集群名字 set name
    bk_capacity int 否 无 设计容量 the design the capacity
    description string 否 无 备注 the remark
    bk_service_status enum 否 开放 服务状态:1/2(1:开放,2:关闭) the service status:1/2 (1:open,2:close)
    bk_set_env enum 否 正式 环境类型：1/2/3(1:测试,2:体验,3:正式) environment type:1/2/3(1:test,2:experience,3:formal)
    bk_set_desc string 否 无 集群描述 the set description

    注: 用户自定义的字段也可以作为参数传入。

    批量删除集群

    • API: DELETE /api/{version}/set/{bk_biz_id}/batch
    • API 名称：batch_delete_set

    • 功能说明：

      • 中文：批量删除集群
      • English：batch to delete set

    • input body

    2. {
    3.     "delete":{
    4.     "inst_ids":[]
    5.     }
    6. }
    • input参数说明：
    字段 类型 必填 默认值 说明 Description
    bk_biz_id int 是 无 业务ID business ID
    inst_ids int array 是 无 集群ID集合 the set id collection
    • output
    1. {
    2.     "result": true,
    3.     "bk_error_code": 0,
    4.     "bk_error_msg": null,
    5.     "data": "success"
    6. }

    注:以上 JSON 数据中各字段的取值仅为示例数据。

    • output 字段说明
    字段 类型 说明 Description
    result bool ture：成功，false：失败 true:success, false: failure
    bk_error_code int 错误编码。 0表示success，>0表示失败错误 error code. 0 represent success, >0 represent failure code
    bk_error_msg string 请求失败返回的错误信息 error message from failed request
    data string 操作结果 the result

    删除集群

    • API: DELETE /api/{version}/set/{bk_biz_id}/{bk_set_id}
    • API 名称：delete_set

    • 功能说明：

      • 中文： 删除集群
      • English：delete set

    • input body

      无

    • input参数说明：

    字段 类型 必填 默认值 说明 Description
    bk_biz_id int 是 无 业务ID business ID
    bk_set_id int 是 无 集群ID the set id
    • output
    1. {
    2.     "result": true,
    3.     "bk_error_code": 0,
    4.     "bk_error_msg": null,
    5.     "data": "success"
    6. }

    注:以上 JSON 数据中各字段的取值仅为示例数据。

    • output 字段说明
    字段 类型 说明 Description
    result bool ture：成功，false：失败 true:success, false: failure
    bk_error_code int 错误编码。 0表示success，>0表示失败错误 error code. 0 represent success, >0 represent failure code
    bk_error_msg string 请求失败返回的错误信息 error message from failed request
    data string 操作结果 the result

    更新集群

    • API： PUT /api/{version}/set/{bk_biz_id}/{bk_set_id}
    • API 名称：update_set

    • 功能说明：

      • 中文： 更新集群
      • English：update set

    • input body

    1. {
    2.     "bk_biz_id":2,
    3.     "bk_set_name":"公共组件",
    4.     "bk_set_desc":"",
    5.     "bk_set_env":"3",
    6.     "bk_service_status":"1",
    7.     "description":"",
    8.     "bk_capacity":null,
    9.     "bk_supplier_account":"0"
    10. }

    注:以上 JSON 数据中各字段为必填字段或内置字段，它们在示例中的值仅为示例数据。

    • input 参数说明
    字段 类型 必填 默认值 说明 Description
    bk_set_id int 是 无 集群ID the set id
    bk_biz_id int 是 无 业务ID business ID
    bk_set_name string 否 无 集群名字 set name
    bk_capacity int 否 无 设计容量 the design the capacity
    description string 否 无 备注 the remark
    bk_service_status enum 否 开放 服务状态:1/2(1:开放,2:关闭) the service status:1/2 (1:open,2:close)
    bk_set_env enum 否 正式 环境类型：1/2/3(1:测试,2:体验,3:正式) environment type:1/2/3(1:test,2:experience,3:formal)
    bk_set_desc string 否 无 集群描述 the set description

    注: 用户在使用的时候可以为每个Set增加字段的数量，这些自定义的字段也可以作为参数传入。

    • output
    1. {
    2.     "result": true,
    3.     "bk_error_code": 0,
    4.     "bk_error_msg": null,
    5.     "data": "success"
    6. }

    注:以上 JSON 数据中各字段的取值仅为示例数据。

    • output 字段说明
    字段 类型 说明 Description
    result bool ture：成功，false：失败 true:success, false: failure
    bk_error_code int 错误编码。 0表示success，>0表示失败错误 error code. 0 represent success, >0 represent failure code
    bk_error_msg string 请求失败返回的错误信息 error message from failed request
    data string 操作结果 the result

    查询集群

    • API： POST /api/{version}/set/search/{bk_supplier_account}/{bk_biz_id}
    • API 名称：search_set

    • 功能说明：

      • 中文： 查询集群
      • English：search set

    • input body:

      1. {
      2.  "fields":[
      3.      "bk_set_name"
      4.  ],
      5.  "page":{
      6.      "start":0,
      7.      "limit":100,
      8.      "sort":"bk_set_name"
      9.  },
      10.  "condition":{
      11.      "bk_set_name":"set_new"
      12.  }
      13. }

    注:以上 JSON 数据中各字段的取值仅为示例数据。

    • input参数说明
    字段 类型 必填 默认值 说明 Description
    bk_supplier_account string 是 无 开发商账号 supplier account code
    bk_biz_id int 是 无 业务ID business ID
    page object 是 无 分页参数 page parameter
    fields array 是 无 查询字段 search fields
    condition object 是 无 查询条件 search condition

    page 参数说明：

    名称 类型 必填 默认值 说明 Description
    start int 是 无 记录开始位置 start record
    limit int 是 无 每页限制条数,最大200 page limit, max is 200
    sort string 否 无 排序字段 the field for sort

    fields参数说明：

    名称 类型 必填 默认值 说明 Description
    bk_parent_id int 否 无 父节点的ID the parent inst identifier
    bk_set_id int 是 无 集群ID the set id
    bk_set_name string 否 无 集群名字 set name
    bk_capacity int 否 无 设计容量 the design the capacity
    description string 否 无 备注 the remark
    bk_service_status enum 否 开放 服务状态:1/2(1:开放,2:关闭) the service status:1/2 (1:open,2:close)
    bk_set_env enum 否 正式 环境类型：1/2/3(1:测试,2:体验,3:正式) environment type:1/2/3(1:test,2:experience,3:formal)
    bk_set_desc string 否 无 集群描述 the set description

    注:所有字段均为Set定义的字段，这些字段包括预置字段，也包括用户自定义字段。

    condition 参数说明：

    名称 类型 必填 默认值 说明 Description
    bk_parent_id int 否 无 父节点的ID the parent inst identifier
    bk_set_id int 是 无 集群ID the set id
    bk_set_name string 否 无 集群名字 set name
    bk_capacity int 否 无 设计容量 the design the capacity
    description string 否 无 备注 the remark
    bk_service_status enum 否 开放 服务状态:1/2(1:开放,2:关闭) the service status:1/2 (1:open,2:close)
    bk_set_env enum 否 正式 环境类型：1/2/3(1:测试,2:体验,3:正式) environment type:1/2/3(1:test,2:experience,3:formal)
    bk_set_desc string 否 无 集群描述 the set description

    注:所有字段均为Set定义的字段，这些字段包括预置字段，也包括用户自定义字段。

    • output
    1. {
    2.     "result": true,
    3.     "bk_error_code": 0,
    4.     "bk_error_msg": null,
    5.     "data": {
    6.         "count": 1,
    7.         "info": [
    8.             {
    9.                 "bk_set_name": "内置模块集"
    10.             }
    11.         ]
    12.     }
    13. }

    注:以上 JSON 数据中各字段的取值仅为示例数据。

    • output 字段说明
    字段 类型 说明 Description
    result bool ture：成功，false：失败 true:success, false: failure
    bk_error_code int 错误编码。 0表示success，>0表示失败错误 error code. 0 represent success, >0 represent failure code
    bk_error_msg string 请求失败返回的错误信息 error message from failed request
    data object 操作结果 the result

    data 说明

    字段 类型 说明 Description
    count int 数据条数 the data item count
    info array 数据集合 the data array

    info 说明

    字段 类型 说明 Description
    bk_parent_id int 父节点的ID the parent inst identifier
    bk_set_id int 集群ID the set id
    bk_set_name string 集群名字 set name
    bk_capacity int 设计容量 the design the capacity
    description string 备注 the remark
    bk_service_status enum 服务状态:1/2(1:开放,2:关闭) the service status:1/2 (1:open,2:close)
    bk_set_env enum 环境类型：1/2/3(1:测试,2:体验,3:正式) environment type:1/2/3(1:test,2:experience,3:formal)
    bk_set_desc string 集群描述 the set description

    注：此处按照fields所指定的字段进行配置，所有字段均为Set定义的字段，这些字段包括预置字段，也包括用户自定义字段。