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

Remove servidores de backend de um grupo de servidores.

Descrição da operação

RemoveServersFromServerGroup é 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 ListServerGroups para consultar o status de um grupo de servidores.
- Se o grupo de servidores estiver no estado Configuring, o grupo de servidores está sendo modificado.
- Se o grupo de servidores estiver no estado Available, o grupo de servidores está em execução.
Você pode chamar ListServerGroupServers para consultar o status de um servidor de backend.
- Se o servidor de backend estiver no estado Removing, o servidor de backend está sendo removido do grupo de servidores.
- Se o servidor de backend não puder ser encontrado, o servidor de backend não está mais no grupo de servidores.

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:RemoveServersFromServerGroup

update

*ServerGroup

acs:alb:{#regionId}:{#accountId}:servergroup/{#servergroupId}

Instance

acs:alb:{#regionId}:{#accountId}:ecs/{#InstanceId}

NetworkInterface

acs:alb:{#regionId}:{#accountId}:eni/{#NetworkInterfaceId}

ContainerGroup

acs:alb:{#regionId}:{#accountId}:eci/{#ContainerGroupId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ServerGroupId	string	Sim	O ID do grupo de servidores.	sgp-atstuj3rtop****
Servers	array<object>	Sim	Os servidores de backend a serem removidos. Você pode especificar até 200 servidores de backend.
	object	Não	As configurações do servidor de backend.
Port	integer	Não	A porta usada pelo servidor de backend. Valores válidos: 1 a 65535. Nota Este parâmetro é obrigatório quando você define ServerType como Ecs, Eni, Eci ou Ip.	80
ServerId	string	Sim	O ID do servidor de backend. Se o grupo de servidores for do tipo Instance, defina ServerId como o ID de um recurso do tipo Ecs, Eni ou Eci. Se o grupo de servidores for do tipo Ip, defina este parâmetro como endereços IP. Se o grupo de servidores for do tipo Fc, defina ServerId como o Alibaba Cloud Resource Name (ARN) de uma função. Nota Você pode chamar a operação ListServerGroups para consultar informações sobre o tipo de grupo de servidores, para que possa definir ServerId com um valor adequado.	i-bp1f9kdprbgy9uiu****
ServerIp	string	Não	O endereço IP da interface de rede elástica (ENI) no modo inclusivo.	192.168.1.1
ServerType	string	Sim	O tipo do servidor de backend. Valores válidos: Ecs: instância do Elastic Compute Service (ECS) Eni: ENI Eci: instância de contêiner elástico Ip: endereço IP Fc: instância do Function Compute	Ecs
ClientToken	string	Não	O token de cliente usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o token, mas deve garantir que o token seja único entre diferentes solicitações. O token pode conter apenas caracteres ASCII. Nota Se você não especificar este parâmetro, o sistema usará automaticamente o ID da solicitação como o token de cliente. O ID da solicitação pode ser diferente para cada solicitação.	593B0448-D13E-4C56-AC0D-FDF0FDE0E9A3
DryRun	boolean	Não	Especifica se deve ser realizado apenas um dry run, sem executar a solicitação real. Valores válidos: true: realiza apenas um dry run. O sistema verifica a solicitação quanto a possíveis problemas, incluindo valores de parâmetros ausentes, sintaxe de solicitação incorreta e limites de serviço. Se a solicitação falhar no dry run, um código de erro será retornado. Se a solicitação passar no dry run, o código de erro `DryRunOperation` será retornado. false (padrão): realiza um dry run e executa a solicitação real. Se a solicitação passar no dry run, um código de status HTTP 2xx será retornado e a operação será executada.	false

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
JobId	string	O ID da tarefa assíncrona.	72dcd26b-f12d-4c27-b3af-18f6aed5****
RequestId	string	O ID da solicitação.	365F4154-92F6-4AE4-92F8-7FF34B540710

Exemplos

Resposta de sucesso

JSON formato

{
  "JobId": "72dcd26b-f12d-4c27-b3af-18f6aed5****",
  "RequestId": "365F4154-92F6-4AE4-92F8-7FF34B540710"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	IncorrectStatus.ServerGroup	The status of %s [%s] is incorrect.	The status of %s [%s] is incorrect.
400	ResourceInConfiguring.BackendServer	The specified resource of %s is being configured, please try again later.	The specified resource of %s is being configured, please try again later.
400	ResourceInConfiguring	The specified resource of %s is being configured. Please try again later.
403	Forbidden.ServerGroup	Authentication is failed for ServerGroup.
404	ResourceNotFound.ServerGroup	The specified resource %s is not found.
404	ResourceNotFound.BackendServer	The specified resource %s 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.