UNPKG

@natzka-oss/pulumi-netbox

Version:

A Pulumi package for creating and managing Netbox cloud resources.

79 lines (78 loc) 3.25 kB
import * as pulumi from "@pulumi/pulumi"; /** * From the [official documentation](https://docs.netbox.dev/en/stable/models/extras/tag/): * > Tags are user-defined labels which can be applied to a variety of objects within NetBox. They can be used to establish dimensions of organization beyond the relationships built into NetBox. For example, you might create a tag to identify a particular ownership or condition across several types of objects. * > * > Each tag has a label, color, and a URL-friendly slug. For example, the slug for a tag named "Dunder Mifflin, Inc." would be dunder-mifflin-inc. The slug is generated automatically and makes tags easier to work with as URL parameters. Each tag can also be assigned a description indicating its purpose. * * ## Example Usage * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as netbox from "@natzka-oss/pulumi-netbox"; * * const dmz = new netbox.Tag("dmz", { * name: "DMZ", * colorHex: "ff00ff", * }); * ``` */ export declare class Tag extends pulumi.CustomResource { /** * Get an existing Tag 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<pulumi.ID>, state?: TagState, opts?: pulumi.CustomResourceOptions): Tag; /** * Returns true if the given object is an instance of Tag. 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 Tag; /** * Defaults to `9e9e9e`. */ readonly colorHex: pulumi.Output<string | undefined>; readonly description: pulumi.Output<string | undefined>; readonly name: pulumi.Output<string>; readonly slug: pulumi.Output<string>; readonly tags: pulumi.Output<string[] | undefined>; /** * Create a Tag 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?: TagArgs, opts?: pulumi.CustomResourceOptions); } /** * Input properties used for looking up and filtering Tag resources. */ export interface TagState { /** * Defaults to `9e9e9e`. */ colorHex?: pulumi.Input<string>; description?: pulumi.Input<string>; name?: pulumi.Input<string>; slug?: pulumi.Input<string>; tags?: pulumi.Input<pulumi.Input<string>[]>; } /** * The set of arguments for constructing a Tag resource. */ export interface TagArgs { /** * Defaults to `9e9e9e`. */ colorHex?: pulumi.Input<string>; description?: pulumi.Input<string>; name?: pulumi.Input<string>; slug?: pulumi.Input<string>; tags?: pulumi.Input<pulumi.Input<string>[]>; }