As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
ListClusters
Retorna uma matriz de objetos ClusterListEntry
do tamanho especificado. Cada objeto ClusterListEntry
contém o estado do cluster, o ID do cluster e outras informações importantes sobre o status.
Sintaxe da Solicitação
{
"MaxResults": number
,
"NextToken": "string
"
}
Parâmetros da solicitação
Para obter informações sobre os parâmetros comuns a todas as ações, consulte Parâmetros Comuns.
A solicitação aceita os seguintes dados no JSON formato.
- MaxResults
-
O número de objetos
ClusterListEntry
a serem devolvidos.Tipo: número inteiro
Intervalo válido: valor mínimo de 0. Valor máximo de 100.
Obrigatório: Não
- NextToken
-
HTTPas solicitações são apátridas. Para identificar qual objeto vem “a seguir” na lista de objetos
ClusterListEntry
, você tem a opção de especificarNextToken
como ponto de partida para sua lista retornada.Tipo: string
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 1.024.
Padrão:
.*
Obrigatório: Não
Sintaxe da Resposta
{
"ClusterListEntries": [
{
"ClusterId": "string",
"ClusterState": "string",
"CreationDate": number,
"Description": "string"
}
],
"NextToken": "string"
}
Elementos de Resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP de 200.
Os dados a seguir são retornados em JSON formato pelo serviço.
- ClusterListEntries
-
Cada objeto
ClusterListEntry
contém o estado do cluster, o ID do cluster e outras informações importantes sobre o status.Tipo: matriz de objetos ClusterListEntry
- NextToken
-
HTTPas solicitações são apátridas. Se você usar o valor de
NextToken
gerado automaticamente em sua próxima chamadaClusterListEntry
, sua lista de clusters retornados começará a partir desse ponto na matriz.Tipo: string
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 1.024.
Padrão:
.*
Erros
Para obter informações sobre os erros comuns retornados pelas ações, consulte Erros comuns.
- InvalidNextTokenException
-
A string
NextToken
foi alterada inesperadamente e a operação foi interrompida. Execute a operação sem alterar a stringNextToken
e tente novamente.HTTPCódigo de status: 400
Consulte também
Para obter mais informações sobre como usar isso API em um idioma específico AWS SDKs, consulte o seguinte: