Deprecated - Deprecate backup_policy_id field for oci_core_volume_group

Author: Terraform Team Automation

examples/storage/block/volume/volume_backup_policy.tf

@@ -3,13 +3,10 @@
 variable "tenancy_ocid" {
 }
 
-variable "user_ocid" {
+variable "auth" {
 }
 
-variable "fingerprint" {
-}
-
-variable "private_key_path" {
+variable "config_file_profile" {
 }
 
 variable "region" {
@@ -22,11 +19,9 @@ variable "destination_region" {
 }
 
 provider "oci" {
-  tenancy_ocid     = var.tenancy_ocid
-  user_ocid        = var.user_ocid
-  fingerprint      = var.fingerprint
-  private_key_path = var.private_key_path
-  region           = var.region
+  auth                = var.auth
+  config_file_profile = var.config_file_profile
+  region              = var.region
 }
 
 data "oci_identity_availability_domain" "ad" {
@@ -132,3 +127,46 @@ output "test_backup_policy_assignments_custom" {
   value = data.oci_core_volume_backup_policy_assignments.test_backup_policy_assignments_custom.volume_backup_policy_assignments
 }
 
+// Example 3: Assign a policy to a volume group
+
+resource "oci_core_volume" "test_volume" {
+  count               = 2
+  availability_domain = data.oci_identity_availability_domain.ad.name
+  compartment_id      = var.compartment_ocid
+  display_name        = format("-tf-volume-%d", count.index + 1)
+  size_in_gbs         = "50"
+}
+
+resource "oci_core_volume_group" "test_volume_group" {
+  #Required
+  availability_domain = data.oci_identity_availability_domain.ad.name
+  compartment_id      = var.compartment_ocid
+
+  source_details {
+    #Required
+    type = "volumeIds"
+
+    volume_ids = oci_core_volume.test_volume.*.id
+  }
+
+  #Optional
+  display_name = "test-volume-group-with-backup-policy"
+}
+
+resource "oci_core_volume_backup_policy_assignment" "test_volume_group_backup_policy_assignment" {
+  asset_id  = oci_core_volume_group.test_volume_group.id
+  policy_id = oci_core_volume_backup_policy.test_volume_backup_policy_custom.id
+}
+
+data "oci_core_volume_backup_policy_assignments" "test_volume_group_backup_policy_assignments" {
+  asset_id = oci_core_volume_group.test_volume_group.id
+
+  filter {
+    name   = "id"
+    values = [oci_core_volume_backup_policy_assignment.test_volume_group_backup_policy_assignment.id]
+  }
+}
+
+output "volume_group_backup_policy_assignments" {
+  value = data.oci_core_volume_backup_policy_assignments.test_volume_group_backup_policy_assignments
+}

internal/service/core/core_volume_group_resource.go

@@ -105,10 +105,11 @@ func CoreVolumeGroupResource() *schema.Resource {
 				Optional: true,
 			},
 			"backup_policy_id": {
-				Type:     schema.TypeString,
-				Optional: true,
-				Computed: true,
-				ForceNew: true,
+				Type:       schema.TypeString,
+				Optional:   true,
+				Computed:   true,
+				ForceNew:   true,
+				Deprecated: tfresource.FieldDeprecatedButSupportedThroughAnotherResource("backup_policy_id", "oci_core_volume_backup_policy_assignment"),
 			},
 			"defined_tags": {
 				Type:             schema.TypeMap,

website/docs/r/core_boot_volume.html.markdown

@@ -64,7 +64,7 @@ The following arguments are supported:
 	* `autotune_type` - (Required) (Updatable) This specifies the type of autotunes supported by OCI.
 	* `max_vpus_per_gb` - (Required when autotune_type=PERFORMANCE_BASED) (Updatable) This will be the maximum VPUs/GB performance level that the volume will be auto-tuned temporarily based on performance monitoring. 
 * `availability_domain` - (Optional) The availability domain of the volume. Omissible for cloning a volume. The new volume will be created in the availability domain of the source volume.  Example: `Uocm:PHX-AD-1` 
-* `backup_policy_id` - (Optional) If provided, specifies the ID of the boot volume backup policy to assign to the newly created boot volume. If omitted, no policy will be assigned. 
+* `backup_policy_id` - (Optional) If provided, specifies the ID of the boot volume backup policy to assign to the newly created boot volume. If omitted, no policy will be assigned. This field is deprecated. Use the `oci_core_volume_backup_policy_assignments` instead to assign a backup policy to a boot volume.
 * `boot_volume_replicas` - (Optional) (Updatable) The list of boot volume replicas to be enabled for this boot volume in the specified destination availability domains. 
 	* `availability_domain` - (Required) (Updatable) The availability domain of the boot volume replica.  Example: `Uocm:PHX-AD-1` 
 	* `display_name` - (Optional) (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. 

website/docs/r/core_volume.html.markdown

@@ -75,7 +75,7 @@ The following arguments are supported:
 	* `autotune_type` - (Required) (Updatable) This specifies the type of autotunes supported by OCI.
 	* `max_vpus_per_gb` - (Required when autotune_type=PERFORMANCE_BASED) (Updatable) This will be the maximum VPUs/GB performance level that the volume will be auto-tuned temporarily based on performance monitoring. 
 * `availability_domain` - (Optional) The availability domain of the volume. Omissible for cloning a volume. The new volume will be created in the availability domain of the source volume.  Example: `Uocm:PHX-AD-1` 
-* `backup_policy_id` - (Optional) If provided, specifies the ID of the volume backup policy to assign to the newly created volume. If omitted, no policy will be assigned. 
+* `backup_policy_id` - (Optional) If provided, specifies the ID of the volume backup policy to assign to the newly created volume. If omitted, no policy will be assigned. This field is deprecated. Use the `oci_core_volume_backup_policy_assignments` instead to assign a backup policy to a volume.
 * `block_volume_replicas` - (Optional) (Updatable) The list of block volume replicas to be enabled for this volume in the specified destination availability domains. 
 	* `availability_domain` - (Required) (Updatable) The availability domain of the block volume replica.  Example: `Uocm:PHX-AD-1` 
 	* `display_name` - (Optional) (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. 

website/docs/r/core_volume_backup_policy_assignment.html.markdown

@@ -10,8 +10,8 @@ description: |-
 # oci_core_volume_backup_policy_assignment
 This resource provides the Volume Backup Policy Assignment resource in Oracle Cloud Infrastructure Core service.
 
-Assigns a volume backup policy to the specified volume. Note that a given volume can
-only have one backup policy assigned to it. If this operation is used for a volume that already
+Assigns a volume backup policy to the specified volume or volume group. Note that a given volume or volume group can
+only have one backup policy assigned to it. If this operation is used for a volume or volume group that already
 has a different backup policy assigned, the prior backup policy will be silently unassigned.
 
 
@@ -29,7 +29,7 @@ resource "oci_core_volume_backup_policy_assignment" "test_volume_backup_policy_a
 
 The following arguments are supported:
 
-* `asset_id` - (Required) The OCID of the volume to assign the policy to.
+* `asset_id` - (Required) The OCID of the volume or volume group to assign the policy to.
 * `policy_id` - (Required) The OCID of the volume backup policy to assign to the volume.
 
 
@@ -40,9 +40,9 @@ Any change to a property that does not support update will force the destruction
 
 The following attributes are exported:
 
-* `asset_id` - The OCID of the volume the policy has been assigned to.
+* `asset_id` - The OCID of the volume or volume group the policy has been assigned to.
 * `id` - The OCID of the volume backup policy assignment.
-* `policy_id` - The OCID of the volume backup policy that has been assigned to the volume. 
+* `policy_id` - The OCID of the volume backup policy that has been assigned to the volume or volume group. For a volume group, only the **user defined** policy is allowed to use. For more information, see [Policy-Based Backups](https://docs.oracle.com/en-us/iaas/Content/Block/Tasks/schedulingvolumebackups.htm).
 * `time_created` - The date and time the volume backup policy was assigned to the volume. The format is defined by [RFC3339](https://tools.ietf.org/html/rfc3339). 
 
 ## Timeouts

website/docs/r/core_volume_group.html.markdown

@@ -53,7 +53,7 @@ resource "oci_core_volume_group" "test_volume_group" {
 The following arguments are supported:
 
 * `availability_domain` - (Required) The availability domain of the volume group.
-* `backup_policy_id` - (Optional) If provided, specifies the ID of the volume backup policy to assign to the newly created volume group. If omitted, no policy will be assigned. 
+* `backup_policy_id` - (Optional) If provided, specifies the ID of the volume backup policy to assign to the newly created volume group. If omitted, no policy will be assigned. This field is deprecated. Use the `oci_core_volume_backup_policy_assignments` instead to assign a backup policy to a volume group.
 * `compartment_id` - (Required) (Updatable) The OCID of the compartment that contains the 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](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/resourcetags.htm).  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.