获取单个数据中心详情。

调试

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

调试

请求参数

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

系统规定参数。取值：DescribeDataCenter。
ClusterId String 是 cds-t4n98w89z77*****

集群ID
DataCenterId String 是 ap-southeast-1a

数据中心Id，可通过DescribeDataCenters获得相应的数据中心Id

返回数据

名称类型示例值描述
名称 类型 示例值 描述
AutoRenewPeriod Integer 1

付费周期，PayType（付费类型）为Subscription并且AutoRenewal（自动续费）为true时会有此结果，单位为月，取值：1-9，12，24，36 。

AutoRenewal Boolean true

是否要自动续费。当参数PayType取值Subscription时才会有此值。取值：

true：自动续费。

false：不自动续费。
ClusterId String cds-t4n98w89z77*****

集群ID。
CommodityInstance String cds-t4n98w89z77*****

集群商业ID。
CreatedTime String 2020-10-16T11:27:20Z

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

集群数据中心ID。
DataCenterName String test_name

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

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

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

cloud_ssd：SSD云盘

cloud_essd：ESSD云盘

cloud_efficiency：高效云盘

local_ssd_pro：本地SSD盘
ExpireTime String 2020-11-17T00:00:00Z

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

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

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 ap-southeast-1

地域ID，可以通过接口DescribeRegions查看可用的地域ID。
RequestId String A4C83BDF-1DE0-41CD-9D6C-8D9FE5EB5504

请求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 ap-southeast-1a

可用区ID，可调用DescribeRegions查询，使用此参数指定要创建实例的可用区。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeDataCenter
&ClusterId=cds-t4n98w89z77*****
&DataCenterId=ap-southeast-1a
&<公共请求参数>

正常返回示例

XML 格式 

<AutoRenewPeriod>1</AutoRenewPeriod>
<Status>Running</Status>
<DataCenterId>ap-southeast-1a</DataCenterId>
<CommodityInstance>cds-t4n98w89z77*****</CommodityInstance>
<CreatedTime>2020-10-16T11:27:20Z</CreatedTime>
<NodeCount>2</NodeCount>
<ZoneId>ap-southeast-1a</ZoneId>
<RequestId>A4C83BDF-1DE0-41CD-9D6C-8D9FE5EB5504</RequestId>
<ClusterId>cds-t4n98w89z77*****</ClusterId>
<LockMode>None</LockMode>
<PayType>Subscription</PayType>
<VswitchId>vsw-bp13e9ynz3jpy****hqlm</VswitchId>
<DataCenterName>test_name</DataCenterName>
<DiskType>cloud_ssd</DiskType>
<AutoRenewal>true</AutoRenewal>
<VpcId>vpc-bp1qitxqe1m5r****4mng</VpcId>
<DiskSize>160</DiskSize>
<RegionId>ap-southeast-1</RegionId>
<ExpireTime>2020-11-17T00:00:00Z</ExpireTime>
<InstanceType>cassandra.c.large</InstanceType>

JSON 格式 

{"AutoRenewPeriod":"1","Status":"Running","DataCenterId":"ap-southeast-1a","CommodityInstance":"cds-t4n98w89z77*****","CreatedTime":"2020-10-16T11:27:20Z","NodeCount":"2","ZoneId":"ap-southeast-1a","RequestId":"A4C83BDF-1DE0-41CD-9D6C-8D9FE5EB5504","ClusterId":"cds-t4n98w89z77*****","LockMode":"None","PayType":"Subscription","VswitchId":"vsw-bp13e9ynz3jpy****hqlm","DataCenterName":"test_name","DiskType":"cloud_ssd","AutoRenewal":"true","VpcId":"vpc-bp1qitxqe1m5r****4mng","DiskSize":"160","RegionId":"ap-southeast-1","ExpireTime":"2020-11-17T00:00:00Z","InstanceType":"cassandra.c.large"}

错误码

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