Method: tagKeys.getNamespaced

Retrieves a TagKey by its namespaced name. This method will return PERMISSION_DENIED if the key does not exist or the user does not have permission to view it.

HTTP request

GET https://cloudresourcemanager.googleapis.com/v3/tagKeys/namespaced

The URL uses gRPC Transcoding syntax.

Query parameters

Parameters
name

string

Required. A namespaced tag key name in the format {parentId}/{tagKeyShort}, such as 42/foo for a key with short name "foo" under the organization with ID 42 or r2-d2/bar for a key with short name "bar" under the project r2-d2.

Request body

The request body must be empty.

Response body

If successful, the response body contains an instance of TagKey.

Authorization scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-platform.read-only

For more information, see the Authentication Overview.