DetachInstances - Auto Scaling: Central de Documentação do Alibaba Cloud

Descrição da operação

Antes de chamar esta operação, certifique-se de que as seguintes condições sejam atendidas:
- O grupo de escalonamento está no estado Enabled.
- Nenhuma atividade de escalonamento está em andamento no grupo de escalonamento.
  
  Nota
  Se nenhuma atividade de escalonamento estiver em andamento no grupo de escalonamento, esta operação pode ignorar o tempo de resfriamento e acionar diretamente uma atividade de escalonamento.
Observe os seguintes itens:
- Após a remoção de uma instância ECS, uma instância de contêiner elástico ou uma instância gerenciada de um grupo de escalonamento, a instância continua a existir de forma independente. Você pode chamar a operação AttachInstances para adicionar a instância ECS, a instância de contêiner elástico ou a instância gerenciada a outro grupo de escalonamento.
- Chamar esta operação para remover uma instância ECS, uma instância de contêiner elástico ou uma instância gerenciada não interrompe nem libera a instância.
- Após a chamada da operação, isso indica apenas que o Auto Scaling aceitou a solicitação. Uma atividade de escalonamento pode ser acionada, mas o sucesso da atividade de escalonamento não é garantido. Você deve verificar o status da atividade de escalonamento com base no ScalingActivityId retornado.
- O número de instâncias ECS, instâncias de contêiner elástico ou instâncias gerenciadas no grupo de escalonamento menos o número de instâncias sendo removidas não pode ser inferior ao número mínimo de instâncias (MinSize) no grupo de escalonamento. Caso contrário, um erro será retornado.

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

ess:DetachInstances

update

*ScalingGroup

acs:ess:{#regionId}:{#accountId}:scalinggroup/{#ScalingGroupId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ScalingGroupId	string	Sim	O ID do grupo de escalonamento.	asg-bp1igpak5ft1flyp****
DecreaseDesiredCapacity	boolean	Não	Especifica se o número esperado de instâncias deve ser modificado. Valores válidos: true: Após a remoção das instâncias ECS, instâncias de contêiner elástico ou instâncias gerenciadas do grupo de escalonamento, o número esperado de instâncias é reduzido na quantidade correspondente. false: Após a remoção das instâncias ECS, instâncias de contêiner elástico ou instâncias gerenciadas do grupo de escalonamento, o número esperado de instâncias permanece inalterado. Valor padrão: true.	true
IgnoreInvalidInstance	boolean	Não	Especifica se as instâncias inválidas devem ser ignoradas ao remover um lote de instâncias do grupo de escalonamento. Valores válidos: true: As instâncias inválidas são ignoradas quando um lote de instâncias é removido do grupo de escalonamento. Se um lote de instâncias contiver instâncias inválidas (por exemplo, instâncias cujo status da instância é `Pending`) e as instâncias válidas forem removidas com sucesso, o status de execução da atividade de escalonamento será exibido como `Warning`. Você pode visualizar as instâncias inválidas nos detalhes da atividade de escalonamento. false: As instâncias inválidas não são ignoradas quando um lote de instâncias é removido do grupo de escalonamento. Se um lote de instâncias contiver instâncias inválidas (por exemplo, instâncias cujo status da instância é `Pending`), um erro será retornado. Valor padrão: false.	false
DetachOption	string	Não	Especifica se deve parar de usar instâncias ECS ou instâncias de contêiner elástico como servidores de back-end da instância de balanceamento de carga associada (ou seja, remover as instâncias ECS ou instâncias de contêiner elástico do grupo de servidores padrão e do grupo de servidores virtuais da instância de balanceamento de carga) e se deve remover as instâncias ECS ou instâncias de contêiner elástico da lista de permissões de acesso da instância do ApsaraDB RDS associada. both: remove as instâncias ECS ou instâncias de contêiner elástico do grupo de servidores padrão e do grupo de servidores virtuais da instância de balanceamento de carga, e remove as instâncias ECS ou instâncias de contêiner elástico da lista de permissões de acesso da instância do ApsaraDB RDS. Nota As configurações para este parâmetro não são suportadas quando instâncias gerenciadas são removidas do grupo de escalonamento.	both
InstanceId	array	Sim	O ID da instância ECS, da instância de contêiner elástico ou da instância gerenciada a ser removida.	i-bp109k5j3dum1ce6****
	string	Não	O ID da instância ECS, da instância de contêiner elástico ou da instância gerenciada a ser removida. Valores válidos de N: 1 a 20. Exemplos: O ID da instância ECS a ser removida é `i-bp109k5j3dum1ce6**`. O ID da instância de contêiner elástico a ser removida é `eci-bp17gw49eu09yiwm`. O ID da instância gerenciada a ser removida é `mi-d23fsd**`. Nota** Apenas um tipo de instância pode ser removido em uma única solicitação.	i-bp109k5j3dum1ce6****
LifecycleHook	boolean	Não	Especifica se o hook de ciclo de vida de scale-in deve ser acionado quando instâncias ECS ou instâncias de contêiner elástico são removidas do grupo de escalonamento. Valores válidos: true: aciona o hook de ciclo de vida. false: não aciona o hook de ciclo de vida. Nota Este parâmetro não é suportado quando instâncias gerenciadas são removidas do grupo de escalonamento. Valor padrão: false.	false
ClientToken	string	Não	O token do cliente usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o token, mas certifique-se de que o token seja exclusivo entre diferentes solicitações. O token pode conter apenas caracteres ASCII e não pode exceder 64 caracteres de comprimento. Para mais informações, consulte Como garantir a idempotência.	123e4567-e89b-12d3-a456-42665544****

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
ScalingActivityId	string	O ID da atividade de escalonamento.	asa-bp1gbswjhjrw8tko****
RequestId	string	O ID da solicitação.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

Exemplos

Resposta de sucesso

JSON formato

{
  "ScalingActivityId": "asa-bp1gbswjhjrw8tko****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
500	InternalError	The request processing has failed due to some unknown error, exception or failure.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.