Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
FailoverShard
Utilisé pour basculer une partition. Cette API est conçue pour tester le comportement de votre application en cas de basculement de MemoryDB. Il n'est pas conçu pour être utilisé en tant qu'outil de production pour lancer un basculement afin de résoudre un problème que vous pourriez rencontrer avec le cluster. De plus, dans certaines conditions, telles que des événements opérationnels à grande échelle, Amazon peut bloquer cette API.
Syntaxe de la requête
{
"ClusterName": "string",
"ShardName": "string"
}Paramètres de demande
Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez Paramètres courants.
Cette demande accepte les données suivantes au format JSON.
- ClusterName
-
Le cluster en cours de basculement.
Type : String
Obligatoire : oui
- ShardName
-
Le nom du shard.
Type : String
Obligatoire : oui
Syntaxe de la réponse
{
"Cluster": {
"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",
"MultiRegionClusterName": "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
}
}Eléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 200.
Les données suivantes sont renvoyées au format JSON par le service.
Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Erreurs courantes.
- APICallRateForCustomerExceededFault
-
Code d’état HTTP : 400
- ClusterNotFoundFault
-
Code d’état HTTP : 400
- InvalidClusterStateFault
-
Code d’état HTTP : 400
- InvalidKMSKeyFault
-
Code d’état HTTP : 400
- InvalidParameterCombinationException
-
Code d’état HTTP : 400
- InvalidParameterValueException
-
Code d’état HTTP : 400
- ShardNotFoundFault
-
Code d’état HTTP : 400
- TestFailoverNotAvailableFault
-
Code d’état HTTP : 400
consultez aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
