gcp.datacatalog.TagTemplate
Explore with Pulumi AI
A tag template defines a tag, which can have one or more typed fields. The template is used to create and attach the tag to GCP resources.
To get more information about TagTemplate, see:
- API documentation
- How-to Guides
Example Usage
Data Catalog Tag Template Basic
import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";
const basicTagTemplate = new gcp.datacatalog.TagTemplate("basic_tag_template", {
tagTemplateId: "my_template",
region: "us-central1",
displayName: "Demo Tag Template",
fields: [
{
fieldId: "source",
displayName: "Source of data asset",
type: {
primitiveType: "STRING",
},
isRequired: true,
},
{
fieldId: "num_rows",
displayName: "Number of rows in the data asset",
type: {
primitiveType: "DOUBLE",
},
},
{
fieldId: "pii_type",
displayName: "PII type",
type: {
enumType: {
allowedValues: [
{
displayName: "EMAIL",
},
{
displayName: "SOCIAL SECURITY NUMBER",
},
{
displayName: "NONE",
},
],
},
},
},
],
forceDelete: false,
});
import pulumi
import pulumi_gcp as gcp
basic_tag_template = gcp.datacatalog.TagTemplate("basic_tag_template",
tag_template_id="my_template",
region="us-central1",
display_name="Demo Tag Template",
fields=[
gcp.datacatalog.TagTemplateFieldArgs(
field_id="source",
display_name="Source of data asset",
type=gcp.datacatalog.TagTemplateFieldTypeArgs(
primitive_type="STRING",
),
is_required=True,
),
gcp.datacatalog.TagTemplateFieldArgs(
field_id="num_rows",
display_name="Number of rows in the data asset",
type=gcp.datacatalog.TagTemplateFieldTypeArgs(
primitive_type="DOUBLE",
),
),
gcp.datacatalog.TagTemplateFieldArgs(
field_id="pii_type",
display_name="PII type",
type=gcp.datacatalog.TagTemplateFieldTypeArgs(
enum_type=gcp.datacatalog.TagTemplateFieldTypeEnumTypeArgs(
allowed_values=[
gcp.datacatalog.TagTemplateFieldTypeEnumTypeAllowedValueArgs(
display_name="EMAIL",
),
gcp.datacatalog.TagTemplateFieldTypeEnumTypeAllowedValueArgs(
display_name="SOCIAL SECURITY NUMBER",
),
gcp.datacatalog.TagTemplateFieldTypeEnumTypeAllowedValueArgs(
display_name="NONE",
),
],
),
),
),
],
force_delete=False)
package main
import (
"github.com/pulumi/pulumi-gcp/sdk/v7/go/gcp/datacatalog"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := datacatalog.NewTagTemplate(ctx, "basic_tag_template", &datacatalog.TagTemplateArgs{
TagTemplateId: pulumi.String("my_template"),
Region: pulumi.String("us-central1"),
DisplayName: pulumi.String("Demo Tag Template"),
Fields: datacatalog.TagTemplateFieldArray{
&datacatalog.TagTemplateFieldArgs{
FieldId: pulumi.String("source"),
DisplayName: pulumi.String("Source of data asset"),
Type: &datacatalog.TagTemplateFieldTypeArgs{
PrimitiveType: pulumi.String("STRING"),
},
IsRequired: pulumi.Bool(true),
},
&datacatalog.TagTemplateFieldArgs{
FieldId: pulumi.String("num_rows"),
DisplayName: pulumi.String("Number of rows in the data asset"),
Type: &datacatalog.TagTemplateFieldTypeArgs{
PrimitiveType: pulumi.String("DOUBLE"),
},
},
&datacatalog.TagTemplateFieldArgs{
FieldId: pulumi.String("pii_type"),
DisplayName: pulumi.String("PII type"),
Type: &datacatalog.TagTemplateFieldTypeArgs{
EnumType: &datacatalog.TagTemplateFieldTypeEnumTypeArgs{
AllowedValues: datacatalog.TagTemplateFieldTypeEnumTypeAllowedValueArray{
&datacatalog.TagTemplateFieldTypeEnumTypeAllowedValueArgs{
DisplayName: pulumi.String("EMAIL"),
},
&datacatalog.TagTemplateFieldTypeEnumTypeAllowedValueArgs{
DisplayName: pulumi.String("SOCIAL SECURITY NUMBER"),
},
&datacatalog.TagTemplateFieldTypeEnumTypeAllowedValueArgs{
DisplayName: pulumi.String("NONE"),
},
},
},
},
},
},
ForceDelete: pulumi.Bool(false),
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcp = Pulumi.Gcp;
return await Deployment.RunAsync(() =>
{
var basicTagTemplate = new Gcp.DataCatalog.TagTemplate("basic_tag_template", new()
{
TagTemplateId = "my_template",
Region = "us-central1",
DisplayName = "Demo Tag Template",
Fields = new[]
{
new Gcp.DataCatalog.Inputs.TagTemplateFieldArgs
{
FieldId = "source",
DisplayName = "Source of data asset",
Type = new Gcp.DataCatalog.Inputs.TagTemplateFieldTypeArgs
{
PrimitiveType = "STRING",
},
IsRequired = true,
},
new Gcp.DataCatalog.Inputs.TagTemplateFieldArgs
{
FieldId = "num_rows",
DisplayName = "Number of rows in the data asset",
Type = new Gcp.DataCatalog.Inputs.TagTemplateFieldTypeArgs
{
PrimitiveType = "DOUBLE",
},
},
new Gcp.DataCatalog.Inputs.TagTemplateFieldArgs
{
FieldId = "pii_type",
DisplayName = "PII type",
Type = new Gcp.DataCatalog.Inputs.TagTemplateFieldTypeArgs
{
EnumType = new Gcp.DataCatalog.Inputs.TagTemplateFieldTypeEnumTypeArgs
{
AllowedValues = new[]
{
new Gcp.DataCatalog.Inputs.TagTemplateFieldTypeEnumTypeAllowedValueArgs
{
DisplayName = "EMAIL",
},
new Gcp.DataCatalog.Inputs.TagTemplateFieldTypeEnumTypeAllowedValueArgs
{
DisplayName = "SOCIAL SECURITY NUMBER",
},
new Gcp.DataCatalog.Inputs.TagTemplateFieldTypeEnumTypeAllowedValueArgs
{
DisplayName = "NONE",
},
},
},
},
},
},
ForceDelete = false,
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.datacatalog.TagTemplate;
import com.pulumi.gcp.datacatalog.TagTemplateArgs;
import com.pulumi.gcp.datacatalog.inputs.TagTemplateFieldArgs;
import com.pulumi.gcp.datacatalog.inputs.TagTemplateFieldTypeArgs;
import com.pulumi.gcp.datacatalog.inputs.TagTemplateFieldTypeEnumTypeArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var basicTagTemplate = new TagTemplate("basicTagTemplate", TagTemplateArgs.builder()
.tagTemplateId("my_template")
.region("us-central1")
.displayName("Demo Tag Template")
.fields(
TagTemplateFieldArgs.builder()
.fieldId("source")
.displayName("Source of data asset")
.type(TagTemplateFieldTypeArgs.builder()
.primitiveType("STRING")
.build())
.isRequired(true)
.build(),
TagTemplateFieldArgs.builder()
.fieldId("num_rows")
.displayName("Number of rows in the data asset")
.type(TagTemplateFieldTypeArgs.builder()
.primitiveType("DOUBLE")
.build())
.build(),
TagTemplateFieldArgs.builder()
.fieldId("pii_type")
.displayName("PII type")
.type(TagTemplateFieldTypeArgs.builder()
.enumType(TagTemplateFieldTypeEnumTypeArgs.builder()
.allowedValues(
TagTemplateFieldTypeEnumTypeAllowedValueArgs.builder()
.displayName("EMAIL")
.build(),
TagTemplateFieldTypeEnumTypeAllowedValueArgs.builder()
.displayName("SOCIAL SECURITY NUMBER")
.build(),
TagTemplateFieldTypeEnumTypeAllowedValueArgs.builder()
.displayName("NONE")
.build())
.build())
.build())
.build())
.forceDelete("false")
.build());
}
}
resources:
basicTagTemplate:
type: gcp:datacatalog:TagTemplate
name: basic_tag_template
properties:
tagTemplateId: my_template
region: us-central1
displayName: Demo Tag Template
fields:
- fieldId: source
displayName: Source of data asset
type:
primitiveType: STRING
isRequired: true
- fieldId: num_rows
displayName: Number of rows in the data asset
type:
primitiveType: DOUBLE
- fieldId: pii_type
displayName: PII type
type:
enumType:
allowedValues:
- displayName: EMAIL
- displayName: SOCIAL SECURITY NUMBER
- displayName: NONE
forceDelete: 'false'
Create TagTemplate Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new TagTemplate(name: string, args: TagTemplateArgs, opts?: CustomResourceOptions);
@overload
def TagTemplate(resource_name: str,
args: TagTemplateArgs,
opts: Optional[ResourceOptions] = None)
@overload
def TagTemplate(resource_name: str,
opts: Optional[ResourceOptions] = None,
fields: Optional[Sequence[TagTemplateFieldArgs]] = None,
tag_template_id: Optional[str] = None,
display_name: Optional[str] = None,
force_delete: Optional[bool] = None,
project: Optional[str] = None,
region: Optional[str] = None)
func NewTagTemplate(ctx *Context, name string, args TagTemplateArgs, opts ...ResourceOption) (*TagTemplate, error)
public TagTemplate(string name, TagTemplateArgs args, CustomResourceOptions? opts = null)
public TagTemplate(String name, TagTemplateArgs args)
public TagTemplate(String name, TagTemplateArgs args, CustomResourceOptions options)
type: gcp:datacatalog:TagTemplate
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args TagTemplateArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args TagTemplateArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args TagTemplateArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args TagTemplateArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args TagTemplateArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Constructor example
The following reference example uses placeholder values for all input properties.
var tagTemplateResource = new Gcp.DataCatalog.TagTemplate("tagTemplateResource", new()
{
Fields = new[]
{
new Gcp.DataCatalog.Inputs.TagTemplateFieldArgs
{
FieldId = "string",
Type = new Gcp.DataCatalog.Inputs.TagTemplateFieldTypeArgs
{
EnumType = new Gcp.DataCatalog.Inputs.TagTemplateFieldTypeEnumTypeArgs
{
AllowedValues = new[]
{
new Gcp.DataCatalog.Inputs.TagTemplateFieldTypeEnumTypeAllowedValueArgs
{
DisplayName = "string",
},
},
},
PrimitiveType = "string",
},
Description = "string",
DisplayName = "string",
IsRequired = false,
Name = "string",
Order = 0,
},
},
TagTemplateId = "string",
DisplayName = "string",
ForceDelete = false,
Project = "string",
Region = "string",
});
example, err := datacatalog.NewTagTemplate(ctx, "tagTemplateResource", &datacatalog.TagTemplateArgs{
Fields: datacatalog.TagTemplateFieldArray{
&datacatalog.TagTemplateFieldArgs{
FieldId: pulumi.String("string"),
Type: &datacatalog.TagTemplateFieldTypeArgs{
EnumType: &datacatalog.TagTemplateFieldTypeEnumTypeArgs{
AllowedValues: datacatalog.TagTemplateFieldTypeEnumTypeAllowedValueArray{
&datacatalog.TagTemplateFieldTypeEnumTypeAllowedValueArgs{
DisplayName: pulumi.String("string"),
},
},
},
PrimitiveType: pulumi.String("string"),
},
Description: pulumi.String("string"),
DisplayName: pulumi.String("string"),
IsRequired: pulumi.Bool(false),
Name: pulumi.String("string"),
Order: pulumi.Int(0),
},
},
TagTemplateId: pulumi.String("string"),
DisplayName: pulumi.String("string"),
ForceDelete: pulumi.Bool(false),
Project: pulumi.String("string"),
Region: pulumi.String("string"),
})
var tagTemplateResource = new TagTemplate("tagTemplateResource", TagTemplateArgs.builder()
.fields(TagTemplateFieldArgs.builder()
.fieldId("string")
.type(TagTemplateFieldTypeArgs.builder()
.enumType(TagTemplateFieldTypeEnumTypeArgs.builder()
.allowedValues(TagTemplateFieldTypeEnumTypeAllowedValueArgs.builder()
.displayName("string")
.build())
.build())
.primitiveType("string")
.build())
.description("string")
.displayName("string")
.isRequired(false)
.name("string")
.order(0)
.build())
.tagTemplateId("string")
.displayName("string")
.forceDelete(false)
.project("string")
.region("string")
.build());
tag_template_resource = gcp.datacatalog.TagTemplate("tagTemplateResource",
fields=[gcp.datacatalog.TagTemplateFieldArgs(
field_id="string",
type=gcp.datacatalog.TagTemplateFieldTypeArgs(
enum_type=gcp.datacatalog.TagTemplateFieldTypeEnumTypeArgs(
allowed_values=[gcp.datacatalog.TagTemplateFieldTypeEnumTypeAllowedValueArgs(
display_name="string",
)],
),
primitive_type="string",
),
description="string",
display_name="string",
is_required=False,
name="string",
order=0,
)],
tag_template_id="string",
display_name="string",
force_delete=False,
project="string",
region="string")
const tagTemplateResource = new gcp.datacatalog.TagTemplate("tagTemplateResource", {
fields: [{
fieldId: "string",
type: {
enumType: {
allowedValues: [{
displayName: "string",
}],
},
primitiveType: "string",
},
description: "string",
displayName: "string",
isRequired: false,
name: "string",
order: 0,
}],
tagTemplateId: "string",
displayName: "string",
forceDelete: false,
project: "string",
region: "string",
});
type: gcp:datacatalog:TagTemplate
properties:
displayName: string
fields:
- description: string
displayName: string
fieldId: string
isRequired: false
name: string
order: 0
type:
enumType:
allowedValues:
- displayName: string
primitiveType: string
forceDelete: false
project: string
region: string
tagTemplateId: string
TagTemplate Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
The TagTemplate resource accepts the following input properties:
- Fields
List<Tag
Template Field> - Set of tag template field IDs and the settings for the field. This set is an exhaustive list of the allowed fields. This set must contain at least one field and at most 500 fields. The change of field_id will be resulting in re-creating of field. The change of primitive_type will be resulting in re-creating of field, however if the field is a required, you cannot update it. Structure is documented below.
- Tag
Template stringId - The id of the tag template to create.
- Display
Name string - The display name for this template.
- Force
Delete bool - This confirms the deletion of any possible tags using this template. Must be set to true in order to delete the tag template.
- Project string
- Region string
- Template location region.
- Fields
[]Tag
Template Field Args - Set of tag template field IDs and the settings for the field. This set is an exhaustive list of the allowed fields. This set must contain at least one field and at most 500 fields. The change of field_id will be resulting in re-creating of field. The change of primitive_type will be resulting in re-creating of field, however if the field is a required, you cannot update it. Structure is documented below.
- Tag
Template stringId - The id of the tag template to create.
- Display
Name string - The display name for this template.
- Force
Delete bool - This confirms the deletion of any possible tags using this template. Must be set to true in order to delete the tag template.
- Project string
- Region string
- Template location region.
- fields
List<Tag
Template Field> - Set of tag template field IDs and the settings for the field. This set is an exhaustive list of the allowed fields. This set must contain at least one field and at most 500 fields. The change of field_id will be resulting in re-creating of field. The change of primitive_type will be resulting in re-creating of field, however if the field is a required, you cannot update it. Structure is documented below.
- tag
Template StringId - The id of the tag template to create.
- display
Name String - The display name for this template.
- force
Delete Boolean - This confirms the deletion of any possible tags using this template. Must be set to true in order to delete the tag template.
- project String
- region String
- Template location region.
- fields
Tag
Template Field[] - Set of tag template field IDs and the settings for the field. This set is an exhaustive list of the allowed fields. This set must contain at least one field and at most 500 fields. The change of field_id will be resulting in re-creating of field. The change of primitive_type will be resulting in re-creating of field, however if the field is a required, you cannot update it. Structure is documented below.
- tag
Template stringId - The id of the tag template to create.
- display
Name string - The display name for this template.
- force
Delete boolean - This confirms the deletion of any possible tags using this template. Must be set to true in order to delete the tag template.
- project string
- region string
- Template location region.
- fields
Sequence[Tag
Template Field Args] - Set of tag template field IDs and the settings for the field. This set is an exhaustive list of the allowed fields. This set must contain at least one field and at most 500 fields. The change of field_id will be resulting in re-creating of field. The change of primitive_type will be resulting in re-creating of field, however if the field is a required, you cannot update it. Structure is documented below.
- tag_
template_ strid - The id of the tag template to create.
- display_
name str - The display name for this template.
- force_
delete bool - This confirms the deletion of any possible tags using this template. Must be set to true in order to delete the tag template.
- project str
- region str
- Template location region.
- fields List<Property Map>
- Set of tag template field IDs and the settings for the field. This set is an exhaustive list of the allowed fields. This set must contain at least one field and at most 500 fields. The change of field_id will be resulting in re-creating of field. The change of primitive_type will be resulting in re-creating of field, however if the field is a required, you cannot update it. Structure is documented below.
- tag
Template StringId - The id of the tag template to create.
- display
Name String - The display name for this template.
- force
Delete Boolean - This confirms the deletion of any possible tags using this template. Must be set to true in order to delete the tag template.
- project String
- region String
- Template location region.
Outputs
All input properties are implicitly available as output properties. Additionally, the TagTemplate resource produces the following output properties:
Look up Existing TagTemplate Resource
Get an existing TagTemplate resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: TagTemplateState, opts?: CustomResourceOptions): TagTemplate
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
display_name: Optional[str] = None,
fields: Optional[Sequence[TagTemplateFieldArgs]] = None,
force_delete: Optional[bool] = None,
name: Optional[str] = None,
project: Optional[str] = None,
region: Optional[str] = None,
tag_template_id: Optional[str] = None) -> TagTemplate
func GetTagTemplate(ctx *Context, name string, id IDInput, state *TagTemplateState, opts ...ResourceOption) (*TagTemplate, error)
public static TagTemplate Get(string name, Input<string> id, TagTemplateState? state, CustomResourceOptions? opts = null)
public static TagTemplate get(String name, Output<String> id, TagTemplateState state, CustomResourceOptions options)
Resource lookup is not supported in YAML
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Display
Name string - The display name for this template.
- Fields
List<Tag
Template Field> - Set of tag template field IDs and the settings for the field. This set is an exhaustive list of the allowed fields. This set must contain at least one field and at most 500 fields. The change of field_id will be resulting in re-creating of field. The change of primitive_type will be resulting in re-creating of field, however if the field is a required, you cannot update it. Structure is documented below.
- Force
Delete bool - This confirms the deletion of any possible tags using this template. Must be set to true in order to delete the tag template.
- Name string
- The resource name of the tag template in URL format. Example: projects/{project_id}/locations/{location}/tagTemplates/{tagTemplateId}
- Project string
- Region string
- Template location region.
- Tag
Template stringId - The id of the tag template to create.
- Display
Name string - The display name for this template.
- Fields
[]Tag
Template Field Args - Set of tag template field IDs and the settings for the field. This set is an exhaustive list of the allowed fields. This set must contain at least one field and at most 500 fields. The change of field_id will be resulting in re-creating of field. The change of primitive_type will be resulting in re-creating of field, however if the field is a required, you cannot update it. Structure is documented below.
- Force
Delete bool - This confirms the deletion of any possible tags using this template. Must be set to true in order to delete the tag template.
- Name string
- The resource name of the tag template in URL format. Example: projects/{project_id}/locations/{location}/tagTemplates/{tagTemplateId}
- Project string
- Region string
- Template location region.
- Tag
Template stringId - The id of the tag template to create.
- display
Name String - The display name for this template.
- fields
List<Tag
Template Field> - Set of tag template field IDs and the settings for the field. This set is an exhaustive list of the allowed fields. This set must contain at least one field and at most 500 fields. The change of field_id will be resulting in re-creating of field. The change of primitive_type will be resulting in re-creating of field, however if the field is a required, you cannot update it. Structure is documented below.
- force
Delete Boolean - This confirms the deletion of any possible tags using this template. Must be set to true in order to delete the tag template.
- name String
- The resource name of the tag template in URL format. Example: projects/{project_id}/locations/{location}/tagTemplates/{tagTemplateId}
- project String
- region String
- Template location region.
- tag
Template StringId - The id of the tag template to create.
- display
Name string - The display name for this template.
- fields
Tag
Template Field[] - Set of tag template field IDs and the settings for the field. This set is an exhaustive list of the allowed fields. This set must contain at least one field and at most 500 fields. The change of field_id will be resulting in re-creating of field. The change of primitive_type will be resulting in re-creating of field, however if the field is a required, you cannot update it. Structure is documented below.
- force
Delete boolean - This confirms the deletion of any possible tags using this template. Must be set to true in order to delete the tag template.
- name string
- The resource name of the tag template in URL format. Example: projects/{project_id}/locations/{location}/tagTemplates/{tagTemplateId}
- project string
- region string
- Template location region.
- tag
Template stringId - The id of the tag template to create.
- display_
name str - The display name for this template.
- fields
Sequence[Tag
Template Field Args] - Set of tag template field IDs and the settings for the field. This set is an exhaustive list of the allowed fields. This set must contain at least one field and at most 500 fields. The change of field_id will be resulting in re-creating of field. The change of primitive_type will be resulting in re-creating of field, however if the field is a required, you cannot update it. Structure is documented below.
- force_
delete bool - This confirms the deletion of any possible tags using this template. Must be set to true in order to delete the tag template.
- name str
- The resource name of the tag template in URL format. Example: projects/{project_id}/locations/{location}/tagTemplates/{tagTemplateId}
- project str
- region str
- Template location region.
- tag_
template_ strid - The id of the tag template to create.
- display
Name String - The display name for this template.
- fields List<Property Map>
- Set of tag template field IDs and the settings for the field. This set is an exhaustive list of the allowed fields. This set must contain at least one field and at most 500 fields. The change of field_id will be resulting in re-creating of field. The change of primitive_type will be resulting in re-creating of field, however if the field is a required, you cannot update it. Structure is documented below.
- force
Delete Boolean - This confirms the deletion of any possible tags using this template. Must be set to true in order to delete the tag template.
- name String
- The resource name of the tag template in URL format. Example: projects/{project_id}/locations/{location}/tagTemplates/{tagTemplateId}
- project String
- region String
- Template location region.
- tag
Template StringId - The id of the tag template to create.
Supporting Types
TagTemplateField, TagTemplateFieldArgs
- Field
Id string - The identifier for this object. Format specified above.
- Type
Tag
Template Field Type - The type of value this tag field can contain. Structure is documented below.
- Description string
- A description for this field.
- Display
Name string - The display name for this field.
- Is
Required bool - Whether this is a required field. Defaults to false.
- Name string
- (Output) The resource name of the tag template field in URL format. Example: projects/{project_id}/locations/{location}/tagTemplates/{tagTemplateId}/fields/{field}
- Order int
- The order of this field with respect to other fields in this tag template. A higher value indicates a more important field. The value can be negative. Multiple fields can have the same order, and field orders within a tag do not have to be sequential.
- Field
Id string - The identifier for this object. Format specified above.
- Type
Tag
Template Field Type - The type of value this tag field can contain. Structure is documented below.
- Description string
- A description for this field.
- Display
Name string - The display name for this field.
- Is
Required bool - Whether this is a required field. Defaults to false.
- Name string
- (Output) The resource name of the tag template field in URL format. Example: projects/{project_id}/locations/{location}/tagTemplates/{tagTemplateId}/fields/{field}
- Order int
- The order of this field with respect to other fields in this tag template. A higher value indicates a more important field. The value can be negative. Multiple fields can have the same order, and field orders within a tag do not have to be sequential.
- field
Id String - The identifier for this object. Format specified above.
- type
Tag
Template Field Type - The type of value this tag field can contain. Structure is documented below.
- description String
- A description for this field.
- display
Name String - The display name for this field.
- is
Required Boolean - Whether this is a required field. Defaults to false.
- name String
- (Output) The resource name of the tag template field in URL format. Example: projects/{project_id}/locations/{location}/tagTemplates/{tagTemplateId}/fields/{field}
- order Integer
- The order of this field with respect to other fields in this tag template. A higher value indicates a more important field. The value can be negative. Multiple fields can have the same order, and field orders within a tag do not have to be sequential.
- field
Id string - The identifier for this object. Format specified above.
- type
Tag
Template Field Type - The type of value this tag field can contain. Structure is documented below.
- description string
- A description for this field.
- display
Name string - The display name for this field.
- is
Required boolean - Whether this is a required field. Defaults to false.
- name string
- (Output) The resource name of the tag template field in URL format. Example: projects/{project_id}/locations/{location}/tagTemplates/{tagTemplateId}/fields/{field}
- order number
- The order of this field with respect to other fields in this tag template. A higher value indicates a more important field. The value can be negative. Multiple fields can have the same order, and field orders within a tag do not have to be sequential.
- field_
id str - The identifier for this object. Format specified above.
- type
Tag
Template Field Type - The type of value this tag field can contain. Structure is documented below.
- description str
- A description for this field.
- display_
name str - The display name for this field.
- is_
required bool - Whether this is a required field. Defaults to false.
- name str
- (Output) The resource name of the tag template field in URL format. Example: projects/{project_id}/locations/{location}/tagTemplates/{tagTemplateId}/fields/{field}
- order int
- The order of this field with respect to other fields in this tag template. A higher value indicates a more important field. The value can be negative. Multiple fields can have the same order, and field orders within a tag do not have to be sequential.
- field
Id String - The identifier for this object. Format specified above.
- type Property Map
- The type of value this tag field can contain. Structure is documented below.
- description String
- A description for this field.
- display
Name String - The display name for this field.
- is
Required Boolean - Whether this is a required field. Defaults to false.
- name String
- (Output) The resource name of the tag template field in URL format. Example: projects/{project_id}/locations/{location}/tagTemplates/{tagTemplateId}/fields/{field}
- order Number
- The order of this field with respect to other fields in this tag template. A higher value indicates a more important field. The value can be negative. Multiple fields can have the same order, and field orders within a tag do not have to be sequential.
TagTemplateFieldType, TagTemplateFieldTypeArgs
- Enum
Type TagTemplate Field Type Enum Type - Represents an enum type.
Exactly one of
primitive_type
orenum_type
must be set Structure is documented below. - Primitive
Type string - Represents primitive types - string, bool etc.
Exactly one of
primitive_type
orenum_type
must be set Possible values are:DOUBLE
,STRING
,BOOL
,TIMESTAMP
.
- Enum
Type TagTemplate Field Type Enum Type - Represents an enum type.
Exactly one of
primitive_type
orenum_type
must be set Structure is documented below. - Primitive
Type string - Represents primitive types - string, bool etc.
Exactly one of
primitive_type
orenum_type
must be set Possible values are:DOUBLE
,STRING
,BOOL
,TIMESTAMP
.
- enum
Type TagTemplate Field Type Enum Type - Represents an enum type.
Exactly one of
primitive_type
orenum_type
must be set Structure is documented below. - primitive
Type String - Represents primitive types - string, bool etc.
Exactly one of
primitive_type
orenum_type
must be set Possible values are:DOUBLE
,STRING
,BOOL
,TIMESTAMP
.
- enum
Type TagTemplate Field Type Enum Type - Represents an enum type.
Exactly one of
primitive_type
orenum_type
must be set Structure is documented below. - primitive
Type string - Represents primitive types - string, bool etc.
Exactly one of
primitive_type
orenum_type
must be set Possible values are:DOUBLE
,STRING
,BOOL
,TIMESTAMP
.
- enum_
type TagTemplate Field Type Enum Type - Represents an enum type.
Exactly one of
primitive_type
orenum_type
must be set Structure is documented below. - primitive_
type str - Represents primitive types - string, bool etc.
Exactly one of
primitive_type
orenum_type
must be set Possible values are:DOUBLE
,STRING
,BOOL
,TIMESTAMP
.
- enum
Type Property Map - Represents an enum type.
Exactly one of
primitive_type
orenum_type
must be set Structure is documented below. - primitive
Type String - Represents primitive types - string, bool etc.
Exactly one of
primitive_type
orenum_type
must be set Possible values are:DOUBLE
,STRING
,BOOL
,TIMESTAMP
.
TagTemplateFieldTypeEnumType, TagTemplateFieldTypeEnumTypeArgs
- Allowed
Values List<TagTemplate Field Type Enum Type Allowed Value> - The set of allowed values for this enum. The display names of the values must be case-insensitively unique within this set. Currently, enum values can only be added to the list of allowed values. Deletion and renaming of enum values are not supported. Can have up to 500 allowed values. Structure is documented below.
- Allowed
Values []TagTemplate Field Type Enum Type Allowed Value - The set of allowed values for this enum. The display names of the values must be case-insensitively unique within this set. Currently, enum values can only be added to the list of allowed values. Deletion and renaming of enum values are not supported. Can have up to 500 allowed values. Structure is documented below.
- allowed
Values List<TagTemplate Field Type Enum Type Allowed Value> - The set of allowed values for this enum. The display names of the values must be case-insensitively unique within this set. Currently, enum values can only be added to the list of allowed values. Deletion and renaming of enum values are not supported. Can have up to 500 allowed values. Structure is documented below.
- allowed
Values TagTemplate Field Type Enum Type Allowed Value[] - The set of allowed values for this enum. The display names of the values must be case-insensitively unique within this set. Currently, enum values can only be added to the list of allowed values. Deletion and renaming of enum values are not supported. Can have up to 500 allowed values. Structure is documented below.
- allowed_
values Sequence[TagTemplate Field Type Enum Type Allowed Value] - The set of allowed values for this enum. The display names of the values must be case-insensitively unique within this set. Currently, enum values can only be added to the list of allowed values. Deletion and renaming of enum values are not supported. Can have up to 500 allowed values. Structure is documented below.
- allowed
Values List<Property Map> - The set of allowed values for this enum. The display names of the values must be case-insensitively unique within this set. Currently, enum values can only be added to the list of allowed values. Deletion and renaming of enum values are not supported. Can have up to 500 allowed values. Structure is documented below.
TagTemplateFieldTypeEnumTypeAllowedValue, TagTemplateFieldTypeEnumTypeAllowedValueArgs
- Display
Name string - The display name for this template.
- Display
Name string - The display name for this template.
- display
Name String - The display name for this template.
- display
Name string - The display name for this template.
- display_
name str - The display name for this template.
- display
Name String - The display name for this template.
Import
TagTemplate can be imported using any of these accepted formats:
{{name}}
When using the pulumi import
command, TagTemplate can be imported using one of the formats above. For example:
$ pulumi import gcp:datacatalog/tagTemplate:TagTemplate default {{name}}
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- Google Cloud (GCP) Classic pulumi/pulumi-gcp
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
google-beta
Terraform Provider.