REST Resource: projects.locations.taxonomies.policyTags

Resource: PolicyTag

Denotes one policy tag in a taxonomy (e.g. ssn). Policy Tags can be defined in a hierarchy. For example, consider the following hierarchy: Geolocation -> (LatLong, City, ZipCode). PolicyTag "Geolocation" contains three child policy tags: "LatLong", "City", and "ZipCode".

JSON representation
{
  "name": string,
  "displayName": string,
  "description": string,
  "parentPolicyTag": string,
  "childPolicyTags": [
    string
  ]
}
Fields
name

string

Output only. Resource name of this policy tag, whose format is: "projects/{project_number}/locations/{locationId}/taxonomies/{taxonomyId}/policyTags/{id}".

displayName

string

Required. User defined name of this policy tag. It must: be unique within the parent taxonomy; contain only unicode letters, numbers, underscores, dashes and spaces; not start or end with spaces; and be at most 200 bytes long when encoded in UTF-8.

description

string

Description of this policy tag. It must: contain only unicode characters, tabs, newlines, carriage returns and page breaks; and be at most 2000 bytes long when encoded in UTF-8. If not set, defaults to an empty description. If not set, defaults to an empty description.

parentPolicyTag

string

Resource name of this policy tag's parent policy tag (e.g. for the "LatLong" policy tag in the example above, this field contains the resource name of the "Geolocation" policy tag). If empty, it means this policy tag is a top level policy tag (e.g. this field is empty for the "Geolocation" policy tag in the example above). If not set, defaults to an empty string.

childPolicyTags[]

string

Output only. Resource names of child policy tags of this policy tag.

Methods

create

Creates a policy tag in the specified taxonomy.

delete

Deletes a policy tag.

get

Gets a policy tag.

getIamPolicy

Gets the IAM policy for a taxonomy or a policy tag.

list

Lists all policy tags in a taxonomy.

patch

Updates a policy tag.

setIamPolicy

Sets the IAM policy for a taxonomy or a policy tag.

testIamPermissions

Returns the permissions that a caller has on the specified taxonomy or policy tag.