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_elastic_UpdateCluster"></a>

Modifica un clúster elástico. Esto incluye actualizar el nombre de usuario y la contraseña del administrador, actualizar la versión de la API y configurar una ventana de copia de seguridad y una ventana de mantenimiento

## Sintaxis de la solicitud
<a name="API_elastic_UpdateCluster_RequestSyntax"></a>

```
PUT /cluster/clusterArn HTTP/1.1
Content-type: application/json

{
   "adminUserPassword": "string",
   "authType": "string",
   "backupRetentionPeriod": number,
   "clientToken": "string",
   "preferredBackupWindow": "string",
   "preferredMaintenanceWindow": "string",
   "shardCapacity": number,
   "shardCount": number,
   "shardInstanceCount": number,
   "subnetIds": [ "string" ],
   "vpcSecurityGroupIds": [ "string" ]
}
```

## Parámetros de solicitud del URI
<a name="API_elastic_UpdateCluster_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [clusterArn](#API_elastic_UpdateCluster_RequestSyntax) **   <a name="documentdb-elastic_UpdateCluster-request-uri-clusterArn"></a>
El identificador ARN del clúster elástico.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_elastic_UpdateCluster_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [adminUserPassword](#API_elastic_UpdateCluster_RequestSyntax) **   <a name="documentdb-elastic_UpdateCluster-request-adminUserPassword"></a>
La contraseña asociada al administrador del clúster elástico. Esta contraseña puede contener cualquier carácter ASCII imprimible, excepto barra inclinada (/), comillas dobles (") o el símbolo de “arroba” (@).  
 *Limitaciones*: debe contener de 8 a 100 caracteres.  
Tipo: cadena  
Requerido: no

 ** [authType](#API_elastic_UpdateCluster_RequestSyntax) **   <a name="documentdb-elastic_UpdateCluster-request-authType"></a>
El tipo de autenticación utilizado para determinar dónde buscar la contraseña que se usa para acceder al clúster elástico. Los tipos válidos son `PLAIN_TEXT` o `SECRET_ARN`.  
Tipo: cadena  
Valores válidos: `PLAIN_TEXT | SECRET_ARN`   
Obligatorio: no

 ** [backupRetentionPeriod](#API_elastic_UpdateCluster_RequestSyntax) **   <a name="documentdb-elastic_UpdateCluster-request-backupRetentionPeriod"></a>
El número de días durante los que se conservan las instantáneas de base de datos automáticas.  
Tipo: entero  
Obligatorio: no

 ** [clientToken](#API_elastic_UpdateCluster_RequestSyntax) **   <a name="documentdb-elastic_UpdateCluster-request-clientToken"></a>
El token de cliente del clúster elástico.  
Tipo: cadena  
Requerido: no

 ** [preferredBackupWindow](#API_elastic_UpdateCluster_RequestSyntax) **   <a name="documentdb-elastic_UpdateCluster-request-preferredBackupWindow"></a>
El intervalo de tiempo diario durante el que se crean las copias de seguridad automatizadas si las copias de seguridad automatizadas están habilitadas según lo determina `backupRetentionPeriod`.  
Tipo: cadena  
Requerido: no

 ** [preferredMaintenanceWindow](#API_elastic_UpdateCluster_RequestSyntax) **   <a name="documentdb-elastic_UpdateCluster-request-preferredMaintenanceWindow"></a>
El intervalo de tiempo semanal durante el cual puede llevarse a cabo el mantenimiento del sistema, en tiempo universal coordinado (UTC).  
 *Formato*: `ddd:hh24:mi-ddd:hh24:mi`   
 *Predeterminado*: un período de 30 minutos seleccionado al azar de un bloque de tiempo de 8 horas para cada uno Región de AWS, que se produce en un día aleatorio de la semana.  
 *Días válidos*: lunes, martes, miércoles, jueves, viernes, sábado, domingo  
 *Restricciones*: plazo mínimo de 30 minutos.  
Tipo: cadena  
Requerido: no

 ** [shardCapacity](#API_elastic_UpdateCluster_RequestSyntax) **   <a name="documentdb-elastic_UpdateCluster-request-shardCapacity"></a>
El número de v CPUs asignado a cada fragmento del clúster elástico. El máximo es 64. Los valores permitidos son 2, 4, 8, 16, 32, 64.  
Tipo: entero  
Obligatorio: no

 ** [shardCount](#API_elastic_UpdateCluster_RequestSyntax) **   <a name="documentdb-elastic_UpdateCluster-request-shardCount"></a>
El número de particiones asignadas al clúster elástico. El máximo es 32.  
Tipo: entero  
Obligatorio: no

 ** [shardInstanceCount](#API_elastic_UpdateCluster_RequestSyntax) **   <a name="documentdb-elastic_UpdateCluster-request-shardInstanceCount"></a>
El número de instancias de réplica que se aplica a todas las particiones del clúster elástico. Un valor de `shardInstanceCount` igual a 1 significa que hay una instancia de escritura y las instancias adicionales son réplicas que se pueden usar para llevar a cabo lecturas y mejorar la disponibilidad.  
Tipo: entero  
Obligatorio: no

 ** [subnetIds](#API_elastic_UpdateCluster_RequestSyntax) **   <a name="documentdb-elastic_UpdateCluster-request-subnetIds"></a>
La subred Amazon EC2 IDs para el clúster elástico.  
Tipo: matriz de cadenas  
Obligatorio: no

 ** [vpcSecurityGroupIds](#API_elastic_UpdateCluster_RequestSyntax) **   <a name="documentdb-elastic_UpdateCluster-request-vpcSecurityGroupIds"></a>
Una lista de grupos de seguridad de VPC de EC2 para asociar al clúster elástico.  
Tipo: matriz de cadenas  
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_elastic_UpdateCluster_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "cluster": { 
      "adminUserName": "string",
      "authType": "string",
      "backupRetentionPeriod": number,
      "clusterArn": "string",
      "clusterEndpoint": "string",
      "clusterName": "string",
      "createTime": "string",
      "kmsKeyId": "string",
      "preferredBackupWindow": "string",
      "preferredMaintenanceWindow": "string",
      "shardCapacity": number,
      "shardCount": number,
      "shardInstanceCount": number,
      "shards": [ 
         { 
            "createTime": "string",
            "shardId": "string",
            "status": "string"
         }
      ],
      "status": "string",
      "subnetIds": [ "string" ],
      "vpcSecurityGroupIds": [ "string" ]
   }
}
```

## Elementos de respuesta
<a name="API_elastic_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_elastic_UpdateCluster_ResponseSyntax) **   <a name="documentdb-elastic_UpdateCluster-response-cluster"></a>
Devuelve información sobre el clúster elástico actualizado.  
Tipo: objeto [Cluster](API_elastic_Cluster.md)

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

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

 ** AccessDeniedException **   
Una excepción que se produce cuando no hay permisos suficientes para realizar una acción.    
 ** message **   
Un mensaje de error que explica por qué se denegó el acceso.
Código de estado HTTP: 403

 ** ConflictException **   
Se ha producido un conflicto de acceso.    
 ** resourceId **   
El identificador del recurso en el que se produjo un conflicto de acceso.  
 ** resourceType **   
El tipo del recurso en el que se produjo un conflicto de acceso.
Código de estado HTTP: 409

 ** InternalServerException **   
Se ha producido un error en el servidor interno.  
Código de estado HTTP: 500

 ** ResourceNotFoundException **   
No se pudo encontrar el recurso especificado.    
 ** message **   
Un mensaje de error que describe el error.  
 ** resourceId **   
El identificador del recurso que no se pudo encontrar.  
 ** resourceType **   
El tipo del recurso que no se pudo encontrar.
Código de estado HTTP: 404

 ** ThrottlingException **   
ThrottlingException se lanzará cuando se rechace la solicitud debido a la limitación de la solicitud.    
 ** retryAfterSeconds **   
La cantidad de segundos que se debe esperar para volver a intentar la operación.
Código de estado HTTP: 429

 ** ValidationException **   
Estructura que define una excepción de validación.    
 ** fieldList **   
Una lista de los campos en los que se produjo la excepción de validación.  
 ** message **   
Un mensaje de error que describe la excepción de validación.  
 ** reason **   
El motivo por el que se produjo la excepción de validación (uno de los siguientes: `unknownOperation`, `cannotParse`, `fieldValidationFailed` o `other`).
Código de estado HTTP: 400

## Véase también
<a name="API_elastic_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/docdb-elastic-2022-11-28/UpdateCluster) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-elastic-2022-11-28/UpdateCluster) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-elastic-2022-11-28/UpdateCluster) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-elastic-2022-11-28/UpdateCluster) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-elastic-2022-11-28/UpdateCluster) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-elastic-2022-11-28/UpdateCluster) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-elastic-2022-11-28/UpdateCluster) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-elastic-2022-11-28/UpdateCluster) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/docdb-elastic-2022-11-28/UpdateCluster) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-elastic-2022-11-28/UpdateCluster)