En esta página se explica cómo usar una plantilla de instancia para crear una instancia de VM. Una plantilla de instancia es un recurso de API que define las propiedades de las instancias de VM. En una plantilla de instancia, se definen propiedades como el tipo de máquina, la imagen del SO, las configuraciones de disco persistente, los metadatos, las secuencias de comandos de inicio, etc. Después, se puede usar la plantilla de instancia para crear instancias de VM individuales o grupos de instancias gestionadas.
Cuando creas una instancia de VM a partir de una plantilla de instancia, el comportamiento predeterminado es crear una instancia de VM idéntica a las propiedades especificadas en la plantilla, excepto el nombre de la instancia de VM y la zona en la que se creará. También puedes anular ciertos campos durante la creación de la instancia si quieres cambiar algunas propiedades de la plantilla de instancia para usos específicos.
En este documento se presupone que ya tienes una plantilla de instancia lista para usar. Si no tienes ninguna plantilla de instancia, sigue las instrucciones para crear una.
Antes de empezar
- Consulta la documentación sobre plantillas de instancias.
- Crea una plantilla de instancia.
-
Si aún no lo has hecho, configura la autenticación.
La autenticación verifica tu identidad para acceder a Google Cloud servicios y APIs. Para ejecutar código o ejemplos desde un entorno de desarrollo local, puedes autenticarte en Compute Engine seleccionando una de las siguientes opciones:
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
-
Instala Google Cloud CLI. Después de la instalación, inicializa la CLI de Google Cloud ejecutando el siguiente comando:
gcloud init
Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.
- Set a default region and zone.
Go
Para usar las Go muestras de esta página en un entorno de desarrollo local, instala e inicializa la CLI de gcloud y, a continuación, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.
Instala Google Cloud CLI.
Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.
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, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
Para obtener más información, consulta Set up authentication for a local development environment.
Java
Para usar las Java muestras de esta página en un entorno de desarrollo local, instala e inicializa la CLI de gcloud y, a continuación, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.
Instala Google Cloud CLI.
Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.
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, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
Para obtener más información, consulta Set up authentication for a local development environment.
Node.js
Para usar las Node.js muestras de esta página en un entorno de desarrollo local, instala e inicializa la CLI de gcloud y, a continuación, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.
Instala Google Cloud CLI.
Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.
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, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
Para obtener más información, consulta Set up authentication for a local development environment.
Python
Para usar las Python muestras de esta página en un entorno de desarrollo local, instala e inicializa la CLI de gcloud y, a continuación, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.
Instala Google Cloud CLI.
Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.
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, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
Para obtener más información, consulta Set up authentication for a local development environment.
REST
Para usar las muestras de la API REST de esta página en un entorno de desarrollo local, debes usar las credenciales que proporciones a la CLI de gcloud.
Instala Google Cloud CLI.
Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.
Para obtener más información, consulta el artículo Autenticarse para usar REST de la documentación sobre autenticación de Google Cloud .
Crear una instancia de VM a partir de una plantilla de instancia
Puedes usar una plantilla de instancia regional o global para crear una instancia de VM. Para crear una instancia exactamente como se describe en la plantilla de instancia, sigue estas instrucciones.
Consola
En la Google Cloud consola, ve a la página Crear una instancia.
En el menú
Crear VM a partir de ..., selecciona Plantillas de instancia.En la ventana Crear VM a partir de plantilla que aparece, haga lo siguiente:
Selecciona una plantilla.
Para crear e iniciar la VM, haz clic en Crear.
gcloud
Para crear una VM a partir de una plantilla de instancia regional o global, usa el mismo comando
gcloud compute instances create
que usarías para crear una instancia normal, pero añade la marca--source-instance-template
:gcloud compute instances create VM_NAME \ --source-instance-template INSTANCE_TEMPLATE_URL
Haz los cambios siguientes:
VM_NAME
: el nombre de la instancia.INSTANCE_TEMPLATE_URL
: la URL de la plantilla de instancia que quieres usar para crear VMs en el MIG. La URL puede contener el ID o el nombre de la plantilla de instancia. Especifica uno de los siguientes valores:- En el caso de una plantilla de instancia regional, haz lo siguiente:
projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_ID
- En el caso de una plantilla de instancia global, haz lo siguiente:
INSTANCE_TEMPLATE_ID
- En el caso de una plantilla de instancia regional, haz lo siguiente:
Por ejemplo:
gcloud compute instances create example-instance \ --source-instance-template 1234567890
Go
Java
Node.js
Python
REST
Para crear una VM a partir de una plantilla de instancia regional o global, crea una solicitud normal para crear una instancia, pero incluye el parámetro de consulta
sourceInstanceTemplate
seguido de una ruta cualificada a una plantilla de instancia.POST https://compute.googleapis.com/compute/v1/projects/ PROJECT_ID/zones/ZONE/ instances?sourceInstanceTemplate=INSTANCE_TEMPLATE_URL
En el cuerpo de la solicitud, proporciona un
name
para la instancia de VM:{ "name": "example-instance" }
Por ejemplo, el siguiente fragmento incluye una ruta completa a la plantilla:
https://compute.googleapis.com/compute/v1/projects/myproject/global/instanceTemplates/1234567890
.POST https://compute.googleapis.com/ compute/v1/projects/myproject/zones/us-central1-a/instances?sourceInstanceTemplate= https://compute.googleapis.com/compute/v1/projects/myproject/global/ instanceTemplates/1234567890
{ "name": "example-instance" }
Crear una instancia de VM a partir de una plantilla de instancia con anulaciones
Cuando usas una plantilla de instancia para iniciar una instancia de VM, el comportamiento predeterminado es crear una instancia de VM exactamente como se describe en la plantilla de instancia, excepto el nombre y la zona de la instancia.
Si quieres crear una instancia basada principalmente en una plantilla de instancia, pero con algunos cambios, puedes usar el comportamiento de anulación. Para usar el comportamiento de anulación, debes transferir los atributos que quieras anular de la plantilla de instancia al crear la instancia.
Consola
En la Google Cloud consola, ve a la página Crear una instancia.
En el menú
Crear VM a partir de ..., selecciona Plantillas de instancia.En la ventana Crear VM a partir de plantilla que aparece, selecciona una plantilla y, a continuación, haz clic en
Personalizar.Opcional: Especifica otras opciones de configuración. Para obtener más información, consulta Opciones de configuración durante la creación de instancias.
Para crear e iniciar la instancia, haz clic en Crear.
gcloud
Con gcloud CLI, haz una solicitud para crear una instancia con la marca
--source-instance-template
y anula cualquier propiedad que quieras con la marcagcloud
adecuada. Para ver una lista de las marcas aplicables, consulta lagcloud
referencia.Por ejemplo, proporciona las siguientes marcas para anular el tipo de máquina, los metadatos, el sistema operativo, el disco de arranque del disco persistente y un disco secundario de una plantilla de instancia:
gcloud compute instances create example-instance \ --source-instance-template 1234567890 --machine-type e2-standard-2 \ --image-family debian-9 --image-project debian-cloud \ --metadata bread=butter --disk=boot=no,name=my-override-disk
Go
Java
Node.js
Python
REST
En la API, usa el parámetro de consulta
sourceInstanceTemplate
y proporciona los campos que quieras anular en el cuerpo de la solicitud al crear una solicitud normal para crear una instancia.El comportamiento de anulación en la API sigue las reglas de combinación de parches JSON, que se describen en el RFC 7396.
En concreto, este cambio afecta a las siguientes acciones:
- Si anulas un campo básico, el campo básico correspondiente de la plantilla de instancia se sustituirá por el valor del campo básico de la solicitud. Los campos básicos incluyen
machineType
,sourceImage
yname
, entre otros. - Si anula un campo repetido, todos los valores repetidos de esa propiedad se sustituirán por los valores correspondientes proporcionados en la solicitud.
Los campos repetidos suelen ser propiedades de tipo
list
. Por ejemplo,disks
ynetworkInterfaces
son campos repetidos. - Si anulas un
nested object
, el objeto de la plantilla de instancia se combinará con la especificación del objeto correspondiente en la solicitud. Ten en cuenta que, si un objeto anidado se encuentra en un campo repetido, el campo se trata según las reglas de los campos repetidos. Las etiquetas son una excepción a esta regla y se tratan como un campo repetido aunque sean de tipoobject
.
Por ejemplo, supongamos que tienes una plantilla de instancia con dos discos que no son de arranque, pero quieres anular uno de los discos. Debes proporcionar la especificación
disks
completa en tu solicitud, incluidos los discos que quieras conservar.URL de esta solicitud:
POST https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances? sourceInstanceTemplate=https://compute.googleapis.com/compute/v1/projects/myproject/global/instanceTemplates/1234567890
Cuerpo de la solicitud:
{ "disks": [ { # Since you are overriding the repeated disk property, you must # specify a boot disk in the request, even if it is already # specified in the instance template "autoDelete": true, "boot": true, "initializeParams": { "sourceImage": "projects/debian-cloud/global/images/family/debian-8" }, "mode": "READ_WRITE", "type": "PERSISTENT" }, { # New disk you want to use "autoDelete": false, "boot": false, "mode": "READ_WRITE", "source": "zones/us-central1-f/disks/my-override-disk", "type": "PERSISTENT" }, { # Assume this disk is already specified in instance template, but # you must specify it again since you are overriding the disks # property "autoDelete": false, "boot": false, "mode": "READ_WRITE", "source": "zones/us-central1-f/disks/my-other-disk-to-keep", "type": "PERSISTENT" } ], "machineType": "zones/us-central1-f/machineTypes/e2-standard-2", "name": "example-instance" }
Siguientes pasos
- Consulta la documentación sobre instancias de máquinas virtuales no garantizadas.
- Consulta información sobre los guiones de apagado.
- Consulta los precios de las instancias interrumpibles.
- Conéctate a tu instancia.
A menos que se indique lo contrario, el contenido de esta página está sujeto a la licencia Reconocimiento 4.0 de Creative Commons y las muestras de código están sujetas a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio web de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-09-12 (UTC).
-