Conferir imagens do SO da VM para o Batch

Nesta página, descrevemos como visualizar as imagens do sistema operacional (SO) disponíveis para as instâncias de máquina virtual (VM) que executam jobs do Batch.

Especificamente, esta página descreve como visualizar uma lista e os detalhes das imagens do SO da VM do Batch. Para saber mais sobre as imagens do SO da VM e quais imagens do SO da VM podem ser usadas com o Batch, consulte Visão geral do ambiente do SO da VM. Se você quiser visualizar outras imagens do SO da VM, como imagens públicas do Compute Engine ou imagens personalizadas, consulte a documentação de imagens do Compute Engine.

Antes de começar

  1. Se você nunca usou o Batch, consulte Introdução ao Batch e ative o serviço concluindo os pré-requisitos para projetos e usuários.

Visualizar uma lista de imagens do SO da VM do Batch

É possível visualizar uma lista de todas as imagens do SO da VM do Batch usando a CLI gcloud ou a API Batch.

gcloud

Para listar todas as imagens do SO da VM com suporte do Batch, use o seguinte gcloud compute images list comando:

gcloud compute images list \
    --project=batch-custom-image \
    --no-standard-images
  • A flag --project=batch-custom-image é necessária para listar imagens do Batch.
  • A flag --no-standard-images omite as imagens padrão do Compute Engine.
  • Opcional: se você precisar ver imagens descontinuadas do Batch, inclua também a flag --show-deprecated.

A saída para cada imagem do SO da VM é semelhante a esta:

NAME: IMAGE_NAME
PROJECT: IMAGE_PROJECT_ID
FAMILY: IMAGE_FAMILY
...

Esta saída inclui os seguintes valores:

  • IMAGE_NAME: o nome da imagem. Um nome de imagem representa uma versão específica de uma imagem do SO da VM. Por exemplo, o nome da imagem batch-cos-stable-official-20260730-00-p01 representa a versão de imagem -20260730-00-p01 (a versão de 30 de julho de 2026) para a família de imagens batch-cos-stable-official.
  • IMAGE_PROJECT_ID: o ID do projeto que contém a imagem. Por exemplo, todas as imagens do Batch estão no projeto batch-custom-image.
  • IMAGE_FAMILY: a família da imagem. Uma família de imagens inclui uma ou mais imagens específicas e representa o tipo e a versão principal do SO. Por exemplo, a família de imagens batch-debian-12-official contém imagens do Batch com base na versão 12 do SO de Debian do Compute Engine.

API

Para listar todas as imagens do SO da VM com suporte do Batch, faça a seguinte solicitação ao método images.list:

GET https://compute.googleapis.com/compute/v1/projects/batch-custom-image/global/images?filter=(-deprecated%3A*)%20OR%20(deprecated.state%3D%22ACTIVE%22)
  • O projeto batch-custom-image é necessário para listar imagens do Batch.
  • O parâmetro de consulta ?filter=(-deprecated%3A*)%20OR%20(deprecated.state%3D%22ACTIVE%22) omite imagens descontinuadas usando codificação de URL para definir o campo filter como (-deprecated:*) OR (deprecated.state="ACTIVE").
    • Opcional: se você precisar ver imagens descontinuadas do Batch, remova o parâmetro de consulta ?filter=(-deprecated%3A*)%20OR%20(deprecated.state%20%3D%20%22ACTIVE%22).

A saída para cada imagem do SO da VM é semelhante a esta:

{
  ...
  "name": "IMAGE_NAME",
  ...
  "family": "IMAGE_FAMILY",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/IMAGE_PROJECT_ID/global/images/IMAGE_NAME",
  ...
}

Esta saída inclui os seguintes valores:

  • IMAGE_NAME: o nome da imagem. Um nome de imagem representa uma versão específica de uma imagem do SO da VM. Por exemplo, o nome da imagem batch-cos-stable-official-20260730-00-p01 representa a versão de imagem -20260730-00-p01 (a versão de 30 de julho de 2026) para a família de imagens batch-cos-stable-official.
  • IMAGE_PROJECT_ID: o ID do projeto que contém a imagem. Por exemplo, todas as imagens do Batch estão no projeto batch-custom-image.
  • IMAGE_FAMILY: a família da imagem. Uma família de imagens inclui uma ou mais imagens específicas e representa o tipo e a versão principal do SO. Por exemplo, a família de imagens batch-debian-12-official contém imagens do Batch com base na versão 12 do SO de Debian do Compute Engine.

Visualizar detalhes de uma imagem do SO da VM do Batch

É possível visualizar todos os detalhes de uma imagem do SO da VM usando a CLI gcloud ou a API Batch.

gcloud

Para visualizar os detalhes de uma imagem do SO da VM do Batch, use o gcloud compute images describe comando e especifique batch-custom-image como o projeto de imagem:

gcloud compute images describe IMAGE_NAME --project=batch-custom-image

Substitua IMAGE_NAME pelo nome da imagem do SO da VM do Batch que você quer descrever.

API

Para visualizar os detalhes de uma imagem do SO da VM do Batch, faça uma solicitação ao images.get método e especifique batch-custom-image como o projeto de imagem:

GET https://compute.googleapis.com/compute/v1/projects/batch-custom-image/global/images/IMAGE_NAME

Substitua IMAGE_NAME pelo nome da imagem do SO da VM do Batch que você quer descrever.

A seguir