云主机加入主机组校验（新）

POST

/v4/ecs/affinity-group/bind-instance-check

接口功能介绍
可以根据用户给定的云主机与云主机组，校验当前情况下是否可以将云主机加入主机组。如果可以则返回值中needMigrate字段为0，反之则需要将云主机迁移。

接口约束
当前页面接口为旧版 API，未来根据实际使用情况可能退役，推荐使用新版本接口，新版本接口更加规范，覆盖场景更全。
云主机需处于运行中（running）或关机（stopped）状态

请求参数

Header 参数

Body 参数application/json

示例

{
"regionID":"nm8",
"affinityGroupID":"f3c9e5f3-16bb-3ccf-3142-c0f17bcb7933",
"instanceID":"a91c844a-426d-cf5b-ef0a-e3779d284f0f"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://ct-global.ctapi-internal.ctyun.local:31111/v4/ecs/affinity-group/bind-instance-check' \
--header 'x-ctyun-user-id: {{userID}}' \
--header 'Accept-Language: zh-CN' \
--header 'userId: ef378f73-1c52-435e-90f2-6a9cd2258c8e' \
--header 'Content-Type: application/json' \
--data-raw '{
"regionID":"nm8",
"affinityGroupID":"f3c9e5f3-16bb-3ccf-3142-c0f17bcb7933",
"instanceID":"a91c844a-426d-cf5b-ef0a-e3779d284f0f"
}'

返回响应

🟢200successful operation

application/json

Body

示例

{
    "message": "success",
    "returnObj": {
        "needMigrate": 0
    },
    "traceID": "feac59c288210d0a6556babffd9fd2f3",
    "statusCode": 800,
    "errorCode": "Success",
    "description": "成功"
}

修改于 2025-07-28 10:12:56

更新云主机组信息

查询云主机组列表或详情-vdc