gcloud alpha resource-manager tags keys create

NAME
gcloud alpha resource-manager tags keys create - creates a TagKey resource under the specified tag parent
SYNOPSIS
gcloud alpha resource-manager tags keys create(SHORT_NAME--parent=PARENT)[--allowed-values-regex=ALLOWED_VALUES_REGEX][--async][--description=DESCRIPTION][--purpose=PURPOSE][--purpose-data=[network=NETWORK],[organization=ORGANIZATION]][GCLOUD_WIDE_FLAG …]
EXAMPLES
To create a TagKey with the name env under 'organizations/123' with description'description', run:
gcloudalpharesource-managertagskeyscreateenv--parent=organizations/123--description=description
POSITIONAL ARGUMENTS
TagKey.

This must be specified.

SHORT_NAME
User specified, friendly name of the TagKey or TagValue. The field must be 1-63characters, beginning and ending with an alphanumeric character ([a-z0-9A-Z])with dashes (-), underscores ( _ ), dots (.), and alphanumerics between.

This positional argument must be specified if any of the other arguments in thisgroup are specified.

--parent=PARENT
Parent of the TagKey in the form of organizations/{org_id}.

This flag argument must be specified if any of the other arguments in this groupare specified.

FLAGS
--allowed-values-regex=ALLOWED_VALUES_REGEX
User-assigned regex of allowed short names of TagValues under a TagKey.
--async
Return immediately, without waiting for the operation in progress to complete.
--description=DESCRIPTION
User-assigned description of the TagKey or TagValue. Must not exceed 256characters.
--purpose=PURPOSE
Purpose specifier of the TagKey that can only be set on creation. Specifyingthis field adds additional validation from the policy system that corresponds tothe purpose.PURPOSE must be one of:GCE_FIREWALL,DATA_GOVERNANCE.
--purpose-data=[network=NETWORK],[organization=ORGANIZATION]
Purpose data of the TagKey that can only be set on creation. This data isvalidated by the policy system that corresponds to the purpose.
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 thiscommand fails with API permission errors despite specifying the correct project,you might be trying to access an API with an invitation-only early accessallowlist. These variants are also available:
gcloudresource-managertagskeyscreate
gcloudbetaresource-managertagskeyscreate

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-06-10 UTC.