创建云主机组

POST

/v4/ecs/affinity-group-create

创建云主机组

请求参数

Body 参数application/json

regionID

string

资源池ID

必需

azName

string

可用区名称

可选

affinityGroupName

string

主机亲和组名称

必需

policyID

integer <int32>

必需

主机亲和组策略ID，如：0(反亲和ANTI-AFFINITY)、1(亲和AFFINITY)、2(软反亲和SOFT-ANTI-AFFINITY)、3(软亲和SOFT-AFFINITY)

affinityGroupLayer

string

可选

置放层级，不填默认为host
枚举值从/v4/ecs/affinity-group-layer-get获取

示例

{
    "regionID": "TestRegionID",
    "azName": "az1",
    "affinityGroupName": "zjy-biz-test",
    "policyID": 0
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v4/ecs/affinity-group-create' \
--header 'Content-Type: application/json' \
--data-raw '{
    "regionID": "TestRegionID",
    "azName": "az1",
    "affinityGroupName": "zjy-biz-test",
    "policyID": 0
}'

返回响应

🟢200successful operation

application/json

Body

errorCode

string

必需

returnObj

object

必需

results

array [object {3}]

必需

statusCode

integer <int32>

必需

message

string

错误消息

可选

description

string

描述信息

可选

示例

{
    "errorCode": null,
    "returnObj": {
        "results": [
            {
                "affinityGroupID": "2004cb48-6912-161c-5dcb-3519a74b17c7",
                "affinityGroupName": "zjy-biz-test-333",
                "affinityGroupPolicy": {
                    "id": 0,
                    "name": "anti-affinity"
                }
            }
        ]
    },
    "statusCode": 800
}

修改于 2025-03-14 06:08:48

云主机组中添加单台云主机

删除云主机组