Todos os produtos
Search
Central de documentação

:UpdateLoadBalancerAttribute

Última atualização: Jul 03, 2026

Modifique o status e o nome de uma instância do Network Load Balancer (NLB).

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

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

Operação a executar. Defina o valor como UpdateLoadBalancerAttribute.

LoadBalancerId String Sim nlb-wb7r6dlwetvt5j****

ID da instância NLB.

LoadBalancerName String Não NLB1

Nome da instância NLB.

O nome deve ter de 2 a 128 caracteres e pode conter letras, dígitos, pontos (.), sublinhados (_) e hifens (-). Deve começar com uma letra.

CrossZoneEnabled Boolean Não false

Indica se o balanceamento de carga entre zonas está ativado para a instância NLB. Valores válidos:

  • true: sim
  • false: não
DryRun Boolean Não false

Indica se apenas a pré-verificação desta solicitação será executada. Valores válidos:

  • true: executa a pré-verificação da solicitação, mas não modifique o nome ou o status da instância NLB. O sistema verifica os parâmetros obrigatórios, a sintaxe da solicitação e os limites. Se a solicitação falhar na pré-verificação, o sistema retorna uma mensagem de erro. Caso seja aprovada, o sistema retorna o código de erro DryRunOperation.
  • false (padrão): envia a solicitação. Se a pré-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 do cliente usado para garantir a idempotência da solicitação.

Use o cliente para gerar o valor e garanta que ele seja único entre todas as solicitações. O ClientToken aceita apenas caracteres ASCII.

Nota Se você não definir este parâmetro, o ClientToken assumirá o valor de RequestId. O valor de RequestId pode variar em cada solicitação de API.
RegionId String Não cn-beijing

ID da região onde a instância NLB está implantada.

Chame a operação DescribeRegions para consultar a lista mais recente de regiões.

Cps Integer Não 1

Número máximo de conexões por segundo permitidas na instância NLB. Intervalo válido: de 1 a 1000000.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

7294679F-08DE-16D4-8E5D-1625685DC10B

ID da solicitação.

JobId

String

aab74cfa-3bc4-48fc-80fc-0101da5a****

ID da tarefa assíncrona.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=UpdateLoadBalancerAttribute
&LoadBalancerId=nlb-wb7r6dlwetvt5j****
&LoadBalancerName=NLB1
&CrossZoneEnabled=false
&DryRun=false
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&RegionId=cn-beijing
&Cps=1
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<UpdateLoadBalancerAttributeResponse>
    <RequestId>7294679F-08DE-16D4-8E5D-1625685DC10B</RequestId>
    <JobId>aab74cfa-3bc4-48fc-80fc-0101da5a****</JobId>
</UpdateLoadBalancerAttributeResponse>

Formato JSON

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

{
  "RequestId" : "7294679F-08DE-16D4-8E5D-1625685DC10B",
  "JobId" : "aab74cfa-3bc4-48fc-80fc-0101da5a****"
}

Códigos de erro

Para obter uma lista de códigos de erro, visite a Central de Erros de API.