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
nota
AWS Snowball Edge não está mais disponível para novos clientes. Novos clientes devem explorar AWS DataSync
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 que são comuns em todas as ações, consulte Parâmetros comuns.
A solicitação aceita os dados a seguir no formato JSON.
- MaxResults
-
O número de objetos
ClusterListEntrya serem devolvidos.Tipo: inteiro
Intervalo válido: valor mínimo de 0. Valor máximo de 100.
Obrigatório: Não
- NextToken
-
Solicitações HTTP são sem estado. Para identificar qual objeto vem “a seguir” na lista de objetos
ClusterListEntry, você tem a opção de especificarNextTokencomo 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 200.
Os dados a seguir são retornados no formato JSON pelo serviço.
- ClusterListEntries
-
Cada objeto
ClusterListEntrycontém o estado do cluster, o ID do cluster e outras informações importantes sobre o status.Tipo: matriz de objetos ClusterListEntry
- NextToken
-
Solicitações HTTP são sem estado. Se você usar o valor de
NextTokengerado 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
NextTokenfoi alterada inesperadamente e a operação foi interrompida. Execute a operação sem alterar a stringNextTokene tente novamente.Código de Status HTTP: 400
Consulte Também
Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte: