- HTTP request
- Path parameters
- Request body
- Response body
- Authorization Scopes
- IAM Permissions
- Examples
- Try it!
Returns the specified node template. Gets a list of available node templates by making a list()
request.
HTTP request
GET https://compute.googleapis.com/compute/beta/projects/{project}/regions/{region}/nodeTemplates/{resourceId}
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters | |
---|---|
project |
Project ID for this request. |
region |
The name of the region for this request. |
resourceId |
Name of the node template to return. |
Request body
The request body must be empty.
Response body
If successful, the response body contains data with the following structure:
JSON representation | |
---|---|
{ "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, "kind": string } |
Fields | |
---|---|
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. An object containing a list of |
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 |
The flexible properties of the desired node type. Node groups that use this node template will create nodes of a type that matches these properties. This field is mutually exclusive with 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. |
kind |
[Output Only] The type of the resource. Always |
Authorization Scopes
Requires one of the following OAuth scopes:
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.