创建云主机组 - 混合云OpenAPI4.0

请求参数

Body 参数application/json

regionID

string

资源池ID

必需

affinityGroupName

string

主机亲和组名称

必需

policyType

integer <int32>

可选

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

affinityGroupLayer

string

可选

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

示例

{
    "regionID": "TestRegionID",
    "affinityGroupName": "test",
    "policyType": 2
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/v4/ecs/affinity-group/create' \
--header 'Content-Type: application/json' \
--data-raw '{
    "regionID": "TestRegionID",
    "affinityGroupName": "test",
    "policyType": 2
}'

返回响应

🟢200successful operation

application/json

Body

errorCode

string

业务细分码，为product.module.code三段式码

可选

returnObj

object

返回参数

可选

affinityGroupID

string

云主机组ID

必需

affinityGroupName

string

云主机组名称

必需

affinityGroupPolicy

object

云主机组策略

必需

statusCode

integer <int32>

返回状态码（800为成功，900为失败），默认值：800

可选

message

string

失败时的错误描述，一般为英文描述

可选

description

string

失败时的错误描述，一般为中文描述

可选

示例

{
    "returnObj": {
        "affinityGroupID": "2c03488f-ad0d-8233-6841-ba3824119555",
        "affinityGroupName": "ghyTest",
        "affinityGroupPolicy": {
            "policyType": 1,
            "policyTypeName": "affinity"
        }
    },
    "message": "SUCCESS",
    "description": "成功",
    "statusCode": 800
}