import * as pulumi from "@pulumi/pulumi"; import * as inputs from "../types/input"; import * as outputs from "../types/output"; /** * A Parameter resource is a logical parameter. * * To get more information about Parameter, see: * * * [API documentation](https://cloud.google.com/secret-manager/parameter-manager/docs/reference/rest/v1/projects.locations.parameters) * * ## Example Usage * * ### Parameter Config Basic * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as gcp from "@pulumi/gcp"; * * const parameter_basic = new gcp.parametermanager.Parameter("parameter-basic", {parameterId: "parameter"}); * ``` * ### Parameter With Format * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as gcp from "@pulumi/gcp"; * * const parameter_with_format = new gcp.parametermanager.Parameter("parameter-with-format", { * parameterId: "parameter", * format: "JSON", * }); * ``` * ### Parameter With Labels * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as gcp from "@pulumi/gcp"; * * const parameter_with_labels = new gcp.parametermanager.Parameter("parameter-with-labels", { * parameterId: "parameter", * labels: { * key1: "val1", * key2: "val2", * key3: "val3", * key4: "val4", * key5: "val5", * }, * }); * ``` * ### Parameter With Kms Key * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as gcp from "@pulumi/gcp"; * * const project = gcp.organizations.getProject({}); * const parameter_with_kms_key = new gcp.parametermanager.Parameter("parameter-with-kms-key", { * parameterId: "parameter", * kmsKey: "kms-key", * }); * ``` * * ## Import * * Parameter can be imported using any of these accepted formats: * * * `projects/{{project}}/locations/global/parameters/{{parameter_id}}` * * `{{project}}/{{parameter_id}}` * * `{{parameter_id}}` * * When using the `pulumi import` command, Parameter can be imported using one of the formats above. For example: * * ```sh * $ pulumi import gcp:parametermanager/parameter:Parameter default projects/{{project}}/locations/global/parameters/{{parameter_id}} * $ pulumi import gcp:parametermanager/parameter:Parameter default {{project}}/{{parameter_id}} * $ pulumi import gcp:parametermanager/parameter:Parameter default {{parameter_id}} * ``` */ export declare class Parameter extends pulumi.CustomResource { /** * Get an existing Parameter 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?: ParameterState, opts?: pulumi.CustomResourceOptions): Parameter; /** * Returns true if the given object is an instance of Parameter. 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 Parameter; /** * The time at which the Parameter was created. */ readonly createTime: pulumi.Output; /** * Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. * When a 'terraform destroy' or 'pulumi up' would delete the resource, * the command will fail if this field is set to "PREVENT" in Terraform state. * When set to "ABANDON", the command will remove the resource from Terraform * management without updating or deleting the resource in the API. * When set to "DELETE", deleting the resource is allowed. */ readonly deletionPolicy: pulumi.Output; /** * All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services. */ readonly effectiveLabels: pulumi.Output<{ [key: string]: string; }>; /** * The format type of the parameter resource. * Default value is `UNFORMATTED`. * Possible values are: `UNFORMATTED`, `YAML`, `JSON`. */ readonly format: pulumi.Output; /** * The resource name of the Cloud KMS CryptoKey used to encrypt parameter version payload. Format * `projects/{{project}}/locations/global/keyRings/{{key_ring}}/cryptoKeys/{{crypto_key}}` */ readonly kmsKey: pulumi.Output; /** * The labels assigned to this Parameter. * Label keys must be between 1 and 63 characters long, have a UTF-8 encoding of maximum 128 bytes, * and must conform to the following PCRE regular expression: [\p{Ll}\p{Lo}][\p{Ll}\p{Lo}\p{N}_-]{0,62} * Label values must be between 0 and 63 characters long, have a UTF-8 encoding of maximum 128 bytes, * and must conform to the following PCRE regular expression: [\p{Ll}\p{Lo}\p{N}_-]{0,63} * No more than 64 labels can be assigned to a given resource. * An object containing a list of "key": value pairs. Example: * { "name": "wrench", "mass": "1.3kg", "count": "3" }. * * **Note**: This field is non-authoritative, and will only manage the labels present in your configuration. * Please refer to the field `effectiveLabels` for all of the labels present on the resource. */ readonly labels: pulumi.Output<{ [key: string]: string; } | undefined>; /** * The resource name of the Parameter. Format: * `projects/{{project}}/locations/global/parameters/{{parameter_id}}` */ readonly name: pulumi.Output; /** * This must be unique within the project. */ readonly parameterId: pulumi.Output; /** * Policy member strings of a Google Cloud resource. * Structure is documented below. */ readonly policyMembers: pulumi.Output; /** * The ID of the project in which the resource belongs. * If it is not provided, the provider project is used. */ readonly project: pulumi.Output; /** * The combination of labels configured directly on the resource * and default labels configured on the provider. */ readonly pulumiLabels: pulumi.Output<{ [key: string]: string; }>; /** * The time at which the Parameter was updated. */ readonly updateTime: pulumi.Output; /** * Create a Parameter 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: ParameterArgs, opts?: pulumi.CustomResourceOptions); } /** * Input properties used for looking up and filtering Parameter resources. */ export interface ParameterState { /** * The time at which the Parameter was created. */ createTime?: pulumi.Input; /** * Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. * When a 'terraform destroy' or 'pulumi up' would delete the resource, * the command will fail if this field is set to "PREVENT" in Terraform state. * When set to "ABANDON", the command will remove the resource from Terraform * management without updating or deleting the resource in the API. * When set to "DELETE", deleting the resource is allowed. */ deletionPolicy?: pulumi.Input; /** * All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services. */ effectiveLabels?: pulumi.Input<{ [key: string]: pulumi.Input; } | undefined>; /** * The format type of the parameter resource. * Default value is `UNFORMATTED`. * Possible values are: `UNFORMATTED`, `YAML`, `JSON`. */ format?: pulumi.Input; /** * The resource name of the Cloud KMS CryptoKey used to encrypt parameter version payload. Format * `projects/{{project}}/locations/global/keyRings/{{key_ring}}/cryptoKeys/{{crypto_key}}` */ kmsKey?: pulumi.Input; /** * The labels assigned to this Parameter. * Label keys must be between 1 and 63 characters long, have a UTF-8 encoding of maximum 128 bytes, * and must conform to the following PCRE regular expression: [\p{Ll}\p{Lo}][\p{Ll}\p{Lo}\p{N}_-]{0,62} * Label values must be between 0 and 63 characters long, have a UTF-8 encoding of maximum 128 bytes, * and must conform to the following PCRE regular expression: [\p{Ll}\p{Lo}\p{N}_-]{0,63} * No more than 64 labels can be assigned to a given resource. * An object containing a list of "key": value pairs. Example: * { "name": "wrench", "mass": "1.3kg", "count": "3" }. * * **Note**: This field is non-authoritative, and will only manage the labels present in your configuration. * Please refer to the field `effectiveLabels` for all of the labels present on the resource. */ labels?: pulumi.Input<{ [key: string]: pulumi.Input; } | undefined>; /** * The resource name of the Parameter. Format: * `projects/{{project}}/locations/global/parameters/{{parameter_id}}` */ name?: pulumi.Input; /** * This must be unique within the project. */ parameterId?: pulumi.Input; /** * Policy member strings of a Google Cloud resource. * Structure is documented below. */ policyMembers?: pulumi.Input[] | undefined>; /** * The ID of the project in which the resource belongs. * If it is not provided, the provider project is used. */ project?: pulumi.Input; /** * The combination of labels configured directly on the resource * and default labels configured on the provider. */ pulumiLabels?: pulumi.Input<{ [key: string]: pulumi.Input; } | undefined>; /** * The time at which the Parameter was updated. */ updateTime?: pulumi.Input; } /** * The set of arguments for constructing a Parameter resource. */ export interface ParameterArgs { /** * Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. * When a 'terraform destroy' or 'pulumi up' would delete the resource, * the command will fail if this field is set to "PREVENT" in Terraform state. * When set to "ABANDON", the command will remove the resource from Terraform * management without updating or deleting the resource in the API. * When set to "DELETE", deleting the resource is allowed. */ deletionPolicy?: pulumi.Input; /** * The format type of the parameter resource. * Default value is `UNFORMATTED`. * Possible values are: `UNFORMATTED`, `YAML`, `JSON`. */ format?: pulumi.Input; /** * The resource name of the Cloud KMS CryptoKey used to encrypt parameter version payload. Format * `projects/{{project}}/locations/global/keyRings/{{key_ring}}/cryptoKeys/{{crypto_key}}` */ kmsKey?: pulumi.Input; /** * The labels assigned to this Parameter. * Label keys must be between 1 and 63 characters long, have a UTF-8 encoding of maximum 128 bytes, * and must conform to the following PCRE regular expression: [\p{Ll}\p{Lo}][\p{Ll}\p{Lo}\p{N}_-]{0,62} * Label values must be between 0 and 63 characters long, have a UTF-8 encoding of maximum 128 bytes, * and must conform to the following PCRE regular expression: [\p{Ll}\p{Lo}\p{N}_-]{0,63} * No more than 64 labels can be assigned to a given resource. * An object containing a list of "key": value pairs. Example: * { "name": "wrench", "mass": "1.3kg", "count": "3" }. * * **Note**: This field is non-authoritative, and will only manage the labels present in your configuration. * Please refer to the field `effectiveLabels` for all of the labels present on the resource. */ labels?: pulumi.Input<{ [key: string]: pulumi.Input; } | undefined>; /** * This must be unique within the project. */ parameterId: pulumi.Input; /** * The ID of the project in which the resource belongs. * If it is not provided, the provider project is used. */ project?: pulumi.Input; } //# sourceMappingURL=parameter.d.ts.map