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

Modifica as zonas e os atributos de zona de uma instância de Network Load Balancer (NLB).

Descrição da operação

Ao chamar esta operação, certifique-se de especificar todas as zonas da instância NLB, incluindo as zonas existentes e as novas zonas. Se você não especificar as zonas existentes, elas serão removidas.

Pré-requisitos.

Uma instância NLB foi criada. Para mais informações, consulte CreateLoadBalancer.
Você pode chamar a operação GetLoadBalancerAttribute para consultar as zonas e os atributos de zona de uma instância NLB.
UpdateLoadBalancerZones é uma operação assíncrona. Após o envio de uma solicitação, o sistema retorna um ID de solicitação e executa a tarefa em segundo plano. Você pode chamar a operação GetJobStatus para consultar o status de uma tarefa:
- Se a tarefa estiver no estado Succeeded, as zonas e os atributos de zona são modificados.
- Se a tarefa estiver no estado Processing, as zonas e os atributos de zona estão sendo modificados. Nesse caso, você pode realizar apenas operações de consulta.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

nlb:UpdateLoadBalancerZones

update

*LoadBalancer

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
LoadBalancerId	string	Sim	O ID da instância NLB.	nlb-83ckzc8d4xlp8o****
ZoneMappings	array<object>	Sim	Os mapeamentos entre as zonas e os vSwitches. Você pode especificar até 10 zonas.
	object	Não	O mapeamento entre a zona e o vSwitch. Você pode especificar até 10 zonas.
VSwitchId	string	Sim	O ID do vSwitch na zona. Por padrão, cada zona usa um vSwitch e uma sub-rede.	vsw-bp1rmcrwg3erh1fh8****
ZoneId	string	Sim	O ID da zona. Você pode chamar a operação DescribeZones para consultar a lista de zonas mais recente.	cn-hangzhou-a
PrivateIPv4Address	string	Não	O endereço IP privado.	192.168.36.16
AllocationId	string	Não	O ID do elastic IP (EIP) ou do Anycast EIP.	eip-bp1aedxso6u80u0qf****
EipType	string	Não	O tipo de EIP. Valores válidos: Common: um EIP Anycast: um Anycast EIP Nota Para regiões que suportam Anycast EIPs, consulte Limits. Este parâmetro é obrigatório se AddressType estiver definido como Internet.	Common
DryRun	boolean	Não	Especifica se deve ser realizado um dry run. Valores válidos: true: valida a solicitação sem executar a operação. O sistema verifica a solicitação em busca de possíveis problemas, incluindo valores de parâmetros ausentes, sintaxe de solicitação incorreta e limites de serviço. Se a solicitação falhar na validação, a mensagem de erro correspondente será retornada. Se a solicitação passar na validação, o código de erro `DryRunOperation` será retornado. false (padrão): valida a solicitação e executa a solicitação. Se a solicitação passar na validação, um código de status HTTP 2xx será retornado e a operação será executada.	false
ClientToken	string	Não	O token de cliente usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o token. Certifique-se de que o token seja exclusivo entre diferentes solicitações. Apenas caracteres ASCII são permitidos. Nota Se você não definir este parâmetro, o valor de RequestId será usado.** O valor de RequestId** é diferente para cada solicitação.	123e4567-e89b-12d3-a456-426655440000
RegionId	string	Não	O ID da região onde a instância NLB está implantada. Você pode chamar a operação DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Resposta.
RequestId	string	O ID da solicitação.	CEF72CEB-54B6-4AE8-B225-F876FF7BA984
JobId	string	O ID da tarefa assíncrona.	72dcd26b-f12d-4c27-b3af-18f6aed5****

Exemplos

Resposta de sucesso

JSON formato

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

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	ResourceInCreating.loadbalancer	The specified resource of loadbalancer is creating, please try again later.	The specified resource of loadbalancer is creating, please try again later.
400	OperationDenied.ProtectedPrivateIPv4AddressChanged	The operation is not allowed because of ProtectedPrivateIPv4AddressChanged.
400	OperationFailed.vSwitchNotSupportIpv6	The operation failed because of vSwitchNotSupportIpv6.
400	OperationDenied.%s	The operation is not allowed because of %s.
400	OperationDenied.ZoneVSwitchChanged	The operation is not allowed because of ZoneVSwitchChanged.	The existing zone does not allow changes to the virtual switch.
400	InvalidZones	The current zone list is illegal.	The Availability Zone used in Zone maping is illegal.
400	ResourceInConfiguring.loadbalancer	The specified resource of loadbalancer is being configured, please try again later.	The specified resource of loadbalancer is being configured, please try again later.
400	SystemBusy	System is busy, please try again later.
400	ResourceNotEnough.VSwitchIp	The specified resource of VSwitchIp is not enough.	The specified virtual switch (vSwitch) IP resources are insufficient.
403	UnauthorizedZone	The specified zone of %s is not authorized.
404	ResourceNotFound.loadBalancer	The specified resource of loadbalancer is not found.	The specified load balancer resource was not found. Please check the input parameters.
404	ResourceNotFound.VSwitch	The specified resource of vSwitch is not found.	The specified vSwitch resource was not found. Please check the input parameters.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.