UpdateLoadBalancerZones - : Central de Documentação do Alibaba Cloud

Precauções

Ao chamar esta operação, especifique todas as zonas da instância NLB, incluindo as existentes e as novas. Se você não especificar as zonas existentes, o sistema as removerá.

Descrição

Verifique se há uma instância NLB criada. Para mais informações, consulte CreateLoadBalancer.
Chame a operação GetLoadBalancerAttribute para consultar as zonas e os atributos de zona de uma instância NLB.
A operação UpdateLoadBalancerZones é assíncrona. Após o envio da solicitação, o sistema retorna o ID da solicitação, mas continua a executar a operação em segundo plano. Chame a operação GetJobStatus para consultar o status da tarefa:
- Se a tarefa estiver no estado Succeeded, as zonas e os atributos de zona foram modificados.
- Se a tarefa estiver no estado Processing, a modificação das zonas e dos atributos de zona está em andamento. Nesse caso, execute apenas operações de consulta.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	UpdateLoadBalancerZones	Operação a ser executada. Defina o valor como UpdateLoadBalancerZones.
LoadBalancerId	String	Sim	nlb-83ckzc8d4xlp8o****	ID da instância NLB.
ZoneMappings.N.VSwitchId	String	Sim	vsw-bp1rmcrwg3erh1fh8****	ID do vSwitch na zona. Por padrão, cada zona contém um vSwitch e uma sub-rede.
ZoneMappings.N.ZoneId	String	Sim	cn-hangzhou-a	ID da zona. Chame a operação DescribeZones para consultar as zonas disponíveis.
ZoneMappings.N.PrivateIPv4Address	String	Não	192.168.36.16	Endereços IP privados.
ZoneMappings.N.AllocationId	String	Não	eip-bp1aedxso6u80u0qf****	ID do Elastic IP Address (EIP) ou Anycast EIP.
ZoneMappings.N.EipType	String	Não	Common	Tipo do EIP. Valores válidos: Common: EIP Anycast: Anycast EIP Nota Somente instâncias NLB na região China (Hong Kong) podem ser associadas a Anycast EIPs. Este parâmetro é obrigatório se você definir o parâmetro AddressType como Internet.
DryRun	Boolean	Não	false	Defina se a solicitação deve ser verificada sem executar a operação. Valores válidos: true: verifica a solicitação sem executar a operação. O sistema valida os parâmetros obrigatórios, a sintaxe da solicitação e os limites. Se a verificação falhar, o sistema retornará uma mensagem de erro. Se a verificação for bem-sucedida, o sistema retornará o código de erro `DryRunOperation`. false: envia a solicitação. Se a verificação for bem-sucedida, o sistema retornará um código de status HTTP 2xx e executará a operação. Este é o valor padrão.
ClientToken	String	Não	123e4567-e89b-12d3-a456-426655440000	Token de cliente usado para garantir a idempotência da solicitação. Use o cliente para gerar o valor, mas garanta que ele seja único entre todas as solicitações. O token pode conter apenas caracteres ASCII. Nota Se você não especificar este parâmetro, o sistema definirá automaticamente ClientToken com o valor de RequestId. O RequestId de cada solicitação de API pode ser diferente.
RegionId	String	Não	cn-hangzhou	ID da região onde a instância NLB está implantada. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	CEF72CEB-54B6-4AE8-B225-F876FF7BA984	ID da solicitação.
JobId	String	72dcd26b-f12d-4c27-b3af-18f6aed5****	ID da tarefa assíncrona.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=UpdateLoadBalancerZones
&LoadBalancerId=nlb-83ckzc8d4xlp8o****
&ZoneMappings=[{"VSwitchId":"vsw-bp1rmcrwg3erh1fh8****","ZoneId":"cn-hangzhou-a","PrivateIPv4Address":"192.168.36.16","AllocationId":"eip-bp1aedxso6u80u0qf****"}]
&DryRun=false
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&RegionId=cn-hangzhou
&Common request parameters

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<UpdateLoadBalancerZonesResponse>
    <RequestId>CEF72CEB-54B6-4AE8-B225-F876FF7BA984</RequestId>
    <JobId>72dcd26b-f12d-4c27-b3af-18f6aed5****</JobId>
</UpdateLoadBalancerZonesResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "CEF72CEB-54B6-4AE8-B225-F876FF7BA984",
  "JobId" : "72dcd26b-f12d-4c27-b3af-18f6aed5****"
}

Códigos de erro

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.