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

POST

/v4/ecs/list-by-typefamilies

该接口提供用户根据指定规格族查询云主机的名称、云主机ID及规格详情

请求参数

Header 参数

Body 参数application/json

示例

{
	"regionID": "nm8",
	"azName": "az1",
	"type_family": "s7"
}

请求示例代码

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/list-by-typefamilies' \
--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": "az1",
	"type_family": "s7"
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "description": "成功",
    "errorCode": "Success",
    "message": "success",
    "returnObj": {
        "currentCount": 10,
        "totalCount": 54,
        "totalPage": 6,
        "results": [
            {
                "id": "e9e05d97-f3ee-4c19-a819-67d5839e2808",
                "name": "ecs-3wxf57hj5-dtbp-in1hour",
                "flavor": {
                    "id": "032e86d9-537a-f37c-0c4a-d20300bbc8af",
                    "name": "s2.small.1",
                    "vcpu": 0,
                    "ram": 1,
                    "gpu_type": "",
                    "gpu_count": 0,
                    "gpu_name": "",
                    "memory": 0,
                    "series": "s"
                }
            },
            {
                "id": "e75dfa4b-b8af-43db-aa28-50e08111a62e",
                "name": "ecs-az2批开-001",
                "flavor": {
                    "id": "032e86d9-537a-f37c-0c4a-d20300bbc8af",
                    "name": "s2.small.1",
                    "vcpu": 0,
                    "ram": 1,
                    "gpu_type": "",
                    "gpu_count": 0,
                    "gpu_name": "",
                    "memory": 0,
                    "series": "s"
                }
            },
            {
                "id": "8af347b4-3981-4868-9738-345381092153",
                "name": "ecs-linux-0530",
                "flavor": {
                    "id": "032e86d9-537a-f37c-0c4a-d20300bbc8af",
                    "name": "s2.small.1",
                    "vcpu": 0,
                    "ram": 1,
                    "gpu_type": "",
                    "gpu_count": 0,
                    "gpu_name": "",
                    "memory": 0,
                    "series": "s"
                }
            }
        ]
    },
    "statusCode": 800,
    "traceID": "d9485ca0a531adf9971ad63b05581a62"
}

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

查询云主机规格族列表

查询云主机库存