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

Adiciona manualmente instâncias a um grupo de escalonamento. Você pode adicionar instâncias ECS, instâncias do Elastic Container Instance (ECI) ou instâncias gerenciadas fora do grupo de escalonamento ao grupo de escalonamento e colocá-las em serviço. Você também pode reiniciar instâncias ECS no grupo de escalonamento que estão no Modo econômico para o estado Running e colocá-las em serviço.

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 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 um ID de vSwitch for especificado para o grupo de escalonamento, instâncias ECS ou ECI conectadas à rede clássica, ou instâncias ECS ou ECI em outras VPCs não poderão ser adicionadas ao grupo de escalonamento.
- Se nenhum ID de vSwitch 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 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.
- 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.
- Instâncias gerenciadas só podem ser adicionadas ou removidas manualmente do grupo de escalonamento. 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 período de cooldown e ser executada diretamente.
- Uma resposta bem-sucedida indica apenas que o Auto Scaling aceitou a solicitação da invocação da operaçã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 atual de instâncias no grupo de escalonamento (Capacidade Total) for maior que o número máximo de instâncias (MaxSize), a invocação da operação falhará.
- 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 delegado ao grupo de escalonamento quando a instância é adicionada manualmente ao grupo de escalonamento. Valores válidos: true: Delegado. 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 (exceto instâncias removidas quando você invoca a operação DetachInstances). false: Não delegado. A instância não é liberada quando é removida do grupo de escalonamento. Nota Este parâmetro não é suportado para instâncias de assinatura, instâncias gerenciadas e instâncias no Modo econômico no grupo de escalonamento. Valor padrão: false.	false
InstanceIds	array	Não	Os IDs das instâncias ECS, instâncias ECI, instâncias gerenciadas ou instâncias no Modo econômico no grupo de escalonamento a serem adicionadas.
	string	Não	ID da instância ECS, instância ECI, instância gerenciada ou instância no Modo econômico no grupo de escalonamento a ser adicionada. 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 no Modo econômico no grupo de escalonamento a ser reiniciada é i-2cd2f. Nota** Apenas um tipo de instância pode ser processado em uma única chamada.	i-28wt4****
LoadBalancerWeights	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.
	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: 1 a 100. Nota Este parâmetro não é suportado para instâncias gerenciadas e instâncias no Modo econômico 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 e instâncias no Modo econômico 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	Garante a idempotência da solicitação. Você pode gerar um valor de parâmetro a partir do seu cliente para garantir que o valor seja exclusivo entre diferentes solicitações. O valor 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 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 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 quando um lote de instâncias é adicionado ao grupo de escalonamento. Se existirem instâncias inválidas no lote, um erro será reportado. 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-A3DC0DE****

Exemplos

Resposta de sucesso

JSON formato

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

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.