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.
CreateCluster
Crea un nuevo clúster elástico de Amazon DocumentDB y devuelve su estructura de clúster.
Sintaxis de la solicitud
POST /cluster HTTP/1.1
Content-type: application/json
{
"adminUserName": "string",
"adminUserPassword": "string",
"authType": "string",
"backupRetentionPeriod": number,
"clientToken": "string",
"clusterName": "string",
"kmsKeyId": "string",
"preferredBackupWindow": "string",
"preferredMaintenanceWindow": "string",
"shardCapacity": number,
"shardCount": number,
"shardInstanceCount": number,
"subnetIds": [ "string" ],
"tags": {
"string" : "string"
},
"vpcSecurityGroupIds": [ "string" ]
}Parámetros de solicitud del URI
La solicitud no utiliza ningún parámetro de URI.
Cuerpo de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
- adminUserName
-
El nombre del administrador de clústeres elásticos de Amazon DocumentDB.
Restricciones:
-
Debe tener de 1 a 63 letras o números.
-
El primer carácter debe ser una letra.
-
No puede ser una palabra reservada.
Tipo: cadena
Obligatorio: sí
-
- adminUserPassword
-
La contraseña del administrador de clústeres elásticos de Amazon DocumentDB. La contraseña puede contener cualquier carácter ASCII imprimible.
Restricciones:
-
Debe contener de 8 a 100 caracteres.
-
No puede contener una barra inclinada (/), comillas dobles (“ ”) ni el símbolo de “arroba” (@).
Tipo: cadena
Obligatorio: sí
-
- 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: sí
- clusterName
-
El nombre del nuevo clúster elástico. Este parámetro se almacena como una cadena en minúsculas.
Restricciones:
-
Deben contener de 1 a 63 caracteres (letras, números o guiones).
-
El primer carácter debe ser una letra.
-
No puede terminar por un guion ni contener dos guiones consecutivos.
Ejemplo:
my-clusterTipo: cadena
Obligatorio: sí
-
- shardCapacity
-
La cantidad de vCPU asignadas a cada partición de clúster elástico. El máximo es 64. Los valores permitidos son 2, 4, 8, 16, 32, 64.
Tipo: entero
Obligatorio: sí
- shardCount
-
El número de particiones asignadas al clúster elástico. El máximo es 32.
Tipo: entero
Obligatorio: sí
- backupRetentionPeriod
-
El número de días durante los que se conservan las instantáneas de base de datos automáticas.
Tipo: entero
Requerido: no
- clientToken
-
El token de cliente del clúster elástico.
Tipo: cadena
Requerido: no
- kmsKeyId
-
El identificador de clave de KMS que se debe utilizar para cifrar el nuevo clúster elástico.
El identificador de la clave de KMS es el Nombre de recurso de Amazon (ARN) de la clave de cifrado de KMS. Si está creando un clúster con la misma cuenta de Amazon a la que pertenece esta clave de cifrado de KMS, puede utilizar el alias de la clave de KMS en lugar del ARN como clave de cifrado de KMS.
Si no se especifica una clave de cifrado, Amazon DocumentDB utiliza la clave de cifrado predeterminada que KMS crea para la cuenta. Su cuenta dispone de una clave de cifrado predeterminada diferente para cada región de Amazon.
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:miEl valor predeterminado es un periodo de 30 minutos seleccionado al azar de un bloque de 8 horas de tiempo para cada Región de AWS, que tiene lugar un día de la semana al azar.
Días válidos: lunes, martes, miércoles, jueves, viernes, sábado, domingo
Restricciones: plazo mínimo de 30 minutos.
Tipo: cadena
Requerido: 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
Requerido: no
- subnetIds
-
ID de subredes de Amazon EC2 para el nuevo clúster elástico.
Tipo: matriz de cadenas
Requerido: no
-
Las etiquetas que se van a asignar al nuevo clúster elástico.
Tipo: mapa de cadena a cadena
Limitaciones de longitud de la clave: longitud mínima de 1. Longitud máxima de 128.
Patrón de clave:
^(?!aws:)[a-zA-Z+-=._:/]+$Limitaciones de longitud de los valores: longitud mínima de 0. La longitud máxima es de 256 caracteres.
Requerido: no
- vpcSecurityGroupIds
-
Una lista de grupos de seguridad EC2 VPC para asociar con el nuevo clúster elástico.
Tipo: matriz de cadenas
Requerido: 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.
Código de estado HTTP: 403
- ConflictException
-
Se ha producido 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
- ServiceQuotaExceededException
-
Se ha superado la cuota de servicio para la acción.
Código de estado HTTP: 402
- ThrottlingException
-
Se lanzará ThrottlingException cuando se deniegue la solicitud debido a la limitación de la solicitud.
Código de estado HTTP: 429
- ValidationException
-
Estructura que define una excepción de validación.
Código de estado HTTP: 400
Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
