Todos os produtos
Search
Central de documentação

DataWorks:ListClusters

Última atualização: Jun 29, 2026

Consulta os clusters registrados no DataWorks. Há suporte para clusters E-MapReduce (EMR) e Cloudera's Distribution Including Apache Hadoop (CDH).

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

ClusterType

string

Sim

O tipo do cluster. Valores válidos:\n\n* CDH: cluster CDH\n* EMR: cluster EMR.

EMR

PageNumber

integer

Não

O número da página. As páginas começam na página 1.

1

PageSize

integer

Não

O número de entradas por página. Valor padrão: 10. Valor máximo: 100.

10

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Os dados retornados.

Data

object

Os dados retornados.

PageNumber

integer

O número da página.

1

PageSize

integer

O número de entradas por página.

10

TotalCount

integer

O número total de entradas retornadas.

100

Clusters

array

A lista de informações dos clusters.

Cluster

As informações do cluster.

RequestId

string

O ID da solicitação. Você pode usar o ID da solicitação para consultar logs e solucionar problemas.

0000-ABCD-E****

Success

boolean

Indica se a solicitação foi bem-sucedida. Valores válidos:\n\n* true\n* false.

true

ErrorCode

string

O código de erro.

101011005

ErrorMessage

string

A mensagem de erro.

Invalid.Cluster.ClusterNotFound

HttpStatusCode

integer

O código de status HTTP.

200

Exemplos

Resposta de sucesso

JSON formato

{
  "Data": {
    "PageNumber": 1,
    "PageSize": 10,
    "TotalCount": 100,
    "Clusters": [
      {
        "ClusterId": 1234,
        "ClusterBizId": "c-d8a7523****"
      }
    ]
  },
  "RequestId": "0000-ABCD-E****",
  "Success": true,
  "ErrorCode": "101011005",
  "ErrorMessage": "Invalid.Cluster.ClusterNotFound",
  "HttpStatusCode": 200
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.