Veja nesta página como encontrar, listar e excluir modelos de instâncias.
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 informações sobre um modelo de instância
Ao visualizar um modelo de instância, é possível conferir o nome, o ID exclusivo, o carimbo de data/hora de criação e todas as propriedades da instância especificadas.
Console
- No console Trusted Cloud , acesse a página "Modelos de instância".
- Clique no nome do modelo de instância para ver os detalhes dele.
gcloud
Para 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_OR_ID \ --region=REGION
Para um modelo de instância global, use o seguinte comando:
gcloud compute instance-templates describe INSTANCE_TEMPLATE_NAME_OR_ID
Go
Java
Node.js
Python
REST
Para informações sobre um modelo de instância regional, use o método
regionInstanceTemplates.get
da seguinte maneira:GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_NAME_OR_ID
Para informações sobre um modelo de instância global, use o método
instanceTemplates.get
da seguinte maneira:GET https://compute.googleapis.com/compute/v1/projects/[PROJECT_ID]/global/instanceTemplates/[INSTANCE_TEMPLATE_NAME_OR_ID]
Listar modelos de instâncias
Para uma lista dos modelos de instância criados por você:
Console
Na página "Modelos de instância", há uma lista de todos os modelos de instância do seu projeto.
gcloud
Para ver uma lista de todos os modelos de instâncias regionais, use o seguinte comando:
gcloud compute instance-templates list \ --regions
Para consultar 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 ver uma lista de modelos globais de instância, use o seguinte comando:
gcloud compute instance-templates list \ --global
Para ver uma lista de todos os modelos de instância, incluindo os modelos regional e global, use o seguinte comando:
gcloud compute instance-templates list
Go
Java
Node.js
Python
REST
Para ver 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 consultar uma lista de modelos globais de instância, 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
Se você excluir um modelo de instância, ele será removido da sua lista de modelos. Não é possível excluir um modelo de instância referenciado por um grupo de instâncias gerenciado.
Console
- No console Trusted Cloud , acesse a página "Modelos de instância".
- Selecione os modelos de instância que quer excluir.
- Clique em Excluir.
gcloud
Usando a Google Cloud CLI, execute:
gcloud compute instance-templates delete INSTANCE_TEMPLATE_NAME
Para um modelo de instância regional, INSTANCE_TEMPLATE_NAME precisa 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
.Go
Java
Node.js
Python
REST
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
Em alguns casos, as VMs de um grupo de instâncias gerenciado podem estar fora de sincronia e usar um modelo de instância diferente em relação às outras instâncias do mesmo grupo. Se uma VM em um grupo de instâncias gerenciadas usar um modelo diferente do especificado no grupo, ela continuará usando o modelo para reparo, mesmo que esse modelo seja excluído. Para mais informações sobre como aplicar um novo modelo de instância, consulte Como 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-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 page provides instructions on how to manage instance templates, including retrieving information about them, listing them, and deleting them."],["Authentication is required to interact with Google Cloud services and APIs, and the gcloud CLI, console, or other supported languages can be used for this purpose."],["You can get details about both global and regional instance templates using the console, gcloud command-line tool, or language-specific code samples."],["Instance templates can be listed globally or by region via the console, gcloud CLI commands, or code samples."],["Instance templates can be deleted through the console, gcloud CLI commands, or programmatically, but if a managed instance group is referencing the template, deletion is not allowed."]]],[]] -