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à.
FailoverShard
Usato per eseguire il failover di un frammento. Questa API è progettata per testare il comportamento dell'applicazione in caso di failover di MemoryDB. Non è progettata per essere utilizzata come strumento a livello di produzione per avviare un failover per superare un problema che potresti avere con il cluster. Inoltre, in determinate condizioni, ad esempio eventi operativi su larga scala, Amazon potrebbe bloccare questa API.
Sintassi della richiesta
{
"ClusterName": "string",
"ShardName": "string"
}
Parametri della richiesta
Per informazioni sui parametri comuni per tutte le azioni, consulta Parametri comuni.
La richiesta accetta i seguenti dati in formato JSON.
- ClusterName
-
Il cluster è stato sottoposto a failover.
Tipo: stringa
Obbligatorio: sì
- ShardName
-
Il nome del frammento.
Tipo: stringa
Obbligatorio: sì
Sintassi della risposta
{
"Cluster": {
"ACLName": "string",
"ARN": "string",
"AutoMinorVersionUpgrade": boolean,
"AvailabilityMode": "string",
"ClusterEndpoint": {
"Address": "string",
"Port": number
},
"DataTiering": "string",
"Description": "string",
"Engine": "string",
"EnginePatchVersion": "string",
"EngineVersion": "string",
"IpDiscovery": "string",
"KmsKeyId": "string",
"MaintenanceWindow": "string",
"MultiRegionClusterName": "string",
"Name": "string",
"NetworkType": "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
}
}
Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare Tipi di errore comuni.
- APICallRateForCustomerExceededFault
-
Codice di stato HTTP: 400
- ClusterNotFoundFault
-
Codice di stato HTTP: 400
- InvalidClusterStateFault
-
Codice di stato HTTP: 400
- InvalidKMSKeyFault
-
Codice di stato HTTP: 400
- InvalidParameterCombinationException
-
Codice di stato HTTP: 400
- InvalidParameterValueException
-
Codice di stato HTTP: 400
- ShardNotFoundFault
-
Codice di stato HTTP: 400
- TestFailoverNotAvailableFault
-
Codice di stato HTTP: 400
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in uno degli AWS SDK specifici della lingua, consulta quanto segue: