文档首页/ 专属计算集群 DCC/ API参考/ API/ 获取专属计算集群资源
更新时间:2024-04-17 GMT+08:00

获取专属计算集群资源

功能介绍

用户可以查询已经申请的专属计算集群资源。

URI

GET /v1/{project_id}/dcc/resource_clusters

参数说明请参见表1

表1 参数说明

参数

参数类型

是否必选

描述

project_id

String

项目ID。

获取方式请参见获取项目ID

请求参数

可以在URI中增加service_type参数,来过滤查询结果。

例如:/v1/{project_id}/dcc/resource_clusters?service_type={service_type}

参数

参数类型

是否必选

描述

service_type

String

集群服务类型。

取值范围:“ecs”或“bms”。

请求样例

查询已经申请的集群服务类型为ecs的资源。
GET https://{Endpoint}/v1/056f7ec7e100d3d32f81c014630b5648/dcc/resource_clusters?service_type=ecs

响应参数

表2 响应参数

参数

参数类型

描述

dedicated_cluster

Array of objects

已开通的资源列表。

详情请参见表3

表3 dedicated_cluster字段数据结构说明

参数

参数类型

描述

project_id

String

项目ID。

availability_zone

String

可用区。

host_total

Integer

主机数量。

host_type

String

主机规格编码。

service_type

String

集群服务类型。

取值范围:“ecs”或“bms”。

host_properties

Object

主机规格信息。

vcpus_used

Integer

已用vcpu个数。

vcpus_total

Integer

总的vcpu个数。

memory_mb_used

Integer

已用内存。

memory_mb_total

Integer

总内存。

flavors

Array of strings

支持的flavor列表。

instance_total

Integer

运行的计算实例总数。

表4 host_properties字段结构说明

参数

参数类型

描述

cpu_cores

Integer

核数。

memory_mb

Integer

内存。

cpu_speed

String

主频。

响应样例

{
    "dedicated_cluster": [
        {
            "project_id": "056f7ec7e100d3d32f81c014630b5648",
            "availability_zone": "kvmxen.dc1",
            "host_total": 1,
            "host_type": "dec_IOoptimizedS2",
            "service_type": "ecs",
            "host_properties": {
                "cpu_cores": 216,
                "memory_mb": 264192,
                "cpu_speed": "2.5"
            },
            "vcpus_used": 1,
            "vcpus_total": 96,
            "memory_mb_used": 2048,
            "memory_mb_total": 264192,
            "flavors": [
                "s2.2xlarge.2",
                "s2.2xlarge.4",
                "s2.4xlarge.2",
                "s2.4xlarge.4",
                "s2.8xlarge.2",
                "s2.8xlarge.4",
                "s2.large.2",
                "s2.large.4",
                "s2.medium.2",
                "s2.medium.4",
                "s2.xlarge.2",
                "s2.xlarge.4"
            ],
            "instance_total": 1
        },
        {
            "project_id": "056f7ec7e100d3d32f81c014630b5648",
            "availability_zone": "kvmxen.dc1",
            "host_total": 3,
            "host_type": "dec_IOoptimizedS2",
            "hypervisor_type": "ecs",
            "host_properties": {
                "cpu_cores": 108,
                "memory_mb": 264192,
                "cpu_speed": "2.5"
            },
            "vcpus_used": 24,
            "vcpus_total": 134,
            "memory_mb_used": 53248,
            "memory_mb_total": 792576,
            "flavors": [
                "s2.2xlarge.2",
                "s2.2xlarge.4",
                "s2.4xlarge.2",
                "s2.4xlarge.4",
                "s2.8xlarge.2",
                "s2.8xlarge.4",
                "s2.large.2",
                "s2.large.4",
                "s2.medium.2",
                "s2.medium.4",
                "s2.xlarge.2",
                "s2.xlarge.4"
            ],
            "instance_total": 23
        }
    ]
}

返回值

请参见状态码