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

Observações de uso

Antes de chamar a operação DetachInstances, verifique se as seguintes condições foram atendidas:
- O grupo de dimensionamento especificado está habilitado.
- Não há atividades de dimensionamento em andamento no grupo de dimensionamento especificado.
  
  Nota
  Se não houver atividades de dimensionamento em andamento no grupo especificado, a operação ignora o período de resfriamento e aciona imediatamente novas atividades de dimensionamento.
Ao executar esta operação, observe os pontos abaixo:
- Após remover uma instância ECS, uma instância de contêiner elástico ou uma instância de terceiros gerenciada pela Alibaba Cloud do grupo de dimensionamento, a instância passa a operar de forma independente. Você também pode chamar a operação AttachInstances para adicioná-la a outro grupo de dimensionamento.
- A remoção de uma instância ECS, instância de contêiner elástico ou instância de terceiros gerenciada pela Alibaba Cloud por meio desta operação não interrompe nem libera a instância.
- Uma chamada bem-sucedida indica apenas que o Auto Scaling aceitou a solicitação, mas não garante o êxito da atividade de dimensionamento. Consulte o valor retornado em ScalingActivityId para verificar o status da atividade.
- Depois de remover um determinado número de instâncias ECS, instâncias de contêiner elástico ou instâncias de terceiros gerenciadas pela Alibaba Cloud, a quantidade restante deve ser igual ou superior ao número mínimo de instâncias definido para o grupo. Caso contrário, a operação falhará e um erro será reportado.

Depuração

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

Parâmetros da solicitação

Parameter	Type	Required	Example	Description
Action	String	Yes	DetachInstances	A operação a ser executada. Defina o valor como DetachInstances.
ScalingGroupId	String	Yes	asg-bp1igpak5ft1flyp****	O ID do grupo de dimensionamento.
DecreaseDesiredCapacity	Boolean	No	true	Define se o número esperado de instâncias no grupo de dimensionamento deve ser modificado. Valores válidos: true: após chamar esta operação para remover um número específico de instâncias ECS, instâncias de contêiner elástico ou instâncias de terceiros gerenciadas pela Alibaba Cloud do grupo especificado, o número esperado de instâncias diminui. false: após chamar esta operação para remover um número específico de instâncias ECS, instâncias de contêiner elástico ou instâncias de terceiros gerenciadas pela Alibaba Cloud do grupo especificado, o número esperado de instâncias permanece inalterado. Valor padrão: true.
IgnoreInvalidInstance	Boolean	No	false	Indica se instâncias inválidas devem ser ignoradas ao remover um lote de instâncias do grupo de dimensionamento. Valores válidos: true: ignora instâncias inválidas. Se o lote incluir instâncias inválidas, como aquelas no estado `Adding`, e as instâncias válidas forem removidas com sucesso, 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 incluir instâncias inválidas, como aquelas no estado `Adding`, um erro será reportado. Valor padrão: false.
DetachOption	String	No	both	Determina se as instâncias ECS ou de contêiner elástico devem ser removidas dos grupos de servidores padrão e vServer groups das instâncias do Server Load Balancer (SLB) associadas, e se seus endereços IP privados devem ser removidos das listas de permissões de endereços IP das instâncias do ApsaraDB RDS associadas. Se você definir este parâmetro como both, as instâncias serão removidas dos grupos de servidores padrão e vServer groups das instâncias SLB associadas, e seus endereços IP serão removidos das listas de permissões de endereços IP das instâncias do ApsaraDB RDS associadas. Nota Este parâmetro não está disponível quando esta operação é chamada para remover um número específico de instâncias de terceiros gerenciadas pela Alibaba Cloud do grupo de dimensionamento.
InstanceId.N	String	No	i-bp109k5j3dum1ce6****	O ID da instância ECS N, instância de contêiner elástico N ou instância de terceiros gerenciada pela Alibaba Cloud N que você deseja remover do grupo de dimensionamento. Valores válidos de N: 1 a 20. Exemplos: Exemplo de ID de instância ECS: `i-bp109k5j3dum1ce6**`. Exemplo de ID de instância de contêiner elástico: `eci-bp17gw49eu09yiwm`. Exemplo de ID de instância gerenciada: `mi-d23fsd`. Nota** Esta operação permite remover apenas instâncias do mesmo tipo por vez.
LifecycleHook	Boolean	No	false	Especifica se um hook de ciclo de vida deve ser acionado ao chamar esta operação. Valores válidos: true false Nota Este parâmetro não está disponível quando esta operação é chamada para remover um número específico de instâncias de terceiros gerenciadas pela Alibaba Cloud do grupo de dimensionamento. Valor padrão: false.
ClientToken	String	No	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 ele seja exclusivo entre diferentes solicitações. O token pode conter apenas caracteres ASCII e não deve exceder 64 caracteres. Para mais informações, consulte Garantir idempotência.

Parâmetros de resposta

Parameter	Type	Example	Description
ScalingActivityId	String	asa-bp1gbswjhjrw8tko****	O ID da atividade de dimensionamento.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****	O ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://ess.aliyuncs.com/?Action=DetachInstances
&ScalingGroupId=asg-bp1igpak5ft1flyp****
&DecreaseDesiredCapacity=true
&IgnoreInvalidInstance=false
&DetachOption=both
&InstanceId=["i-bp109k5j3dum1ce6****"]
&LifecycleHook=false
&ClientToken=123e4567-e89b-12d3-a456-42665544****
&<Common request parameters>

Exemplos de respostas de sucesso

XML formato

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

<DetachInstancesResponse>
    <ScalingActivityId>asa-bp1gbswjhjrw8tko****</ScalingActivityId>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</DetachInstancesResponse>

JSON formato

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

{
  "ScalingActivityId" : "asa-bp1gbswjhjrw8tko****",
  "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.

HTTP status code	Error code	Error message	Description
400	IncorrectScalingGroupStatus	The current status of the specified scaling group does not support this action.	O grupo de dimensionamento especificado não está habilitado.
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.	Existe uma atividade de dimensionamento em andamento no grupo de dimensionamento especificado.
400	IncorrectLoadBalancerStatus	The current status of the specified load balancer does not support this action.	A instância SLB especificada não está no estado Active.
400	IncorrectDBInstanceStatus	The current status of DB instance "XXX" does not support this action.	A instância do ApsaraDB RDS especificada não está no estado Running.
400	IncorrectCapacity.MinSize	To remove the instances, the total capacity will be lesser than the MinSize.	O número de instâncias ECS ou de contêiner elástico no grupo de dimensionamento ficaria inferior ao valor de MinSize caso a quantidade especificada de instâncias fosse removida.
403	Forbidden.Unauthorized	A required authorization for the specified action is not supplied.	Você não tem autorização para chamar esta operaçã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 ou de contêiner elástico especificada não existe na conta Alibaba Cloud.