Conferir a flexibilidade da instância

Neste documento, descrevemos como conferir a configuração de flexibilidade de instância em um grupo gerenciado de instâncias (MIG) e os tipos de máquina usados por cada VM no grupo.

Depois de adicionar ou fazer mudanças na flexibilidade de instâncias em um MIG, você pode fazer o seguinte:

Antes de começar

  • Configure a autenticação, caso ainda não tenha feito isso. A autenticação verifica sua identidade para acesso a serviços e APIs do Google Cloud . Para executar códigos ou amostras de um ambiente de desenvolvimento local, autentique-se no Compute Engine selecionando uma das seguintes opções:

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    1. Instale a CLI do Google Cloud. Após a instalação, inicialize a CLI do Google Cloud executando o seguinte comando: 

      gcloud init

      Ao usar um provedor de identidade (IdP) externo, primeiro faça login na gcloud CLI com sua identidade federada.

    2. Set a default region and zone.

    REST

    Para usar as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para a CLI gcloud.

      Instale a CLI do Google Cloud. Após a instalação, inicialize a CLI do Google Cloud executando o seguinte comando: 

      gcloud init

      Ao usar um provedor de identidade (IdP) externo, primeiro faça login na gcloud CLI com sua identidade federada.

    Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Google Cloud .

Conferir a configuração de flexibilidade da instância

Console

  1. No console Google Cloud , acesse a página Grupos de instâncias.

    Acesse grupo de instâncias

  2. Na coluna Nome, clique no nome do MIG de que você quer ver a configuração de flexibilidade da instância.

    A página de visão geral do MIG será aberta.

  3. Clique na guia Detalhes.

    Na seção Flexibilidade da instância, a tabela Seleções de instância mostra o nome, a classificação e os tipos de máquina em uma seleção. Se o MIG não tiver a flexibilidade de instância configurada, a seção Flexibilidade de instância não será mostrada.

gcloud

Para conferir a configuração de flexibilidade de instância, use o comando instance-groups managed describe. Inclua a flag --format para filtrar as propriedades instanceFlexibilityPolicy.instanceSelections.

  gcloud compute instance-groups managed describe INSTANCE_GROUP_NAME \
      --region REGION \
      --format="json(instanceFlexibilityPolicy.instanceSelections)"

Veja um exemplo de saída:

{
  "instanceFlexibilityPolicy": {
    "instanceSelections": {
      "instance-selection-1": {
        "machineTypes": [
          "n1-standard-16",
          "n2-standard-16",
          "e2-standard-16"
        ],
        "rank": 1
      }
    }
  }
}

Se um MIG não tiver a flexibilidade de instância configurada, a saída vai retornar null.

Substitua:

  • INSTANCE_GROUP_NAME: o nome do MIG de que você quer ver a configuração de flexibilidade de instância.
  • REGION: a região em que o MIG está localizado.

REST

Para conferir a configuração de flexibilidade da instância, use o método regionInstanceGroupManagers.get. Inclua o parâmetro fields no URL da solicitação para filtrar as propriedades instanceFlexibilityPolicy.instanceSelections.

  GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME?fields=instanceFlexibilityPolicy.instanceSelections

Veja um exemplo de saída:

{
  "instanceFlexibilityPolicy": {
    "instanceSelections": {
      "instance-selection-1": {
        "machineTypes": [
          "n1-standard-16",
          "n2-standard-16",
          "e2-standard-16"
        ],
        "rank": 1
      }
    }
  }
}

Se um MIG não tiver a flexibilidade de instância configurada, a saída vai retornar null.

Substitua:

  • PROJECT_ID: o ID do projeto.
  • REGION: a região em que o MIG está localizado.
  • INSTANCE_GROUP_NAME: o nome do MIG de que você quer ver a configuração de flexibilidade de instância.

Ver os tipos de máquinas usados por cada VM

Console

  1. No console Google Cloud , acesse a página Grupos de instâncias.

    Acesse grupo de instâncias

  2. Na coluna Nome, clique no nome do MIG em que você quer ver os tipos de máquina usados por cada VM.

    A página Visão geral do MIG é aberta, listando todas as VMs no grupo, os tipos de máquina e outros detalhes.

gcloud

Para conferir os tipos de máquinas usados por cada VM em um MIG, liste as VMs usando o comando instance-groups managed list-instances e inclua a flag --format para filtrar o campo propertiesFromFlexibilityPolicy.machineType. Você também pode filtrar outros campos conforme necessário.

  gcloud compute instance-groups managed list-instances INSTANCE_GROUP_NAME \
      --region REGION \
      --format='(name,instanceStatus,currentAction,propertiesFromFlexibilityPolicy.machineType,lastAttempt.errors.errors)'

Veja um exemplo de saída:

NAME: example-mig-0md2
STATUS: RUNNING
ACTION: NONE
MACHINE_TYPE: n1-standard-16
LAST_ERROR:

NAME: example-mig-vbgg
STATUS: RUNNING
ACTION: NONE
MACHINE_TYPE: n1-standard-16
LAST_ERROR:

Substitua:

  • REGION: a região em que o MIG está localizado.
  • INSTANCE_GROUP_NAME: o nome do MIG de que você quer ver a configuração de flexibilidade de instância.

REST

Para conferir os tipos de máquina usados por cada VM em um MIG, liste as VMs usando o método listManagedInstances e verifique o campo propertiesFromFlexibilityPolicy.machineType na resposta.

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME/listManagedInstances

Confira a seguir um exemplo de saída. Procure o campo propertiesFromFlexibilityPolicy em que o campo machineType de uma VM está definido.

{
  "managedInstances": [
    {
      "instance": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-b/instances/example-mig-0md2",
      "instanceStatus": "RUNNING",
      "id": "2656095434923471959",
      "version": {
        "instanceTemplate": "https://www.googleapis.com/compute/v1/projects/example-project/global/instanceTemplates/example-instance-template"
      },
      "targetStatus": "RUNNING",
      "name": "example-mig-0md2",
      "propertiesFromFlexibilityPolicy": {
        "machineType": "n1-standard-16"
      }
    },
    {
      "instance": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-b/instances/example-mig-vbgg",
      "instanceStatus": "RUNNING",
      "currentAction": "NONE",
      "id": "9171259522409694366",
      "version": {
        "instanceTemplate": "https://www.googleapis.com/compute/v1/projects/example-project/global/instanceTemplates/example-instance-template"
      },
      "targetStatus": "RUNNING",
      "name": "example-mig-vbgg",
      "propertiesFromFlexibilityPolicy": {
        "machineType": "n1-standard-16"
      }
    }
  ]
}

Substitua:

  • PROJECT_ID: o ID do projeto.
  • REGION: a região em que o MIG está localizado.
  • INSTANCE_GROUP_NAME: o nome do MIG de que você quer ver a configuração de flexibilidade de instância.

A seguir