En esta página, se describe cómo obtener, enumerar y borrar plantillas de instancias.
Antes de comenzar
-
Configura la autenticación si aún no lo hiciste.
La autenticación es el proceso mediante el cual se verifica tu identidad para acceder a los servicios y las API de Google Cloud.
Para ejecutar código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine de la siguiente manera.
Selecciona la pestaña para saber cómo planeas usar las muestras en esta página:
Consola
Cuando usas la consola de Google Cloud para acceder a los servicios y las APIs de Google Cloud, no necesitas configurar la autenticación.
gcloud
-
Instala Google Cloud CLI y, luego, inicializa la ejecución del siguiente comando:
gcloud init
- Configura una región y una zona predeterminadas.
Go
Para usar las muestras de Go de esta página desde un entorno de desarrollo local, instala e inicializa la CLI de gcloud y, luego, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.
- Instala Google Cloud CLI.
-
Para inicializar la CLI de gcloud, ejecuta el siguiente comando:
gcloud init
-
Crea credenciales de autenticación locales para tu Cuenta de Google:
gcloud auth application-default login
Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Java
Para usar las muestras de Java de esta página desde un entorno de desarrollo local, instala e inicializa la CLI de gcloud y, luego, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.
- Instala Google Cloud CLI.
-
Para inicializar la CLI de gcloud, ejecuta el siguiente comando:
gcloud init
-
Crea credenciales de autenticación locales para tu Cuenta de Google:
gcloud auth application-default login
Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Node.js
Para usar las muestras de Node.js de esta página desde un entorno de desarrollo local, instala e inicializa la CLI de gcloud y, luego, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.
- Instala Google Cloud CLI.
-
Para inicializar la CLI de gcloud, ejecuta el siguiente comando:
gcloud init
-
Crea credenciales de autenticación locales para tu Cuenta de Google:
gcloud auth application-default login
Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Python
Para usar las muestras de Python de esta página desde un entorno de desarrollo local, instala e inicializa la CLI de gcloud y, luego, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.
- Instala Google Cloud CLI.
-
Para inicializar la CLI de gcloud, ejecuta el siguiente comando:
gcloud init
-
Crea credenciales de autenticación locales para tu Cuenta de Google:
gcloud auth application-default login
Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
REST
Para usar las muestras de la API de REST en esta página en un entorno de desarrollo local, debes usar las credenciales que proporcionas a la CLI de gcloud.
Instala Google Cloud CLI y, luego, inicializa la ejecución del siguiente comando:
gcloud init
-
Obtén información de una plantilla de instancias
Console
- En la consola de Google Cloud, ve a la página Plantillas de instancia.
- Haz clic en el nombre de la plantilla de instancias para ver los detalles de la plantilla.
gcloud
Para obtener información sobre una plantilla de instancias regional o global, usa instance-templates describe command
.
Para una plantilla de instancias regional, usa el siguiente comando:
gcloud compute instance-templates describe INSTANCE_TEMPLATE_NAME \ --region=REGION
Para una plantilla de instancias global, usa el siguiente comando:
gcloud compute instance-templates describe INSTANCE_TEMPLATE_NAME
Go
Java
Node.js
Python
REST
Para obtener información sobre una plantilla de instancias regional, usa el método regionInstanceTemplates.get
de la siguiente manera:
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_NAME
Para obtener información sobre una plantilla de instancias global, usa instanceTemplates.get
de la siguiente manera:
GET https://compute.googleapis.com/compute/v1/projects/[PROJECT_ID]/global/instanceTemplates/[INSTANCE_TEMPLATE]
Mostrar lista de plantillas de instancias
Para obtener una lista de las plantillas de instancias que creaste, sigue estos pasos:
Console
En la página Plantillas de instancias, se enumeran todas las plantillas de instancias en tu proyecto.
gcloud
Para obtener una lista de todas las plantillas de instancias regionales, usa el siguiente comando:
gcloud compute instance-templates list \ --regions
Para obtener una lista de plantillas de instancias regionales en una región específica, usa el siguiente comando:
gcloud compute instance-templates list \ --filter="region:(REGION)"
Para obtener una lista de plantillas de instancias globales, usa el siguiente comando:
gcloud compute instance-templates list \ --global
Para obtener una lista de todas las plantillas de instancias, incluidas las regionales y las globales, usa el siguiente comando:
gcloud compute instance-templates list
Go
Java
Node.js
Python
REST
Para obtener una lista de las plantillas de instancias regionales, realiza una solicitud regionInstanceTemplates.list
:
GET https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/instanceTemplates
Para obtener una lista de las plantillas de instancias globales, realiza una solicitud instanceTemplates.list
:
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/instanceTemplates
Borrar una plantilla de instancias
Si borras una plantilla de instancias, se quita de tu lista de plantillas. No puedes borrar una plantilla de instancias si un grupo de instancias administrado hace referencia a ella.
Console
- En la consola de Google Cloud, ve a la página Plantillas de instancia.
- Selecciona las plantillas de instancias que quieres borrar.
- Haz clic en Borrar.
gcloud
Con Google Cloud CLI, ejecuta lo siguiente:
gcloud compute instance-templates delete INSTANCE_TEMPLATE_NAME
Para una plantilla de instancias regional, INSTANCE_TEMPLATE_NAME debe contener la URL completa de la plantilla. Por ejemplo, https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/instanceTemplates/example-regional-instance-template
Go
Java
Node.js
Python
REST
Para borrar una plantilla de instancias regional, realiza una solicitud regionInstanceTemplates.delete
:
DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_NAME
Para borrar una plantilla de instancias global, realiza una solicitud instanceTemplates.delete
:
DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/instanceTemplates/INSTANCE_TEMPLATE_NAME
A veces, las VMs en un grupo de instancias administrado pueden estar fuera de sincronización con el resto del grupo y usar una plantilla de instancias diferente que el resto del grupo. Si una VM en un grupo de instancias administrado usa una plantilla diferente a la especificada en el grupo, esa VM continuará con el uso de su plantilla para la reparación, incluso si esa plantilla se borra. Para obtener más información sobre cómo aplicar una plantilla de instancias nueva, consulta Aplica una configuración nueva a las VMs en un MIG.