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

Cambia la VPC o el vSwitch de una instancia de Tair (compatible con Redis OSS). Si la instancia está desplegada en la red clásica, el tipo de red de la instancia se cambia de red clásica a VPC.

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:SwitchNetwork

update

*DBInstance

acs:kvstore:{#regionId}:{#accountId}:instance/{#instanceId}

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
TargetNetworkType	string	No	El tipo de red al que desea cambiar. Si desea cambiar a la red VPC, establezca el valor en VPC.	VPC
VpcId	string	No	El ID de la VPC a la que desea cambiar. Puede llamar a la operación DescribeVpcs para consultar el ID de la VPC. Nota La VPC y la instancia deben estar desplegadas en la misma región. Después de configurar este parámetro, también debe configurar el parámetro VSwitchId.	vpc-bp1nme44gek34slfc****
VSwitchId	string	No	El ID del vSwitch que pertenece a la VPC a la que desea cambiar. Puede llamar a la operación DescribeVpcs para consultar el ID del vSwitch. Nota El vSwitch y la instancia deben estar desplegados en la misma zona.	vsw-bp1e7clcw529l773d****
InstanceId	string	Sí	El ID de la instancia. Puede llamar a la operación DescribeInstances para consultar el ID de la instancia.	r-bp1zxszhcgatnx****
RetainClassic	string	No	Especifica si se debe conservar el endpoint de red clásica original después de cambiar la instancia de red clásica a VPC. Valor predeterminado: False. Valores válidos: True: conserva el endpoint de red clásica. False: no conserva el endpoint de red clásica. Nota Este parámetro solo está disponible cuando el tipo de red de la instancia es red clásica.	True
ClassicExpiredDays	string	No	El período de retención del endpoint de red clásica. Valores válidos: 14, 30, 60 y 120. Unidad: días. Nota Este parámetro está disponible y es obligatorio solo cuando el parámetro RetainClassic se establece en True. Después de completar la operación de cambio, también puede llamar a la operación ModifyInstanceNetExpireTime para modificar el período de retención del endpoint de red clásica.	30

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
TaskId	string	El ID de la tarea.	578678678
RequestId	string	El ID de la solicitud.	F0997EE8-F4C2-4503-9168-85177ED78C70

Ejemplos

Respuesta exitosa

JSON Formato

{
  "TaskId": "578678678",
  "RequestId": "F0997EE8-F4C2-4503-9168-85177ED78C70"
}

Respuesta de error

JSON Formato

{
    "TaskId":"578678678",
    "requestId":"F0997EE8-F4C2-4503-9168-85177ED78C70"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidToken.Malformed	The Specified parameter Token is not valid.
400	VpcServiceError	Invoke vpc service failed.
400	IzNotSupportVpcError	Specify iz not support vpc.
400	IzNotSupportSwitchNetworkError	Specify iz not support switch network.
400	VpcVerifyError	VpcId is wrong.
400	VpcAndVSwitchNotChange	VpcId and vSwitchId not change.	The VpcId and vSwitchId parameter values are not changed.
403	ResourceAlreadyExists	Resource already exists.
403	InsufficientResourceCapacity	ip resource is conflict with other custins.
403	VpcFreePasswordNoSupport	The custins opend VPCFreePassword not support this operation.	This operation is not supported for the instance because the VPC secret exemption is enabled or the# no_loose_check-whitelist-always parameter is set to no at the same time.

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.