- HTTP request
- Path parameters
- Request body
- Response body
- Authorization scopes
- IAM Permissions
- Try it!
Returns the specified node template.
HTTP request
GET https://compute.googleapis.com/compute/beta/projects/{project}/regions/{region}/nodeTemplates/{nodeTemplate}
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters | |
---|---|
project |
Project ID for this request. |
region |
The name of the region for this request. |
nodeTemplate |
Name of the node template to return. |
Request body
The request body must be empty.
Response body
Represent a sole-tenant Node Template resource.
You can use a template to define properties for nodes in a node group. For more information, read Creating node groups and instances.
If successful, the response body contains data with the following structure:
JSON representation |
---|
{ "kind": string, "id": string, "creationTimestamp": string, "name": string, "description": string, "nodeType": string, "nodeAffinityLabels": { string: string, ... }, "status": enum, "statusMessage": string, "region": string, "selfLink": string, "nodeTypeFlexibility": { "cpus": string, "memory": string, "localSsd": string }, "serverBinding": { "type": enum }, "disks": [ { "diskType": string, "diskSizeGb": integer, "diskCount": integer } ], "accelerators": [ { "acceleratorType": string, "acceleratorCount": integer } ], "cpuOvercommitType": enum } |
Fields | |
---|---|
kind |
[Output Only] The type of the resource. Always |
id |
[Output Only] The unique identifier for the resource. This identifier is defined by the server. |
creationTimestamp |
[Output Only] Creation timestamp in RFC3339 text format. |
name |
The name of the resource, provided by the client when initially creating the resource. The resource 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 |
description |
An optional description of this resource. Provide this property when you create the resource. |
nodeType |
The node type to use for nodes group that are created from this template. |
nodeAffinityLabels |
Labels to use for node affinity, which will be used in instance scheduling. |
status |
[Output Only] The status of the node template. One of the following values: |
statusMessage |
[Output Only] An optional, human-readable explanation of the status. |
region |
[Output Only] The name of the region where the node template resides, such as us-central1. |
selfLink |
[Output Only] Server-defined URL for the resource. |
nodeTypeFlexibility |
Do not use. Instead, use the |
nodeTypeFlexibility.cpus |
|
nodeTypeFlexibility.memory |
|
nodeTypeFlexibility.localSsd |
|
serverBinding |
Sets the binding properties for the physical server. Valid values include:
See Sole-tenant node options for more information. |
serverBinding.type |
|
disks[] |
|
disks[].diskType |
Specifies the desired disk type on the node. This disk type must be a local storage type (e.g.: |
disks[].diskSizeGb |
Specifies the size of the disk in base-2 GB. |
disks[].diskCount |
Specifies the number of such disks. |
accelerators[] |
|
accelerators[].acceleratorType |
Full or partial URL of the accelerator type resource to attach to this instance. For example: |
accelerators[].acceleratorCount |
The number of the guest accelerator cards exposed to this instance. |
cpuOvercommitType |
CPU overcommit. |
Authorization scopes
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/compute.readonly
https://www.googleapis.com/auth/compute
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authentication Overview.
IAM Permissions
In addition to any permissions specified on the fields above, authorization requires one or more of the following IAM permissions:
compute.nodeTemplates.get
To find predefined roles that contain those permissions, see Compute Engine IAM Roles.