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.

# CreateGlobalCluster
<a name="API_CreateGlobalCluster"></a>

Crea un clúster global de Amazon DocumentDB que puede abarcar varios múltiplos Regiones de AWS. El clúster global contiene un clúster principal con capacidad de lectura y escritura, y hasta 10 clústeres secundarios de solo lectura. Los clústeres globales utilizan una replicación rápida basada en el almacenamiento en todas las regiones con latencias inferiores a un segundo, mediante una infraestructura especializada que no afecta el rendimiento de la carga de trabajo.



Puede crear un clúster que inicialmente esté vacío y, a posteriormente agregarle un clúster principal y un clúster secundario. O bien, puede especificar un clúster existente durante la operación de creación y este clúster pasará a ser el principal del clúster global. 

**nota**  
Esta acción solo se aplica a los clústeres de Amazon DocumentDB.

## Parámetros de la solicitud
<a name="API_CreateGlobalCluster_RequestParameters"></a>

 Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

 ** GlobalClusterIdentifier **   
Identificador de clúster del nuevo clúster global.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 255 caracteres.  
Patrón: `[A-Za-z][0-9A-Za-z-:._]*`   
Obligatorio: sí

 ** DatabaseName **   
El nombre para la base de datos de hasta 64 caracteres alfanuméricos. Si no proporciona un nombre, Amazon DocumentDB no creará una base de datos en el clúster global que está creando.  
Tipo: cadena  
Requerido: no

 ** DeletionProtection **   
La configuración de protección contra eliminación para el nuevo clúster global. El clúster global no se puede eliminar cuando está habilitada la protección contra eliminación.   
Tipo: Booleano  
Obligatorio: no

 ** Engine **   
El nombre del motor de base de datos que se debe utilizar para este clúster.  
Tipo: cadena  
Requerido: no

 ** EngineVersion **   
La versión del motor del clúster global.  
Tipo: cadena  
Requerido: no

 ** SourceDBClusterIdentifier **   
El i Nombre de recurso de Amazon (ARN) que se utilizará como clúster principal de la base de datos global. Este parámetro es opcional.  
Tipo: cadena  
Requerido: no

 ** StorageEncrypted **   
Configuración de cifrado de almacenamiento para el nuevo clúster global.   
Tipo: Booleano  
Obligatorio: no

## Elementos de respuesta
<a name="API_CreateGlobalCluster_ResponseElements"></a>

El servicio devuelve el siguiente elemento.

 ** GlobalCluster **   
Tipo de datos que representa un clúster global de Amazon DocumentDB.  
Tipo: objeto [GlobalCluster](API_GlobalCluster.md)

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

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

 ** DBClusterNotFoundFault **   
 `DBClusterIdentifier` no hace referencia a un clúster existente.   
Código de estado HTTP: 404

 ** GlobalClusterAlreadyExistsFault **   
El `GlobalClusterIdentifier` ya existe. Elija un nuevo identificador de clúster global (nombre único) para crear un nuevo clúster global.   
Código de estado HTTP: 400

 ** GlobalClusterQuotaExceededFault **   
El número de clústeres globales de esta cuenta ya es el máximo permitido.  
Código de estado HTTP: 400

 ** InvalidDBClusterStateFault **   
El clúster no se encuentra en un estado válido.  
Código de estado HTTP: 400

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