gcloud alpha resource-manager tags holds create

NAME

gcloud alpha resource-manager tags holds create - create a TagHold resource

SYNOPSIS

gcloud alpha resource-manager tags holds create PARENT --holder=HOLDER [--help-link=HELP_LINK] [--location=LOCATION] [--origin=ORIGIN] [GCLOUD_WIDE_FLAG …]

DESCRIPTION

(ALPHA) 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 alpha resource-manager tags holds create tagValues/123 --holder=cloud-resource-holder --origin=creator-origin --help-link=www.example.help.link.com --location=us-central1-a

To create a TagHold under TagValue test under TagKey env in organization id 789, with holder cloud-resource-holder, run:

gcloud alpha 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 help for details.

NOTES

This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early access allowlist. These variants are also available:

gcloud resource-manager tags holds create

gcloud beta resource-manager tags holds create