Gerenciamento de instâncias em lote

Função

• Adicionar ou remover instâncias de ou para um grupo de AS em lotes.
• Configurar a proteção de instância ou cancelar a configuração das instâncias em um grupo de AS em lotes.
• Definir o modo de espera ou cancelar a configuração para as instâncias em um grupo de AS em lotes.

• Uma operação em lote pode ser executada em um máximo de 50 instâncias por vez. Depois que as instâncias são adicionadas a um grupo de AS, o número de instâncias no grupo de AS não pode ser maior que o número máximo de instâncias. Depois que as instâncias são removidas de um grupo de AS, o número de instâncias no grupo de AS não pode ser menor que o número mínimo de instâncias.
• As instâncias podem ser adicionadas a um grupo de AS somente quando o grupo de AS estiver no estado INSERVICE e não tiver nenhuma ação de dimensionamento em andamento.
• Você pode remover instâncias de um grupo de AS somente quando nenhuma ação de dimensionamento estiver em andamento.
• Para adicionar instâncias a um grupo de AS, verifique se a AZ das instâncias está dentro do grupo de AS.
• Somente instâncias no estado INSERVICE podem ser removidas de um grupo de AS. A proteção de instância pode ser ativada ou desativada somente para instâncias INSERVICE.
• Quando a capacidade de um grupo de AS é automaticamente diminuída, as instâncias com proteção de instância ativada não serão removidas do grupo de AS.
• Se o ouvinte vinculado à instância a ser removida for o mesmo que o ouvinte no grupo de AS, o ouvinte será desvinculado da instância. Se o ouvinte vinculado à instância a ser removida for diferente do ouvinte no grupo de AS, o relacionamento de vinculação entre o ouvinte e a instância será reservado.

URI

POST /autoscaling-api/v1/{project_id}/scaling_group_instance/{scaling_group_id}/action

Mensagem de solicitação

• Parâmetros de solicitação

  Tabela 2 Parâmetros de solicitação

  Parâmetro	Obrigatório	Tipo	Descrição
  instances_id	Sim	Array of strings	Especifica o ID de ECS.
  instance_delete	Não	String	Especifica se uma instância deve ser excluída quando ela for removida de um grupo de AS. Opções: no (padrão): a instância não será excluída. yes: a instância será excluída. Este parâmetro tem efeito somente quando action é definida como REMOVE.
  instance_append	Não	String	Especifica se devem ser adicionadas novas instâncias quando determinadas instâncias existentes entrarem no modo de espera. Opções: no (padrão): nenhuma nova instância será adicionada. yes: novas instâncias serão adicionadas. Este parâmetro tem efeito somente quando action é definida como ENTER_STANDBY.
  action	Sim	String	Especifica uma ação a ser executada em instâncias em lotes. As opções são as seguintes: ADD: adiciona instâncias ao grupo de AS. REMOVE: remove instâncias do grupo de AS. PROTECT: ativa a proteção de instâncias. UNPROTECT: desativa a proteção da instância. ENTER_STANDBY: define as instâncias para o modo de espera. EXIT_STANDBY: cancela o modo de espera para instâncias.

• Exemplo de solicitação
  Este exemplo mostra como remover e excluir instâncias com os IDs instance_id_1 e instance_id_2 do grupo de AS com o ID e5d27f5c-dd76-4a61-b4bc-a67c5686719a em um lote.

  POST https://{Endpoint}/autoscaling-api/v1/{project_id}/scaling_group_instance/e5d27f5c-dd76-4a61-b4bc-a67c5686719a/action
  
  {
      "action": "REMOVE",
      "instances_id": [
          "instance_id_1",
          "instance_id_2"
      ],
      "instance_delete": "yes"
  }

Mensagem de resposta

• Parâmetros de resposta

  Nenhum

• Exemplo de resposta

  Nenhum

Valores retornados

• Normal

  204

• Anormal

  Valores retornados	Descrição
  400 Bad Request	O servidor falhou ao processar a solicitação.
  401 Unauthorized	Você deve digitar o nome de usuário e a senha para acessar a página solicitada.
  403 Forbidden	Você está proibido de acessar a página solicitada.
  404 Not Found	O servidor não conseguiu encontrar a página solicitada.
  405 Method Not Allowed	Você não tem permissão para usar o método especificado na solicitação.
  406 Not Acceptable	A resposta gerada pelo servidor não poderia ser aceita pelo cliente.
  407 Proxy Authentication Required	Você deve usar o servidor proxy para autenticação para que a solicitação possa ser processada.
  408 Request Timeout	A solicitação expirou o tempo limite.
  409 Conflict	A solicitação não pôde ser processada devido a um conflito.
  500 Internal Server Error	Falhou ao concluir a solicitação porque ocorre um erro de serviço interno.
  501 Not Implemented	Falhou ao concluir a solicitação porque o servidor não suporta a função solicitada.
  502 Bad Gateway	Falhou ao concluir a solicitação porque a solicitação é inválida.
  503 Service Unavailable	Falhou ao concluir a solicitação porque o sistema não está disponível.
  504 Gateway Timeout	Ocorreu um erro de tempo limite de gateway.

Códigos de erro

Consulte Códigos de erro.