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

Altera o tipo de rede de uma instância de Application Load Balancer (ALB).

Descrição da operação

Antes de começar:

Você criou uma instância ALB. Para mais informações, consulte CreateLoadBalancer.
Para alterar o tipo de rede de uma instância ALB de rede privada para rede pública usando esta operação, você deve primeiro criar um elastic IP (EIP). Para mais informações, consulte AllocateEipAddress.

Notas de uso:

UpdateLoadBalancerAddressTypeConfig é uma operação assíncrona. Após o envio de uma solicitação, o sistema retorna um ID de solicitação, mas o tipo de rede da instância ALB ainda não foi alterado. O nó de alteração continua em segundo plano. Você pode invocar GetLoadBalancerAttribute para consultar o status de alteração do tipo de rede da instância ALB:

Se a instância ALB estiver no estado Configuring, o tipo de rede da instância de load balancer está sendo alterado.
Se a instância ALB estiver no estado Active, o tipo de rede da instância de load balancer foi alterado com sucesso.

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

alb:UpdateLoadBalancerAddressTypeConfig

update

*LoadBalancer.

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

alb:AddressType

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ClientToken	string	Não	O token do cliente que é usado para garantir a idempotência da solicitação. Gere um valor exclusivo a partir do seu cliente para este parâmetro. O ClientToken suporta apenas caracteres ASCII. Nota Se você não especificar este parâmetro, o sistema usará automaticamente o RequestId da solicitação de API como o ClientToken. O RequestId de cada solicitação de API pode ser diferente.	123e4567-e89b-12d3-a456-42665544****
DryRun	string	Não	Especifica se deve ser realizado um dry run. Valores válidos: true: Envia uma solicitação de dry run. O tipo de rede da instância não é alterado. O sistema verifica se os parâmetros obrigatórios foram especificados, se o formato da solicitação é válido e se os limites de negócios são atendidos. Se a verificação falhar, o erro correspondente será retornado. Se a verificação for bem-sucedida, o código de erro DryRunOperation será retornado. false (padrão): Envia uma solicitação regular. Se a verificação for bem-sucedida, o sistema retornará um código de status HTTP 2xx e executará a operação.	false
LoadBalancerId	string	Sim	O ID da instância de load balancer.	alb-bp1o94dp5i6ea****
AddressType	string	Sim	O tipo de rede de destino. Valores válidos: Internet: A instância de load balancer possui um endereço IP público e seu nome de domínio DNS é resolvido para o endereço IP público. A instância de load balancer pode ser acessada pela Internet. Intranet: A instância de load balancer possui apenas um endereço IP privado e seu nome de domínio DNS é resolvido para o endereço IP privado. A instância de load balancer pode ser acessada apenas no ambiente de rede interna da VPC onde reside.	Internet
ZoneMappings	array<object>	Não	A lista de mapeamentos de zona e vSwitch. Você pode adicionar até 10 zonas. Se a região atual suportar duas ou mais zonas, você deve adicionar pelo menos duas zonas.
	object	Não	A estrutura da lista de mapeamento de zona e vSwitch.
VSwitchId	string	Não	O vSwitch que corresponde à zona. Cada zona pode usar apenas um vSwitch e uma sub-rede. Você pode adicionar até 10 zonas. Se a região atual suportar duas ou mais zonas, você deve adicionar pelo menos duas zonas.	vsw-bp10ttov87felojcn****
ZoneId	string	Não	O ID da zona da instância de load balancer. Você pode adicionar até 10 zonas. Se a região atual suportar duas ou mais zonas, você deve adicionar pelo menos duas zonas. Você pode invocar DescribeZones para consultar as informações da zona ativa que correspondem a um ID de zona.	cn-hangzhou-a
AllocationId	string	Não	O ID da instância do EIP. Você pode adicionar até 10 zonas ativas. Nota Este parâmetro é obrigatório quando você invoca esta operação para transformar o tipo de rede de rede privada para rede pública.	eip-bp1aedxso6u80u0qf****
EipType	string	Não	O tipo do EIP. Valores válidos: Common (padrão): um EIP padrão. Anycast: um EIP Anycast. Nota Para as regiões que suportam a vinculação de EIPs Anycast a instâncias ALB, consulte Limits.	Common
RetainResourceType	array	Não	Os tipos de recursos que são criados automaticamente pelo ALB e precisam ser retidos. As configurações podem ser configuradas atualmente como eip, o que indica EIPs. As operações de criação e anexação automática aplicam-se a esses tipos de recursos.
	string	Não	O tipo de recurso a ser retido. Você pode definir este parâmetro como eip, o que indica um EIP.	eip

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	A estrutura da resposta.
RequestId	string	O ID da solicitação.	593B0448-D13E-4C56-AC0D-FDF0FDE0E9A3
JobId	string	O ID da tarefa assíncrona.	72dcd26b-f12d-4c27-b3af-18f6aed5****

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "593B0448-D13E-4C56-AC0D-FDF0FDE0E9A3",
  "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	OperationDenied.OnlyPostPaidEipSupported	The operation is not allowed because of OnlyPostPaidEipSupported.	A operação foi rejeitada porque apenas endereços IP elásticos (EIPs) pós-pagos são suportados.
400	Mismatch.ZoneIdAndVSwitchId	The ZoneId and VSwitchId are mismatched.	%s e %s não correspondem.
400	IncorrectBusinessStatus.Eip	The business status of %s [%s] is incorrect.	O status comercial do recurso %s [%s] é inválido.
400	ResourceNotFound.Eip	The specified resource ResourceNotFound.Eip is not found.	O recurso Elastic IP Address (EIP) não existe.
400	IncorrectStatus.CommonBandwidthPackage	The status of %s [%s] is incorrect.	O status do recurso %s [%s] é inválido.
400	IncorrectBusinessStatus.CommonBandwidthPackage	The business status of %s [%s] is incorrect.	O status comercial do recurso %s [%s] é inválido.
400	OperationDenied.AddressTypeNotChanged	The operation is not allowed because of AddressTypeNotChanged.	O tipo de rede da instância de load balancer não foi alterado.
400	IncorrectStatus.LoadBalancer	The status of %s [%s] is incorrect.	O status atual da instância não suporta esta operação.
404	ResourceNotFound.CommonBandwidthPackage	The specified resource %s is not found.	O recurso %s não existe.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.