Esta página descreve como obter, listar e excluir modelos de instância.
Antes de começar
- Se ainda não o fez, configure a autenticação. Autenticação é o processo pelo qual sua identidade é verificada para acesso a Google Cloud serviços e APIs. Para executar códigos ou amostras em um ambiente de desenvolvimento local, você pode se autenticar 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 Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
-
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
- Set a default region and zone.
- Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
If an authentication error is returned, confirm that you have configured the gcloud CLI to use Workforce Identity Federation.
- Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
If an authentication error is returned, confirm that you have configured the gcloud CLI to use Workforce Identity Federation.
- Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
If an authentication error is returned, confirm that you have configured the gcloud CLI to use Workforce Identity Federation.
- Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
If an authentication error is returned, confirm that you have configured the gcloud CLI to use Workforce Identity Federation.
- No console do Google Cloud, acesse a página Modelos de instância.
- Clique no nome do modelo de instância para ver os detalhes do modelo.
- No console do Google Cloud, acesse a página Modelos de instância.
- Selecione os modelos de instância que você deseja excluir.
- Clique em Excluir .
Go
Para usar os exemplos Go desta página em um ambiente de desenvolvimento local, instale e inicialize o gcloud CLI e e configure o Application Default Credentials com suas credenciais de usuário.
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 o gcloud CLI e e configure o Application Default Credentials com suas credenciais de usuário.
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 o gcloud CLI e e configure o Application Default Credentials com suas credenciais de usuário.
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 o gcloud CLI e e configure o Application Default Credentials com suas credenciais de usuário.
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 gcloud CLI.
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Google Cloud.
Obtenha informações sobre um modelo de instância
Console
gcloud
Para obter informações sobre um modelo de instância regional ou global, use o
instance-templates describe command
.Para um modelo de instância regional, use o seguinte comando:
gcloud compute instance-templates describe INSTANCE_TEMPLATE_NAME \ --region=REGION
Para um modelo de instância global, use o seguinte comando:
gcloud compute instance-templates describe INSTANCE_TEMPLATE_NAME
Ir
Java
Node.js
Pitão
DESCANSAR
Para obter informações sobre um modelo de instância regional, use o método
regionInstanceTemplates.get
da seguinte forma:GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_NAME
Para obter informações sobre um modelo de instância global, use
instanceTemplates.get
da seguinte forma:GET https://compute.googleapis.com/compute/v1/projects/[PROJECT_ID]/global/instanceTemplates/[INSTANCE_TEMPLATE]
Listar modelos de instância
Para obter uma lista de modelos de instância que você criou:
Console
A página Modelos de instância lista todos os modelos de instância do seu projeto.
gcloud
Para obter uma lista de todos os modelos de instâncias regionais, use o seguinte comando:
gcloud compute instance-templates list \ --regions
Para obter uma lista de modelos de instâncias regionais em uma região específica, use o seguinte comando:
gcloud compute instance-templates list \ --filter="region:(REGION)"
Para obter uma lista de modelos de instância globais, use o seguinte comando:
gcloud compute instance-templates list \ --global
Para obter uma lista de todos os modelos de instância, incluindo regionais e globais, use o seguinte comando:
gcloud compute instance-templates list
Ir
Java
Node.js
Pitão
DESCANSAR
Para obter uma lista de modelos de instâncias regionais, faça uma solicitação
regionInstanceTemplates.list
:GET https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/instanceTemplates
Para obter uma lista de modelos de instância globais, faça uma solicitação
instanceTemplates.list
:GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/instanceTemplates
Excluir um modelo de instância
Excluir um modelo de instância o remove da sua lista de modelos. Você não poderá excluir um modelo de instância se um grupo de instâncias gerenciadas fizer referência a ele.
Console
gcloud
Usando a CLI do Google Cloud, execute:
gcloud compute instance-templates delete INSTANCE_TEMPLATE_NAME
Para um modelo de instância regional, INSTANCE_TEMPLATE_NAME deve conter o URL completo do modelo. Por exemplo,
https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/instanceTemplates/example-regional-instance-template
.Ir
Java
Node.js
Pitão
DESCANSAR
Para excluir um modelo de instância regional, faça uma solicitação
regionInstanceTemplates.delete
:DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_NAME
Para excluir um modelo de instância global, faça uma solicitação
instanceTemplates.delete
:DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/instanceTemplates/INSTANCE_TEMPLATE_NAME
Às vezes, as VMs em um grupo de instâncias gerenciadas podem estar fora de sincronia com o restante do grupo e usar um modelo de instância diferente do restante do grupo. Se uma VM em um grupo de instâncias gerenciadas usar um modelo diferente do especificado no grupo, essa VM continuará usando seu modelo para reparo, mesmo que esse modelo seja excluído. Para obter mais informações sobre como aplicar um novo modelo de instância, consulte Aplicar novas configurações a VMs em um MIG .
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-04-21 UTC.
-