调用DescribeDataCenters获取数据中心信息。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

请求参数

名称类型是否必选示例值描述
名称 类型 是否必选 示例值 描述
Action String 是 DescribeDataCenters

系统规定参数。取值：DescribeDataCenters。
ClusterId String 是 cds-bp1b136j****5d57

集群ID。

返回数据

名称类型示例值描述
名称 类型 示例值 描述
DataCenters Array

数据中心信息列表。
DataCenter
ClusterId String cds-bp1syjlt****q976

集群ID。
CommodityInstance String cds-bp1syjlt****q976

集群商业ID。
CreatedTime String 2019-09-20T16:02:34Z

集群创建时间。格式：HH:mmZ（UTC 通用标准时，以Z来标识）。
DataCenterId String cn-hangzhou-g

集群数据中心ID。
DataCenterName String test

集群数据中心名称。
DiskSize Integer 22000

磁盘存储大小（每节点，单位GB）。
DiskType String local_ssd_pro

磁盘存储类型。可取值示例：

  • cloud_ssd：SSD云盘
  • cloud_essd：ESSD云盘
  • cloud_efficiency：高效云盘
  • local_ssd_pro：本地SSD盘
ExpireTime String 2020-03-22T00:00:00Z

集群订阅到期时间。格式：HH:mmZ（UTC 通用标准时，以Z来标识）。
InstanceType String cassandra.c5.xlarge

集群实例类型。可取值部分示例：

  • cassandra.c.large：2核 4G
  • cassandra.c.xlarge：4核 8G
  • cassandra.c.2xlarge：8核 16G
LockMode String None

锁定模式。可取值：

  • None：未锁定
  • Expired：集群订阅到期锁定
  • DiskFull：磁盘已满锁定
NodeCount Integer 2

节点数。
PayType String Subscription

付费类型：

  • Subscription：包年包月
  • PayAsYouGo：按量付费

<note>按量付费实例无到期时间</note>
RegionId String cn-hangzhou

地域ID，可以通过接口DescribeRegions查看可用的地域ID。
Status String Running

集群运行状态，可取值部分示例：

  • Creating：创建中
  • CreateFailed：创建失败
  • Running：运行中
  • Deleting：删除中
  • DeleteFailed：删除失败
  • Deleted：已删除
VpcId String vpc-bp1qitxqe1m5r****4mng

VPC网络的ID。
VswitchId String vsw-bp13e9ynz3jpy****hqlm

虚拟交换机的ID。
ZoneId String cn-hangzhou-g

可用区ID，可调用DescribeRegions查询，使用此参数指定要创建实例的可用区。
RequestId String C8CA4D25-47FE-47D9-A34F-69B554A3A069

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeDataCenters
&ClusterId=cds-bp1b136j****5d57
&<公共请求参数>

正常返回示例

XML 格式 

<DescribeDataCentersResponse>
  <DataCenters>
        <DataCenter>
              <Status>Running</Status>
              <DataCenterId>cn-hangzhou-g</DataCenterId>
              <CreatedTime>2020-02-21T10:29:45Z</CreatedTime>
              <CommodityInstance>cds-bp1syjlt****q976</CommodityInstance>
              <ZoneId>cn-hangzhou-g</ZoneId>
              <NodeCount>2</NodeCount>
              <ClusterId>cds-bp1syjlt****q976</ClusterId>
              <PayType>Subscription</PayType>
              <LockMode>None</LockMode>
              <DataCenterName>test</DataCenterName>
              <VswitchId>vsw-bp1nm66r36goq****2thl</VswitchId>
              <DiskType>local_ssd_pro</DiskType>
              <VpcId>vpc-bp120k6ixs4eo****vu6x</VpcId>
              <DiskSize>22000</DiskSize>
              <RegionId>cn-hangzhou</RegionId>
              <InstanceType>cassandra.c.2xlarge</InstanceType>
              <ExpireTime>2020-03-22T00:00:00Z</ExpireTime>
        </DataCenter>
  </DataCenters>
  <RequestId>5AA67458-E8E8-419C-873A-D211CE2C7D31</RequestId>
</DescribeDataCentersResponse>

JSON 格式 

{
  "DataCenters": {
    "DataCenter": [
      {
        "Status": "Running",
        "DataCenterId": "cn-hangzhou-g",
        "CreatedTime": "2020-02-21T10:29:45Z",
        "CommodityInstance": "cds-bp1syjlt****q976",
        "ZoneId": "cn-hangzhou-g",
        "NodeCount": 2,
        "ClusterId": "cds-bp1syjlt****q976",
        "PayType": "Subscription",
        "LockMode": "None",
        "DataCenterName": "test",
        "VswitchId": "vsw-bp1nm66r36goq****2thl",
        "DiskType": "local_ssd_pro",
        "VpcId": "vpc-bp120k6ixs4eo****vu6x",
        "DiskSize": 22000,
        "RegionId": "cn-hangzhou",
        "InstanceType": "cassandra.c.2xlarge",
        "ExpireTime": "2020-03-22T00:00:00Z"
      }
    ]
  },
  "RequestId": "5AA67458-E8E8-419C-873A-D211CE2C7D31"
}

错误码

访问错误中心查看更多错误码。