Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
DescribeClusters
Restituisce informazioni su tutti i cluster assegnati se non viene specificato alcun identificatore di cluster o su un cluster specifico se viene fornito un nome di cluster.
Sintassi della richiesta
{
"ClusterName": "string",
"MaxResults": number,
"NextToken": "string",
"ShowShardDetails": boolean
}Parametri della richiesta
Per informazioni sui parametri comuni per tutte le azioni, consulta Parametri comuni.
La richiesta accetta i seguenti dati nel formato. JSON
- ClusterName
-
Il nome del cluster
Tipo: string
Campo obbligatorio: no
- MaxResults
-
Numero massimo di record da includere nella risposta. Se esistono più record rispetto al MaxResults valore specificato, nella risposta viene incluso un token in modo da poter recuperare i risultati rimanenti.
Tipo: integer
Campo obbligatorio: no
- NextToken
-
Un argomento opzionale da utilizzare nel caso in cui il numero totale di record superi il valore di. MaxResults Se nextToken viene restituito, ci sono più risultati disponibili. Il valore di nextToken è un token di impaginazione unico per ogni pagina. Effettua nuovamente la chiamata utilizzando il token restituito per recuperare la pagina successiva. Mantieni invariati tutti gli altri argomenti.
Tipo: string
Campo obbligatorio: no
- ShowShardDetails
-
Un flag opzionale che può essere incluso nella richiesta per recuperare informazioni sui singoli frammenti.
Tipo: Booleano
Campo obbligatorio: no
Sintassi della risposta
{
"Clusters": [
{
"ACLName": "string",
"ARN": "string",
"AutoMinorVersionUpgrade": boolean,
"AvailabilityMode": "string",
"ClusterEndpoint": {
"Address": "string",
"Port": number
},
"DataTiering": "string",
"Description": "string",
"Engine": "string",
"EnginePatchVersion": "string",
"EngineVersion": "string",
"KmsKeyId": "string",
"MaintenanceWindow": "string",
"Name": "string",
"NodeType": "string",
"NumberOfShards": number,
"ParameterGroupName": "string",
"ParameterGroupStatus": "string",
"PendingUpdates": {
"ACLs": {
"ACLToApply": "string"
},
"Resharding": {
"SlotMigration": {
"ProgressPercentage": number
}
},
"ServiceUpdates": [
{
"ServiceUpdateName": "string",
"Status": "string"
}
]
},
"SecurityGroups": [
{
"SecurityGroupId": "string",
"Status": "string"
}
],
"Shards": [
{
"Name": "string",
"Nodes": [
{
"AvailabilityZone": "string",
"CreateTime": number,
"Endpoint": {
"Address": "string",
"Port": number
},
"Name": "string",
"Status": "string"
}
],
"NumberOfNodes": number,
"Slots": "string",
"Status": "string"
}
],
"SnapshotRetentionLimit": number,
"SnapshotWindow": "string",
"SnsTopicArn": "string",
"SnsTopicStatus": "string",
"Status": "string",
"SubnetGroupName": "string",
"TLSEnabled": boolean
}
],
"NextToken": "string"
}Elementi di risposta
Se l'azione ha esito positivo, il servizio restituisce una risposta di HTTP 200.
I seguenti dati vengono restituiti in JSON formato dal servizio.
- Clusters
-
Un elenco di cluster
Tipo: matrice di oggetti Cluster
- NextToken
-
Un argomento opzionale da passare nel caso in cui il numero totale di record superi il valore di. MaxResults Se nextToken viene restituito, ci sono più risultati disponibili. Il valore di nextToken è un token di impaginazione unico per ogni pagina. Effettua nuovamente la chiamata utilizzando il token restituito per recuperare la pagina successiva. Mantieni invariati tutti gli altri argomenti.
Tipo: stringa
Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.
- ClusterNotFoundFault
-
HTTPCodice di stato: 400
- InvalidParameterCombinationException
-
HTTPCodice di stato: 400
- InvalidParameterValueException
-
HTTPCodice di stato: 400
- ServiceLinkedRoleNotFoundFault
-
HTTPCodice di stato: 400
Vedi anche
Per ulteriori informazioni sull'utilizzo API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
