View a markdown version of this page

FailoverShard - Amazon MemoryDB

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

FailoverShard

Wird für das Failover eines Shards verwendet. Diese API wurde entwickelt, um das Verhalten Ihrer Anwendung im Falle eines MemoryDB-Failovers zu testen. Sie ist nicht dafür konzipiert, als Tool auf Produktionsebene zum Initiieren eines Failovers verwendet zu werden, um ein Problem zu lösen, das Sie möglicherweise mit dem Cluster haben. Darüber hinaus kann Amazon unter bestimmten Bedingungen, wie z. B. bei groß angelegten Betriebsereignissen, diese API blockieren.

Anforderungssyntax

{ "ClusterName": "string", "ShardName": "string" }

Anforderungsparameter

Informationen zu den Parametern, die alle Aktionen gemeinsam haben, finden Sie unter Allgemeine Parameter.

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

ClusterName

Der Cluster, für den ein Failover ausgeführt wird.

Typ: Zeichenfolge

Erforderlich: Ja

ShardName

Der Name des Shards.

Typ: Zeichenfolge

Erforderlich: Ja

Antwortsyntax

{ "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 } }

Antwortelemente

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

Cluster

Der Cluster, für den ein Failover ausgeführt wird.

Typ: Cluster Objekt

Fehler

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter Häufige Fehlertypen.

APICallRateForCustomerExceededFault

HTTP-Statuscode: 400

ClusterNotFoundFault

HTTP-Statuscode: 400

InvalidClusterStateFault

HTTP-Statuscode: 400

InvalidKMSKeyFault

HTTP-Statuscode: 400

InvalidParameterCombinationException

HTTP-Statuscode: 400

InvalidParameterValueException

HTTP-Statuscode: 400

ShardNotFoundFault

HTTP-Statuscode: 400

TestFailoverNotAvailableFault

HTTP-Statuscode: 400

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS SDKs finden Sie im Folgenden: