Google Cloud Native is in preview. Google Cloud Classic is fully supported.
google-native.file/v1beta1.Backup
Explore with Pulumi AI
Google Cloud Native is in preview. Google Cloud Classic is fully supported.
Creates a backup. Auto-naming is currently not supported for this resource.
Create Backup Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new Backup(name: string, args: BackupArgs, opts?: CustomResourceOptions);@overload
def Backup(resource_name: str,
           args: BackupArgs,
           opts: Optional[ResourceOptions] = None)
@overload
def Backup(resource_name: str,
           opts: Optional[ResourceOptions] = None,
           backup_id: Optional[str] = None,
           description: Optional[str] = None,
           kms_key_name: Optional[str] = None,
           labels: Optional[Mapping[str, str]] = None,
           location: Optional[str] = None,
           project: Optional[str] = None,
           source_file_share: Optional[str] = None,
           source_instance: Optional[str] = None)func NewBackup(ctx *Context, name string, args BackupArgs, opts ...ResourceOption) (*Backup, error)public Backup(string name, BackupArgs args, CustomResourceOptions? opts = null)
public Backup(String name, BackupArgs args)
public Backup(String name, BackupArgs args, CustomResourceOptions options)
type: google-native:file/v1beta1:Backup
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 BackupArgs
- 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 BackupArgs
- 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 BackupArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args BackupArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args BackupArgs
- 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 examplebackupResourceResourceFromFilev1beta1 = new GoogleNative.File.V1Beta1.Backup("examplebackupResourceResourceFromFilev1beta1", new()
{
    BackupId = "string",
    Description = "string",
    KmsKeyName = "string",
    Labels = 
    {
        { "string", "string" },
    },
    Location = "string",
    Project = "string",
    SourceFileShare = "string",
    SourceInstance = "string",
});
example, err := filev1beta1.NewBackup(ctx, "examplebackupResourceResourceFromFilev1beta1", &filev1beta1.BackupArgs{
	BackupId:    pulumi.String("string"),
	Description: pulumi.String("string"),
	KmsKeyName:  pulumi.String("string"),
	Labels: pulumi.StringMap{
		"string": pulumi.String("string"),
	},
	Location:        pulumi.String("string"),
	Project:         pulumi.String("string"),
	SourceFileShare: pulumi.String("string"),
	SourceInstance:  pulumi.String("string"),
})
var examplebackupResourceResourceFromFilev1beta1 = new Backup("examplebackupResourceResourceFromFilev1beta1", BackupArgs.builder()
    .backupId("string")
    .description("string")
    .kmsKeyName("string")
    .labels(Map.of("string", "string"))
    .location("string")
    .project("string")
    .sourceFileShare("string")
    .sourceInstance("string")
    .build());
examplebackup_resource_resource_from_filev1beta1 = google_native.file.v1beta1.Backup("examplebackupResourceResourceFromFilev1beta1",
    backup_id="string",
    description="string",
    kms_key_name="string",
    labels={
        "string": "string",
    },
    location="string",
    project="string",
    source_file_share="string",
    source_instance="string")
const examplebackupResourceResourceFromFilev1beta1 = new google_native.file.v1beta1.Backup("examplebackupResourceResourceFromFilev1beta1", {
    backupId: "string",
    description: "string",
    kmsKeyName: "string",
    labels: {
        string: "string",
    },
    location: "string",
    project: "string",
    sourceFileShare: "string",
    sourceInstance: "string",
});
type: google-native:file/v1beta1:Backup
properties:
    backupId: string
    description: string
    kmsKeyName: string
    labels:
        string: string
    location: string
    project: string
    sourceFileShare: string
    sourceInstance: string
Backup 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 Backup resource accepts the following input properties:
- BackupId string
- Required. The ID to use for the backup. The ID must be unique within the specified project and location. This value must start with a lowercase letter followed by up to 62 lowercase letters, numbers, or hyphens, and cannot end with a hyphen.
- Description string
- A description of the backup with 2048 characters or less. Requests with longer descriptions will be rejected.
- KmsKey stringName 
- Immutable. KMS key name used for data encryption.
- Labels Dictionary<string, string>
- Resource labels to represent user provided metadata.
- Location string
- Project string
- string
- Name of the file share in the source Filestore instance that the backup is created from.
- SourceInstance string
- The resource name of the source Filestore instance, in the format projects/{project_id}/locations/{location_id}/instances/{instance_id}, used to create this backup.
- BackupId string
- Required. The ID to use for the backup. The ID must be unique within the specified project and location. This value must start with a lowercase letter followed by up to 62 lowercase letters, numbers, or hyphens, and cannot end with a hyphen.
- Description string
- A description of the backup with 2048 characters or less. Requests with longer descriptions will be rejected.
- KmsKey stringName 
- Immutable. KMS key name used for data encryption.
- Labels map[string]string
- Resource labels to represent user provided metadata.
- Location string
- Project string
- string
- Name of the file share in the source Filestore instance that the backup is created from.
- SourceInstance string
- The resource name of the source Filestore instance, in the format projects/{project_id}/locations/{location_id}/instances/{instance_id}, used to create this backup.
- backupId String
- Required. The ID to use for the backup. The ID must be unique within the specified project and location. This value must start with a lowercase letter followed by up to 62 lowercase letters, numbers, or hyphens, and cannot end with a hyphen.
- description String
- A description of the backup with 2048 characters or less. Requests with longer descriptions will be rejected.
- kmsKey StringName 
- Immutable. KMS key name used for data encryption.
- labels Map<String,String>
- Resource labels to represent user provided metadata.
- location String
- project String
- String
- Name of the file share in the source Filestore instance that the backup is created from.
- sourceInstance String
- The resource name of the source Filestore instance, in the format projects/{project_id}/locations/{location_id}/instances/{instance_id}, used to create this backup.
- backupId string
- Required. The ID to use for the backup. The ID must be unique within the specified project and location. This value must start with a lowercase letter followed by up to 62 lowercase letters, numbers, or hyphens, and cannot end with a hyphen.
- description string
- A description of the backup with 2048 characters or less. Requests with longer descriptions will be rejected.
- kmsKey stringName 
- Immutable. KMS key name used for data encryption.
- labels {[key: string]: string}
- Resource labels to represent user provided metadata.
- location string
- project string
- string
- Name of the file share in the source Filestore instance that the backup is created from.
- sourceInstance string
- The resource name of the source Filestore instance, in the format projects/{project_id}/locations/{location_id}/instances/{instance_id}, used to create this backup.
- backup_id str
- Required. The ID to use for the backup. The ID must be unique within the specified project and location. This value must start with a lowercase letter followed by up to 62 lowercase letters, numbers, or hyphens, and cannot end with a hyphen.
- description str
- A description of the backup with 2048 characters or less. Requests with longer descriptions will be rejected.
- kms_key_ strname 
- Immutable. KMS key name used for data encryption.
- labels Mapping[str, str]
- Resource labels to represent user provided metadata.
- location str
- project str
- str
- Name of the file share in the source Filestore instance that the backup is created from.
- source_instance str
- The resource name of the source Filestore instance, in the format projects/{project_id}/locations/{location_id}/instances/{instance_id}, used to create this backup.
- backupId String
- Required. The ID to use for the backup. The ID must be unique within the specified project and location. This value must start with a lowercase letter followed by up to 62 lowercase letters, numbers, or hyphens, and cannot end with a hyphen.
- description String
- A description of the backup with 2048 characters or less. Requests with longer descriptions will be rejected.
- kmsKey StringName 
- Immutable. KMS key name used for data encryption.
- labels Map<String>
- Resource labels to represent user provided metadata.
- location String
- project String
- String
- Name of the file share in the source Filestore instance that the backup is created from.
- sourceInstance String
- The resource name of the source Filestore instance, in the format projects/{project_id}/locations/{location_id}/instances/{instance_id}, used to create this backup.
Outputs
All input properties are implicitly available as output properties. Additionally, the Backup resource produces the following output properties:
- CapacityGb string
- Capacity of the source file share when the backup was created.
- CreateTime string
- The time when the backup was created.
- DownloadBytes string
- Amount of bytes that will be downloaded if the backup is restored
- Id string
- The provider-assigned unique ID for this managed resource.
- Name string
- The resource name of the backup, in the format projects/{project_id}/locations/{location_id}/backups/{backup_id}.
- SatisfiesPzs bool
- Reserved for future use.
- SourceInstance stringTier 
- The service tier of the source Filestore instance that this backup is created from.
- State string
- The backup state.
- StorageBytes string
- The size of the storage used by the backup. As backups share storage, this number is expected to change with backup creation/deletion.
- CapacityGb string
- Capacity of the source file share when the backup was created.
- CreateTime string
- The time when the backup was created.
- DownloadBytes string
- Amount of bytes that will be downloaded if the backup is restored
- Id string
- The provider-assigned unique ID for this managed resource.
- Name string
- The resource name of the backup, in the format projects/{project_id}/locations/{location_id}/backups/{backup_id}.
- SatisfiesPzs bool
- Reserved for future use.
- SourceInstance stringTier 
- The service tier of the source Filestore instance that this backup is created from.
- State string
- The backup state.
- StorageBytes string
- The size of the storage used by the backup. As backups share storage, this number is expected to change with backup creation/deletion.
- capacityGb String
- Capacity of the source file share when the backup was created.
- createTime String
- The time when the backup was created.
- downloadBytes String
- Amount of bytes that will be downloaded if the backup is restored
- id String
- The provider-assigned unique ID for this managed resource.
- name String
- The resource name of the backup, in the format projects/{project_id}/locations/{location_id}/backups/{backup_id}.
- satisfiesPzs Boolean
- Reserved for future use.
- sourceInstance StringTier 
- The service tier of the source Filestore instance that this backup is created from.
- state String
- The backup state.
- storageBytes String
- The size of the storage used by the backup. As backups share storage, this number is expected to change with backup creation/deletion.
- capacityGb string
- Capacity of the source file share when the backup was created.
- createTime string
- The time when the backup was created.
- downloadBytes string
- Amount of bytes that will be downloaded if the backup is restored
- id string
- The provider-assigned unique ID for this managed resource.
- name string
- The resource name of the backup, in the format projects/{project_id}/locations/{location_id}/backups/{backup_id}.
- satisfiesPzs boolean
- Reserved for future use.
- sourceInstance stringTier 
- The service tier of the source Filestore instance that this backup is created from.
- state string
- The backup state.
- storageBytes string
- The size of the storage used by the backup. As backups share storage, this number is expected to change with backup creation/deletion.
- capacity_gb str
- Capacity of the source file share when the backup was created.
- create_time str
- The time when the backup was created.
- download_bytes str
- Amount of bytes that will be downloaded if the backup is restored
- id str
- The provider-assigned unique ID for this managed resource.
- name str
- The resource name of the backup, in the format projects/{project_id}/locations/{location_id}/backups/{backup_id}.
- satisfies_pzs bool
- Reserved for future use.
- source_instance_ strtier 
- The service tier of the source Filestore instance that this backup is created from.
- state str
- The backup state.
- storage_bytes str
- The size of the storage used by the backup. As backups share storage, this number is expected to change with backup creation/deletion.
- capacityGb String
- Capacity of the source file share when the backup was created.
- createTime String
- The time when the backup was created.
- downloadBytes String
- Amount of bytes that will be downloaded if the backup is restored
- id String
- The provider-assigned unique ID for this managed resource.
- name String
- The resource name of the backup, in the format projects/{project_id}/locations/{location_id}/backups/{backup_id}.
- satisfiesPzs Boolean
- Reserved for future use.
- sourceInstance StringTier 
- The service tier of the source Filestore instance that this backup is created from.
- state String
- The backup state.
- storageBytes String
- The size of the storage used by the backup. As backups share storage, this number is expected to change with backup creation/deletion.
Package Details
- Repository
- Google Cloud Native pulumi/pulumi-google-native
- License
- Apache-2.0
Google Cloud Native is in preview. Google Cloud Classic is fully supported.