feat(s3): bucket websiteRedirect (#3392)

Implements missing Bucket WebsiteConfiguration [RedirectAllRequestsTo](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-websiteconfiguration.html#cfn-s3-websiteconfiguration-redirectallrequeststo) property.
The constructor checks that the following requirement is fulfilled:
> If you specify this property, you can't specify any other property.

Fixes #1083

Author: Jimmy Gaussen

packages/@aws-cdk/aws-s3/lib/bucket.ts

@@ -695,6 +695,31 @@ export interface CorsRule {
   readonly exposedHeaders?: string[];
 }
 
+/**
+ * All http request methods
+ */
+export enum RedirectProtocol {
+  HTTP = 'http',
+  HTTPS = 'https',
+}
+
+/**
+ * Specifies a redirect behavior of all requests to a website endpoint of a bucket.
+ */
+export interface RedirectTarget {
+  /**
+   * Name of the host where requests are redirected
+   */
+  readonly hostName: string;
+
+  /**
+   * Protocol to use when redirecting requests
+   *
+   * @default - The protocol used in the original request.
+   */
+  readonly protocol?: RedirectProtocol;
+}
+
 export interface BucketProps {
   /**
    * The kind of server-side encryption to apply to this bucket.
@@ -762,6 +787,15 @@ export interface BucketProps {
    */
   readonly websiteErrorDocument?: string;
 
+  /**
+   * Specifies the redirect behavior of all requests to a website endpoint of a bucket.
+   *
+   * If you specify this property, you can't specify "websiteIndexDocument" nor "websiteErrorDocument".
+   *
+   * @default - No redirection.
+   */
+  readonly websiteRedirect?: RedirectTarget;
+
   /**
    * Grants public read access to all objects in the bucket.
    * Similar to calling `bucket.grantPublicAccess()`
@@ -1214,17 +1248,22 @@ export class Bucket extends BucketBase {
   }
 
   private renderWebsiteConfiguration(props: BucketProps): CfnBucket.WebsiteConfigurationProperty | undefined {
-    if (!props.websiteErrorDocument && !props.websiteIndexDocument) {
+    if (!props.websiteErrorDocument && !props.websiteIndexDocument && !props.websiteRedirect) {
       return undefined;
     }
 
     if (props.websiteErrorDocument && !props.websiteIndexDocument) {
       throw new Error(`"websiteIndexDocument" is required if "websiteErrorDocument" is set`);
     }
 
+    if (props.websiteRedirect && (props.websiteErrorDocument || props.websiteIndexDocument)) {
+        throw new Error('"websiteIndexDocument" and "websiteErrorDocument" cannot be set if "websiteRedirect" is used');
+    }
+
     return {
       indexDocument: props.websiteIndexDocument,
-      errorDocument: props.websiteErrorDocument
+      errorDocument: props.websiteErrorDocument,
+      redirectAllRequestsTo: props.websiteRedirect,
     };
   }
 }

packages/@aws-cdk/aws-s3/test/test.bucket.ts

@@ -1524,7 +1524,38 @@ export = {
       });
       test.deepEqual(stack.resolve(bucket.bucketWebsiteUrl), { 'Fn::GetAtt': ['Website32962D0B', 'WebsiteURL'] });
       test.done();
-    }
+    },
+    'adds RedirectAllRequestsTo property'(test: Test) {
+      const stack = new cdk.Stack();
+      new s3.Bucket(stack, 'Website', {
+        websiteRedirect: {
+          hostName: 'www.example.com',
+          protocol: s3.RedirectProtocol.HTTPS
+        }
+      });
+      expect(stack).to(haveResource('AWS::S3::Bucket', {
+        WebsiteConfiguration: {
+          RedirectAllRequestsTo: {
+            HostName: 'www.example.com',
+            Protocol: 'https'
+          }
+        }
+      }));
+      test.done();
+    },
+    'fails if websiteRedirect and another website property are specified'(test: Test) {
+      const stack = new cdk.Stack();
+      test.throws(() => {
+        new s3.Bucket(stack, 'Website', {
+          websiteIndexDocument: 'index.html',
+          websiteErrorDocument: 'error.html',
+          websiteRedirect: {
+            hostName: 'www.example.com'
+          }
+        });
+      }, /"websiteIndexDocument" and "websiteErrorDocument" cannot be set if "websiteRedirect" is used/);
+      test.done();
+    },
   },
 
   'Bucket.fromBucketArn'(test: Test) {