調用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

磁盤存儲大?。抗濣c，單位GB）。
DiskType String local_ssd_pro

磁盤存儲類型?？扇≈凳纠?/p>

  • 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

集群實例類型?？扇≈挡糠质纠?/p>

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

鎖定模式?？扇≈担?/p>

  • 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"
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。