CreateGlobalCluster
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 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
Para obtener información sobre los parámetros comunes a todas las acciones, consulte Parámetros comunes.
- 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
Requerido: 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
Requerido: no
Elementos de respuesta
El servicio devuelve el siguiente elemento.
- GlobalCluster
-
Tipo de datos que representa un clúster global de Amazon DocumentDB.
Tipo: objeto GlobalCluster
Errores
Para obtener información acerca de los errores comunes a todas las acciones, consulte Errores comunes.
- DBClusterNotFoundFault
-
DBClusterIdentifierno hace referencia a un clúster existente.Código de estado HTTP: 404
- GlobalClusterAlreadyExistsFault
-
El
GlobalClusterIdentifierya 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
Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
