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.
CreateDBInstance
Crea una nueva instancia.
Parámetros de la solicitud
Para obtener información sobre los parámetros comunes a todas las acciones, consulte Parámetros comunes.
- DBClusterIdentifier
-
El identificador del clúster al que pertenecerá la instancia.
Tipo: cadena
Obligatorio: sí
- DBInstanceClass
-
La capacidad de memoria e informática de la instancia (por ejemplo, ).,
db.r5.large.Tipo: cadena
Obligatorio: sí
- DBInstanceIdentifier
-
El identificador de instancias. 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::
mydbinstanceTipo: cadena
Obligatorio: sí
-
- Engine
-
Nombre del motor de base de datos que se va a usar para esta instancia.
Valor válido:
docdbTipo: cadena
Obligatorio: sí
- AutoMinorVersionUpgrade
-
Este parámetro no se aplica a Amazon DocumentDB. Amazon DocumentDB no actualiza versiones secundarias, independientemente del valor establecido.
Predeterminado:
falseTipo: Booleano
Obligatorio: no
- AvailabilityZone
-
La zona de disponibilidad de Amazon EC2 en la que se crea la instancia.
Predeterminado: una zona de disponibilidad aleatoria elegida por el sistema en la Región de AWS del punto de conexión.
Ejemplo::
us-east-1dTipo: cadena
Requerido: no
- CACertificateIdentifier
-
El identificador del certificado de CA que se utilizará para el certificado de servidor de la instancia de DB.
Para obtener más información, consulte Cómo actualizar los certificados TLS de Amazon DocumentDB y Cómo cifrar datos en tránsito en la Guía para desarrolladores de Amazon DocumentDB.
Tipo: cadena
Requerido: no
- CopyTagsToSnapshot
-
Es un valor que indica si se deben copiar las etiquetas de la instancia de base de datos en instantáneas de la instancia de base de datos. Las etiquetas no se copian de forma predeterminada.
Tipo: Booleano
Obligatorio: no
- EnablePerformanceInsights
-
Un valor que indica si se habilita Información sobre rendimiento para la instancia de base de datos. Para obtener más información, consulte Uso de Información sobre rendimiento de Amazon.
Tipo: Booleano
Obligatorio: no
- PerformanceInsightsKMSKeyId
-
El identificador de la clave de AWS KMS para el cifrado de datos de Performance Insights.
El identificador de la clave de AWS KMS es el ARN de la clave, el identificador de clave, el ARN de alias o el nombre de alias de la clave de KMS.
Si no especifica un valor para PerformanceInsightsKMSKeyId, Amazon DocumentDB utilizará su clave KMS predeterminada. Existe una clave KMS predeterminada para su cuenta de Amazon Web Services. La cuenta de Amazon Web Services tiene una clave de KMS predeterminada diferente para cada región de Amazon Web Services.
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: ventana mínima de 30 minutos.
Tipo: cadena
Requerido: no
- PromotionTier
-
Valor que especifica el orden en el que se promueve una réplica de Amazon DocumentDB a la instancia primaria tras un fallo de la instancia primaria existente.
Valor predeterminado: 1
Valores válidos: 0-15
Tipo: entero
Obligatorio: no
- Tags.Tag.N
-
Las etiquetas que se van a asignar a la instancia. Puede asignar hasta 10 etiquetas a una instancia.
Tipo: matriz de objetos Tag
Obligatorio: no
Elementos de respuesta
El servicio devuelve el siguiente elemento.
- DBInstance
-
Información detallada sobre una instancia.
Tipo: objeto DBInstance
Errores
Para obtener información acerca de los errores comunes a todas las acciones, consulte Errores comunes.
- AuthorizationNotFound
-
La IP CIDR o el grupo de seguridad de Amazon EC2 especificados no están autorizados para el grupo de seguridad especificado.
Es posible que Amazon DocumentDB tampoco esté autorizado para realizar las acciones necesarias en su nombre mediante IAM.
Código de estado HTTP: 404
- DBClusterNotFoundFault
-
DBClusterIdentifierno hace referencia a un clúster existente.Código de estado HTTP: 404
- DBInstanceAlreadyExists
-
Ya tiene una instancia con el identificador dado.
Código de estado HTTP: 400
- DBParameterGroupNotFound
-
DBParameterGroupNameno hace referencia a un grupo de parámetros existente.Código de estado HTTP: 404
- DBSecurityGroupNotFound
-
DBSecurityGroupNameno hace referencia a un grupo de seguridad existente.Código de estado HTTP: 404
- DBSubnetGroupDoesNotCoverEnoughAZs
-
Las subredes del grupo de subredes deben incluir al menos dos zonas de disponibilidad a menos que solo haya una zona de disponibilidad.
Código de estado HTTP: 400
- DBSubnetGroupNotFoundFault
-
DBSubnetGroupNameno hace referencia a un grupo de subredes existente.Código de estado HTTP: 404
- InstanceQuotaExceeded
-
La solicitud provocaría que se superara el número de instancias permitido.
Código de estado HTTP: 400
- InsufficientDBInstanceCapacity
-
La clase de instancia especificada no está disponible en la zona de disponibilidad especificada.
Código de estado HTTP: 400
- InvalidDBClusterStateFault
-
El clúster no se encuentra en un estado válido.
Código de estado HTTP: 400
- InvalidSubnet
-
La subred solicitada no es válida o se solicitaron varias subredes que no están en la misma nube privada virtual (VPC).
Código de estado HTTP: 400
- InvalidVPCNetworkStateFault
-
El grupo de subredes no cubre todas las zonas de disponibilidad después de crearla, debido a los cambios realizados.
Código de estado HTTP: 400
- KMSKeyNotAccessibleFault
-
Se ha producido un error al acceder a una clave de AWS KMS.
Código de estado HTTP: 400
- StorageQuotaExceeded
-
La solicitud provocaría que superara la cantidad permitida de almacenamiento disponible en todas las instancias.
Código de estado HTTP: 400
- StorageTypeNotSupported
-
El almacenamiento del
StorageTypeespecificado no puede asociarse a la instancia de base de datos.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:
