Skip to main content

instance_templates

Creates, updates, deletes, gets or lists a instance_templates resource.

Overview

Nameinstance_templates
TypeResource
Idgoogle.compute.instance_templates

Fields

NameDatatypeDescription
idstring[Output Only] A unique identifier for this instance template. The server defines this identifier.
namestringName of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
descriptionstringAn optional description of this resource. Provide this property when you create the resource.
creationTimestampstring[Output Only] The creation timestamp for this instance template in RFC3339 text format.
kindstring[Output Only] The resource type, which is always compute#instanceTemplate for instance templates.
propertiesobject
regionstring[Output Only] URL of the region where the instance template resides. Only applicable for regional resources.
selfLinkstring[Output Only] The URL for this instance template. The server defines this URL.
sourceInstancestringThe source instance used to create the template. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /instances/instance - projects/project/zones/zone/instances/instance
sourceInstanceParamsobjectA specification of the parameters to use when creating the instance template from a source instance.

Methods

NameAccessible byRequired ParamsDescription
getSELECTinstanceTemplate, projectReturns the specified instance template.
listSELECTprojectRetrieves a list of instance templates that are contained within the specified project.
insertINSERTprojectCreates an instance template in the specified project using the data that is included in the request. If you are creating a new template to update an existing instance group, your new instance template must use the same network or, if applicable, the same subnetwork as the original template.
deleteDELETEinstanceTemplate, projectDeletes the specified instance template. Deleting an instance template is permanent and cannot be undone. It is not possible to delete templates that are already in use by a managed instance group.

SELECT examples

Retrieves a list of instance templates that are contained within the specified project.

SELECT
id,
name,
description,
creationTimestamp,
kind,
properties,
region,
selfLink,
sourceInstance,
sourceInstanceParams
FROM google.compute.instance_templates
WHERE project = '{{ project }}';

INSERT example

Use the following StackQL query and manifest file to create a new instance_templates resource.

/*+ create */
INSERT INTO google.compute.instance_templates (
project,
name,
description,
properties,
sourceInstance,
sourceInstanceParams,
region
)
SELECT
'{{ project }}',
'{{ name }}',
'{{ description }}',
'{{ properties }}',
'{{ sourceInstance }}',
'{{ sourceInstanceParams }}',
'{{ region }}'
;

DELETE example

Deletes the specified instance_templates resource.

/*+ delete */
DELETE FROM google.compute.instance_templates
WHERE instanceTemplate = '{{ instanceTemplate }}'
AND project = '{{ project }}';