查询云主机组列表或详情

请求参数

Body 参数application/json

regionID

string

资源池ID

必需

pageNo

integer <int32>

页码，默认值：1

可选

pageSize

integer <int32>

可选

| 每页记录数目，取值范围：[1~10000]，默认值：10，单页最大记录不超过10000|

azName

string

可用区名称

可选

affinityGroupID

string

云主机主机组ID

可选

queryContent

string

可选

查询内容（可是id或者name）、模糊匹配

示例

{
    "regionID": "TestRegionID",
    "ctUserId": 2065,
    "azName": "az1",
    "pageNo": 1,
    "pageSize": 4,
    "sort": "",
    "asc": true,
    "affinityGroupID": "1676a8c4-5962-6ac0-f655-3a80cc15ee5b"
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/v4/ecs/affinity-group-list' \
--header 'Content-Type: application/json' \
--data-raw '{
    "regionID": "TestRegionID",
    "ctUserId": 2065,
    "azName": "az1",
    "pageNo": 1,
    "pageSize": 4,
    "sort": "",
    "asc": true,
    "affinityGroupID": "1676a8c4-5962-6ac0-f655-3a80cc15ee5b"
}'

返回响应

🟢200successful operation

application/json

Body

errorCode

string

业务细分码

必需

returnObj

object

返回参数

必需

currentCount

integer <int64>

当前页记录数目

必需

results

array [object {7}]

分页明细

必需

totalCount

integer <int64>

总记录数

必需

totalPage

integer <int64>

总页数

必需

statusCode

integer <int32>

必需

返回状态码（800为成功，900为失败）

message

string

消息

必需

description

string

描述

必需

示例

{
    "errorCode": null,
    "returnObj": {
        "currentCount": 1,
        "results": [
            {
                "affinityGroupID": "1676a8c4-5962-6ac0-f655-3a80cc15ee5b",
                "affinityGroupName": "biz-test",
                "affinityGroupPolicy": {
                    "id": 2,
                    "name": "soft-anti-affinity"
                },
                "createAt": "2022-12-19T03:16:09.501922Z",
                "deleted": false,
                "updateAt": "2022-12-22T01:58:06.635026Z"
            }
        ],
        "totalCount": 1,
        "totalPage": 1
    },
    "statusCode": 800
}