UpdateLoadBalancerZones - Server Load Balancer - Centro de documentación de Alibaba Cloud

Actualiza las zonas de una instancia de Gateway Load Balancer (GWLB).

Descripción de la operación

Asegúrese de comprender completamente los métodos de facturación y los precios del producto Gateway Load Balancer antes de utilizar esta API.

UpdateLoadBalancerZones es una API asíncrona, lo que significa que el sistema devuelve un ID de solicitud, pero la zona de disponibilidad y los atributos de la zona de la instancia aún no se han modificado correctamente, ya que la tarea de cambio en segundo plano sigue en curso. Puede llamar a GetLoadBalancerAttribute para consultar el estado de actualización de la instancia de Gateway Load Balancer:

Cuando la instancia de Gateway Load Balancer está en estado Configuring, indica que la instancia se está actualizando.
Cuando la instancia de Gateway Load Balancer está en estado Active, indica que la actualización de la instancia se realizó correctamente.

Importante Cada vez que llame a esta API, asegúrese de pasar todos los parámetros de zona de disponibilidad de la instancia de Gateway Load Balancer, incluidas las zonas actuales y las nuevas. Si no pasa los parámetros de la zona actual, se interpretará como una solicitud para eliminar dicha zona. Puede consultar las zonas de disponibilidad actuales de la instancia mediante la API GetLoadBalancerAttribute.

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

gwlb:UpdateLoadBalancerZones

update

*LoadBalancer

acs:gwlb:{#regionId}:{#accountId}:loadbalancer/{#LoadBalancerId}

*VSwitch

acs:vpc:{#regionId}:{#accountId}:vswitch/{#VSwitchId}

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
LoadBalancerId	string	Sí	El ID de la instancia de GWLB.	gwlb-9njtjmqt7zfcqm****
ZoneMappings	array<object>	Sí	Las asignaciones entre zonas y vSwitches. Debe especificar al menos una zona. Puede especificar hasta 20 zonas. Si la región admite dos o más zonas, se recomienda seleccionar dos o más zonas.
	object	No
VSwitchId	string	Sí	El ID del vSwitch en la zona. Solo puede especificar un vSwitch (subred) en cada zona de una instancia de GWLB.	vsw-bp1n75pbs77v5q6p3****
ZoneId	string	Sí	El ID de la zona. Puede llamar a la operación DescribeZones para consultar la lista de zonas más reciente.	cn-hangzhou-h
DryRun	boolean	No	Especifica si se debe realizar una ejecución de prueba sin ejecutar la solicitud real. Valores válidos: true: realiza solo una ejecución de prueba. El sistema comprueba la solicitud en busca de posibles problemas, incluidos valores de parámetros faltantes, sintaxis de solicitud incorrecta y límites de servicio. Si la solicitud no supera la ejecución de prueba, se devuelve un código de error. Si la solicitud supera la ejecución de prueba, se devuelve el código de error `DryRunOperation`. false (valor predeterminado): realiza una ejecución de prueba y ejecuta la solicitud real. Si la solicitud supera la ejecución de prueba, se devuelve un código de estado HTTP 2xx y se realiza la operación.	false
ClientToken	string	No	El token de cliente que se utiliza para garantizar la idempotencia de la solicitud. Puede utilizar el cliente para generar el token, pero debe asegurarse de que el token sea único entre diferentes solicitudes. El token de cliente solo puede contener caracteres ASCII. Nota Si no especifica este parámetro, el sistema utiliza automáticamente el ID de solicitud como token de cliente. El ID de solicitud puede ser diferente para cada solicitud.	123e4567-e89b-12d3-a456-42665544****

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
RequestId	string	El ID de la solicitud.	ED8905C2-A4F6-5E43-87B7-6A5DC8757146

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "ED8905C2-A4F6-5E43-87B7-6A5DC8757146"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	OperationDenied.VSwitchChangeNotSupport	The operation is not allowed because of VSwitchChangeNotSupport.	Modifying the vSwitch is not allowed.
400	DuplicatedParam.VSwitchId	The param of VSwitchId is duplicated.	Duplicate vSwitchId parameter in list
400	DuplicatedParam.ZoneId	The param of ZoneId is duplicated.	Duplicate ZoneId parameter in list
400	IllegalParamSize.ZoneMappings	The param size of ZoneMappings is illegal.	Illegal number of ZoneMappings lists
400	IncorrectBusinessStatus.LoadBalancer	The business status of %s [%s] is incorrect.	Resource %s with business state %s does not support current operation
400	IncorrectStatus.LoadBalancer	The status of %s [%s] is incorrect.	Resource %s current state %s does not support operation
400	Mismatch.ZoneIdAndVSwitchId	The ZoneId and VSwitchId are mismatched.	The value of the ZoneId parameter does not match that of the vSwitchId
400	MissingParam.LoadBalancerId	The param of LoadBalancerId is missing.	Load balancing ID parameter missing
400	OperationDenied.VSwitchNotSupportIpv6	The operation is not allowed because of VSwitchNotSupportIpv6.	The operation is not allowed because IPv6 is not enabled for the vSwitch.
400	ResourceAlreadyAssociated.GwlbeAssociated	The specified resource of %s is already associated.	The specified resource %s is already associated
400	ResourceNotEnough.VSwitchIp	The specified resource of VSwitchIp is not enough.	Insufficient vSwitch IP resources
400	ResourceNotFound.LoadBalancer	The specified resource of %s is not found.

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.