NAME

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

SYNOPSIS

gcloud beta resource-manager tags holds create PARENT --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 {org_id}/{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-a

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

NOTES

This command is currently in beta and might change without notice. These variants are also available:

$ gcloud resource-manager tags holds create

$ gcloud alpha resource-manager tags holds create