查询云主机库存

POST

/v4/ecs/get-resources-assess

statusCode=800是正常返回，900接口报错。
[errorCode]
Compute.RegionNotFound -- 非法的资源池
Compute.AvailableZoneNotFound -- 非法的可用区
Compute.Param.Error -- 参数错误
Compute.CommonInternalError -- 内部错误

请求参数

Header 参数

Body 参数application/json

示例

{
    "regionID":"nm8",
    "azName":"az3",
    "flavorList":[
        {
            "flavorName":"c7.large.2",
            "availabilityZone":"SERIES-7-ZONE"
        },
        {
            "flavorName":"c7.large.4",
            "availabilityZone":"SERIES-7-ZONE"
        },
        {
            "flavorName":"c6.xlarge.2.1",
            "availabilityZone":"OPTIMIZE-ZONE"
        }
    ]
}

请求示例代码

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/get-resources-assess' \
--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",
    "azName":"az3",
    "flavorList":[
        {
            "flavorName":"c7.large.2",
            "availabilityZone":"SERIES-7-ZONE"
        },
        {
            "flavorName":"c7.large.4",
            "availabilityZone":"SERIES-7-ZONE"
        },
        {
            "flavorName":"c6.xlarge.2.1",
            "availabilityZone":"OPTIMIZE-ZONE"
        }
    ]
}'

返回响应

🟢200successful operation

application/json

Body

示例

{
    "description": "成功",
    "errorCode": "Success",
    "message": "success",
    "returnObj": [
        {
            "availabilityZone": "SERIES-7-ZONE",
            "flavorId": "26e61c9f-72ea-e85d-c83d-68d4f8eb52ec",
            "flavorName": "c7.large.2",
            "num": "0"
        },
        {
            "availabilityZone": "SERIES-7-ZONE",
            "flavorId": "fec81408-b2f3-a4e8-1ff4-1bdd2e6ef139",
            "flavorName": "c7.large.4",
            "num": "0"
        },
        {
            "availabilityZone": "OPTIMIZE-ZONE",
            "flavorId": "9c437753-6da7-5c86-d735-8a02c7961c42",
            "flavorName": "c6.xlarge.2.1",
            "num": "7"
        }
    ],
    "statusCode": 800,
    "traceID": "f5f86a14f34b127ba10e9285136d4e15"
}

修改于 2026-01-14 01:32:01

查询指定规格族下的云主机信息

批量查询云主机余量