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

Remove uma ou mais instâncias de um grupo de dimensionamento. Se o grupo de dimensionamento estiver ativado e não houver atividades de dimensionamento em andamento, você pode chamar a operação RemoveInstances para remover instâncias que não são mais necessárias do grupo de dimensionamento.

Observações de uso

Antes de chamar esta operação, verifique se os seguintes requisitos foram atendidos:
- O grupo de dimensionamento está no estado Active.
- O grupo de dimensionamento não possui atividades de dimensionamento em andamento.

Se o grupo de dimensionamento não tiver atividades de dimensionamento em andamento, você pode chamar a operação mesmo durante o período de resfriamento.

Se uma instância Elastic Compute Service (ECS) foi criada automaticamente pelo Auto Scaling ou se uma instância ECS foi adicionada manualmente a um grupo de dimensionamento e gerenciada por ele, a instância ECS entra no Modo Econômico ou é liberada quando removida do grupo de dimensionamento.
Se uma instância ECS foi adicionada manualmente a um grupo de dimensionamento e não é gerenciada por ele, a instância ECS não é parada nem liberada quando removida do grupo de dimensionamento.
Se a diferença entre o número de instâncias ECS existentes especificado por TotalCapacity e o número de instâncias ECS que você deseja remover for menor que o valor de MinSize, a chamada falhará.

Uma chamada bem-sucedida indica apenas que o Auto Scaling aceitou a solicitação. Isso não garante o sucesso da atividade de dimensionamento. Você pode obter o status de uma atividade de dimensionamento com base no valor de ScalingActivityId na resposta.

Depuração

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

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	RemoveInstances	A operação que você deseja executar. Defina o valor como RemoveInstances.
ScalingGroupId	String	Sim	asg-bp18p2yfxow2dloq****	O ID do grupo de dimensionamento.
RemovePolicy	String	Não	release	A ação que o Auto Scaling deve executar após a remoção das instâncias ECS do grupo de dimensionamento. Valores válidos: recycle: coloca as instâncias ECS no Modo Econômico. Nota Essa configuração só terá efeito se você definir `ScalingPolicy` como `recycle`. release: libera as instâncias ECS. `ScalingPolicy` na operação CreateScalingGroup especifica o modo de recuperação do grupo de dimensionamento. `RemovePolicy` na operação RemoveInstances especifica a ação específica sobre uma instância quando ela é removida. Exemplos: Se você definir `ScalingPolicy` e `RemovePolicy` como `recycle`, as instâncias ECS serão colocadas no Modo Econômico quando removidas. Se você definir `ScalingPolicy` como `recycle` e `RemovePolicy` como `release`, as instâncias ECS serão liberadas quando removidas. Se você definir `ScalingPolicy` como `release` e `RemovePolicy` como `recycle`, as instâncias ECS serão liberadas quando removidas. Se você definir `ScalingPolicy` e `RemovePolicy` como `release`, as instâncias ECS serão liberadas quando removidas. Valor padrão: release.
DecreaseDesiredCapacity	Boolean	Não	true	Especifica se o número esperado de instâncias ECS no grupo de dimensionamento deve ser modificado. Valores válidos: true: Após a remoção das instâncias ECS do grupo de dimensionamento, o número esperado de instâncias ECS no grupo diminui. false: Após a remoção das instâncias ECS do grupo de dimensionamento, o número esperado de instâncias ECS no grupo permanece inalterado. Valor padrão: true.
IgnoreInvalidInstance	Boolean	Não	false	Especifica se instâncias inválidas devem ser ignoradas quando um lote de instâncias é removido do grupo de dimensionamento. Valores válidos: true: ignora instâncias inválidas. Se o lote de instâncias incluir instâncias inválidas, como instâncias no estado `Adding`, e as instâncias válidas forem removidas com sucesso do grupo de dimensionamento, a atividade de dimensionamento correspondente entrará no estado `Warning`. Acesse a página de detalhes da atividade de dimensionamento para visualizar as instâncias inválidas. false: não ignora instâncias inválidas. Se o lote de instâncias incluir instâncias inválidas, como instâncias no estado Adding, um erro será reportado. Valor padrão: false.
InstanceId.N	String	Não	i-28wt4****	O ID da instância ECS N que você deseja excluir. Valores válidos de N: 1 a 20.
RegionId	String	Não	cn-qingdao	O ID da região onde o grupo de dimensionamento está localizado.
ClientToken	String	Não	123e4567-e89b-12d3-a456-42665544****	O token de cliente usado para garantir a idempotência da solicitação. Use 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. Para mais informações, consulte Garantir idempotência.
StopInstanceTimeout	Integer	Não	60	O período de tempo necessário para que cada instância ECS entre no estado Stopped durante o processo de redução de escala. Unidade: segundos. Valores válidos: 30 a 240. Nota Por padrão, este parâmetro herda o valor especificado para o grupo de dimensionamento. Também é possível alterar o valor ao chamar a operação RemoveInstances. Este parâmetro só tem efeito se você definir RemovePolicy como release. Se você especificar este parâmetro, o sistema prosseguirá com o processo de redução de escala somente após o término do período de tempo especificado por StopInstanceTimeout. Nesse caso, a operação de redução de escala continua independentemente de a instância ECS ter entrado no estado Stopped. Se você não especificar este parâmetro, o sistema prosseguirá com o processo de redução de escala somente após a instância ECS entrar no estado Stopped. Se a instância ECS não conseguir entrar no estado Stopped, o processo de redução de escala será revertido e a operação de redução de escala será considerada com falha.
LifecycleHookContext	Object	Não		O contexto do hook de ciclo de vida.
DisableLifecycleHook	Boolean	Não	false	Especifica se o recurso de hook de ciclo de vida deve ser desativado. Valores válidos: true false
IgnoredLifecycleHookIds	Array of String	Não	ash-bp14zolna43z266bq***	Os IDs dos hooks de ciclo de vida que você deseja desativar.

Parâmetros da resposta

Parâmetro	Tipo	Exemplo	Descrição
ScalingActivityId	String	asa-bp175o6f6ego3r2j****	O ID da atividade de dimensionamento.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****	O ID da solicitação.

Exemplos

Solicitações de exemplo

http(s)://ess.aliyuncs.com/?Action=RemoveInstances
&ScalingGroupId=asg-bp18p2yfxow2dloq****
&RemovePolicy=release
&DecreaseDesiredCapacity=true
&IgnoreInvalidInstance=false
&InstanceId=["i-28wt4****"]
&RegionId=cn-qingdao
&ClientToken=123e4567-e89b-12d3-a456-42665544****
&<Common request parameters>

Respostas de sucesso de exemplo

XML formato

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

<RemoveInstancesResponse>
    <ScalingActivityId>asa-bp175o6f6ego3r2j****</ScalingActivityId>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</RemoveInstancesResponse>

JSON formato

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

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

Códigos de erro

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
404	InvalidScalingGroupId.NotFound	The specified scaling group does not exist.	O grupo de dimensionamento especificado não existe na conta Alibaba Cloud.
404	InvalidInstanceId.NotFound	Instance "XXX" does not exist.	A instância ECS especificada não existe no grupo de dimensionamento.
400	InvalidParameter	The specified group does not support the specified RemovePolicy.	O grupo de dimensionamento especificado não suporta a configuração RemovePolicy.
403	Forbidden.Unauthorized	A required authorization for the specified action is not supplied.	O Auto Scaling não está autorizado a chamar a operação.
400	IncorrectScalingGroupStatus	The current status of the specified scaling group does not support this action.	O grupo de dimensionamento não está no estado Active.
400	ScalingActivityInProgress	You cannot delete a scaling group or launch a new scaling activity while there is a scaling activity in progress for the specified scaling group.	O grupo de dimensionamento possui uma atividade de dimensionamento em andamento.
400	IncorrectLoadBalancerStatus	The current status of the specified load balancer does not support this action.	A instância Server Load Balancer (SLB) do grupo de dimensionamento ao qual a regra de dimensionamento especificada pertence não está no estado Active.
400	IncorrectDBInstanceStatus	The current status of DB instance "XXX" does not support this action.	A instância ApsaraDB RDS do grupo de dimensionamento ao qual a regra de dimensionamento especificada pertence não está no estado Running.
400	IncorrectCapacity.MinSize	To remove the instances, the total capacity will be lesser than the MinSize.	A diferença entre o número de instâncias ECS existentes especificado por TotalCapacity e o número de instâncias ECS que você especificou para remover é menor que o valor de MinSize.