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. Ceci API est conçu 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 le bloquerAPI.
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.
La demande accepte les données suivantes au JSON format suivant.
- 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",
"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 sous JSON forme formatée par le service.
Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Erreurs courantes.
- APICallRateForCustomerExceededFault
-
HTTPCode de statut : 400
- ClusterNotFoundFault
-
HTTPCode de statut : 400
- InvalidClusterStateFault
-
HTTPCode de statut : 400
- InvalidKMSKeyFault
-
HTTPCode de statut : 400
- InvalidParameterCombinationException
-
HTTPCode de statut : 400
- InvalidParameterValueException
-
HTTPCode de statut : 400
- ShardNotFoundFault
-
HTTPCode de statut : 400
- TestFailoverNotAvailableFault
-
HTTPCode de statut : 400
consultez aussi
Pour plus d'informations sur son utilisation API dans l'une des langues spécifiques AWS SDKs, consultez ce qui suit :