REST Resource: projects.locations.instances.tags

Resource: Tag

Tag resource.

JSON representation
{
  "name": string,
  "displayName": string,
  "description": string,
  "childTags": [
    string
  ],
  "etag": string,
  "tagOwner": enum (TagOwner),
  "parentTags": [
    string
  ],
  "metadata": {
    string: string,
    ...
  },
  "createTime": string,
  "updateTime": string
}
Fields
name

string

Identifier. Full resource name for the Tag. Format: projects/{project}/locations/{location}/instances/{instance}/tags/{tag}

displayName

string

Optional. Display name of the tag.

description

string

Optional. Description of the tag.

childTags[]
(deprecated)

string

Optional. Deprecated: Prefer parentTags instead. Resource names of associated tags organized under the tag. Example: [ "projects/{project}/locations/{location}/instances/{instance}/ tags/google.mitre.technique.T9999.0001" ]

etag

string

Optional. The etag for this tag. If this is provided on update, the request will succeed if and only if it matches the server-computed value, and will fail with an ABORTED error otherwise.

tagOwner

enum (TagOwner)

Output only. The tag owner (i.e., whether the tag is customer-authored or Google-authored).

parentTags[]

string

Optional. Resource names of associated tags that this tag is a child of. Populated in FULL and BASIC views. Example: [ "projects/{project}/locations/{location}/instances/{instance}/ tags/google.mitre.technique.T9999.0001" ]

metadata

map (key: string, value: string)

Optional. Unstructured key-value metadata. Populated in FULL view.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

createTime

string (Timestamp format)

Output only. The timestamp of when the tag was created. Populated in FULL view.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Output only. The timestamp of when the tag was last updated. Populated in FULL view.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".

TagOwner

TagOwner is an enum representing the author/curator of the tag.

Enums
TAG_OWNER_UNSPECIFIED Tag owners is unspecified.
TAG_OWNER_CUSTOMER Tag is customer-authored.
TAG_OWNER_GOOGLE Tag is Google-authored.

Methods

create

Creates a new Tag.

delete

Deletes a Tag.

get

Gets a single Tag.

list

Lists a collection of Tags

patch

Updates an existing Tag.