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

Altera o tipo de rede do endereço IPv4 de uma instância do Network Load Balancer (NLB).

Descrição da operação

Certifique-se de que uma instância NLB foi criada. Para mais informações, consulte CreateLoadBalancer.
Você pode chamar a operação GetLoadBalancerAttribute para consultar o valor de AddressType de uma instância NLB após alterar o tipo de rede.
UpdateLoadBalancerAddressTypeConfig é 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 da tarefa:
- Se a tarefa estiver no estado Succeeded, o tipo de rede do endereço IPv4 da instância NLB foi alterado.
- Se a tarefa estiver no estado Processing, o tipo de rede do endereço IPv4 da instância NLB está sendo alterado. 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:UpdateLoadBalancerAddressTypeConfig

update

*LoadBalancer

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

nlb:AddressType

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****
AddressType	string	Sim	O novo tipo de rede. Valores válidos: Internet: Os nós de uma instância NLB voltada para a Internet possuem endereços IP públicos. O nome DNS de uma instância NLB voltada para a Internet é publicamente resolvível para os endereços IP públicos dos nós. Portanto, instâncias NLB voltadas para a Internet podem rotear solicitações de clientes pela Internet. Intranet: Os nós de uma instância NLB interna possuem apenas endereços IP privados. O nome DNS de uma instância NLB interna é publicamente resolvível para os endereços IP privados dos nós. Portanto, instâncias NLB internas podem rotear solicitações apenas de clientes com acesso à virtual private cloud (VPC) da instância NLB.	Internet
ZoneMappings	array<object>	Não	Os mapeamentos entre zonas e vSwitches. Você pode especificar até 10 zonas.
	object	Não	O mapeamento entre a zona e um vSwitch na zona.
VSwitchId	string	Não	O ID do vSwitch na zona. Você pode especificar apenas um vSwitch (sub-rede) em cada zona de uma instância NLB.	vsw-bp10ttov87felojcn****
ZoneId	string	Não	O ID da zona da instância NLB. Você pode chamar a operação DescribeZones para consultar a lista de zonas mais recente.	cn-hangzhou-a
AllocationId	string	Não	O ID do elastic IP address (EIP).	eip-bp1aedxso6u80u0qf****
EipType	string	Não	O tipo do EIP. Valores válidos: Common: um EIP Anycast: um Anycast EIP Nota Este parâmetro é obrigatório apenas se AddressType estiver definido como Internet.	Common
DryRun	boolean	Não	Realiza um dry run sem efetivamente executar a solicitação. Valores válidos: true: Realiza apenas um dry run. 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 verificação, uma mensagem de erro especificando o problema será retornada. Se a solicitação for aprovada, o código de erro `DryRunOperation` será retornado. false (padrão): Verifica a solicitação e executa a operação. Se a solicitação for aprovada na verificação, um código de status HTTP 2xx será retornado e a operação será executada.	false
ClientToken	string	Não	O token do cliente usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar este valor. Certifique-se de que o valor seja único entre todas as solicitações. Apenas caracteres ASCII são permitidos. Nota Se você não especificar este parâmetro, o valor de RequestId será usado. O RequestId de cada solicitação é diferente.	123e4567-e89b-12d3-a456-426655440000
RegionId	string	Não	O ID da região da instância NLB. 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	Altera o tipo de rede do endereço IPv4 de uma instância NLB.
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	DuplicatedParam.AllocationId	The param of AllocationId is duplicated.
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	OperationDenied.EipAlreadyInBandwidthPackage	The operation is not allowed because of EipAlreadyInBandwidthPackage.
400	ResourceInConfiguring.%s	The specified resource of %s is being configured, please try again later.
400	OperationDenied.AddressTypeNotChanged	The operation is not allowed because of AddressTypeNotChanged.
400	Mismatch.ZoneIdAndVswitchId	The ZoneIdAndVswitchId is mismatched for %s and %s.
400	TagInvokeError	listTagsByResourceIds: InvalidResourceId.NotFound : The specified ResourceIds are not found in our records.
400	DryRunOperation	Request validation has been passed with DryRun flag set.	Request validation has been passed with DryRun flag set.
400	IllegalParam	The param of %s is illegal.
400	Throttling.User	Request was denied due to api flow control.	Request was denied due to api flow control.
403	Forbidden.NoPermission	Authentication is failed for NoPermission.	Authentication is failed for NoPermission.
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.AnycastInstance	The specified resource of AnycastInstance is not found.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.