add support for universal deletion_policy

mmv1/api/metadata/metadata.go

@@ -35,6 +35,12 @@ func FromResource(r api.Resource) Metadata {
 			ApiField: "selfLink",
 		})
 	}
+	if !r.DeletionPolicyExclude && !r.ExcludeDelete {
+		m.Fields = append(m.Fields, Field{
+			Field:        "deletion_policy",
+			ProviderOnly: true,
+		})
+	}
 	return m
 }
 

mmv1/api/resource.go

@@ -298,6 +298,19 @@ type Resource struct {
 	// public ca external account keys
 	ExcludeRead bool `yaml:"exclude_read,omitempty"`
 
+	// Set to true for resources that are excluded from universal deletion policy due to differing
+	// behavior on a universal option or use a different data type
+	DeletionPolicyExclude bool `yaml:"deletion_policy_exclude,omitempty"`
+
+	// Set to true for resources that have deletion policy fields with custom options that are
+	// compatible with the universal deletion policy
+	// if set to true, use implement `deletion_policy` within the yaml of the resource
+	DeletionPolicyCustomDocs bool `yaml:"deletion_policy_custom_docs,omitempty"`
+
+	// Set to the default deletion policy value for the resource.
+	// By default this will be "DELETE".
+	DeletionPolicyDefault string `yaml:"deletion_policy_default,omitempty"`
+
 	// Set to true for resources that wish to disable automatic generation of default provider
 	// value customdiff functions
 	// TODO rewrite: 1 instance used
@@ -492,6 +505,11 @@ func (r *Resource) setShallowDefaults() {
 	if r.Timeouts == nil {
 		r.Timeouts = NewTimeouts() // This only sets defaults if Timeouts is nil
 	}
+	if !r.DeletionPolicyExclude {
+		if r.DeletionPolicyDefault == "" {
+			r.DeletionPolicyDefault = "DELETE"
+		}
+	}
 }
 
 // SetDefault sets default values for this Resource and all its properties.

mmv1/products/alloydb/Cluster.yaml

@@ -59,6 +59,8 @@
   pre_create: 'templates/terraform/pre_create/alloydb_cluster.go.tmpl'
   pre_update: 'templates/terraform/pre_update/alloydb_cluster.go.tmpl'
   pre_delete: 'templates/terraform/pre_delete/alloydb_cluster.go.tmpl'
+deletion_policy_default: "DEFAULT"
+deletion_policy_custom_docs: true
 # Skipping the sweeper because we need to force-delete clusters.
 exclude_sweeper: true
 include_in_tgc_next: true
@@ -138,9 +140,17 @@
       Policy to determine if the cluster should be deleted forcefully.
       Deleting a cluster forcefully, deletes the cluster and all its associated instances within the cluster.
       Deleting a Secondary cluster with a secondary instance REQUIRES setting deletion_policy = "FORCE" otherwise an error is returned. This is needed as there is no support to delete just the secondary instance, and the only way to delete secondary instance is to delete the associated secondary cluster forcefully which also deletes the secondary instance.
-      Possible values: DEFAULT, FORCE
+
+      When a 'terraform destroy' or 'terraform apply' 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", the command will behave as if set to "DEFAULT".
+
+      Possible values: DEFAULT, FORCE, PREVENT, ABANDON, DELETE
     type: String
-    default_value: "DEFAULT"
+    #excluded from generation due to Universal Deletion Policy
+    exclude: true
   - name: 'deletion_protection'
     description: |
       Whether Terraform will be prevented from destroying the cluster.

mmv1/products/chronicle/DataTable.yaml

@@ -23,6 +23,8 @@
 
 update_verb: PATCH
 update_mask: true
+deletion_policy_default: "DEFAULT"
+deletion_policy_custom_docs: true
 references:
   guides:
     'Google SecOps Guides': 'https://cloud.google.com/chronicle/docs/secops/secops-overview'
@@ -52,9 +54,17 @@
       The policy governing the deletion of the data table.
       If set to `FORCE`, allows the deletion of the data table even if it contains rows.
       If set to `DEFAULT`,or if the field is omitted, the data table must be empty before it can be deleted.
-      Possible values: DEFAULT, FORCE
+
+      When a 'terraform destroy' or 'terraform apply' 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", the command will behave as if set to "DEFAULT".
+
+      Possible values: DEFAULT, FORCE, PREVENT, ABANDON, DELETE
     type: String
-    default_value: "DEFAULT"
+    #excluded from generation due to Universal Deletion Policy
+    exclude: true
 
 parameters:
   - name: location

mmv1/products/chronicle/Rule.yaml

@@ -27,7 +27,8 @@
 update_verb: PATCH
 update_mask: true
 autogen_status: UnVsZQ==
-
+deletion_policy_default: "DEFAULT"
+deletion_policy_custom_docs: true
 examples:
   - name: 'chronicle_rule_basic'
     primary_resource_id: example
@@ -61,11 +62,19 @@
       If deletion_policy = "FORCE", any retrohunts and any detections associated with the rule
       will also be deleted. If deletion_policy = "DEFAULT", the call will only succeed if the
       rule has no associated retrohunts, including completed retrohunts, and no
-      associated detections. Regardless of this field's value, the rule
-      deployment associated with this rule will also be deleted.
-      Possible values: DEFAULT, FORCE
+      associated detections. Regardless of being set to "FORCE" the rule
+      deployment associated with this rule will also be deleted if deletion is successful.
+
+      When a 'terraform destroy' or 'terraform apply' 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", the command will behave as if set to "DEFAULT".
+
+      Possible values: DEFAULT, FORCE, PREVENT, ABANDON, DELETE
     type: String
-    default_value: "DEFAULT"
+    #excluded from generation due to Universal Deletion Policy
+    exclude: true
 
 parameters:
   - name: location

mmv1/products/containerattached/Cluster.yaml

@@ -45,6 +45,7 @@
   constants: 'templates/terraform/constants/containerattached_cluster_diff.go.tmpl'
   pre_update: 'templates/terraform/pre_update/containerattached_update.go.tmpl'
   pre_delete: 'templates/terraform/pre_delete/container_attached_deletion_policy.go.tmpl'
+deletion_policy_custom_docs: true
 examples:
   - name: 'container_attached_cluster_basic'
     primary_resource_id: 'primary'
@@ -71,9 +72,18 @@
       - 'deletion_policy'
 virtual_fields:
   - name: 'deletion_policy'
-    description: 'Policy to determine what flags to send on delete. Possible values: DELETE, DELETE_IGNORE_ERRORS'
+    description: |
+      Policy to determine what flags to send on delete.
+
+      When a 'terraform destroy' or 'terraform apply' 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.
+
+      Possible values: DELETE, DELETE_IGNORE_ERRORS, PREVENT, ABANDON'. Defaults to 'DELETE'.
     type: String
-    default_value: "DELETE"
+    #excluded from generation due to Universal Deletion Policy
+    exclude: true
 parameters:
 properties:
   - name: 'location'

mmv1/products/dataform/Repository.yaml

@@ -37,6 +37,7 @@
   min_version: 'beta'
 custom_code:
   pre_delete: 'templates/terraform/pre_delete/dataform_repository.go.tmpl'
+deletion_policy_custom_docs: true
 examples:
   - name: 'dataform_repository'
     primary_resource_id: 'dataform_repository'
@@ -92,11 +93,17 @@
   - name: 'deletion_policy'
     type: Enum
     description: |
-      Policy to control how the repository and its child resources are deleted. When set to `FORCE`, any child resources of this repository will also be deleted. Possible values: `DELETE`, `FORCE`. Defaults to `DELETE`.
-    default_value: 'DELETE'
-    enum_values:
-      - 'DELETE'
-      - 'FORCE'
+      Policy to control how the repository and its child resources are deleted.
+      When set to `FORCE`, any child resources of this repository will also be deleted.
+
+      When a 'terraform destroy' or 'terraform apply' 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.
+
+      Possible values: `DELETE`, `FORCE`, 'PREVENT', 'ABANDON'. Defaults to `DELETE`.
+    #excluded from generation due to Universal Deletion Policy
+    exclude: true
 parameters:
   - name: 'region'
     type: String

mmv1/products/datastream/PrivateConnection.yaml

@@ -27,6 +27,8 @@ create_url: 'projects/{{project}}/locations/{{location}}/privateConnections?priv
 immutable: true
 import_format:
   - 'projects/{{project}}/locations/{{location}}/privateConnections/{{private_connection_id}}'
+deletion_policy_custom_docs: true
+deletion_policy_default: "FORCE"
 timeouts:
   insert_minutes: 30
   update_minutes: 30
@@ -81,9 +83,14 @@ virtual_fields:
       The deletion policy for the private connection. Setting `FORCE` will also delete any child
       routes that belong to this private connection. Setting `DEFAULT` will fail the delete if
       child routes exist. Defaults to `FORCE` for backwards compatibility.
-      Possible values: `DEFAULT`, `FORCE`.
+
+      When a 'terraform destroy' or 'terraform apply' 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", the command will behave as if set to "DEFAULT".
     type: String
-    default_value: "FORCE"
+    exclude: true
 parameters:
   - name: 'privateConnectionId'
     type: String

mmv1/products/firebase/AndroidApp.yaml

@@ -81,14 +81,6 @@ examples:
     ignore_read_extra:
       - 'project'
       - 'deletion_policy'
-virtual_fields:
-  - name: 'deletion_policy'
-    description: |
-      (Optional) Set to `ABANDON` to allow the AndroidApp to be untracked from terraform state
-      rather than deleted upon `terraform destroy`. This is useful because the AndroidApp may be
-      serving traffic. Set to `DELETE` to delete the AndroidApp. Defaults to `DELETE`.
-    type: String
-    default_value: "DELETE"
 parameters:
 properties:
   - name: 'name'

mmv1/products/firebase/AppleApp.yaml

@@ -72,7 +72,7 @@
       display_name: 'Display Name Full'
       bundle_id: 'apple.app.12345'
       app_store_id: '12345'
  # Has to be a 10-digit number.
       team_id: '9987654321'
       api_key_name: 'api-key'
     test_env_vars:
@@ -86,14 +86,6 @@
     ignore_read_extra:
       - 'project'
       - 'deletion_policy'
-virtual_fields:
-  - name: 'deletion_policy'
-    description: |
-      (Optional) Set to `ABANDON` to allow the Apple to be untracked from terraform state
-      rather than deleted upon `terraform destroy`. This is useful because the Apple may be
-      serving traffic. Set to `DELETE` to delete the Apple. Defaults to `DELETE`.
-    type: String
-    default_value: "DELETE"
 parameters:
 properties:
   - name: 'name'

mmv1/products/firebase/WebApp.yaml

@@ -79,14 +79,6 @@ examples:
     ignore_read_extra:
       - 'project'
       - 'deletion_policy'
-virtual_fields:
-  - name: 'deletion_policy'
-    description: |
-      Set to `ABANDON` to allow the WebApp to be untracked from terraform state
-      rather than deleted upon `terraform destroy`. This is useful becaue the WebApp may be
-      serving traffic. Set to `DELETE` to delete the WebApp. Default to `DELETE`
-    type: String
-    default_value: "DELETE"
 parameters:
 properties:
   - name: 'name'

mmv1/products/firebasedataconnect/Service.yaml

@@ -61,6 +61,8 @@
     resource_inside_response: true
   include_project: false
 autogen_status: U2VydmljZQ==
+deletion_policy_default: "DEFAULT"
+deletion_policy_custom_docs: true
 parameters:
   - name: location
     type: String
@@ -130,12 +132,20 @@
 virtual_fields:
   - name: deletion_policy
     type: String
-    default_value: DEFAULT
     description: |-
       The deletion policy for the database. Setting the field to FORCE allows the
       Service to be deleted even if a Schema or Connector is present. By default,
       the Service deletion will only succeed when no Schema or Connectors are
       present.
-      Possible values: DEFAULT, FORCE
+
+      When a 'terraform destroy' or 'terraform apply' 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", the command will behave as if set to "DEFAULT".
+
+      Possible values: DEFAULT, FORCE, PREVENT, ABANDON, DELETE
+    #excluded from generation due to Universal Deletion Policy
+    exclude: true
 custom_code:
   pre_delete: templates/terraform/pre_delete/firebasedataconnect_service.go.tmpl

mmv1/products/firestore/Database.yaml

@@ -49,6 +49,8 @@ async:
     resource_inside_response: true
 custom_code:
   pre_delete: 'templates/terraform/pre_delete/firestore_database.go.tmpl'
+# TODO: remove this default in the 8.0.0 major release
+deletion_policy_default: "ABANDON"
 examples:
   - name: 'firestore_default_database'
     primary_resource_id: 'database'
@@ -177,19 +179,6 @@ examples:
       - 'project'
       - 'etag'
       - 'deletion_policy'
-virtual_fields:
-  - name: 'deletion_policy'
-    description: |
-      Deletion behavior for this database.
-      If the deletion policy is `ABANDON`, the database will be removed from Terraform state but not deleted from Google Cloud upon destruction.
-      If the deletion policy is `DELETE`, the database will both be removed from Terraform state and deleted from Google Cloud upon destruction.
-      The default value is `ABANDON`.
-      See also `delete_protection`.
-    type: String
-    default_value: "ABANDON"
-    # `deletion_policy` is deprecated and will be removed in a future major release.
-    # Once that release happens, you should use `delete_protection_state` instead.
-    # For now though, setting this field is necessary if you wish for your Firestore databases to be deleted upon `terraform destroy`.
 parameters:
 properties:
   - name: 'name'

mmv1/products/firestore/Index.yaml

@@ -52,7 +52,6 @@ custom_code:
   encoder: 'templates/terraform/encoders/index.go.tmpl'
   custom_import: 'templates/terraform/custom_import/index_self_link_as_name_set_project.go.tmpl'
   custom_create: 'templates/terraform/custom_create/firestore_index.go.tmpl'
-  pre_delete: 'templates/terraform/pre_delete/firestore_index.go.tmpl'
 error_retry_predicates:
   - 'transport_tpg.FirestoreIndex409Retry'
 examples:
@@ -144,18 +143,6 @@ virtual_fields:
     default_value: false
     description: "Whether to skip waiting for the index to be created."
     ignore_read: true
-  - name: 'deletion_policy'
-    type: Enum
-    default_value: 'DELETE'
-    ignore_read: true
-    enum_values:
-      - 'DELETE'
-      - 'PREVENT'
-    description: |
-      Deletion behavior for this index.
-      If the deletion policy is `PREVENT`, the index cannot be deleted and a terraform destroy will fail.
-      If the deletion policy is `DELETE`, the index will both be removed from Terraform state and deleted from Google Cloud upon destruction.
-      The default value is `DELETE`.
 parameters:
 # Firestore uses a custom create function. Any new fields must be explicitly handled there.
 properties:

mmv1/products/looker/Instance.yaml

@@ -38,6 +38,8 @@ async:
     base_url: '{{op_id}}'
   result:
     resource_inside_response: true
+deletion_policy_default: "DEFAULT"
+deletion_policy_custom_docs: true
 exclude_sweeper: true
 error_abort_predicates:
 
@@ -110,13 +112,21 @@ examples:
       - 'deletion_policy'
 virtual_fields:
   - name: 'deletion_policy'
-    default_value: "DEFAULT"
     type: String
     description: |
       Policy to determine if the cluster should be deleted forcefully.
       If setting deletion_policy = "FORCE", the Looker instance will be deleted regardless
       of its nested resources. If set to "DEFAULT", Looker instances that still have
-      nested resources will return an error. Possible values: DEFAULT, FORCE
+      nested resources will return an error.
+
+      When a 'terraform destroy' or 'terraform apply' 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", the command will behave as if set to "DEFAULT".
+
+      Possible values: DEFAULT, FORCE, PREVENT, ABANDON, DELETE
+    exclude: true
 custom_code:
   pre_delete: templates/terraform/pre_delete/looker_instance.go.tmpl
 parameters: