tag_holds

Creates, updates, deletes, gets or lists a tag_holds resource.

Overview

Name	tag_holds
Type	Resource
Id	google.cloudresourcemanager.tag_holds

Fields

Name	Datatype	Description
name	string	Output only. The resource name of a TagHold. This is a String of the form: tagValues/{tag-value-id}/tagHolds/{tag-hold-id} (e.g. tagValues/123/tagHolds/456). This resource name is generated by the server.
createTime	string	Output only. The time this TagHold was created.
helpLink	string	Optional. A URL where an end user can learn more about removing this hold. E.g. https://cloud.google.com/resource-manager/docs/tags/tags-creating-and-managing
holder	string	Required. The name of the resource where the TagValue is being used. Must be less than 200 characters. E.g. //compute.googleapis.com/compute/projects/myproject/regions/us-east-1/instanceGroupManagers/instance-group
origin	string	Optional. An optional string representing the origin of this request. This field should include human-understandable information to distinguish origins from each other. Must be less than 200 characters. E.g. migs-35678234

Methods

Name	Accessible by	Required Params	Description
list	SELECT	tagValuesId	Lists TagHolds under a TagValue.
create	INSERT	tagValuesId	Creates a TagHold. Returns ALREADY_EXISTS if a TagHold with the same resource and origin exists under the same TagValue.
delete	DELETE	tagHoldsId, tagValuesId	Deletes a TagHold.

SELECT examples

Lists TagHolds under a TagValue.

SELECT
name,
createTime,
helpLink,
holder,
origin
FROM google.cloudresourcemanager.tag_holds
WHERE tagValuesId = '{{ tagValuesId }}';

INSERT example

Use the following StackQL query and manifest file to create a new tag_holds resource.

All Properties

/*+ create */
INSERT INTO google.cloudresourcemanager.tag_holds (
tagValuesId,
holder,
origin,
helpLink
)
SELECT 
'{{ tagValuesId }}',
'{{ holder }}',
'{{ origin }}',
'{{ helpLink }}'
;

Manifest

- name: your_resource_model_name
  props:
    - name: name
      value: string
    - name: holder
      value: string
    - name: origin
      value: string
    - name: helpLink
      value: string
    - name: createTime
      value: string

DELETE example

Deletes the specified tag_holds resource.

/*+ delete */
DELETE FROM google.cloudresourcemanager.tag_holds
WHERE tagHoldsId = '{{ tagHoldsId }}'
AND tagValuesId = '{{ tagValuesId }}';