- HTTP request
- Path parameters
- Request body
- Response body
- Authorization scopes
- IAM Permissions
- Try it!
instanceSettings.get Instance settings.
HTTP request
GET https://compute.googleapis.com/compute/beta/projects/{project}/zones/{zone}/instanceSettings
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters | |
---|---|
project
|
Project ID for this request. |
zone
|
Name of the zone for this request. |
Request body
The request body must be empty.
Response body
Represents a Instance Settings resource. You can use instance settings to configure default settings for Compute Engine VM instances. For example, you can use it to configure default machine type of Compute Engine VM instances.
If successful, the response body contains data with the following structure:
JSON representation |
---|
{ "kind" : string , "fingerprint" : string , "metadata" : { "kind" : string , "items" : { string : string , ... } } , "zone" : string } |
Fields | |
---|---|
kind
|
[Output Only] Type of the resource. Always |
fingerprint
|
Specifies a fingerprint for instance settings, which is essentially a hash of the instance settings resource's contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update the instance settings resource. You must always provide an up-to-date fingerprint hash in order to update or change the resource, otherwise the request will fail with error To see the latest fingerprint, make a A base64-encoded string. |
metadata
|
The metadata key/value pairs assigned to all the instances in the corresponding scope. |
metadata.kind
|
[Output Only] Type of the resource. Always |
metadata.items
|
A metadata key/value items map. The total size of all keys and values must be less than 512KB. |
zone
|
[Output Only] URL of the zone where the resource resides You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. |
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.instanceSettings.get
To find predefined roles that contain those permissions, see Compute Engine IAM Roles .