feat(cdk): Support UpdateReplacePolicy on Resources (#1610)

Support the new UpdateReplacePolicy option of the CloudFormation
resources.

See: https://docs.aws.amazon.com/fr_fr/AWSCloudFormation/latest/UserGuide/aws-attribute-updatereplacepolicy.html

Author: RomainMuller

Diff for: packages/@aws-cdk/cdk/lib/cloudformation/resource.ts

@@ -191,6 +191,7 @@ export class Resource extends Referenceable {
             DependsOn: ignoreEmpty(this, this.renderDependsOn()),
             CreationPolicy:  capitalizePropertyNames(this, this.options.creationPolicy),
             UpdatePolicy: capitalizePropertyNames(this, this.options.updatePolicy),
+            UpdateReplacePolicy: capitalizePropertyNames(this, this.options.updateReplacePolicy),
             DeletionPolicy: capitalizePropertyNames(this, this.options.deletionPolicy),
             Metadata: ignoreEmpty(this, this.options.metadata),
             Condition: this.options.condition && this.options.condition.logicalId
@@ -270,6 +271,12 @@ export interface ResourceOptions {
    */
   updatePolicy?: UpdatePolicy;
 
+  /**
+   * Use the UpdateReplacePolicy attribute to retain or (in some cases) backup the existing physical instance of a resource
+   * when it is replaced during a stack update operation.
+   */
+  updateReplacePolicy?: DeletionPolicy;
+
   /**
    * Metadata associated with the CloudFormation resource. This is not the same as the construct metadata which can be added
    * using construct.addMetadata(), but would not appear in the CloudFormation template automatically.

Diff for: packages/@aws-cdk/cdk/test/cloudformation/test.resource.ts

@@ -165,7 +165,7 @@ export = {
     test.done();
   },
 
-  'creation/update/deletion policies can be set on a resource'(test: Test) {
+  'creation/update/updateReplace/deletion policies can be set on a resource'(test: Test) {
     const stack = new Stack();
     const r1 = new Resource(stack, 'Resource', { type: 'Type' });
 
@@ -181,6 +181,7 @@ export = {
       },
     };
     r1.options.deletionPolicy = DeletionPolicy.Retain;
+    r1.options.updateReplacePolicy = DeletionPolicy.Snapshot;
 
     test.deepEqual(stack.toCloudFormation(), {
       Resources: {
@@ -196,7 +197,8 @@ export = {
               BeforeAllowTrafficHook: 'lambda1',
             },
           },
-          DeletionPolicy: 'Retain'
+          DeletionPolicy: 'Retain',
+          UpdateReplacePolicy: 'Snapshot'
         }
       }
     });