添加实例至群组

接口说明


添加实例至指定群组中(支持批量)。

注意事项:

  1. 强反亲和策略、强亲和策略群组不支持添加实例。

  2. 当一台实例已经属于某个群组,再将其加入另外的群组时,将自动从当前群组移除,一台实例最多只能属于一个群组。


推荐使用API Explorer调试

API Explorer支持接口在线可视化调用,同时自动生成动态代码示例,搭配OpenAPI SDK无需计算签名实现接口快速集成。

URL

POST https://ecloud.10086.cn/api/openapi-instance/v4/instance-group/bind-instances

请求参数

Body

参数名称
类型
必填
描述
instanceGroupReq
InstanceGroupReq
是

instanceGroupReq

groupId
string
是

主机组ID。

instanceIds
<string> array
是

实例ID数组,可通过查询实例状态列表接口获取。

dryRun
boolean
否

是否预校验。取值范围:

  • true:预校验,
  • false:非预校验。

默认值:false。

请求示例

POST https://ecloud.10086.cn/api/openapi-instance/v4/instance-group/bind-instances
{
	"groupId":"4ed219c8-4ef6-4d41-8711-d04651cafdf0",
	"instanceIds":[
		"c37945d7-0859-4c88-906b-0c49f79b64e0",
		"a3e664c3-f3cd-43ee-9f76-32476f218af2"
	]
}

返回参数

返回码:200
OK
参数名称
类型
描述
body
InstanceGroupBatchResp«InstanceGroupBatchResult»

请求成功时返回的数据。

batchActionResult
<InstanceGroupBatchResult> array

实例批量操作结果集。

instanceId
string

实例ID。

message
string

操作结果信息,失败时返回错误信息,成功时返回空字符串。

result
boolean

操作是否下发成功。

errorCode
string

统一错误码。

errorMessage
string

页面国际化错误提示。

errorParams
<string> array

统一错误码的自定义参数。

requestId
string

每个请求的序列号。

state
enum(OK,ERROR,EXCEPTION,ALARM,FORBIDDEN)

返回状态码。返回正常:OK,返回错误:ERROR,返回异常:EXCEPTION,需要告警实现的:ALARM,禁止访问:FORBIDDEN。

返回示例

返回码:200
OK
{
	"requestId":"req-150f330d-2b38-4da8-9113-99992ded4601",
	"state":"OK",
	"body":{
		"batchActionResult":[
			{
				"instanceId":"c37945d7-0859-4c88-906b-0c49f79b64e0",
				"result":true,
				"message":""
			},
			{
				"instanceId":"a3e664c3-f3cd-43ee-9f76-32476f218af2",
				"result":true,
				"message":""
			}
		]
	}
}
本文档内容整理自移动云官方帮助中心(查看原文),仅供参考。