Ver o número de núcleos de CPU visíveis

Este documento descreve como conferir o número de núcleos de CPU visíveis para uma instância de máquina virtual (VM).

Ao acessar os detalhes de uma VM, é possível verificar se ela tem o número padrão de núcleos de CPU visíveis ou se esse número foi personalizado. Reduzir o número de núcleos de CPU visíveis para uma VM pode ajudar a reduzir os custos de licenciamento sem reduzir os limites de desempenho do disco persistente. No entanto, reduzir o número de núcleos de CPU visíveis pode afetar o desempenho da rede.

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 Google Cloud. Para executar códigos ou amostras de um ambiente de desenvolvimento local, autentique-se no Compute Engine da seguinte maneira.

    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. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. REST

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

        Install the Google Cloud CLI, then initialize it by running the following command: 

        gcloud init

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

Funções exigidas

Para receber a permissão necessária para conferir os detalhes de uma VM, peça ao administrador para conceder a você o papel do IAM Administrador da instância do Compute (v1) (roles/compute.instanceAdmin.v1) na VM ou no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esse papel predefinido contém a permissão compute.instances.get, que é necessária para conferir os detalhes de uma VM.

Também é possível conseguir essa permissão com papéis personalizados ou outros papéis predefinidos.

Conferir o número de núcleos de CPU visíveis de uma VM

Para determinar se o número de núcleos de CPU visíveis foi personalizado para uma VM, selecione uma das seguintes opções:

Console

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

    Acessar instâncias de VM

  2. Na coluna Nome, clique no nome da VM.

    A página de detalhes da VM é aberta e a guia Detalhes é selecionada.

  3. Na seção Configuração da máquina, verifique o valor de Cores visíveis personalizadas. Se nenhum valor for exibido, a VM terá o número padrão de núcleos de CPU visíveis.

gcloud

Para ver os detalhes da VM, use o comando gcloud compute instances describe.

gcloud compute instances describe VM_NAME \
    --zone=ZONE

Substitua:

  • VM_NAME: o nome da VM.

  • ZONE: a zona em que a VM está localizada.

Se o número de núcleos de CPU visíveis para a VM foi personalizado, a saída conterá o campo visibleCoreCount da seguinte maneira:

advancedMachineFeatures:
  visibleCoreCount: VISIBLE_CORE_COUNT
...

Se a saída não contiver o campo visibleCoreCount, a VM terá o número padrão de núcleos de CPU visíveis.

REST

Para conferir os detalhes da VM, faça uma solicitação GET para o método instances.get.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME

Substitua:

  • PROJECT_ID: o ID do projeto em que a VM está localizada.

  • ZONE: a zona em que a VM está localizada.

  • VM_NAME: o nome da VM.

Se o número de núcleos de CPU visíveis para a VM foi personalizado, a saída conterá o campo visibleCoreCount da seguinte maneira:

{
  ...
  "advancedMachineFeatures": {
    visibleCoreCount: VISIBLE_CORE_COUNT
  },
  ...
}

Se a saída não contiver o campo visibleCoreCount, a VM terá o número padrão de núcleos de CPU visíveis.

A seguir