查询云主机组内的云主机

请求参数

Body 参数application/json

regionID

string

资源池ID

必需

azName

string

可用区名称

必需

affinityGroupID

string

云主机组ID

必需

示例

{
    "regionID": "TestRegionID",
    "azName": "az1",
    "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/ecs-list' \
--header 'Content-Type: application/json' \
--data-raw '{
    "regionID": "TestRegionID",
    "azName": "az1",
    "affinityGroupID": "1676a8c4-5962-6ac0-f655-3a80cc15ee5b"
}'

返回响应

🟢200successful operation

application/json

Body

errorCode

string

错误码

必需

returnObj

array [object {29}]

返回对象

必需

addresses

array [object {2}]

网络地址信息

必需

affinityGroup

object

云主机组信息

必需

attachedVolume

array[string]

附加卷

必需

availabilityZone

string

高可用zone

必需

createdAt

string

创建时间

必需

displayName

string

云主机名称

必需

expiredTime

string

到期时间

必需

fixedIp

array[string]

固定ip

必需

flavor

object

规格信息

必需

floatingV6UUID

string

必需

弹性ipv6的uuid

ID

string

主机id

必需

image

object

镜像信息

必需

keypairName

string

密钥对名称

必需

name

string

主机名称

必需

nicList

array [object {7}]

网卡信息

必需

onDemand

boolean

必需

付费方式，true表示按量付费; false为包周期

osType

string

操作系统类型id

必需

privateIP

string

内网ipv4地址

必需

privateIPv6

string

内网ipv6地址

必需

projectID

string

项目id

必需

resourceID

string

资源id

必需

securityGroup

array [object {2}]

安全组信息

必需

updatedAt

string

更新时间

必需

vipCount

integer <int32>

vip数目

必需

vipInfoList

array [object {5}]

虚拟ip信息列表

必需

vmState

string

主机状态

必需

vpcID

string

vpcID

必需

vpcName

string

vpc名称

必需

zabbixName

string

监控对象名称

必需

statusCode

integer <int32>

状态码

必需

message

string

消息

必需

description

string

描述

必需

示例

{
    "errorCode": null,
    "returnObj": [
        {
            "addresses": [
                {
                    "addressList": [
                        {
                            "addr": "192.168.0.42",
                            "type": "fixed",
                            "version": 4
                        }
                    ],
                    "vpcName": "vpc-hybcloud-test"
                }
            ],
            "affinityGroup": {
                "affinityGroupID": "1676a8c4-5962-6ac0-f655-3a80cc15ee5b",
                "affinityGroupName": "biz-test",
                "policy": "SOFT-ANTI-AFFINITY"
            },
            "attachedVolume": [
                "b0994b92-a83c-4c7d-9058-83cb7c8eddc8"
            ],
            "availabilityZone": "SERIES-7-ZONE",
            "createdAt": "2022-12-06T06:18:09Z",
            "displayName": "ecs-zhr-11",
            "expiredTime": "2023-03-06T06:18:44Z",
            "fixedIp": [
                "192.168.0.42"
            ],
            "flavor": {
                "flavorID": "2ab6855b-531e-89fd-0182-9434428644fe",
                "ram": 4,
                "specName": "s7.large.2",
                "vcpu": 2
            },
            "floatingV6UUID": "",
            "iD": "e12e4369-b13d-cc2c-fee8-079552cbc815",
            "image": {
                "imageID": "0ff4e04a-239b-4cc3-b876-ef78011f81eb",
                "imageName": "teledb-mysql:2.7-v8-release"
            },
            "keypairName": "",
            "name": "ecs-zhr-11",
            "nicList": [
                {
                    "gateway": "",
                    "iPv4Address": "192.168.0.42",
                    "isMaster": true,
                    "nicID": "port-sws65jyb6u",
                    "securityGroup": [
                        "sg-yjo0aruemp",
                        "sg-7nyc77cwsk",
                        "sg-w7wz5mbwz4"
                    ],
                    "subnetCidr": "192.168.0.0/24",
                    "subnetID": "subnet-79dzrqykep"
                }
            ],
            "onDemand": false,
            "osType": "5",
            "privateIP": "192.168.0.42",
            "privateIPv6": "",
            "projectID": "",
            "resourceID": "99158e8f9b844e799371be989bd32589",
            "securityGroup": [
                {
                    "securityGroupID": "sg-yjo0aruemp",
                    "securityGroupName": "Default-Security-Group-202"
                },
                {
                    "securityGroupID": "sg-w7wz5mbwz4",
                    "securityGroupName": "Default-Security-Group"
                },
                {
                    "securityGroupID": "sg-7nyc77cwsk",
                    "securityGroupName": "Security-Group-hybtest"
                }
            ],
            "updatedAt": "2022-12-29T11:17:35Z",
            "vipCount": 0,
            "vipInfoList": [
                {
                    "nicID": "vpc-n96mwxjlt6",
                    "vipAddress": "192.168.0.102",
                    "vipBindNicIP": "192.168.0.95",
                    "vipBindNicIPv6": "",
                    "vipID": "havip-2rd122s0p4"
                },
                {
                    "nicID": "vpc-n96mwxjlt6",
                    "vipAddress": "192.168.0.101",
                    "vipBindNicIP": "192.168.0.100",
                    "vipBindNicIPv6": "",
                    "vipID": "havip-uhaogrmam1"
                },
                {
                    "nicID": "vpc-n96mwxjlt6",
                    "vipAddress": "192.168.5.4",
                    "vipBindNicIPv6": "",
                    "vipID": "havip-ewhuukpe6i"
                }
            ],
            "vmState": "ACTIVE",
            "vpcID": "vpc-n96mwxjlt6",
            "vpcName": "vpc-hybcloud-test",
            "zabbixName": "e12e4369-b13d-cc2c-fee8-079552cbc815"
        }
    ],
    "statusCode": 800
}