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
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
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
La solicitud utiliza los siguientes parámetros URI.
- clusterArn
-
El identificador ARN del clúster elástico.
Obligatorio: sí
Cuerpo de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
- adminUserPassword
-
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
-
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_TEXToSECRET_ARN.Tipo: cadena
Valores válidos:
PLAIN_TEXT | SECRET_ARNObligatorio: no
- backupRetentionPeriod
-
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
-
El token de cliente del clúster elástico.
Tipo: cadena
Requerido: no
- preferredBackupWindow
-
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
-
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:miPredeterminado: 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
-
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
-
El número de particiones asignadas al clúster elástico. El máximo es 32.
Tipo: entero
Obligatorio: no
- shardInstanceCount
-
El número de instancias de réplica que se aplica a todas las particiones del clúster elástico. Un valor de
shardInstanceCountigual 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
-
La EC2 subred de Amazon IDs para el clúster elástico.
Tipo: matriz de cadenas
Obligatorio: no
- vpcSecurityGroupIds
-
Una lista de grupos de seguridad de EC2 VPC para asociarlos al clúster elástico.
Tipo: matriz de cadenas
Obligatorio: no
Sintaxis de la respuesta
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
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
Errores
Para obtener información acerca de los errores comunes a todas las acciones, consulte Errores comunes.
- 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 de 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 localizar.
- resourceType
-
El tipo de 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
-
El número de segundos que hay que esperar antes de 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:
unknownOperationcannotParsefieldValidationFailed,, oother).
Código de estado HTTP: 400
Véase también
Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
