ModifyDBClusterPrimaryZone - PolarDB - Centro de documentación de Alibaba Cloud

Cambia la zona principal de un clúster de PolarDB.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

polardb:ModifyDBClusterPrimaryZone

update

*dbcluster

acs:polardb:{#regionId}:{#accountId}:dbcluster/{#dbclusterId}

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
DBClusterId	string	Sí	El ID del clúster. Nota Llame a la operación DescribeDBClusters para consultar los detalles de todos los clústeres en una región de destino, incluidos sus ID de clúster.	pc-**************
ZoneId	string	Sí	El ID de la nueva zona. Nota Llame a la operación DescribeRegions para consultar las zonas disponibles.	cn-hangzhou-g
ZoneType	string	No	El tipo de zona. Valores válidos: Primary: La zona principal. Standby: La zona secundaria.	Primary
VSwitchId	string	No	El ID del vSwitch en la zona de destino. Nota Este parámetro es obligatorio para los clústeres de PolarDB for Oracle y PolarDB for PostgreSQL. Para los clústeres de PolarDB for MySQL, este parámetro es obligatorio si se crea un vSwitch en la zona de destino. Si no se crea ningún vSwitch, se utiliza el vSwitch predeterminado y este parámetro es opcional.	vsw-**************
IsSwitchOverForDisaster	string	No	Especifica si se debe realizar la conmutación por recuperación a la zona original. Valores válidos: true: Realiza la conmutación por recuperación a la zona original. false: No realiza la conmutación por recuperación a la zona original.	false
PlannedStartTime	string	No	La hora más temprana para iniciar la tarea programada de cambio de zona. Especifique la hora en formato `YYYY-MM-DDThh:mm:ssZ`. La hora debe estar en UTC. Nota La hora de inicio debe ser un momento dentro de las próximas 24 horas. Por ejemplo, si la hora actual es `2021-01-14T09:00:00Z`, puede establecer la hora de inicio en un valor entre `2021-01-14T09:00:00Z` y `2021-01-15T09:00:00Z`. Si no especifica este parámetro, la tarea de cambio de zona se ejecuta inmediatamente.	2021-01-14T09:00:00Z
PlannedEndTime	string	No	La hora más tardía para iniciar la tarea programada. Especifique la hora en formato `YYYY-MM-DDThh:mm:ssZ`. La hora debe estar en UTC. Nota La hora de inicio más tardía debe ser al menos 30 minutos posterior a la hora de inicio más temprana. Si especifica `PlannedStartTime` pero no este parámetro, la hora de inicio más tardía de la tarea será el valor de `PlannedStartTime` más 30 minutos de forma predeterminada. Por ejemplo, si establece `PlannedStartTime` en `2021-01-14T09:00:00Z` y deja este parámetro vacío, la tarea comenzará a más tardar a las `2021-01-14T09:30:00Z`.	2021-01-14T09:30:00Z
FromTimeService	boolean	No	Especifica si el cambio de zona se realiza inmediatamente o en un horario programado. Valores válidos: false (predeterminado): El cambio de zona se realiza en el horario programado. true: El cambio de zona se realiza inmediatamente.	false
VPCId	string	No	El ID de la nube privada virtual (VPC).	vpc-**********

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
RequestId	string	El ID de la solicitud.	ED12C6FF-3261-4571-AB57-3570F6******

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "ED12C6FF-3261-4571-AB57-3570F6******"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error
400	ScheduleTaskExist	The specified cluster already has a scheduled task.
400	InvalidZoneId.Malformed	The specified parameter ZoneId is not valid.
400	InvalidZoneId.Same	The specified parameter ZoneId is same with origin zoneId.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.
403	ActionUnauthorized	The specified action is not available for you.
403	OperationDenied.MutexLock	The operation is not permitted due to the mutex lock.
404	InvalidDBCluster.NotFound	The DBClusterId provided does not exist in our records.
404	InvalidDBClusterId.Malformed	The specified parameter DBClusterId is not valid.
404	InsufficientResource	The specified target zone has insufficient resources.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.