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
<a name="API_FailoverShard"></a>

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
<a name="API_FailoverShard_RequestSyntax"></a>

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

## Paramètres de demande
<a name="API_FailoverShard_RequestParameters"></a>

Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md).

Cette demande accepte les données suivantes au format JSON.

 ** [ClusterName](#API_FailoverShard_RequestSyntax) **   <a name="MemoryDB-FailoverShard-request-ClusterName"></a>
Le cluster en cours de basculement.  
Type : Chaîne  
Obligatoire : oui

 ** [ShardName](#API_FailoverShard_RequestSyntax) **   <a name="MemoryDB-FailoverShard-request-ShardName"></a>
Le nom du shard.  
Type : Chaîne  
Obligatoire : oui

## Syntaxe de la réponse
<a name="API_FailoverShard_ResponseSyntax"></a>

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

## Eléments de réponse
<a name="API_FailoverShard_ResponseElements"></a>

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.

 ** [Cluster](#API_FailoverShard_ResponseSyntax) **   <a name="MemoryDB-FailoverShard-response-Cluster"></a>
Le cluster en cours de basculement.  
Type : objet [Cluster](API_Cluster.md)

## Erreurs
<a name="API_FailoverShard_Errors"></a>

Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Types d'erreurs courants](CommonErrors.md).

 ** 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

## Voir aussi
<a name="API_FailoverShard_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/memorydb-2021-01-01/FailoverShard) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/memorydb-2021-01-01/FailoverShard) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/memorydb-2021-01-01/FailoverShard) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/memorydb-2021-01-01/FailoverShard) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/memorydb-2021-01-01/FailoverShard) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/memorydb-2021-01-01/FailoverShard) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/memorydb-2021-01-01/FailoverShard) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/memorydb-2021-01-01/FailoverShard) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/memorydb-2021-01-01/FailoverShard) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/memorydb-2021-01-01/FailoverShard)