Todos os produtos
Search
Central de documentação

Data Transmission Service:DescribeDedicatedCluster

Última atualização: Jun 27, 2026

Consulta informações sobre um cluster dedicado do Data Transmission Service (DTS).

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action

String

Sim

DescribeDedicatedCluster

Operação a ser executada. Defina o valor como DescribeDedicatedCluster.

DedicatedClusterId

String

Sim

dtsCluster****

ID do cluster.

RegionId

String

Não

cn-hangzhou

ID da região onde a instância está localizada.

Parâmetros de resposta

Parâmetro Tipo Exemplo Descrição
HttpStatusCode String 200

Código de status HTTP.

RequestId String 621BB4F8-3016-4FAA-8D5A-5D3163CC****

ID da solicitação.

ErrCode String InternalError

Código de erro retornado em caso de falha na solicitação.

Success String true

Indica se a solicitação foi bem-sucedida.

ErrMessage String The Value of Input Parameter %s is not valid.

Mensagem de erro retornada em caso de falha na solicitação.

DedicatedClusterId String dtsCluster****

ID do cluster.

DedicatedClusterName String daily_test

Nome do cluster.

Du Long 30

Quantidade de unidades DTS (DUs).

OversoldDu Long 60

Quantidade de DUs que excede o limite superior.

UsedDu Long 5

Quantidade de DUs em uso.

State String inti

Status do cluster. Valores válidos:

  • init: O cluster está sendo inicializado.
  • schedule: O cluster está com agendamento pendente.
  • running: O cluster está em execução.
  • upgrade: O cluster está sendo atualizado.
  • downgrade: O cluster está tendo sua versão reduzida.
  • locked: O cluster está bloqueado.
  • releasing: O cluster está sendo liberado.
  • released: O cluster foi liberado.
RegionId String cn-hangzhou

ID da região onde a instância está localizada.

NodeCount Long 5

Número de nós no cluster.

DuUtilization Long 16

Uso de DU. Unidade: porcentagem.

CpuUtilization Long 30

Utilização da CPU. Unidade: porcentagem.

TotalCpuCore Long 100

Número total de núcleos de CPU.

UsedCpuCore Long 30

Número de núcleos de CPU em uso.

MemUtilization Long 20

Capacidade de memória utilizada.

TotalMemGBSize Long 256

Quantidade total de memória. Unidade: GB.

UsedMemGBSize Long 128

Quantidade de memória em uso. Unidade: GB.

DiskUtilization Long 50

Uso do disco.

TotalDiskGBSize Long 2048

Tamanho total do disco. Unidade: GB.

UsedDiskGBSize Long 1024

Tamanho do disco em uso. Unidade: GB.

GmtCreated Long 1642476144000

Horário de criação do cluster.

GmtFinished Long 1645200000000

Horário de expiração do cluster.

DtsInstanceID String dtsb8r****

ID da instância.

Exemplos

Solicitações de exemplo

http(s)://dts.aliyuncs.com/?Action=DescribeDedicatedCluster
&DedicatedClusterId=dtsCluster****
&RegionId=cn-hangzhou
&Common request parameters

Respostas de sucesso de exemplo

Formato 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>

Formato 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
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400

Throttling.User

Request was denied due to user flow control.

O número de solicitações atingiu o limite e a solicitação foi rejeitada. Tente novamente mais tarde.

500

ServiceUnavailable

The request has failed due to a temporary failure of the server.

A resposta do servidor expirou ou o servidor estava indisponível. Tente novamente. Se o erro persistir, entre em contato com o suporte técnico.

403

InvalidSecurityToken.Expired

Specified SecurityToken is expired.

A assinatura expirou. Use uma nova assinatura.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.