Todos os produtos
Search
Central de documentação

Data Transmission Service:DescribeClusterUsedUtilization

Última atualização: Jun 27, 2026

Consulta a utilização de recursos de um cluster.

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 DescribeClusterUsedUtilization

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

DedicatedClusterId String Sim nodeid

ID do cluster. Se MetricType for CLUSTER, insira o ID do cluster dedicado. Caso contrário, defina este parâmetro como um ID de nó.

Env String Não ALIYUN

Ambiente do cluster. Valor padrão: ALIYUN.

MetricType String Não NODE

Escopo das métricas a consultar. Valores válidos:

  • CLUSTER (padrão): consulta as métricas do cluster.
  • NODE: consulta as métricas de um nó.
RegionId String Não cn-hangzhou

ID da região da instância do Data Transmission Service (DTS).

DtsJobId String Não k2gm967v16f****

ID da tarefa de migração ou sincronização de dados.

ClientToken String Não 0c593ea1-3bea-11e9-b96b-88e9fe63****

Token de cliente usado para garantir a idempotência da solicitação. Gere o token no cliente e assegure que seja exclusivo entre diferentes solicitações. O token aceita apenas caracteres ASCII e tem limite de 64 caracteres.

AccountId String Não 12323344****

ID da conta Alibaba Cloud. Este parâmetro está obsoleto e será removido futuramente.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

DedicatedClusterId

String

dtscluster_h3fl1cs217sx952

ID do cluster.

CpuTotal

Float

50

Utilização da CPU do cluster. Unidade: %.

MemoryUsed

Float

0

Tamanho da memória utilizada pelo cluster. Retorna temporariamente o valor 0.

MemoryTotal

Float

0

Tamanho total da memória do cluster. Retorna temporariamente o valor 0.

DiskTotal

Float

1024

Tamanho total do disco do cluster. Unidade: GB.

DiskUsed

Float

96

Tamanho do disco utilizado pelo cluster. Unidade: GB.

DuTotal

Integer

30

Número total de unidades DTS (DUs).

DuUsed

Integer

2

Número de DUs utilizadas.

TaskRunning

Integer

3

Número de tarefas em andamento.

Success

Boolean

true

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

Code

String

200

Código de erro retornado pelo serviço de back-end. O número é incrementado.

ErrCode

String

InternalError

Código de erro retornado se a solicitação falhar.

ErrMessage

String

The Value of Input Parameter %s is not valid.

Mensagem de erro retornada se a solicitação falhar.

DynamicMessage

String

Type

Parte dinâmica da mensagem de erro. Substitui a variável %s no valor de ErrMessage.

HttpStatusCode

Integer

200

Código de status HTTP.

RequestId

String

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

ID da solicitação.

MemoryUsedPercentage

Float

1.0

Porcentagem de uso de memória. Unidade: %.

Exemplos

Exemplos de solicitações

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****
&Common request parameters

Exemplos de respostas de sucesso

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

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

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.

Solicitação limitada devido ao controle de fluxo do usuário. Tente novamente mais tarde.

500

ServiceUnavailable

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

O servidor atingiu o tempo limite ou 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. Utilize uma nova assinatura.

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