View a markdown version of this page

FailoverShard - Amazon MemoryDB

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.

Cluster

Il cluster in cui è stato eseguito il failover.

Tipo: oggetto Cluster

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: