LoadBalancerJoinSecurityGroup - : Central de Documentação do Alibaba Cloud

Observações de uso

Certifique-se de ter criado um grupo de segurança. Para mais informações sobre como criar um grupo de segurança, consulte CreateSecurityGroup.
Uma instância NLB aceita associação com até quatro grupos de segurança.
Para consultar os grupos de segurança associados a uma instância NLB, chame a operação GetLoadBalancerAttribute.
LoadBalancerJoinSecurityGroup é uma operação assíncrona. Após a chamada, o sistema retorna um ID de solicitação e executa a tarefa em segundo plano. Chame a operação GetJobStatus para consultar o status da tarefa.
- Se a tarefa estiver no estado Succeeded, o grupo de segurança foi associado.
- Se a tarefa estiver no estado Processing, a associação do grupo de segurança está em andamento. Nesse caso, 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 de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	LoadBalancerJoinSecurityGroup	A operação a ser executada. Defina o valor como LoadBalancerJoinSecurityGroup.
SecurityGroupIds.N	String	Não	sg-bp1fg655nh68xyz9****	O ID do grupo de segurança.
LoadBalancerId	String	Sim	nlb-83ckzc8d4xlp8o****	O ID da instância NLB a ser associada ao grupo de segurança.
DryRun	Boolean	Não	true	Especifica se a solicitação deve ser verificada sem executar a operação. Valores válidos: true: verifica a solicitação sem executar a operação. O sistema valida os parâmetros obrigatórios, a sintaxe da solicitação e os limites. Se a verificação falhar, o sistema retornará um código de erro conforme a causa da falha. Se a verificação for bem-sucedida, o sistema retornará o código de erro `DryRunOperation`. false (padrão): envia a solicitação. Se a verificação for aprovada, o sistema retornará um código de status HTTP 2xx e executará a operação.
ClientToken	String	Não	123e4567-e89b-12d3-a456-426655440000	O token de cliente usado para garantir a idempotência da solicitação. Use o cliente para gerar o valor, mas garanta que ele seja exclusivo entre diferentes solicitações. O token de cliente pode conter apenas caracteres ASCII. Nota Se você não definir este parâmetro, o sistema usará automaticamente o valor de RequestId como valor de ClientToken. O valor de RequestId pode variar a cada solicitação de API.
RegionId	String	Não	cn-hangzhou	O ID da região onde a instância NLB está implantada. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.

Parâmetros de resposta

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

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=LoadBalancerJoinSecurityGroup
&SecurityGroupIds=["sg-bp1fg655nh68xyz9****"]
&LoadBalancerId=nlb-83ckzc8d4xlp8o****
&DryRun=true
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&RegionId=cn-hangzhou
&Common request parameters

Exemplos de respostas de sucesso

Formato XML

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

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

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 Códigos de erro do serviço.