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.

# UpdateCluster
<a name="API_UpdateCluster"></a>

Modifie les paramètres d'un cluster. Vous pouvez utiliser cette opération pour modifier un ou plusieurs paramètres de configuration du cluster en spécifiant les paramètres et les nouvelles valeurs.

## Syntaxe de la requête
<a name="API_UpdateCluster_RequestSyntax"></a>

```
{
   "ACLName": "string",
   "ClusterName": "string",
   "Description": "string",
   "Engine": "string",
   "EngineVersion": "string",
   "IpDiscovery": "string",
   "MaintenanceWindow": "string",
   "NodeType": "string",
   "ParameterGroupName": "string",
   "ReplicaConfiguration": { 
      "ReplicaCount": number
   },
   "SecurityGroupIds": [ "string" ],
   "ShardConfiguration": { 
      "ShardCount": number
   },
   "SnapshotRetentionLimit": number,
   "SnapshotWindow": "string",
   "SnsTopicArn": "string",
   "SnsTopicStatus": "string"
}
```

## Paramètres de demande
<a name="API_UpdateCluster_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.

 ** [ACLName](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-ACLName"></a>
Liste de contrôle d'accès associée au cluster.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1.  
Modèle : `[a-zA-Z][a-zA-Z0-9\-]*`   
Obligatoire : non

 ** [ClusterName](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-ClusterName"></a>
Nom du cluster à mettre à jour.  
Type : Chaîne  
Obligatoire : oui

 ** [Description](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-Description"></a>
Description du cluster à mettre à jour.  
Type : chaîne  
Obligatoire : non

 ** [Engine](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-Engine"></a>
Nom du moteur à utiliser pour le cluster.  
Type : chaîne  
Obligatoire : non

 ** [EngineVersion](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-EngineVersion"></a>
Version améliorée du moteur à exécuter sur les nœuds. Vous pouvez effectuer une mise à niveau vers une version du moteur plus récente, mais vous ne pouvez pas rétrograder vers une version antérieure du moteur. Si vous souhaitez utiliser une version antérieure du moteur, vous devez supprimer le cluster existant et le créer à nouveau avec la version précédente du moteur.  
Type : chaîne  
Obligatoire : non

 ** [IpDiscovery](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-IpDiscovery"></a>
Le mécanisme de découverte des adresses IP pour le protocole de découverte de clusters. Les valeurs valides sont « ipv4 » ou « ipv6 ». Lorsqu'elles sont définies sur « ipv4 », les fonctions de découverte de clusters telles que les emplacements de cluster, les partitions de cluster et les nœuds de cluster renvoient les IPv4 adresses des nœuds de cluster. Lorsqu'elles sont définies sur « ipv6 », les fonctions de découverte du cluster renvoient IPv6 les adresses des nœuds du cluster. La valeur doit être compatible avec le NetworkType paramètre. Si ce n'est pas spécifié, la valeur par défaut est « ipv4 ».  
Type : Chaîne  
Valeurs valides : `ipv4 | ipv6`   
Obligatoire : non

 ** [MaintenanceWindow](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-MaintenanceWindow"></a>
Indique la plage de temps hebdomadaire au cours de laquelle la maintenance sur le cluster est effectuée. Elle est spécifiée en tant que plage au format jjj:hh24:mi-jjjj:hh24:mi (24 H UTC). La fenêtre de maintenance minimale est une période de 60 minutes.  
Les valeurs valides pour `ddd` sont :  
+  `sun` 
+  `mon` 
+  `tue` 
+  `wed` 
+  `thu` 
+  `fri` 
+  `sat` 
Exemple : `sun:23:00-mon:01:30`   
Type : chaîne  
Obligatoire : non

 ** [NodeType](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-NodeType"></a>
Type de nœud valide auquel vous souhaitez augmenter ou diminuer ce cluster.  
Type : chaîne  
Obligatoire : non

 ** [ParameterGroupName](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-ParameterGroupName"></a>
Nom du groupe de paramètres à mettre à jour.  
Type : chaîne  
Obligatoire : non

 ** [ReplicaConfiguration](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-ReplicaConfiguration"></a>
Le nombre de répliques qui résideront dans chaque partition.  
Type : objet [ReplicaConfigurationRequest](API_ReplicaConfigurationRequest.md)  
Obligatoire : non

 ** [SecurityGroupIds](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-SecurityGroupIds"></a>
Le SecurityGroupIds à mettre à jour.  
Type : tableau de chaînes  
Obligatoire : non

 ** [ShardConfiguration](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-ShardConfiguration"></a>
Le nombre de partitions dans le cluster.  
Type : objet [ShardConfigurationRequest](API_ShardConfigurationRequest.md)  
Obligatoire : non

 ** [SnapshotRetentionLimit](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-SnapshotRetentionLimit"></a>
Nombre de jours pendant lesquels MemoryDB conserve les instantanés automatiques du cluster avant de les supprimer. Par exemple, si vous définissez SnapshotRetentionLimit la valeur 5, un instantané pris aujourd'hui est conservé pendant 5 jours avant d'être supprimé.  
Type : Integer  
Obligatoire : non

 ** [SnapshotWindow](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-SnapshotWindow"></a>
La plage horaire quotidienne (en UTC) pendant laquelle MemoryDB commence à prendre un instantané quotidien de votre cluster.  
Type : chaîne  
Obligatoire : non

 ** [SnsTopicArn](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-SnsTopicArn"></a>
L'ARN de la rubrique SNS à mettre à jour.  
Type : chaîne  
Obligatoire : non

 ** [SnsTopicStatus](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-SnsTopicStatus"></a>
État de la rubrique de notification Amazon SNS. Les notifications ne sont envoyées que si le statut est actif.  
Type : chaîne  
Obligatoire : non

## Syntaxe de la réponse
<a name="API_UpdateCluster_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_UpdateCluster_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_UpdateCluster_ResponseSyntax) **   <a name="MemoryDB-UpdateCluster-response-Cluster"></a>
Le cluster mis à jour.  
Type : objet [Cluster](API_Cluster.md)

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

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

 ** ACLNotFoundFault **   
  
Code d’état HTTP : 400

 ** ClusterNotFoundFault **   
  
Code d’état HTTP : 400

 ** ClusterQuotaForCustomerExceededFault **   
  
Code d’état HTTP : 400

 ** InvalidACLStateFault **   
  
Code d’état HTTP : 400

 ** InvalidClusterStateFault **   
  
Code d’état HTTP : 400

 ** InvalidKMSKeyFault **   
  
Code d’état HTTP : 400

 ** InvalidNodeStateFault **   
  
Code d’état HTTP : 400

 ** InvalidParameterCombinationException **   
  
Code d’état HTTP : 400

 ** InvalidParameterValueException **   
  
Code d’état HTTP : 400

 ** InvalidVPCNetworkStateFault **   
  
Code d’état HTTP : 400

 ** NodeQuotaForClusterExceededFault **   
  
Code d’état HTTP : 400

 ** NodeQuotaForCustomerExceededFault **   
  
Code d’état HTTP : 400

 ** NoOperationFault **   
  
Code d’état HTTP : 400

 ** ParameterGroupNotFoundFault **   
  
Code d’état HTTP : 400

 ** ServiceLinkedRoleNotFoundFault **   
  
Code d’état HTTP : 400

 ** ShardsPerClusterQuotaExceededFault **   
  
Code d’état HTTP : 400

## Voir aussi
<a name="API_UpdateCluster_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/UpdateCluster) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/memorydb-2021-01-01/UpdateCluster) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/memorydb-2021-01-01/UpdateCluster) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/memorydb-2021-01-01/UpdateCluster) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/memorydb-2021-01-01/UpdateCluster) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/memorydb-2021-01-01/UpdateCluster) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/memorydb-2021-01-01/UpdateCluster) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/memorydb-2021-01-01/UpdateCluster) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/memorydb-2021-01-01/UpdateCluster) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/memorydb-2021-01-01/UpdateCluster)