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

Remove uma ou mais instâncias ECS de um grupo de escalabilidade.

Descrição da operação

Antes de invocar esta operação, certifique-se de que as seguintes condições sejam atendidas:
- O grupo de escalabilidade está no estado habilitado (Active).
- Nenhuma atividade de escalabilidade está sendo executada no grupo de escalabilidade.

Se nenhuma atividade de escalabilidade estiver sendo executada no grupo de escalabilidade, esta operação pode ignorar o tempo de resfriamento (DefaultCooldown) e ser executada imediatamente.

Se uma instância ECS foi criada automaticamente pelo Auto Scaling por meio de criação automática, ou foi adicionada manualmente mas foi confiada ao grupo de escalabilidade, a instância ECS aciona o modo econômico ou é liberada quando é removida do grupo de escalabilidade.
Se uma instância ECS foi adicionada manualmente e não foi confiada ao grupo de escalabilidade, a instância ECS não é parada nem liberada quando é removida do grupo de escalabilidade.
Se o número atual de instâncias (TotalCapacity) no grupo de escalabilidade menos o número de instâncias especificado nesta operação for menor que o número mínimo de instâncias (MinSize) no grupo de escalabilidade, a invocação falhará.

Uma resposta bem-sucedida indica apenas que o Auto Scaling aceitou a solicitação. A atividade de escalabilidade pode ser executada, mas uma resposta bem-sucedida não garante que a atividade de escalabilidade será bem-sucedida. Você pode verificar o status de execução da atividade de escalabilidade com base no ScalingActivityId 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 escalabilidade.	asg-bp18p2yfxow2dloq****
RemovePolicy	string	Não	A ação a ser tomada nas instâncias ECS que são removidas. Valores válidos: recycle: A instância ECS entra no modo econômico. Nota Este valor só tem efeito quando `ScalingPolicy` está definido como `recycle`. release: A instância ECS é liberada. O parâmetro `ScalingPolicy` de CreateScalingGroup especifica o modo de recuperação do grupo de escalabilidade, mas a ação específica tomada quando uma instância é removida é determinada pelo parâmetro `RemovePolicy` de RemoveInstances. Exemplos: Se `ScalingPolicy` estiver definido como `recycle` e `RemovePolicy` estiver definido como `recycle`, a instância ECS entra no modo econômico. Se `ScalingPolicy` estiver definido como `recycle` e `RemovePolicy` estiver definido como `release`, a instância ECS é liberada. Se `ScalingPolicy` estiver definido como `release` e `RemovePolicy` estiver definido como `recycle`, a instância ECS é liberada. Se `ScalingPolicy` estiver definido como `release` e `RemovePolicy` estiver definido como `release`, a instância ECS é liberada. Valor padrão: release.	release
DecreaseDesiredCapacity	boolean	Não	Especifica se o número esperado de instâncias deve ser modificado. Valores válidos: true: Após as instâncias ECS serem removidas do grupo de escalabilidade, o número esperado de instâncias é reduzido pelo número correspondente. false: Após as instâncias ECS serem removidas do grupo de escalabilidade, o número esperado de instâncias permanece inalterado. Valor padrão: true.	true
IgnoreInvalidInstance	boolean	Não	Especifica se instâncias inválidas devem ser ignoradas ao excluir um lote de instâncias do grupo de escalabilidade. Valores válidos: true: Instâncias inválidas são ignoradas quando um lote de instâncias é excluído do grupo de escalabilidade. Se um lote de instâncias contiver instâncias inválidas (por exemplo, instâncias cujo status é `Pending`), as instâncias válidas são excluídas com sucesso e o status de execução da atividade de escalabilidade é exibido como `Warning`. Você pode visualizar as instâncias inválidas nos detalhes da atividade de escalabilidade. false: Instâncias inválidas não são ignoradas quando um lote de instâncias é excluído do grupo de escalabilidade. Se um lote de instâncias contiver instâncias inválidas, um erro é retornado. Valor padrão: false.	false
InstanceId	array	Sim	O ID da instância ECS a ser removida.	i-28wt4****
	string	Não	O ID da instância ECS a ser removida. Valores válidos de N: 1 a 20.	i-28wt4****
RegionId	string	Não	O ID da região do grupo de escalabilidade.	cn-qingdao
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 único entre diferentes solicitações. O token pode conter apenas caracteres ASCII e não pode exceder 64 caracteres. Para mais informações, consulte Como garantir a idempotência.	123e4567-e89b-12d3-a456-42665544****
StopInstanceTimeout	integer	Não	O período de tempo limite para aguardar a parada de uma instância ECS durante o processo de redução de escala. Unidade: segundos. Valores válidos: 30 a 240. Nota Por padrão, o valor deste parâmetro é herdado do grupo de escalabilidade. Você também pode redefinir este valor ao chamar RemoveInstances. Este parâmetro só tem efeito em processos de redução de escala em que RemovePolicy está definido como release. Se este parâmetro for especificado, o sistema aguarda até o período StopInstanceTimeout para a instância parar. Após o período de tempo limite expirar, o processo de redução de escala continua independentemente de a instância ter sido parada ou não. Se este parâmetro não for especificado, o sistema aguarda até que a instância seja parada antes de continuar o processo de redução de escala. Se a instância não conseguir parar, o processo de redução de escala é revertido e a redução de escala falha.	60
LifecycleHookContext	object	Não	As informações de contexto do lifecycle hook.
DisableLifecycleHook	boolean	Não	Especifica se todos os lifecycle hooks devem ser desabilitados para a atividade de escalabilidade. Valores válidos: true: Desabilitados. false: Não desabilitados.	false
IgnoredLifecycleHookIds	array	Não	A lista de IDs de lifecycle hooks a serem desabilitados para a atividade de escalabilidade.
	string	Não	A lista de IDs de lifecycle hooks a serem desabilitados para a atividade de escalabilidade.	ash-bp14zolna43z266bq***
LifecycleHookResult	string	Não

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
ScalingActivityId	string	O ID da atividade de escalabilidade.	asa-bp175o6f6ego3r2j****
RequestId	string	O ID da solicitação.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
IgnoredInstances	object
IgnoredInstance	array<object>
	object
InstanceId	string
Code	string
Message	string

Exemplos

Resposta de sucesso

JSON formato

{
  "ScalingActivityId": "asa-bp175o6f6ego3r2j****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "IgnoredInstances": {
    "IgnoredInstance": [
      {
        "InstanceId": "",
        "Code": "",
        "Message": ""
      }
    ]
  }
}

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.