oci_core_volume_group_backup
This resource provides the Volume Group Backup resource in Oracle Cloud Infrastructure Core service.
Creates a new backup volume group of the specified volume group. For more information, see Volume Groups.
Example Usage
resource "oci_core_volume_group_backup" "test_volume_group_backup" {
#Required
volume_group_id = oci_core_volume_group.test_volume_group.id
#Optional
compartment_id = var.compartment_id
defined_tags = {"Operations.CostCenter"= "42"}
display_name = var.volume_group_backup_display_name
freeform_tags = {"Department"= "Finance"}
type = var.volume_group_backup_type
}
Argument Reference
The following arguments are supported:
compartment_id
- (Optional) (Updatable) The OCID of the compartment that will contain the volume group backup. This parameter is optional, by default backup will be created in the same compartment and source volume group.defined_tags
- (Optional) (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:{"Operations.CostCenter": "42"}
display_name
- (Optional) (Updatable) A user-friendly name. Does not have to be unique, and it’s changeable. Avoid entering confidential information.freeform_tags
- (Optional) (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. Example:{"Department": "Finance"}
type
- (Optional) The type of backup to create. If omitted, defaults to incremental.- Allowed values are :
- FULL
- INCREMENTAL
- Allowed values are :
volume_group_id
- (Required) The OCID of the volume group that needs to be backed up.source_details
- (Optional) Details of the volume group backup source in the cloud.kms_key_id
- (Optional) The OCID of the KMS key in the destination region which will be the master encryption key for the copied volume backup.region
- (Required) The region of the volume backup source.volume_group_backup_id
- (Required) The OCID of the source volume group backup.
** 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
Attributes Reference
The following attributes are exported:
compartment_id
- The OCID of the compartment that contains the volume group backup.defined_tags
- Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:{"Operations.CostCenter": "42"}
display_name
- A user-friendly name. Does not have to be unique, and it’s changeable. Avoid entering confidential information.expiration_time
- The date and time the volume group backup will expire and be automatically deleted. Format defined by RFC3339. This parameter will always be present for volume group backups that were created automatically by a scheduled-backup policy. For manually created volume group backups, it will be absent, signifying that there is no expiration time and the backup will last forever until manually deleted.freeform_tags
- 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. Example:{"Department": "Finance"}
id
- The OCID of the volume group backup.size_in_gbs
- The aggregate size of the volume group backup, in GBs.size_in_mbs
- The aggregate size of the volume group backup, in MBs.source_type
- Specifies whether the volume group backup was created manually, or via scheduled backup policy.source_volume_group_backup_id
- The OCID of the source volume group backup.state
- The current state of a volume group backup.time_created
- The date and time the volume group backup was created. This is the time the actual point-in-time image of the volume group data was taken. Format defined by RFC3339.time_request_received
- The date and time the request to create the volume group backup was received. Format defined by RFC3339.type
- The type of backup.unique_size_in_gbs
- The aggregate size used by the volume group backup, in GBs. It is typically smaller thansize_in_gbs
, depending on the space consumed on the volume group and whether the volume backup is full or incremental.unique_size_in_mbs
- The aggregate size used by the volume group backup, in MBs. It is typically smaller thansize_in_mbs
, depending on the space consumed on the volume group and whether the volume backup is full or incremental.volume_backup_ids
- OCIDs for the volume backups in this volume group backup.volume_group_id
- The OCID of the source volume group.
Timeouts
The timeouts
block allows you to specify timeouts for certain operations:
* create
- (Defaults to 20 minutes), when creating the Volume Group Backup
* update
- (Defaults to 20 minutes), when updating the Volume Group Backup
* delete
- (Defaults to 20 minutes), when destroying the Volume Group Backup
Import
VolumeGroupBackups can be imported using the id
, e.g.
$ terraform import oci_core_volume_group_backup.test_volume_group_backup "id"