Method: instances.getGuestAttributes

Returns the specified guest attributes entry.

HTTP request

GET https://compute.googleapis.com/compute/beta/projects/{project}/zones/{zone}/instances/{instance}/getGuestAttributes

The URL usesgRPC Transcoding syntax. To know more about valid error responses that can be thrown by this HTTP request, please refer to theservice error catalog

Path parameters

Parameters
project

string

Project ID for this request.

zone

string

The name of the zone for this request.

instance

string

Name of the instance scoping this request.

Query parameters

Parameters
variableKey

string

Specifies the key for the guest attributes entry.

queryPath

string

Specifies the guest attributes path to be queried.

Request body

The request body must be empty.

Response body

A guest attributes entry.

If successful, the response body contains data with the following structure:

JSON representation
{"kind":string,"variableKey":string,"variableValue":string,"queryPath":string,"queryValue":{"items":[{"namespace":string,"key":string,"value":string}]},"selfLink":string}
Fields
kind

string

[Output Only] Type of the resource. Alwayscompute#guestAttributes for guest attributes entry.

variableKey

string

The key to search for.

variableValue

string

[Output Only] The value found for the requested key.

queryPath

string

The path to be queried. This can be the default namespace ('') or a nested namespace ('<namespace>/') or a specified key ('<namespace>/<key>').

queryValue

object

[Output Only] The value of the requested queried path.

queryValue.items[]

object

queryValue.items[].namespace

string

Namespace for the guest attribute entry.

queryValue.items[].key

string

Key for the guest attribute entry.

queryValue.items[].value

string

Value for the guest attribute entry.

selfLink

string

[Output Only] Server-defined URL for this resource.

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 theAuthentication Overview.

IAM Permissions

In addition to any permissions specified on the fields above, authorization requires one or more of the followingIAM permissions:

  • compute.instances.getGuestAttributes

To find predefined roles that contain those permissions, seeCompute Engine IAM Roles.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-09-18 UTC.