Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

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

Modifica la configuración de un clúster. Puede usar esta operación para cambiar una o más opciones de configuración del clúster especificando las configuraciones y los nuevos valores.

## Sintaxis de la solicitud
<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"
}
```

## Parámetros de la solicitud
<a name="API_UpdateCluster_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [ACLName](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-ACLName"></a>
La lista de control de acceso asociada al clúster.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1.  
Patrón: `[a-zA-Z][a-zA-Z0-9\-]*`   
Obligatorio: no

 ** [ClusterName](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-ClusterName"></a>
El nombre del clúster que se va a actualizar.  
Tipo: cadena  
Obligatorio: sí

 ** [Description](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-Description"></a>
La descripción del clúster que se va a actualizar.  
Tipo: cadena  
Requerido: no

 ** [Engine](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-Engine"></a>
El nombre del motor que se utilizará para el clúster.  
Tipo: cadena  
Requerido: no

 ** [EngineVersion](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-EngineVersion"></a>
La versión mejorada del motor que se ejecutará en los nodos. Puede actualizar a una versión de motor más reciente, pero no puede volver a una versión de motor anterior. Si desea usar una versión anterior del motor, deberá eliminar el clúster existente y crearlo de nuevo con la versión del motor más antigua.  
Tipo: cadena  
Requerido: no

 ** [IpDiscovery](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-IpDiscovery"></a>
El mecanismo para descubrir las direcciones IP del protocolo de descubrimiento de clústeres. Los valores válidos son «ipv4» o «ipv6». Cuando se establece en «ipv4», las funciones de detección de clústeres, como las ranuras de clúster, las particiones de clúster y los nodos de clúster, devolverán las direcciones de los nodos del clúster. IPv4 Cuando se establece en «ipv6», las funciones de detección de clústeres devuelven las IPv6 direcciones de los nodos del clúster. El valor debe ser compatible con el NetworkType parámetro. Si no se especifica, el valor predeterminado es «ipv4».  
Tipo: cadena  
Valores válidos: `ipv4 | ipv6`   
Obligatorio: no

 ** [MaintenanceWindow](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-MaintenanceWindow"></a>
Especifica el intervalo de tiempo semanal durante el cual se realiza el mantenimiento en el clúster. Se especifica como un intervalo en el formato ddd:hh24:mi-ddd:hh24:mi (UTC de reloj de 24 h). La ventana de mantenimiento mínima es un periodo de 60 minutos.  
Los valores válidos para `ddd` son:  
+  `sun` 
+  `mon` 
+  `tue` 
+  `wed` 
+  `thu` 
+  `fri` 
+  `sat` 
Ejemplo: `sun:23:00-mon:01:30`   
Tipo: cadena  
Requerido: no

 ** [NodeType](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-NodeType"></a>
Un tipo de nodo válido al que desee escalar o reducir verticalmente este clúster.  
Tipo: cadena  
Requerido: no

 ** [ParameterGroupName](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-ParameterGroupName"></a>
El nombre del grupo de parámetros que se va a actualizar.  
Tipo: cadena  
Requerido: no

 ** [ReplicaConfiguration](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-ReplicaConfiguration"></a>
El número de réplicas que residirán en cada fragmento.  
Tipo: objeto [ReplicaConfigurationRequest](API_ReplicaConfigurationRequest.md)  
Obligatorio: no

 ** [SecurityGroupIds](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-SecurityGroupIds"></a>
El que debe SecurityGroupIds actualizarse.  
Tipo: matriz de cadenas  
Obligatorio: no

 ** [ShardConfiguration](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-ShardConfiguration"></a>
El número de fragmentos del clúster.  
Tipo: objeto [ShardConfigurationRequest](API_ShardConfigurationRequest.md)  
Obligatorio: no

 ** [SnapshotRetentionLimit](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-SnapshotRetentionLimit"></a>
El número de días durante los que MemoryDB retiene instantáneas automáticas del clúster antes de eliminarlas. Por ejemplo, si se establece SnapshotRetentionLimit en 5, una instantánea que se haya tomado hoy se conserva durante 5 días antes de eliminarla.  
Tipo: entero  
Obligatorio: no

 ** [SnapshotWindow](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-SnapshotWindow"></a>
El intervalo de tiempo diario (en UTC) durante el cual MemoryDB empieza a tomar una instantánea diaria de su clúster.  
Tipo: cadena  
Requerido: no

 ** [SnsTopicArn](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-SnsTopicArn"></a>
El ARN del tema SNS que se va a actualizar.  
Tipo: cadena  
Requerido: no

 ** [SnsTopicStatus](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-SnsTopicStatus"></a>
El estado del tema de notificación de Amazon SNS. Las notificaciones se envían solo si el estado está activo.  
Tipo: cadena  
Requerido: no

## Sintaxis de la respuesta
<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
   }
}
```

## Elementos de respuesta
<a name="API_UpdateCluster_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [Cluster](#API_UpdateCluster_ResponseSyntax) **   <a name="MemoryDB-UpdateCluster-response-Cluster"></a>
El clúster actualizado.  
Tipo: objeto [Cluster](API_Cluster.md)

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

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** ACLNotFoundFault **   
  
Código de estado HTTP: 400

 ** ClusterNotFoundFault **   
  
Código de estado HTTP: 400

 ** ClusterQuotaForCustomerExceededFault **   
  
Código de estado HTTP: 400

 ** InvalidACLStateFault **   
  
Código de estado HTTP: 400

 ** InvalidClusterStateFault **   
  
Código de estado HTTP: 400

 ** InvalidKMSKeyFault **   
  
Código de estado HTTP: 400

 ** InvalidNodeStateFault **   
  
Código de estado HTTP: 400

 ** InvalidParameterCombinationException **   
  
Código de estado HTTP: 400

 ** InvalidParameterValueException **   
  
Código de estado HTTP: 400

 ** InvalidVPCNetworkStateFault **   
  
Código de estado HTTP: 400

 ** NodeQuotaForClusterExceededFault **   
  
Código de estado HTTP: 400

 ** NodeQuotaForCustomerExceededFault **   
  
Código de estado HTTP: 400

 ** NoOperationFault **   
  
Código de estado HTTP: 400

 ** ParameterGroupNotFoundFault **   
  
Código de estado HTTP: 400

 ** ServiceLinkedRoleNotFoundFault **   
  
Código de estado HTTP: 400

 ** ShardsPerClusterQuotaExceededFault **   
  
Código de estado HTTP: 400

## Véase también
<a name="API_UpdateCluster_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/memorydb-2021-01-01/UpdateCluster) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/memorydb-2021-01-01/UpdateCluster) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/memorydb-2021-01-01/UpdateCluster) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/memorydb-2021-01-01/UpdateCluster) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/memorydb-2021-01-01/UpdateCluster) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/memorydb-2021-01-01/UpdateCluster) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/memorydb-2021-01-01/UpdateCluster) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/memorydb-2021-01-01/UpdateCluster) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/memorydb-2021-01-01/UpdateCluster) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/memorydb-2021-01-01/UpdateCluster)