1. Packages
  2. Google Cloud Native
  3. API Docs
  4. datacatalog
  5. datacatalog/v1beta1
  6. Taxonomy

Google Cloud Native is in preview. Google Cloud Classic is fully supported.

Google Cloud Native v0.32.0 published on Wednesday, Nov 29, 2023 by Pulumi

google-native.datacatalog/v1beta1.Taxonomy

Explore with Pulumi AI

google-native logo

Google Cloud Native is in preview. Google Cloud Classic is fully supported.

Google Cloud Native v0.32.0 published on Wednesday, Nov 29, 2023 by Pulumi

    Creates a taxonomy in the specified project. Auto-naming is currently not supported for this resource.

    Create Taxonomy Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new Taxonomy(name: string, args: TaxonomyArgs, opts?: CustomResourceOptions);
    @overload
    def Taxonomy(resource_name: str,
                 args: TaxonomyArgs,
                 opts: Optional[ResourceOptions] = None)
    
    @overload
    def Taxonomy(resource_name: str,
                 opts: Optional[ResourceOptions] = None,
                 display_name: Optional[str] = None,
                 activated_policy_types: Optional[Sequence[TaxonomyActivatedPolicyTypesItem]] = None,
                 description: Optional[str] = None,
                 location: Optional[str] = None,
                 project: Optional[str] = None)
    func NewTaxonomy(ctx *Context, name string, args TaxonomyArgs, opts ...ResourceOption) (*Taxonomy, error)
    public Taxonomy(string name, TaxonomyArgs args, CustomResourceOptions? opts = null)
    public Taxonomy(String name, TaxonomyArgs args)
    public Taxonomy(String name, TaxonomyArgs args, CustomResourceOptions options)
    
    type: google-native:datacatalog/v1beta1:Taxonomy
    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 TaxonomyArgs
    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 TaxonomyArgs
    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 TaxonomyArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args TaxonomyArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args TaxonomyArgs
    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 google_nativeTaxonomyResource = new GoogleNative.DataCatalog.V1Beta1.Taxonomy("google-nativeTaxonomyResource", new()
    {
        DisplayName = "string",
        ActivatedPolicyTypes = new[]
        {
            GoogleNative.DataCatalog.V1Beta1.TaxonomyActivatedPolicyTypesItem.PolicyTypeUnspecified,
        },
        Description = "string",
        Location = "string",
        Project = "string",
    });
    
    example, err := datacatalogv1beta1.NewTaxonomy(ctx, "google-nativeTaxonomyResource", &datacatalogv1beta1.TaxonomyArgs{
    	DisplayName: pulumi.String("string"),
    	ActivatedPolicyTypes: datacatalog.TaxonomyActivatedPolicyTypesItemArray{
    		datacatalogv1beta1.TaxonomyActivatedPolicyTypesItemPolicyTypeUnspecified,
    	},
    	Description: pulumi.String("string"),
    	Location:    pulumi.String("string"),
    	Project:     pulumi.String("string"),
    })
    
    var google_nativeTaxonomyResource = new Taxonomy("google-nativeTaxonomyResource", TaxonomyArgs.builder()
        .displayName("string")
        .activatedPolicyTypes("POLICY_TYPE_UNSPECIFIED")
        .description("string")
        .location("string")
        .project("string")
        .build());
    
    google_native_taxonomy_resource = google_native.datacatalog.v1beta1.Taxonomy("google-nativeTaxonomyResource",
        display_name="string",
        activated_policy_types=[google_native.datacatalog.v1beta1.TaxonomyActivatedPolicyTypesItem.POLICY_TYPE_UNSPECIFIED],
        description="string",
        location="string",
        project="string")
    
    const google_nativeTaxonomyResource = new google_native.datacatalog.v1beta1.Taxonomy("google-nativeTaxonomyResource", {
        displayName: "string",
        activatedPolicyTypes: [google_native.datacatalog.v1beta1.TaxonomyActivatedPolicyTypesItem.PolicyTypeUnspecified],
        description: "string",
        location: "string",
        project: "string",
    });
    
    type: google-native:datacatalog/v1beta1:Taxonomy
    properties:
        activatedPolicyTypes:
            - POLICY_TYPE_UNSPECIFIED
        description: string
        displayName: string
        location: string
        project: string
    

    Taxonomy Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The Taxonomy resource accepts the following input properties:

    DisplayName string
    User defined name of this taxonomy. It must: contain only unicode letters, numbers, underscores, dashes and spaces; not start or end with spaces; and be at most 200 bytes long when encoded in UTF-8. The taxonomy display name must be unique within an organization.
    ActivatedPolicyTypes List<Pulumi.GoogleNative.DataCatalog.V1Beta1.TaxonomyActivatedPolicyTypesItem>
    Optional. A list of policy types that are activated for this taxonomy. If not set, defaults to an empty list.
    Description string
    Optional. Description of this taxonomy. It must: contain only unicode characters, tabs, newlines, carriage returns and page breaks; and be at most 2000 bytes long when encoded in UTF-8. If not set, defaults to an empty description.
    Location string
    Project string
    DisplayName string
    User defined name of this taxonomy. It must: contain only unicode letters, numbers, underscores, dashes and spaces; not start or end with spaces; and be at most 200 bytes long when encoded in UTF-8. The taxonomy display name must be unique within an organization.
    ActivatedPolicyTypes []TaxonomyActivatedPolicyTypesItem
    Optional. A list of policy types that are activated for this taxonomy. If not set, defaults to an empty list.
    Description string
    Optional. Description of this taxonomy. It must: contain only unicode characters, tabs, newlines, carriage returns and page breaks; and be at most 2000 bytes long when encoded in UTF-8. If not set, defaults to an empty description.
    Location string
    Project string
    displayName String
    User defined name of this taxonomy. It must: contain only unicode letters, numbers, underscores, dashes and spaces; not start or end with spaces; and be at most 200 bytes long when encoded in UTF-8. The taxonomy display name must be unique within an organization.
    activatedPolicyTypes List<TaxonomyActivatedPolicyTypesItem>
    Optional. A list of policy types that are activated for this taxonomy. If not set, defaults to an empty list.
    description String
    Optional. Description of this taxonomy. It must: contain only unicode characters, tabs, newlines, carriage returns and page breaks; and be at most 2000 bytes long when encoded in UTF-8. If not set, defaults to an empty description.
    location String
    project String
    displayName string
    User defined name of this taxonomy. It must: contain only unicode letters, numbers, underscores, dashes and spaces; not start or end with spaces; and be at most 200 bytes long when encoded in UTF-8. The taxonomy display name must be unique within an organization.
    activatedPolicyTypes TaxonomyActivatedPolicyTypesItem[]
    Optional. A list of policy types that are activated for this taxonomy. If not set, defaults to an empty list.
    description string
    Optional. Description of this taxonomy. It must: contain only unicode characters, tabs, newlines, carriage returns and page breaks; and be at most 2000 bytes long when encoded in UTF-8. If not set, defaults to an empty description.
    location string
    project string
    display_name str
    User defined name of this taxonomy. It must: contain only unicode letters, numbers, underscores, dashes and spaces; not start or end with spaces; and be at most 200 bytes long when encoded in UTF-8. The taxonomy display name must be unique within an organization.
    activated_policy_types Sequence[TaxonomyActivatedPolicyTypesItem]
    Optional. A list of policy types that are activated for this taxonomy. If not set, defaults to an empty list.
    description str
    Optional. Description of this taxonomy. It must: contain only unicode characters, tabs, newlines, carriage returns and page breaks; and be at most 2000 bytes long when encoded in UTF-8. If not set, defaults to an empty description.
    location str
    project str
    displayName String
    User defined name of this taxonomy. It must: contain only unicode letters, numbers, underscores, dashes and spaces; not start or end with spaces; and be at most 200 bytes long when encoded in UTF-8. The taxonomy display name must be unique within an organization.
    activatedPolicyTypes List<"POLICY_TYPE_UNSPECIFIED" | "FINE_GRAINED_ACCESS_CONTROL">
    Optional. A list of policy types that are activated for this taxonomy. If not set, defaults to an empty list.
    description String
    Optional. Description of this taxonomy. It must: contain only unicode characters, tabs, newlines, carriage returns and page breaks; and be at most 2000 bytes long when encoded in UTF-8. If not set, defaults to an empty description.
    location String
    project String

    Outputs

    All input properties are implicitly available as output properties. Additionally, the Taxonomy resource produces the following output properties:

    Id string
    The provider-assigned unique ID for this managed resource.
    Name string
    Resource name of this taxonomy, whose format is: "projects/{project_number}/locations/{location_id}/taxonomies/{id}".
    PolicyTagCount int
    Number of policy tags contained in this taxonomy.
    Service Pulumi.GoogleNative.DataCatalog.V1Beta1.Outputs.GoogleCloudDatacatalogV1beta1TaxonomyServiceResponse
    Identity of the service which owns the Taxonomy. This field is only populated when the taxonomy is created by a Google Cloud service. Currently only 'DATAPLEX' is supported.
    TaxonomyTimestamps Pulumi.GoogleNative.DataCatalog.V1Beta1.Outputs.GoogleCloudDatacatalogV1beta1SystemTimestampsResponse
    Timestamps about this taxonomy. Only create_time and update_time are used.
    Id string
    The provider-assigned unique ID for this managed resource.
    Name string
    Resource name of this taxonomy, whose format is: "projects/{project_number}/locations/{location_id}/taxonomies/{id}".
    PolicyTagCount int
    Number of policy tags contained in this taxonomy.
    Service GoogleCloudDatacatalogV1beta1TaxonomyServiceResponse
    Identity of the service which owns the Taxonomy. This field is only populated when the taxonomy is created by a Google Cloud service. Currently only 'DATAPLEX' is supported.
    TaxonomyTimestamps GoogleCloudDatacatalogV1beta1SystemTimestampsResponse
    Timestamps about this taxonomy. Only create_time and update_time are used.
    id String
    The provider-assigned unique ID for this managed resource.
    name String
    Resource name of this taxonomy, whose format is: "projects/{project_number}/locations/{location_id}/taxonomies/{id}".
    policyTagCount Integer
    Number of policy tags contained in this taxonomy.
    service GoogleCloudDatacatalogV1beta1TaxonomyServiceResponse
    Identity of the service which owns the Taxonomy. This field is only populated when the taxonomy is created by a Google Cloud service. Currently only 'DATAPLEX' is supported.
    taxonomyTimestamps GoogleCloudDatacatalogV1beta1SystemTimestampsResponse
    Timestamps about this taxonomy. Only create_time and update_time are used.
    id string
    The provider-assigned unique ID for this managed resource.
    name string
    Resource name of this taxonomy, whose format is: "projects/{project_number}/locations/{location_id}/taxonomies/{id}".
    policyTagCount number
    Number of policy tags contained in this taxonomy.
    service GoogleCloudDatacatalogV1beta1TaxonomyServiceResponse
    Identity of the service which owns the Taxonomy. This field is only populated when the taxonomy is created by a Google Cloud service. Currently only 'DATAPLEX' is supported.
    taxonomyTimestamps GoogleCloudDatacatalogV1beta1SystemTimestampsResponse
    Timestamps about this taxonomy. Only create_time and update_time are used.
    id str
    The provider-assigned unique ID for this managed resource.
    name str
    Resource name of this taxonomy, whose format is: "projects/{project_number}/locations/{location_id}/taxonomies/{id}".
    policy_tag_count int
    Number of policy tags contained in this taxonomy.
    service GoogleCloudDatacatalogV1beta1TaxonomyServiceResponse
    Identity of the service which owns the Taxonomy. This field is only populated when the taxonomy is created by a Google Cloud service. Currently only 'DATAPLEX' is supported.
    taxonomy_timestamps GoogleCloudDatacatalogV1beta1SystemTimestampsResponse
    Timestamps about this taxonomy. Only create_time and update_time are used.
    id String
    The provider-assigned unique ID for this managed resource.
    name String
    Resource name of this taxonomy, whose format is: "projects/{project_number}/locations/{location_id}/taxonomies/{id}".
    policyTagCount Number
    Number of policy tags contained in this taxonomy.
    service Property Map
    Identity of the service which owns the Taxonomy. This field is only populated when the taxonomy is created by a Google Cloud service. Currently only 'DATAPLEX' is supported.
    taxonomyTimestamps Property Map
    Timestamps about this taxonomy. Only create_time and update_time are used.

    Supporting Types

    GoogleCloudDatacatalogV1beta1SystemTimestampsResponse, GoogleCloudDatacatalogV1beta1SystemTimestampsResponseArgs

    CreateTime string
    The creation time of the resource within the given system.
    ExpireTime string
    The expiration time of the resource within the given system. Currently only apllicable to BigQuery resources.
    UpdateTime string
    The last-modified time of the resource within the given system.
    CreateTime string
    The creation time of the resource within the given system.
    ExpireTime string
    The expiration time of the resource within the given system. Currently only apllicable to BigQuery resources.
    UpdateTime string
    The last-modified time of the resource within the given system.
    createTime String
    The creation time of the resource within the given system.
    expireTime String
    The expiration time of the resource within the given system. Currently only apllicable to BigQuery resources.
    updateTime String
    The last-modified time of the resource within the given system.
    createTime string
    The creation time of the resource within the given system.
    expireTime string
    The expiration time of the resource within the given system. Currently only apllicable to BigQuery resources.
    updateTime string
    The last-modified time of the resource within the given system.
    create_time str
    The creation time of the resource within the given system.
    expire_time str
    The expiration time of the resource within the given system. Currently only apllicable to BigQuery resources.
    update_time str
    The last-modified time of the resource within the given system.
    createTime String
    The creation time of the resource within the given system.
    expireTime String
    The expiration time of the resource within the given system. Currently only apllicable to BigQuery resources.
    updateTime String
    The last-modified time of the resource within the given system.

    GoogleCloudDatacatalogV1beta1TaxonomyServiceResponse, GoogleCloudDatacatalogV1beta1TaxonomyServiceResponseArgs

    Identity string
    The service agent for the service.
    Name string
    The Google Cloud service name.
    Identity string
    The service agent for the service.
    Name string
    The Google Cloud service name.
    identity String
    The service agent for the service.
    name String
    The Google Cloud service name.
    identity string
    The service agent for the service.
    name string
    The Google Cloud service name.
    identity str
    The service agent for the service.
    name str
    The Google Cloud service name.
    identity String
    The service agent for the service.
    name String
    The Google Cloud service name.

    TaxonomyActivatedPolicyTypesItem, TaxonomyActivatedPolicyTypesItemArgs

    PolicyTypeUnspecified
    POLICY_TYPE_UNSPECIFIEDUnspecified policy type.
    FineGrainedAccessControl
    FINE_GRAINED_ACCESS_CONTROLFine grained access control policy, which enables access control on tagged resources.
    TaxonomyActivatedPolicyTypesItemPolicyTypeUnspecified
    POLICY_TYPE_UNSPECIFIEDUnspecified policy type.
    TaxonomyActivatedPolicyTypesItemFineGrainedAccessControl
    FINE_GRAINED_ACCESS_CONTROLFine grained access control policy, which enables access control on tagged resources.
    PolicyTypeUnspecified
    POLICY_TYPE_UNSPECIFIEDUnspecified policy type.
    FineGrainedAccessControl
    FINE_GRAINED_ACCESS_CONTROLFine grained access control policy, which enables access control on tagged resources.
    PolicyTypeUnspecified
    POLICY_TYPE_UNSPECIFIEDUnspecified policy type.
    FineGrainedAccessControl
    FINE_GRAINED_ACCESS_CONTROLFine grained access control policy, which enables access control on tagged resources.
    POLICY_TYPE_UNSPECIFIED
    POLICY_TYPE_UNSPECIFIEDUnspecified policy type.
    FINE_GRAINED_ACCESS_CONTROL
    FINE_GRAINED_ACCESS_CONTROLFine grained access control policy, which enables access control on tagged resources.
    "POLICY_TYPE_UNSPECIFIED"
    POLICY_TYPE_UNSPECIFIEDUnspecified policy type.
    "FINE_GRAINED_ACCESS_CONTROL"
    FINE_GRAINED_ACCESS_CONTROLFine grained access control policy, which enables access control on tagged resources.

    Package Details

    Repository
    Google Cloud Native pulumi/pulumi-google-native
    License
    Apache-2.0
    google-native logo

    Google Cloud Native is in preview. Google Cloud Classic is fully supported.

    Google Cloud Native v0.32.0 published on Wednesday, Nov 29, 2023 by Pulumi