- NAME
-
- gcloud beta resource-manager tags holds create - create a TagHold resource
- SYNOPSIS
-
-
gcloud beta resource-manager tags holds createPARENT--holder=HOLDER[--help-link=HELP_LINK] [--location=LOCATION] [--origin=ORIGIN] [GCLOUD_WIDE_FLAG …]
-
- DESCRIPTION
-
(BETA)Create a TagHold under a TagValue, indicating that the TagValue is being used by a holder (cloud resource) from an (optional) origin. The TagValue can be represented with its numeric id or its namespaced name of {parent_namespace}/{tag_key_short_name}/{tag_value_short_name}. - EXAMPLES
- To create a TagHold on tagValues/123, with holder cloud-resource-holder, origin
creator-origin, in region us-central1-a, with help link
www.example.help.link.com, run:
gcloud beta resource-manager tags holds create tagValues/123 --holder = cloud-resource-holder --origin = creator-origin --help-link = www.example.help.link.com --location = us-central1-aTo create a TagHold under TagValue test under TagKey env in organization id 789, with holder cloud-resource-holder, run:
gcloud beta resource-manager tags holds create 789 /env/test --holder = cloud-resource-holder - POSITIONAL ARGUMENTS
-
-
PARENT - Tag value name or namespaced name.
-
- REQUIRED FLAGS
-
-
--holder=HOLDER - The name of the resource where the TagValue is being used. Must be less than 200 characters.
-
- OPTIONAL FLAGS
-
-
--help-link=HELP_LINK - A URL where an end user can learn more about removing this hold.
-
--location=LOCATION - Region or zone where the TagHold will be stored. If not provided, the TagHold will be stored in a "global" region.
-
--origin=ORIGIN - 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.
-
- GCLOUD WIDE FLAGS
- These flags are available to all commands:
--access-token-file,--account,--billing-project,--configuration,--flags-file,--flatten,--format,--help,--impersonate-service-account,--log-http,--project,--quiet,--trace-token,--user-output-enabled,--verbosity.Run
$ gcloud helpfor details. - NOTES
- This command is currently in beta and might change without notice. These
variants are also available:
gcloud resource-manager tags holds creategcloud alpha resource-manager tags holds create
gcloud beta resource-manager tags holds create
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-05-27 UTC.

