import * as pulumi from "@pulumi/pulumi"; /** * A BackupChannel imposes constraints on where clusters can be backed up. * The BackupChannel should be in the same project and region * as the cluster being backed up. * The backup can be created only in destination_project. * * To get more information about BackupChannel, see: * * * [API documentation](https://cloud.google.com/kubernetes-engine/docs/add-on/backup-for-gke/reference/rest/v1/projects.locations.backupChannels) * * How-to Guides * * [Official Documentation](https://cloud.google.com/kubernetes-engine/docs/add-on/backup-for-gke) * * ## Example Usage * * ### Gkebackup Backupchannel Basic * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as gcp from "@pulumi/gcp"; * * const basic = new gcp.gkebackup.BackupChannel("basic", { * name: "basic-channel", * location: "us-central1", * description: "Description", * destinationProject: "projects/24240755850", * labels: { * key: "some-value", * }, * }); * ``` * * ## Import * * BackupChannel can be imported using any of these accepted formats: * * * `projects/{{project}}/locations/{{location}}/backupChannels/{{name}}` * * * `{{project}}/{{location}}/{{name}}` * * * `{{location}}/{{name}}` * * When using the `pulumi import` command, BackupChannel can be imported using one of the formats above. For example: * * ```sh * $ pulumi import gcp:gkebackup/backupChannel:BackupChannel default projects/{{project}}/locations/{{location}}/backupChannels/{{name}} * ``` * * ```sh * $ pulumi import gcp:gkebackup/backupChannel:BackupChannel default {{project}}/{{location}}/{{name}} * ``` * * ```sh * $ pulumi import gcp:gkebackup/backupChannel:BackupChannel default {{location}}/{{name}} * ``` */ export declare class BackupChannel extends pulumi.CustomResource { /** * Get an existing BackupChannel 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?: BackupChannelState, opts?: pulumi.CustomResourceOptions): BackupChannel; /** * Returns true if the given object is an instance of BackupChannel. 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 BackupChannel; /** * User specified descriptive string for this BackupChannel. */ readonly description: pulumi.Output; /** * The project where Backups are allowed to be stored. * The format is `projects/{project}`. * {project} can be project number or project id. */ readonly destinationProject: pulumi.Output; /** * The projectId where Backups are allowed to be stored. * Example Project ID: "my-project-id". */ readonly destinationProjectId: 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; }>; /** * etag is used for optimistic concurrency control as a way to help prevent simultaneous * updates of a backup channel from overwriting each other. It is strongly suggested that * systems make use of the 'etag' in the read-modify-write cycle to perform BackupChannel updates * in order to avoid race conditions: An etag is returned in the response to backupChannels.get, * and systems are expected to put that etag in the request to backupChannels.patch or * backupChannels.delete to ensure that their change will be applied to the same version of the resource. */ readonly etag: pulumi.Output; /** * Description: A set of custom labels supplied by the user. * 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 region of the Backup Channel. */ readonly location: pulumi.Output; /** * The full name of the BackupChannel Resource. */ readonly name: 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; }>; /** * Server generated, unique identifier of UUID format. */ readonly uid: pulumi.Output; /** * Create a BackupChannel 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: BackupChannelArgs, opts?: pulumi.CustomResourceOptions); } /** * Input properties used for looking up and filtering BackupChannel resources. */ export interface BackupChannelState { /** * User specified descriptive string for this BackupChannel. */ description?: pulumi.Input; /** * The project where Backups are allowed to be stored. * The format is `projects/{project}`. * {project} can be project number or project id. */ destinationProject?: pulumi.Input; /** * The projectId where Backups are allowed to be stored. * Example Project ID: "my-project-id". */ destinationProjectId?: 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; }>; /** * etag is used for optimistic concurrency control as a way to help prevent simultaneous * updates of a backup channel from overwriting each other. It is strongly suggested that * systems make use of the 'etag' in the read-modify-write cycle to perform BackupChannel updates * in order to avoid race conditions: An etag is returned in the response to backupChannels.get, * and systems are expected to put that etag in the request to backupChannels.patch or * backupChannels.delete to ensure that their change will be applied to the same version of the resource. */ etag?: pulumi.Input; /** * Description: A set of custom labels supplied by the user. * 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; }>; /** * The region of the Backup Channel. */ location?: pulumi.Input; /** * The full name of the BackupChannel Resource. */ name?: 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; /** * The combination of labels configured directly on the resource * and default labels configured on the provider. */ pulumiLabels?: pulumi.Input<{ [key: string]: pulumi.Input; }>; /** * Server generated, unique identifier of UUID format. */ uid?: pulumi.Input; } /** * The set of arguments for constructing a BackupChannel resource. */ export interface BackupChannelArgs { /** * User specified descriptive string for this BackupChannel. */ description?: pulumi.Input; /** * The project where Backups are allowed to be stored. * The format is `projects/{project}`. * {project} can be project number or project id. */ destinationProject: pulumi.Input; /** * Description: A set of custom labels supplied by the user. * 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; }>; /** * The region of the Backup Channel. */ location: pulumi.Input; /** * The full name of the BackupChannel Resource. */ name?: 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; }