調用DescribeDedicatedCluster介面獲得叢集的詳細資料。
調試
您可以在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 | 叢集狀態,取值為:
|
| 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. | 簽名已經到期,請更新簽名 |
訪問錯誤中心查看更多錯誤碼。