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 Google Cloud.
Para executar códigos ou amostras de um ambiente de desenvolvimento local, autentique-se no
Compute Engine da seguinte maneira.
Selecione a guia para como planeja usar as amostras nesta página:
Console
Quando você usa o console do Google Cloud para acessar os serviços e as APIs do Google Cloud, não é necessário configurar a autenticação.
gcloud
-
Instale a Google Cloud CLI e inicialize-a executando o seguinte comando:
gcloud init
- Defina uma região e uma zona padrão.
Go
Para usar as amostras de Go nesta página de um ambiente de desenvolvimento local, instale e inicialize a CLI gcloud e, em seguida, configure o Application Default Credentials com as credenciais de usuário.
- Instale a CLI do Google Cloud.
-
Para inicializar a CLI gcloud, execute o seguinte comando:
gcloud init
-
Crie as credenciais de autenticação para sua Conta do Google:
gcloud auth application-default login
Veja mais informações em: Configurar a autenticação para um ambiente de desenvolvimento local.
Java
Para usar as amostras de Java nesta página de um ambiente de desenvolvimento local, instale e inicialize a CLI gcloud e, em seguida, configure o Application Default Credentials com as credenciais de usuário.
- Instale a CLI do Google Cloud.
-
Para inicializar a CLI gcloud, execute o seguinte comando:
gcloud init
-
Crie as credenciais de autenticação para sua Conta do Google:
gcloud auth application-default login
Veja mais informações em: Configurar a autenticação para um ambiente de desenvolvimento local.
Node.js
Para usar as amostras de Node.js nesta página de um ambiente de desenvolvimento local, instale e inicialize a CLI gcloud e, em seguida, configure o Application Default Credentials com as credenciais de usuário.
- Instale a CLI do Google Cloud.
-
Para inicializar a CLI gcloud, execute o seguinte comando:
gcloud init
-
Crie as credenciais de autenticação para sua Conta do Google:
gcloud auth application-default login
Veja mais informações em: Configurar a autenticação para um ambiente de desenvolvimento local.
Python
Para usar as amostras de Python nesta página de um ambiente de desenvolvimento local, instale e inicialize a CLI gcloud e, em seguida, configure o Application Default Credentials com as credenciais de usuário.
- Instale a CLI do Google Cloud.
-
Para inicializar a CLI gcloud, execute o seguinte comando:
gcloud init
-
Crie as credenciais de autenticação para sua Conta do Google:
gcloud auth application-default login
Veja mais informações em: Configurar a autenticação para um ambiente de desenvolvimento local.
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 inicialize-a executando o seguinte comando:
gcloud init
-
Receber informações sobre um modelo de instância
Console
- 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 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 \ --region=REGION
Para um modelo de instância global, use o seguinte comando:
gcloud compute instance-templates describe INSTANCE_TEMPLATE_NAME
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
Para informações sobre um modelo de instância global, use o
instanceTemplates.get
da seguinte maneira:
GET https://compute.googleapis.com/compute/v1/projects/[PROJECT_ID]/global/instanceTemplates/[INSTANCE_TEMPLATE]
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 do Google 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.