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](CommonParameters.md).
** 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 con un guion ni contener dos guiones consecutivos.
Ejemplo: `mydbinstance`
Tipo: cadena
Obligatorio: sí
** Engine **
Nombre del motor de base de datos que se va a usar para esta instancia.
Valor válido: `docdb`
Tipo: cadena
Obligatorio: sí
** AutoMinorVersionUpgrade **
Este parámetro no se aplica a Amazon DocumentDB. Amazon DocumentDB no actualiza versiones secundarias, independientemente del valor establecido.
Valor predeterminado: `false`
Tipo: Booleano
Obligatorio: no
** AvailabilityZone **
La zona de disponibilidad de Amazon EC2 en la que se crea la instancia.
Predeterminada: una zona de disponibilidad aleatoria elegida por el sistema en el punto final. Región de AWS
Ejemplo: `us-east-1d`
Tipo: cadena
Requerido: no
** CACertificateIdentifier **
El identificador del certificado 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](https://docs.aws.amazon.com/documentdb/latest/developerguide/ca_cert_rotation.html) y [Cómo cifrar datos en tránsito](https://docs.aws.amazon.com/documentdb/latest/developerguide/security.encryption.ssl.html) 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](https://docs.aws.amazon.com/documentdb/latest/developerguide/performance-insights.html).
Tipo: Booleano
Obligatorio: no
** PerformanceInsightsKMSKeyId **
El identificador AWS KMS clave para el cifrado de los datos de Performance Insights.
El identificador de AWS KMS clave es el ARN de clave, el identificador de clave, el ARN de alias o el nombre de alias de la clave KMS.
Si no especifica un valor para el PerformanceInsights KMSKey identificador, Amazon DocumentDB utilizará la clave de 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:mi`
El valor predeterminado es 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
** 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](API_Tag.md)
Obligatorio: no
## Elementos de respuesta
El servicio devuelve el siguiente elemento.
** DBInstance **
Información detallada sobre una instancia.
Tipo: objeto [DBInstance](API_DBInstance.md)
## Errores
Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).
** 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 **
`DBClusterIdentifier` no 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 **
`DBParameterGroupName` no hace referencia a un grupo de parámetros existente.
Código de estado HTTP: 404
** DBSecurityGroupNotFound **
`DBSecurityGroupName` no 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 **
`DBSubnetGroupName` no 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 AWS KMS clave.
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 `StorageType` especificado 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 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-2014-10-31/CreateDBInstance)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/CreateDBInstance)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/CreateDBInstance)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/CreateDBInstance)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/CreateDBInstance)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/CreateDBInstance)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/CreateDBInstance)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/CreateDBInstance)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/CreateDBInstance)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/CreateDBInstance)