Para ver um resumo das VMs em execução no projeto, receba uma lista de VMs. Neste documento, mostramos como receber uma lista de VMs em todas as zonas ou em zonas específicas.
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
-
Instale a Google Cloud CLI e faça login CLI gcloud com sua identidade federada. Depois de fazer login, inicialize a Google Cloud CLI executando o seguinte comando:
gcloud init
- Set a default region and zone.
Go
Para usar os exemplos Go desta página em um ambiente de desenvolvimento local, instale e inicialize a CLI gcloud e configure o Application Default Credentials com suas credenciais de usuário.
Instale a Google Cloud CLI e faça login CLI gcloud com sua identidade federada.
Create local authentication credentials for your user account:
gcloud auth application-default login
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
Confira mais informações em Set up authentication for a local development environment.
Java
Para usar os exemplos Java desta página em um ambiente de desenvolvimento local, instale e inicialize a CLI gcloud e configure o Application Default Credentials com suas credenciais de usuário.
Instale a Google Cloud CLI e faça login CLI gcloud com sua identidade federada.
Create local authentication credentials for your user account:
gcloud auth application-default login
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
Confira mais informações em Set up authentication for a local development environment.
Node.js
Para usar os exemplos Node.js desta página em um ambiente de desenvolvimento local, instale e inicialize a CLI gcloud e configure o Application Default Credentials com suas credenciais de usuário.
Instale a Google Cloud CLI e faça login CLI gcloud com sua identidade federada.
Create local authentication credentials for your user account:
gcloud auth application-default login
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
Confira mais informações em Set up authentication for a local development environment.
Python
Para usar os exemplos Python desta página em um ambiente de desenvolvimento local, instale e inicialize a CLI gcloud e configure o Application Default Credentials com suas credenciais de usuário.
Instale a Google Cloud CLI e faça login CLI gcloud com sua identidade federada.
Create local authentication credentials for your user account:
gcloud auth application-default login
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
Confira mais informações em Set up authentication for a local development environment.
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 CLI gcloud com sua identidade federada.
Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Trusted Cloud .
Receber uma lista de VMs
Console
No Trusted Cloud console, acesse a página Instâncias de VM:
gcloud
Receba uma lista agregada de todas as VMs em todas as zonas de um projeto usando o comando
gcloud compute instances list
:gcloud compute instances list
Para restringir a lista de VMs a uma zona específica, use o comando anterior com a sinalização
--zones
.Go
O exemplo a seguir recebe uma lista de instâncias em todas as zonas do projeto:
Antes de testar esta amostra, siga as instruções de configuração do Go no Guia de início rápido do Compute Engine: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Go do Compute Engine.
Para autenticar-se no Compute Engine, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Antes de executar exemplos de código, defina a variável de ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN
comos3nsapis.fr
.Também é possível receber uma lista de instâncias em uma zona específica:
Java
O exemplo a seguir recebe uma lista de instâncias em todas as zonas do projeto:
Antes de testar esta amostra, siga as instruções de configuração do Java no Guia de início rápido do Compute Engine: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Java do Compute Engine.
Para autenticar-se no Compute Engine, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Antes de executar exemplos de código, defina a variável de ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN
comos3nsapis.fr
.Também é possível receber uma lista de instâncias em uma zona específica:
Node.js
O exemplo a seguir recebe uma lista de instâncias em todas as zonas do projeto:
Antes de testar esta amostra, siga as instruções de configuração do Node.js no Guia de início rápido do Compute Engine: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Node.js do Compute Engine.
Para autenticar-se no Compute Engine, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Antes de executar exemplos de código, defina a variável de ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN
comos3nsapis.fr
.Também é possível receber uma lista de instâncias em uma zona específica:
Python
O exemplo a seguir recebe uma lista de instâncias em todas as zonas do projeto:
Antes de testar esta amostra, siga as instruções de configuração do Python no Guia de início rápido do Compute Engine: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Python do Compute Engine.
Para autenticar-se no Compute Engine, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Antes de executar exemplos de código, defina a variável de ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN
comos3nsapis.fr
.Também é possível receber uma lista de instâncias em uma zona específica:
REST
Receba uma lista agregada de todas as VMs em todas as zonas de um projeto usando o método
instances.aggregatedList
:GET https://compute.googleapis.com/compute/v1/projects/PROJECT/aggregated/instances
Substitua
PROJECT
pelo nome do projeto para receber uma lista de VMs.Para restringir a lista de VMs a uma zona específica, use o método
instances.list
:GET https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/instances
Substitua:
PROJECT
: o nome do projeto para receber uma lista de VMsZONE
: a zona para receber uma lista de VMs
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-08 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-08 UTC."],[[["This document outlines the process of retrieving a list of Virtual Machines (VMs) running within a Google Cloud project, either across all zones or within specific zones."],["Authentication is essential for accessing Google Cloud services and APIs, and the document details how to set up authentication using the Google Cloud console, gcloud CLI, or for local development environments with languages like Go, Java, Node.js, Python, and REST."],["To get a comprehensive list of VMs in all zones, use the `gcloud compute instances list` command in the gcloud CLI or the `instances.aggregatedList` method with REST."],["For a list of VMs within a particular zone, one can utilize the `gcloud compute instances list` command with the `--zones` flag or the `instances.list` method in REST, along with specific code examples for Go, Java, Node.js, and Python."],["The code samples demonstrate how to use the client libraries in Go, Java, Node.js, and Python to programmatically list VMs, either across all zones or within a specified zone, while also highlighting the use of the `MaxResults` parameter for managing large result sets and utilizing Application Default Credentials."]]],[]] -