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.
Os seguintes limites se aplicam a instâncias ECS ou instâncias do Elastic Container Instance (ECI) que você deseja adicionar a um 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 podem pertencer a outro grupo de escalonamento. - O método de pagamento das instâncias deve ser assinatura, pay-as-you-go ou instância spot. - Se o grupo de escalonamento tiver um VswitchID especificado, instâncias ECS ou ECI do tipo de rede Classic não poderão ser adicionadas ao grupo de escalonamento. Instâncias ECS ou ECI em uma VPC diferente também não poderão ser adicionadas ao grupo de escalonamento. - Se o grupo de escalonamento não tiver um VswitchID especificado, instâncias ECS ou ECI do tipo de rede VPC não poderão ser adicionadas ao grupo de escalonamento.
Os seguintes limites se aplicam a instâncias gerenciadas que você deseja adicionar a um 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 pertencem a um grupo de escalonamento podem ser adicionadas a um grupo de escalonamento do tipo ECS.
- As instâncias gerenciadas não suportam hooks de ciclo de vida, associação de balanceamento de carga ou recursos de verificação de integridade.
- Depois que as instâncias gerenciadas são adicionadas a um grupo de escalonamento do tipo 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 de um grupo de escalonamento. As instâncias gerenciadas não são liberadas após serem removidas.
Observe os seguintes itens ao invocar esta operação:
- Quando nenhuma atividade de escalonamento estiver em andamento no grupo de escalonamento, esta operação pode ignorar o tempo de espera (Cooldown) e ser executada imediatamente.
- Uma invocação bem-sucedida indica apenas que o Auto Scaling aceitou a solicitação. A atividade de escalonamento pode ser executada, mas uma invocação bem-sucedida não garante que a atividade de escalonamento será bem-sucedida. Você pode verificar o status de execução da atividade de escalonamento com base no ScalingActivityId retornado.
- Se o número de instâncias especificado nesta operação somado ao número atual de instâncias no grupo de escalonamento (Total Capacity) exceder o tamanho máximo (MaxSize), a invocação falhará.
- Instâncias ECS, instâncias ECI ou instâncias gerenciadas que são adicionadas manualmente ao invocar esta operação não sã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 da instância deve ser delegado ao grupo de escalonamento quando você adiciona manualmente uma instância existente ao grupo de escalonamento. Valores válidos: true: O ciclo de vida da instância é gerenciado pelo Auto Scaling, de forma consistente com as instâncias criadas por meio da criação automática pelo grupo de escalonamento. A instância está sujeita à liberação automática quando é removida do grupo de escalonamento, exceto quando é removida ao invocar a operação DetachInstances. false: O ciclo de vida da instância não é gerenciado pelo grupo de escalonamento. 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 por assinatura, instâncias gerenciadas ou instâncias no estado de modo econômico (parado) dentro do grupo de escalonamento. Valor padrão: false.	false
InstanceId	array	Não	O ID da instância ECS, instância ECI, instância gerenciada ou instância no estado de modo econômico (parado) dentro do grupo de escalonamento que você deseja adicionar. Valores válidos de N: 1 a 20. Exemplos: ID da instância ECS a ser adicionada: i-28wt4**. ID da instância ECI a ser adicionada: eci-bp17gw49eu09yiwm. ID da instância gerenciada a ser adicionada: mi-2cx*. ID da instância no estado de modo econômico (parado) dentro do 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	O ID da instância ECS, instância ECI, instância gerenciada ou instância no estado de modo econômico (parado) dentro do grupo de escalonamento que você deseja adicionar. Valores válidos de N: 1 a 20. Exemplos: ID da instância ECS a ser adicionada: i-28wt4**. ID da instância ECI a ser adicionada: eci-bp17gw49eu09yiwm. ID da instância gerenciada a ser adicionada: mi-2cx*. ID da instância no estado de modo econômico (parado) dentro do 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 da instância de balanceamento de carga. Nota As configurações para este parâmetro não são suportadas para instâncias gerenciadas ou instâncias no estado de modo econômico (parado) dentro do grupo de escalonamento.	50
	integer	Não	O peso da instância ECS ou instância ECI como servidor de back-end da instância de balanceamento de carga. 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 no estado de modo econômico (parado) dentro do grupo de escalonamento. Valor padrão: 50.	50
LifecycleHook	boolean	Não	Especifica se um 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: aciona o hook de ciclo de vida. false: não aciona o hook de ciclo de vida. Nota Este parâmetro não é suportado para instâncias gerenciadas ou instâncias no estado de modo econômico (parado) dentro do 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 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****
IgnoreInvalidInstance	boolean	Não	Especifica se instâncias inválidas devem ser ignoradas ao adicionar um lote de instâncias ao grupo de escalonamento. Valores válidos: true: Instâncias inválidas são ignoradas quando um lote de instâncias é adicionado ao grupo de escalonamento. Se existirem instâncias inválidas e instâncias válidas forem adicionadas com sucesso, o status 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 quando um lote de instâncias é adicionado ao grupo de escalonamento. Se existir qualquer instância inválida 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.