import * as pulumi from "@pulumi/pulumi"; /** * This resource provides the Tag Namespace resource in Oracle Cloud Infrastructure Identity service. * Api doc link for the resource: https://docs.oracle.com/iaas/api/#/en/identity/latest/TagNamespace * * Example terraform configs related to the resource : https://github.com/oracle/terraform-provider-oci/tree/master/examples/identity * * Creates a new tag namespace in the specified compartment. * * You must specify the compartment ID in the request object (remember that the tenancy is simply the root * compartment). * * You must also specify a *name* for the namespace, which must be unique across all namespaces in your tenancy * and cannot be changed. The name can contain any ASCII character except the space (_) or period (.). * Names are case insensitive. That means, for example, "myNamespace" and "mynamespace" are not allowed * in the same tenancy. Once you created a namespace, you cannot change the name. * If you specify a name that's already in use in the tenancy, a 409 error is returned. * * You must also specify a *description* for the namespace. * It does not have to be unique, and you can change it with * [UpdateTagNamespace](https://docs.cloud.oracle.com/iaas/api/#/en/identity/latest/TagNamespace/UpdateTagNamespace). * * ## Example Usage * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as oci from "@pulumi/oci"; * * const testTagNamespace = new oci.identity.TagNamespace("test_tag_namespace", { * compartmentId: compartmentId, * description: tagNamespaceDescription, * name: tagNamespaceName, * definedTags: { * "Operations.CostCenter": "42", * }, * freeformTags: { * Department: "Finance", * }, * isRetired: false, * }); * ``` * * ## Import * * TagNamespaces can be imported using the `id`, e.g. * * ```sh * $ pulumi import oci:Identity/tagNamespace:TagNamespace test_tag_namespace "id" * ``` */ export declare class TagNamespace extends pulumi.CustomResource { /** * Get an existing TagNamespace resource's state with the given name, ID, and optional extra * properties used to qualify the lookup. * * @param name The _unique_ name of the resulting resource. * @param id The _unique_ provider ID of the resource to lookup. * @param state Any extra arguments used during the lookup. * @param opts Optional settings to control the behavior of the CustomResource. */ static get(name: string, id: pulumi.Input, state?: TagNamespaceState, opts?: pulumi.CustomResourceOptions): TagNamespace; /** * Returns true if the given object is an instance of TagNamespace. This is designed to work even * when multiple copies of the Pulumi SDK have been loaded into the same process. */ static isInstance(obj: any): obj is TagNamespace; /** * (Updatable) The OCID of the tenancy containing the tag namespace. */ readonly compartmentId: pulumi.Output; /** * (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see [Resource Tags](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Operations.CostCenter": "42"}` */ readonly definedTags: pulumi.Output<{ [key: string]: string; }>; /** * (Updatable) The description you assign to the tag namespace during creation. */ readonly description: pulumi.Output; /** * (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see [Resource Tags](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Department": "Finance"}` */ readonly freeformTags: pulumi.Output<{ [key: string]: string; }>; /** * (Updatable) Whether the tag namespace is retired. For more information, see [Retiring Key Definitions and Namespace Definitions](https://docs.us-phoenix-1.oraclecloud.com/Content/Identity/Concepts/taggingoverview.htm#Retiring). * * ** IMPORTANT ** * Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values */ readonly isRetired: pulumi.Output; /** * The name you assign to the tag namespace during creation. It must be unique across all tag namespaces in the tenancy and cannot be changed. */ readonly name: pulumi.Output; /** * The tagnamespace's current state. After creating a tagnamespace, make sure its `lifecycleState` is ACTIVE before using it. After retiring a tagnamespace, make sure its `lifecycleState` is INACTIVE before using it. */ readonly state: pulumi.Output; /** * Date and time the tag namespace was created, in the format defined by RFC3339. Example: `2016-08-25T21:10:29.600Z` */ readonly timeCreated: pulumi.Output; /** * Create a TagNamespace resource with the given unique name, arguments, and options. * * @param name The _unique_ name of the resource. * @param args The arguments to use to populate this resource's properties. * @param opts A bag of options that control this resource's behavior. */ constructor(name: string, args: TagNamespaceArgs, opts?: pulumi.CustomResourceOptions); } /** * Input properties used for looking up and filtering TagNamespace resources. */ export interface TagNamespaceState { /** * (Updatable) The OCID of the tenancy containing the tag namespace. */ compartmentId?: pulumi.Input; /** * (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see [Resource Tags](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Operations.CostCenter": "42"}` */ definedTags?: pulumi.Input<{ [key: string]: pulumi.Input; } | undefined>; /** * (Updatable) The description you assign to the tag namespace during creation. */ description?: pulumi.Input; /** * (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see [Resource Tags](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Department": "Finance"}` */ freeformTags?: pulumi.Input<{ [key: string]: pulumi.Input; } | undefined>; /** * (Updatable) Whether the tag namespace is retired. For more information, see [Retiring Key Definitions and Namespace Definitions](https://docs.us-phoenix-1.oraclecloud.com/Content/Identity/Concepts/taggingoverview.htm#Retiring). * * ** IMPORTANT ** * Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values */ isRetired?: pulumi.Input; /** * The name you assign to the tag namespace during creation. It must be unique across all tag namespaces in the tenancy and cannot be changed. */ name?: pulumi.Input; /** * The tagnamespace's current state. After creating a tagnamespace, make sure its `lifecycleState` is ACTIVE before using it. After retiring a tagnamespace, make sure its `lifecycleState` is INACTIVE before using it. */ state?: pulumi.Input; /** * Date and time the tag namespace was created, in the format defined by RFC3339. Example: `2016-08-25T21:10:29.600Z` */ timeCreated?: pulumi.Input; } /** * The set of arguments for constructing a TagNamespace resource. */ export interface TagNamespaceArgs { /** * (Updatable) The OCID of the tenancy containing the tag namespace. */ compartmentId: pulumi.Input; /** * (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see [Resource Tags](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Operations.CostCenter": "42"}` */ definedTags?: pulumi.Input<{ [key: string]: pulumi.Input; } | undefined>; /** * (Updatable) The description you assign to the tag namespace during creation. */ description: pulumi.Input; /** * (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see [Resource Tags](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Department": "Finance"}` */ freeformTags?: pulumi.Input<{ [key: string]: pulumi.Input; } | undefined>; /** * (Updatable) Whether the tag namespace is retired. For more information, see [Retiring Key Definitions and Namespace Definitions](https://docs.us-phoenix-1.oraclecloud.com/Content/Identity/Concepts/taggingoverview.htm#Retiring). * * ** IMPORTANT ** * Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values */ isRetired?: pulumi.Input; /** * The name you assign to the tag namespace during creation. It must be unique across all tag namespaces in the tenancy and cannot be changed. */ name?: pulumi.Input; } //# sourceMappingURL=tagNamespace.d.ts.map