Todos os produtos
Search

Este produto

    :UpdateLoadBalancerAddressTypeConfig

    Central de documentação

    :UpdateLoadBalancerAddressTypeConfig

    Última atualização: Jul 03, 2026

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

    Observações de uso

    • Certifique-se de ter criado uma instância NLB. Para mais informações, consulte CreateLoadBalancer.

    • Para consultar o valor de AddressType de uma instância NLB após alterar o tipo de rede, chame a operação GetLoadBalancerAttribute.

    • A operação UpdateLoadBalancerAddressTypeConfig é assíncrona. Após o envio da requisição, o sistema retorna o ID da requisição, mas continua executando a operação em segundo plano. Chame a operação GetJobStatus para verificar 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 com sucesso.

      • Caso a tarefa esteja no estado Processing, a alteração do tipo de rede do endereço IPv4 da instância NLB está em andamento. Nesse cenário, apenas operações de consulta são permitidas.

    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 códigos de exemplo da operação para diferentes SDKs.

    Parâmetros da requisição

    Parâmetro Tipo Obrigatório Exemplo Descrição
    Action String Sim UpdateLoadBalancerAddressTypeConfig

    Operação a ser executada. Defina o valor como UpdateLoadBalancerAddressTypeConfig.

    LoadBalancerId String Sim nlb-83ckzc8d4xlp8o****

    ID da instância NLB.

    AddressType String Sim Internet

    Novo tipo de rede. Valores válidos:

    • Internet: a instância NLB utiliza um endereço IP público. O nome de domínio da instância NLB resolve para o endereço IP público, permitindo acesso pela Internet.
    • Intranet: a instância NLB utiliza um endereço IP privado. O nome de domínio da instância NLB resolve para o endereço IP privado, restringindo o acesso à VPC onde a instância está implantada.
    ZoneMappings.N.VSwitchId String Não vsw-bp10ttov87felojcn****

    ID do vSwitch na zona. Especifique apenas um vSwitch (sub-rede) por zona em uma instância NLB.

    ZoneMappings.N.ZoneId String Não cn-hangzhou-a

    ID da zona da instância NLB.

    Chame a operação DescribeZones para obter a lista mais recente de zonas.

    ZoneMappings.N.AllocationId String Não eip-bp1aedxso6u80u0qf****

    ID do Elastic IP Address (EIP).

    ZoneMappings.N.EipType String Não Common

    Tipo de 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 requisição deve ser verificada sem executar a operação. Valores válidos:

    • true: verifica a requisição sem executar a operação. O sistema valida os parâmetros obrigatórios, a sintaxe da requisição e os limites. Se a verificação falhar, o sistema retorna uma mensagem de erro. Caso a verificação seja bem-sucedida, o sistema retorna o código de erro DryRunOperation.
    • false (padrão): envia a requisição. Se a verificação for bem-sucedida, o sistema retorna um código de status HTTP 2xx e executa a operação.
    ClientToken String Não 123e4567-e89b-12d3-a456-426655440000

    Token de cliente usado para garantir a idempotência da requisição.

    Use o cliente para gerar o valor e garanta que ele seja único entre todas as requisições. O token pode conter apenas caracteres ASCII.

    Nota Se este parâmetro não for especificado, o sistema definirá automaticamente ClientToken com o valor de RequestId. O RequestId de cada requisiçã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 obter a lista mais recente de regiões.

    Parâmetros de resposta

    Parâmetro

    Tipo

    Exemplo

    Descrição

    RequestId

    String

    CEF72CEB-54B6-4AE8-B225-F876FF7BA984

    ID da requisição.

    JobId

    String

    72dcd26b-f12d-4c27-b3af-18f6aed5****

    ID da tarefa assíncrona.

    Exemplos

    Exemplos de requisição

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

    Exemplos de resposta de sucesso

    Formato XML

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

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

    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 os códigos de erro do Serviço.