Ver a flexibilidade da instância

Este documento descreve como visualizar a configuração de flexibilidade da 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 da instância em um MIG, você pode fazer o seguinte:

Antes de começar

  • Configure a autenticação, caso ainda não tenha feito isso. Com isso, você confirma sua identidade para acesso a Google Cloud serviços e APIs do. Para executar código ou amostras de um ambiente de desenvolvimento local, faça a autenticação no Compute Engine com uma destas opções:

    Selecione a guia para como planeja usar as amostras nesta página:

    Console

    Quando você usa o Google Cloud console para acessar Google Cloud serviços e APIs, não é necessário configurar a autenticação.

    gcloud

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

      gcloud init

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

  • Defina uma região e uma zona padrão.

    • REST

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

      Instale a Google Cloud CLI.

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

    Saiba mais em Autenticar para usar REST na documentação de autenticação do Google Cloud .

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

Console

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

    Acesse grupo de instâncias

  2. Na coluna Nome, clique no nome do MIG do qual você quer visualizar 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 da instância configurada, a seção Flexibilidade da instância não será mostrada.

gcloud

Para visualizar a configuração de flexibilidade da instância, use o instance-groups managed describe comando. 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 da instância configurada, a saída retornará null.

Substitua:

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

REST

Para visualizar a configuração de flexibilidade da instância, use o regionInstanceGroupManagers.get método. 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 da instância configurada, a saída 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 do qual você quer visualizar a configuração de flexibilidade da instância.

Visualizar os tipos de máquina usados por cada VM

Console

  1. No console, do 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 visualizar 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 visualizar os tipos de máquina usados por cada VM em um MIG, liste as VMs usando o instance-groups managed list-instances comando e inclua a --format flag para filtrar o propertiesFromFlexibilityPolicy.machineType campo. 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 do qual você quer visualizar a configuração de flexibilidade da instância.

REST

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

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

Confira 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 do qual você quer visualizar a configuração de flexibilidade da instância.

A seguir