调用DescribeDedicatedCluster接口获得集群的详细信息_数据传输服务(DTS)-阿里云帮助中心

调试

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

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	DescribeDedicatedCluster	系统规定参数。取值：DescribeDedicatedCluster。
DedicatedClusterId	String	是	dtsCluster****	集群ID。
RegionId	String	否	cn-hangzhou	实例所在地域。

返回数据


名称	类型	示例值	描述
HttpStatusCode	String	200	状态码。
RequestId	String	621BB4F8-3016-4FAA-8D5A-5D3163CC****	请求ID。
ErrCode	String	InternalError	调用出错时返回的错误码。
Success	String	true	请求是否成功。
ErrMessage	String	The Value of Input Parameter %s is not valid.	调用错误时返回的错误信息。
DedicatedClusterId	String	dtsCluster****	集群ID。
DedicatedClusterName	String	daily_test	集群名称。
Du	Long	30	DU数。
OversoldDu	Long	60	超配DU的数量。
UsedDu	Long	5	已使用DU数量。
State	String	inti	集群状态，取值为： init：初始化。 schedule：待调度。 running：运行中。 upgrade：升级中。 downgrade,：降级中。 locked：已锁定。 releasing：释放中。 released：已经释放。
RegionId	String	cn-hangzhou	实例所在区域。
NodeCount	Long	5	集群节点数。
DuUtilization	Long	16	DU使用百分比。
CpuUtilization	Long	30	CPU使用百分比。
TotalCpuCore	Long	100	CPU总核数。
UsedCpuCore	Long	30	已使用CPU核数。
MemUtilization	Long	20	CPU使用量。
TotalMemGBSize	Long	256	内存总大小（GB）。
UsedMemGBSize	Long	128	已使用内存大小（GB）。
DiskUtilization	Long	50	磁盘使用量。
TotalDiskGBSize	Long	2048	磁盘总大小（GB）。
UsedDiskGBSize	Long	1024	已使用磁盘大小（GB）。
GmtCreated	Long	1642476144000	创建时间。
GmtFinished	Long	1645200000000	结束时间。
DtsInstanceID	String	dtsb8r****	实例ID。

示例

请求示例

http(s)://dts.aliyuncs.com/?Action=DescribeDedicatedCluster
&DedicatedClusterId=dtsCluster****
&RegionId=cn-hangzhou
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeDedicatedClusterResponse>
    <code>200</code>
    <data>
        <UsedDu>14</UsedDu>
        <DuUtilization>46</DuUtilization>
        <UsedDiskGBSize>51</UsedDiskGBSize>
        <RequestId>1D1C3EFB-3338-143F-***</RequestId>
        <DedicatedClusterId>dtscluster_w4iv***</DedicatedClusterId>
        <NodeCount>2</NodeCount>
        <OversoldDu>30</OversoldDu>
        <TotalDiskGBSize>1006</TotalDiskGBSize>
        <DiskUtilization>6</DiskUtilization>
        <GmtFinished>1645200000000</GmtFinished>
        <UsedMemGBSize>63</UsedMemGBSize>
        <GmtCreated>1642476144000</GmtCreated>
        <DedicatedClusterName>dtscluster_w4iv***</DedicatedClusterName>
        <DtsInstanceID>dtsb84w***</DtsInstanceID>
        <Success>true</Success>
        <TotalMemGBSize>259</TotalMemGBSize>
        <MemUtilization>24</MemUtilization>
        <Du>30</Du>
        <State>running</State>
        <HttpStatusCode>200</HttpStatusCode>
        <UsedCpuCore>64</UsedCpuCore>
        <TotalCpuCore>32</TotalCpuCore>
        <RegionId>cn-hangzhou</RegionId>
        <CpuUtilization>2</CpuUtilization>
    </data>
    <httpStatusCode>200</httpStatusCode>
    <requestId>1D1C3EFB-3338-143F-8CF2-***</requestId>
    <successResponse>true</successResponse>
</DescribeDedicatedClusterResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "code" : "200",
  "data" : {
    "UsedDu" : 14,
    "DuUtilization" : 46,
    "UsedDiskGBSize" : 51,
    "RequestId" : "1D1C3EFB-3338-143F-***",
    "DedicatedClusterId" : "dtscluster_w4iv***",
    "NodeCount" : 2,
    "OversoldDu" : 30,
    "TotalDiskGBSize" : 1006,
    "DiskUtilization" : 6,
    "GmtFinished" : 1645200000000,
    "UsedMemGBSize" : 63,
    "GmtCreated" : 1642476144000,
    "DedicatedClusterName" : "dtscluster_w4iv***",
    "DtsInstanceID" : "dtsb84w***",
    "Success" : true,
    "TotalMemGBSize" : 259,
    "MemUtilization" : 24,
    "Du" : 30,
    "State" : "running",
    "HttpStatusCode" : 200,
    "UsedCpuCore" : 64,
    "TotalCpuCore" : 32,
    "RegionId" : "cn-hangzhou",
    "CpuUtilization" : 2
  },
  "httpStatusCode" : "200",
  "requestId" : "1D1C3EFB-3338-143F-8CF2-***",
  "successResponse" : true
}

错误码


HttpCode	错误码	错误信息	描述
400	Throttling.User	Request was denied due to user flow control.	由于请求频次达到阈值，请求被拒绝，请稍后重试。
500	ServiceUnavailable	The request has failed due to a temporary failure of the server.	由于服务端响应超时或者不可用导致请求失败，请重试，重试后仍失败请联系技术支持。
403	InvalidSecurityToken.Expired	Specified SecurityToken is expired.	签名已经过期，请更新签名

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