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 é o processo de verificação da sua identidade para acesso a serviços e APIs do Trusted Cloud by S3NS . 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 Trusted Cloud console to access Trusted Cloud by S3NS services and APIs, you don't need to set up authentication.

    gcloud

    1. Instale a Google Cloud CLI e faça login nela com sua identidade federada. Depois de fazer login, inicialize a Google Cloud CLI executando o seguinte comando:

      gcloud init
    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 Google Cloud CLI e faça login nela com sua identidade federada. Depois de fazer login, inicialize a Google Cloud CLI executando o seguinte comando:

      gcloud init

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

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

Console

  1. No console Trusted 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 de 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 Trusted 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