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

Adiciona manualmente instâncias ECS a um grupo de escalonamento.

Descrição da operação

Antes de invocar esta operação, certifique-se de que as seguintes condições sejam atendidas:
- O grupo de escalonamento está no estado Active.
- Nenhuma atividade de escalonamento está em andamento no grupo de escalonamento.
Limites para instâncias ECS ou instâncias Elastic Container Instance (ECI) a serem adicionadas ao grupo de escalonamento:
- As instâncias devem estar na mesma região que o grupo de escalonamento.
- As instâncias devem estar no estado Running.
- As instâncias não devem estar adicionadas a outros grupos de escalonamento.
- O método de faturamento das instâncias deve ser assinatura, pay-as-you-go ou instância spot.
- Se VSwitchId for especificado para o grupo de escalonamento, instâncias ECS ou ECI conectadas à rede clássica e instâncias ECS ou ECI em outras VPCs não poderão ser adicionadas ao grupo de escalonamento.
- Se VSwitchId não for especificado para o grupo de escalonamento, instâncias ECS ou ECI conectadas à VPC não poderão ser adicionadas ao grupo de escalonamento.
Limites para instâncias gerenciadas a serem adicionadas ao grupo de escalonamento:
- As instâncias gerenciadas devem estar na mesma região que o grupo de escalonamento.
- Apenas instâncias gerenciadas que não estão adicionadas a nenhum grupo de escalonamento podem ser adicionadas a um grupo de escalonamento ECS.
- As instâncias gerenciadas não suportam hooks de ciclo de vida, associação com balanceamento de carga ou o recurso de verificação de integridade.
- Depois que as instâncias gerenciadas são adicionadas a um grupo de escalonamento ECS, o grupo de escalonamento não gerencia o ciclo de vida das instâncias gerenciadas.
- As instâncias gerenciadas só podem ser adicionadas ou removidas manualmente do grupo de escalonamento. As instâncias gerenciadas removidas não são liberadas.
Precauções para o uso desta operação:
- Se nenhuma atividade de escalonamento estiver em andamento no grupo de escalonamento, esta operação pode ignorar o tempo de resfriamento e ser executada diretamente.
- Uma resposta bem-sucedida indica apenas que o serviço Auto Scaling aceita a solicitação de invocação e que a atividade de escalonamento pode ser executada. Isso não significa que a atividade de escalonamento será executada com sucesso. Você deve usar o ScalingActivityId retornado para verificar o status de execução da atividade de escalonamento.
- Se a soma do número de instâncias especificadas nesta operação e o número total atual de instâncias no grupo de escalonamento for maior que o número máximo de instâncias permitido, a invocação falhará.
- As instâncias ECS, instâncias ECI ou instâncias gerenciadas adicionadas manualmente por meio desta operação não estão associadas à configuração de escalonamento ativa do grupo de escalonamento.

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

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-bp18p2yfxow2dloq****
Entrusted	boolean	Não	Especifica se o ciclo de vida de uma instância existente deve ser confiado ao grupo de escalonamento quando a instância é adicionada manualmente ao grupo de escalonamento. Valores válidos: true: O ciclo de vida é confiado. O ciclo de vida da instância é gerenciado pelo Auto Scaling, o que é igual ao das instâncias criadas automaticamente pelo grupo de escalonamento. A instância é liberada automaticamente quando é removida do grupo de escalonamento, excluindo as instâncias removidas quando você invoca a operação DetachInstances. false: O ciclo de vida não é confiado. A instância não é liberada quando é removida do grupo de escalonamento. Nota As configurações para este parâmetro não são suportadas para instâncias de assinatura, instâncias gerenciadas ou instâncias paradas no grupo de escalonamento. Valor padrão: false.	false
InstanceId	array	Não	InstanceId.N especifica o ID da instância ECS, instância ECI, instância gerenciada ou instância parada no grupo de escalonamento a ser adicionada. Valores válidos de N: 1 a 20. Exemplos: O ID da instância ECS a ser adicionada é `i-28wt4**`. O ID da instância ECI a ser adicionada é `eci-bp17gw49eu09yiwm`. O ID da instância gerenciada a ser adicionada é `mi-2cx*`. O ID da instância parada no grupo de escalonamento a ser reiniciada é `i-2cd2f`. Nota** Apenas um tipo de instância pode ser processado em uma única solicitação.	i-28wt4****
	string	Não	InstanceId.N especifica o ID da instância ECS, instância ECI, instância gerenciada ou instância parada no grupo de escalonamento a ser adicionada. Valores válidos de N: 1 a 20. Exemplos: O ID da instância ECS a ser adicionada é `i-28wt4**`. O ID da instância ECI a ser adicionada é `eci-bp17gw49eu09yiwm`. O ID da instância gerenciada a ser adicionada é `mi-2cx*`. O ID da instância parada no grupo de escalonamento a ser reiniciada é `i-2cd2f`. Nota** Apenas um tipo de instância pode ser processado em uma única solicitação.	i-28wt4****
LoadBalancerWeight	array	Não	O peso da instância ECS ou instância ECI como servidor de back-end de balanceamento de carga. Nota As configurações para este parâmetro não são suportadas para instâncias gerenciadas ou instâncias paradas no grupo de escalonamento.	50
	integer	Não	LoadBalancerWeight.N especifica o peso da instância ECS ou instância ECI como servidor de back-end do load balancer. Valores válidos de N: 1 a 20. Valores válidos deste parâmetro: 1 a 100. Nota As configurações para este parâmetro não são suportadas para instâncias gerenciadas ou instâncias paradas no grupo de escalonamento. Valor padrão: 50.	50
LifecycleHook	boolean	Não	Especifica se o hook de ciclo de vida de scale-out deve ser acionado quando instâncias são adicionadas ao grupo de escalonamento. Valores válidos: true: Acionado. false: Não acionado. Nota Este parâmetro não é suportado para instâncias gerenciadas ou instâncias paradas no grupo de escalonamento. Valor padrão: false.	false
RegionId	string	Não	O ID da região do grupo de escalonamento.	cn-qingdao
ClientToken	string	Não	O token de cliente usado para garantir a idempotência da solicitação. Você pode gerar o valor a partir do seu cliente para garantir que o valor 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****
IgnoreInvalidInstance	boolean	Não	Especifica se instâncias inválidas devem ser ignoradas quando um lote de instâncias é adicionado ao grupo de escalonamento. Valores válidos: true: Instâncias inválidas são ignoradas. Se existirem instâncias inválidas e instâncias válidas forem adicionadas 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: Instâncias inválidas não são ignoradas. Se existirem instâncias inválidas no lote, a solicitação retornará um erro. Valor padrão: false.	false

Elementos de resposta

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

Exemplos

Resposta de sucesso

JSON formato

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