接口说明
添加实例至指定群组中(支持批量)。
注意事项:
-
强反亲和策略、强亲和策略群组不支持添加实例。
-
当一台实例已经属于某个群组,再将其加入另外的群组时,将自动从当前群组移除,一台实例最多只能属于一个群组。
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
|
否
|
是否预校验。取值范围:
默认值: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":""
}
]
}
}