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.
SwitchoverGlobalCluster
Cambia el clúster de Amazon DocumentDB secundario especificado para que sea el nuevo clúster de Amazon DocumentDB principal del clúster de base de datos global.
Parámetros de la solicitud
Para obtener información sobre los parámetros comunes a todas las acciones, consulte Parámetros comunes.
- GlobalClusterIdentifier
-
El identificador del clúster de base de datos global de Amazon DocumentDB que va a hacer la transición. El identificador es la clave única asignada por el usuario cuando se creó el clúster. Dicho de otro modo, es el nombre del clúster global. Este parámetro no distingue entre mayúsculas y minúsculas.
Restricciones:
-
Debe coincidir con el identificador de un clúster global existente (base de datos global de Amazon DocumentDB).
-
Longitud mínima de 1. La longitud máxima es de 255 caracteres.
Patrón:
[A-Za-z][0-9A-Za-z-:._]*
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í
-
- TargetDbClusterIdentifier
-
El identificador del clúster secundario de Amazon DocumentDB que desea promover para que sea el nuevo principal del clúster de base de datos global. Utilice el nombre de recurso de Amazon (ARN) como identificador para que Amazon DocumentDB pueda localizar el clúster en su región. AWS
Restricciones:
-
Debe coincidir con el identificador de un clúster secundario existente.
-
Longitud mínima de 1. La longitud máxima es de 255 caracteres.
Patrón:
[A-Za-z][0-9A-Za-z-:._]*
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í
-
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
-
DBClusterIdentifier
no hace referencia a un clúster existente.Código de estado HTTP: 404
- GlobalClusterNotFoundFault
-
GlobalClusterIdentifier
no hace referencia a un clúster global existente.Código de estado HTTP: 404
- InvalidDBClusterStateFault
-
El clúster no se encuentra en un estado válido.
Código de estado HTTP: 400
- InvalidGlobalClusterStateFault
-
La operación solicitada no se puede realizar mientras el clúster esté en este estado.
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, consulte lo siguiente: