SwitchInstanceHA - Tair (Redis® OSS-Compatible) - Centro de documentación de Alibaba Cloud

Descripción de la operación

Nota

Para obtener más información sobre el acceso más cercano para aplicaciones en escenarios de despliegue multizona, consulte Ejemplos de escenarios.

Al llamar a esta operación, la instancia debe ser del tipo de alta disponibilidad o de réplica dual.

Llamar a esta operación tiene los siguientes impactos:

Después de activar un cambio de rol de nodo, el nodo de datos que se cambia entra en estado de solo lectura durante unos segundos y experimenta una desconexión transitoria. Asegúrese de que su aplicación cuente con un mecanismo de reconexión.
Mientras la instancia se encuentra en estado de cambio, no puede realizar operaciones a nivel de instancia, como cambios de configuración o migración de zona.

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

kvstore:SwitchInstanceHA

update

*All Resource

*

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
InstanceId	string	Sí	El ID de la instancia. Puede llamar a DescribeInstances para consultar el ID de la instancia.	r-bp1zxszhcgatnx****
NodeId	string	No	El ID del nodo de fragmento de datos. Puede llamar a DescribeRoleZoneInfo para obtener el parámetro CustinsId. Separe varios ID de nodos de fragmento de datos con comas (,). Para especificar todos los nodos, escriba `all`. Nota Este parámetro está disponible y es obligatorio solo cuando la instancia utiliza la arquitectura de clúster o de división de lectura/escritura.	56**19,56**20
SwitchMode	integer	No	El tiempo de ejecución. Valores válidos: 0: inmediatamente. Este es el valor predeterminado. 1: durante la ventana de mantenimiento. Nota Puede llamar a ModifyInstanceMaintainTime para modificar la ventana de mantenimiento de la instancia.	0
SwitchType	string	No	El modo de cambio. Valores válidos: ReliabilityPriority (predeterminado): Se prioriza la confiabilidad. El cambio principal/secundario se realiza solo cuando la sincronización principal/secundaria no tiene latencia, lo que evita la pérdida de datos. En escenarios con cargas de trabajo de escritura intensivas y latencia de sincronización persistente, este modo puede provocar que el cambio principal/secundario falle. AvailablePriority: Se prioriza la disponibilidad. El cambio principal/secundario se realiza inmediatamente sin importar la latencia principal/secundaria, lo que puede causar una pérdida menor de datos. Nota Evalúe sus requisitos empresariales de integridad de datos y disponibilidad del servicio antes de seleccionar un modo de cambio. Valores válidos: AvailablePriority : AvailablePriority. ReliabilityPriority : ReliabilityPriority.	ReliabilityPriority
SourceNodeId	string	No	El ID de nodo del nodo MASTER original en el fragmento.	52717408
TargetNodeId	string	No	El ID de nodo del nodo MASTER de destino después del cambio.	52717403
TargetShardName	string	No	El nombre del fragmento de la instancia.	r-2zegk3jyxxxwixfo6c-db-1

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
RequestId	string	El ID de la solicitud.	5D622714-AEDD-4609-9167-F5DDD3D1****
TaskId	string		674546459

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "5D622714-AEDD-4609-9167-F5DDD3D1****",
  "TaskId": "674546459"
}

Códigos de error

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.