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

Neste documento, você vai aprender a conferir o número de núcleos de CPU visíveis de 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 um número personalizado. Reduzir o número de núcleos de CPU visíveis de uma VM pode ajudar a diminuir os custos de licenciamento sem redução nos limites de desempenho do Persistent Disk. No entanto, essa redução pode afetar o desempenho da rede.

Antes de começar

  • Configure a autenticação, caso ainda não tenha feito isso. Com isso, você confirma sua identidade para acesso a serviços e APIs do Google Cloud . Para executar código ou exemplos em um ambiente de desenvolvimento local, faça a autenticação no Compute Engine com um destes métodos:

    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 desta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para gcloud CLI.

      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.

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

Papéis necessários

Para receber a permissão necessária e conferir os detalhes de uma VM, peça ao administrador para conceder a você o papel do IAM de 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 receber 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 de uma VM foi personalizado, selecione uma das seguintes opções:

Console

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

    Acessar Instâncias de VM

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

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

  3. Na seção Configuração da máquina, verifique o valor de Núcleos visíveis personalizados. Quando nenhum valor é exibido, isso significa que a VM tem o número padrão de núcleos de CPU visíveis.

gcloud

Para conferir 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á.

Se o número de núcleos de CPU visíveis da VM tiver sido personalizado, a saída vai conter o campo visibleCoreCount, como mostrado aqui:

advancedMachineFeatures:
  visibleCoreCount: VISIBLE_CORE_COUNT
...

Se a saída não tiver 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á.

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

  • VM_NAME: o nome da VM.

Se o número de núcleos de CPU visíveis da VM tiver sido personalizado, a saída vai conter o campo visibleCoreCount, como mostrado aqui:

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

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

A seguir