全部產品
Search
文件中心

Data Transmission Service:查詢指定叢集詳細資料

更新時間:Feb 10, 2025

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

叢集狀態,取值為:

  • 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. 簽名已經到期,請更新簽名

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