調用DescribeClusterUsedUtilization介面查看叢集當前使用量。
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
請求參數
| 名稱 | 類型 | 是否必選 | 樣本值 | 描述 |
| Action | String | 是 | DescribeClusterUsedUtilization | 系統規定參數。取值：DescribeClusterUsedUtilization。 |
| DedicatedClusterId | String | 是 | nodeid | 當MetricType為CLUSTER填入獨享叢集ID，否則為nodeid。 |
| Env | String | 否 | ALIYUN | 預設為ALIYUN。 |
| MetricType | String | 否 | NODE | 查詢叢集或節點，取值：
|
| RegionId | String | 否 | cn-hangzhou | 執行個體所在地區。 |
| DtsJobId | String | 否 | k2gm967v16f**** | 遷移或同步任務ID。 |
| ClientToken | String | 否 | 0c593ea1-3bea-11e9-b96b-88e9fe63**** | 保證請求等冪性。從您的用戶端產生一個參數值，確保不同請求間該參數值唯一。ClientToken只支援ASCII字元，且不能超過64個字元。 |
| AccountId | String | 否 | 12323344**** | 阿里雲主帳號ID，無需設定，該參數即將下線。 |
返回資料
| 名稱 | 類型 | 樣本值 | 描述 |
| DedicatedClusterId | String | dtscluster_h3fl1cs217sx952 | 叢集ID。 |
| CpuTotal | Float | 50 | 叢集CPU使用率，單位為%。 |
| MemoryUsed | Float | 0 | 記憶體使用量量，暫時返回0。 |
| MemoryTotal | Float | 0 | 記憶體總量，暫時返回0。 |
| DiskTotal | Float | 1024 | 叢集磁碟總量，單位GB。 |
| DiskUsed | Float | 96 | 叢集磁碟使用量，單位GB。 |
| DuTotal | Integer | 30 | 總DU量。 |
| DuUsed | Integer | 2 | DU使用量。 |
| TaskRunning | Integer | 3 | 運行任務數。 |
| Success | Boolean | true | 調用結果是否成功。 |
| Code | String | 200 | 後端錯誤碼，數字遞增。 |
| ErrCode | String | InternalError | 調用出錯時返回的錯誤碼。 |
| ErrMessage | String | The Value of Input Parameter %s is not valid. | 錯誤資訊。 |
| DynamicMessage | String | Type | 動態錯誤資訊，用於替換返回參數ErrMessage錯誤資訊中的%s。 |
| HttpStatusCode | Integer | 200 | 狀態代碼。 |
| RequestId | String | 621BB4F8-3016-4FAA-8D5A-5D3163CC**** | 請求ID。 |
| MemoryUsedPercentage | Float | 1.0 | 記憶體使用量百分比。 |
樣本
請求樣本
http(s)://dts.aliyuncs.com/?Action=DescribeClusterUsedUtilization
&DedicatedClusterId=nodeid
&Env=ALIYUN
&MetricType=NODE
&RegionId=cn-hangzhou
&DtsJobId=k2gm967v16f****
&ClientToken=0c593ea1-3bea-11e9-b96b-88e9fe63****
&AccountId=12323344****
&公用請求參數正常返回樣本
XML格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeClusterUsedUtilizationResponse>
<code>200</code>
<data>
<DedicatedClusterId>dtscluster_****</DedicatedClusterId>
<RequestId>E2E2AD3E-B7A4-106C-9063-****</RequestId>
<DuUsed>14</DuUsed>
<Success>true</Success>
<DuTotal>30</DuTotal>
<DiskTotal>982.3013</DiskTotal>
<HttpStatusCode>200</HttpStatusCode>
<MemoryUsedPercentage>5.5200005</MemoryUsedPercentage>
<MemoryUsed>0</MemoryUsed>
<TaskRunning>3</TaskRunning>
<DiskUsed>92.0647</DiskUsed>
<MemoryTotal>0</MemoryTotal>
<CpuTotal>1.7</CpuTotal>
</data>
<httpStatusCode>200</httpStatusCode>
<requestId>E2E2AD3E-B7A4-106C-9063-****</requestId>
<successResponse>true</successResponse>
</DescribeClusterUsedUtilizationResponse>JSON格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"code" : "200",
"data" : {
"DedicatedClusterId" : "dtscluster_****",
"RequestId" : "E2E2AD3E-B7A4-106C-9063-****",
"DuUsed" : 14,
"Success" : true,
"DuTotal" : 30,
"DiskTotal" : 982.3013,
"HttpStatusCode" : 200,
"MemoryUsedPercentage" : 5.5200005,
"MemoryUsed" : 0.0,
"TaskRunning" : 3,
"DiskUsed" : 92.0647,
"MemoryTotal" : 0.0,
"CpuTotal" : 1.7
},
"httpStatusCode" : "200",
"requestId" : "E2E2AD3E-B7A4-106C-9063-****",
"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. | 簽名已經到期，請更新簽名 |
訪問錯誤中心查看更多錯誤碼。