Google Cloud Native is in preview. Google Cloud Classic is fully supported.
google-native.cloudresourcemanager/v3.getTagKey
Explore with Pulumi AI
Google Cloud Native is in preview. Google Cloud Classic is fully supported.
Retrieves a TagKey. This method will return PERMISSION_DENIED
if the key does not exist or the user does not have permission to view it.
Using getTagKey
Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.
function getTagKey(args: GetTagKeyArgs, opts?: InvokeOptions): Promise<GetTagKeyResult>
function getTagKeyOutput(args: GetTagKeyOutputArgs, opts?: InvokeOptions): Output<GetTagKeyResult>
def get_tag_key(tag_key_id: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetTagKeyResult
def get_tag_key_output(tag_key_id: Optional[pulumi.Input[str]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetTagKeyResult]
func LookupTagKey(ctx *Context, args *LookupTagKeyArgs, opts ...InvokeOption) (*LookupTagKeyResult, error)
func LookupTagKeyOutput(ctx *Context, args *LookupTagKeyOutputArgs, opts ...InvokeOption) LookupTagKeyResultOutput
> Note: This function is named LookupTagKey
in the Go SDK.
public static class GetTagKey
{
public static Task<GetTagKeyResult> InvokeAsync(GetTagKeyArgs args, InvokeOptions? opts = null)
public static Output<GetTagKeyResult> Invoke(GetTagKeyInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetTagKeyResult> getTagKey(GetTagKeyArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
fn::invoke:
function: google-native:cloudresourcemanager/v3:getTagKey
arguments:
# arguments dictionary
The following arguments are supported:
- Tag
Key stringId
- Tag
Key stringId
- tag
Key StringId
- tag
Key stringId
- tag_
key_ strid
- tag
Key StringId
getTagKey Result
The following output properties are available:
- Create
Time string - Creation time.
- Description string
- Optional. User-assigned description of the TagKey. Must not exceed 256 characters. Read-write.
- Etag string
- Optional. Entity tag which users can pass to prevent race conditions. This field is always set in server responses. See UpdateTagKeyRequest for details.
- Name string
- Immutable. The resource name for a TagKey. Must be in the format
tagKeys/{tag_key_id}
, wheretag_key_id
is the generated numeric id for the TagKey. - Namespaced
Name string - Immutable. Namespaced name of the TagKey.
- Parent string
- Immutable. The resource name of the TagKey's parent. A TagKey can be parented by an Organization or a Project. For a TagKey parented by an Organization, its parent must be in the form
organizations/{org_id}
. For a TagKey parented by a Project, its parent can be in the formprojects/{project_id}
orprojects/{project_number}
. - Purpose string
- Optional. A purpose denotes that this Tag is intended for use in policies of a specific policy engine, and will involve that policy engine in management operations involving this Tag. A purpose does not grant a policy engine exclusive rights to the Tag, and it may be referenced by other policy engines. A purpose cannot be changed once set.
- Purpose
Data Dictionary<string, string> - Optional. Purpose data corresponds to the policy system that the tag is intended for. See documentation for
Purpose
for formatting of this field. Purpose data cannot be changed once set. - Short
Name string - Immutable. The user friendly name for a TagKey. The short name should be unique for TagKeys within the same tag namespace. The short name must be 1-63 characters, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between.
- Update
Time string - Update time.
- Create
Time string - Creation time.
- Description string
- Optional. User-assigned description of the TagKey. Must not exceed 256 characters. Read-write.
- Etag string
- Optional. Entity tag which users can pass to prevent race conditions. This field is always set in server responses. See UpdateTagKeyRequest for details.
- Name string
- Immutable. The resource name for a TagKey. Must be in the format
tagKeys/{tag_key_id}
, wheretag_key_id
is the generated numeric id for the TagKey. - Namespaced
Name string - Immutable. Namespaced name of the TagKey.
- Parent string
- Immutable. The resource name of the TagKey's parent. A TagKey can be parented by an Organization or a Project. For a TagKey parented by an Organization, its parent must be in the form
organizations/{org_id}
. For a TagKey parented by a Project, its parent can be in the formprojects/{project_id}
orprojects/{project_number}
. - Purpose string
- Optional. A purpose denotes that this Tag is intended for use in policies of a specific policy engine, and will involve that policy engine in management operations involving this Tag. A purpose does not grant a policy engine exclusive rights to the Tag, and it may be referenced by other policy engines. A purpose cannot be changed once set.
- Purpose
Data map[string]string - Optional. Purpose data corresponds to the policy system that the tag is intended for. See documentation for
Purpose
for formatting of this field. Purpose data cannot be changed once set. - Short
Name string - Immutable. The user friendly name for a TagKey. The short name should be unique for TagKeys within the same tag namespace. The short name must be 1-63 characters, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between.
- Update
Time string - Update time.
- create
Time String - Creation time.
- description String
- Optional. User-assigned description of the TagKey. Must not exceed 256 characters. Read-write.
- etag String
- Optional. Entity tag which users can pass to prevent race conditions. This field is always set in server responses. See UpdateTagKeyRequest for details.
- name String
- Immutable. The resource name for a TagKey. Must be in the format
tagKeys/{tag_key_id}
, wheretag_key_id
is the generated numeric id for the TagKey. - namespaced
Name String - Immutable. Namespaced name of the TagKey.
- parent String
- Immutable. The resource name of the TagKey's parent. A TagKey can be parented by an Organization or a Project. For a TagKey parented by an Organization, its parent must be in the form
organizations/{org_id}
. For a TagKey parented by a Project, its parent can be in the formprojects/{project_id}
orprojects/{project_number}
. - purpose String
- Optional. A purpose denotes that this Tag is intended for use in policies of a specific policy engine, and will involve that policy engine in management operations involving this Tag. A purpose does not grant a policy engine exclusive rights to the Tag, and it may be referenced by other policy engines. A purpose cannot be changed once set.
- purpose
Data Map<String,String> - Optional. Purpose data corresponds to the policy system that the tag is intended for. See documentation for
Purpose
for formatting of this field. Purpose data cannot be changed once set. - short
Name String - Immutable. The user friendly name for a TagKey. The short name should be unique for TagKeys within the same tag namespace. The short name must be 1-63 characters, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between.
- update
Time String - Update time.
- create
Time string - Creation time.
- description string
- Optional. User-assigned description of the TagKey. Must not exceed 256 characters. Read-write.
- etag string
- Optional. Entity tag which users can pass to prevent race conditions. This field is always set in server responses. See UpdateTagKeyRequest for details.
- name string
- Immutable. The resource name for a TagKey. Must be in the format
tagKeys/{tag_key_id}
, wheretag_key_id
is the generated numeric id for the TagKey. - namespaced
Name string - Immutable. Namespaced name of the TagKey.
- parent string
- Immutable. The resource name of the TagKey's parent. A TagKey can be parented by an Organization or a Project. For a TagKey parented by an Organization, its parent must be in the form
organizations/{org_id}
. For a TagKey parented by a Project, its parent can be in the formprojects/{project_id}
orprojects/{project_number}
. - purpose string
- Optional. A purpose denotes that this Tag is intended for use in policies of a specific policy engine, and will involve that policy engine in management operations involving this Tag. A purpose does not grant a policy engine exclusive rights to the Tag, and it may be referenced by other policy engines. A purpose cannot be changed once set.
- purpose
Data {[key: string]: string} - Optional. Purpose data corresponds to the policy system that the tag is intended for. See documentation for
Purpose
for formatting of this field. Purpose data cannot be changed once set. - short
Name string - Immutable. The user friendly name for a TagKey. The short name should be unique for TagKeys within the same tag namespace. The short name must be 1-63 characters, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between.
- update
Time string - Update time.
- create_
time str - Creation time.
- description str
- Optional. User-assigned description of the TagKey. Must not exceed 256 characters. Read-write.
- etag str
- Optional. Entity tag which users can pass to prevent race conditions. This field is always set in server responses. See UpdateTagKeyRequest for details.
- name str
- Immutable. The resource name for a TagKey. Must be in the format
tagKeys/{tag_key_id}
, wheretag_key_id
is the generated numeric id for the TagKey. - namespaced_
name str - Immutable. Namespaced name of the TagKey.
- parent str
- Immutable. The resource name of the TagKey's parent. A TagKey can be parented by an Organization or a Project. For a TagKey parented by an Organization, its parent must be in the form
organizations/{org_id}
. For a TagKey parented by a Project, its parent can be in the formprojects/{project_id}
orprojects/{project_number}
. - purpose str
- Optional. A purpose denotes that this Tag is intended for use in policies of a specific policy engine, and will involve that policy engine in management operations involving this Tag. A purpose does not grant a policy engine exclusive rights to the Tag, and it may be referenced by other policy engines. A purpose cannot be changed once set.
- purpose_
data Mapping[str, str] - Optional. Purpose data corresponds to the policy system that the tag is intended for. See documentation for
Purpose
for formatting of this field. Purpose data cannot be changed once set. - short_
name str - Immutable. The user friendly name for a TagKey. The short name should be unique for TagKeys within the same tag namespace. The short name must be 1-63 characters, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between.
- update_
time str - Update time.
- create
Time String - Creation time.
- description String
- Optional. User-assigned description of the TagKey. Must not exceed 256 characters. Read-write.
- etag String
- Optional. Entity tag which users can pass to prevent race conditions. This field is always set in server responses. See UpdateTagKeyRequest for details.
- name String
- Immutable. The resource name for a TagKey. Must be in the format
tagKeys/{tag_key_id}
, wheretag_key_id
is the generated numeric id for the TagKey. - namespaced
Name String - Immutable. Namespaced name of the TagKey.
- parent String
- Immutable. The resource name of the TagKey's parent. A TagKey can be parented by an Organization or a Project. For a TagKey parented by an Organization, its parent must be in the form
organizations/{org_id}
. For a TagKey parented by a Project, its parent can be in the formprojects/{project_id}
orprojects/{project_number}
. - purpose String
- Optional. A purpose denotes that this Tag is intended for use in policies of a specific policy engine, and will involve that policy engine in management operations involving this Tag. A purpose does not grant a policy engine exclusive rights to the Tag, and it may be referenced by other policy engines. A purpose cannot be changed once set.
- purpose
Data Map<String> - Optional. Purpose data corresponds to the policy system that the tag is intended for. See documentation for
Purpose
for formatting of this field. Purpose data cannot be changed once set. - short
Name String - Immutable. The user friendly name for a TagKey. The short name should be unique for TagKeys within the same tag namespace. The short name must be 1-63 characters, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between.
- update
Time String - Update time.
Package Details
- Repository
- Google Cloud Native pulumi/pulumi-google-native
- License
- Apache-2.0
Google Cloud Native is in preview. Google Cloud Classic is fully supported.