add docs and fix tests

Author: praneetap

tests/translator/output/api_with_custom_domain_route53.json

@@ -1,15 +1,11 @@
 {
   "Parameters": {
-    "MyHostedZone": {
-      "Default": "myregionalhostedzoneid", 
+    "ACMCertificateArn": {
+      "Default": "cert-arn-in-us-east-1", 
       "Type": "String"
     }, 
-    "MyDomainName": {
-      "Default": "api-edge.com", 
-      "Type": "String"
-    }, 
-    "MyDomainCert": {
-      "Default": "my-edge-api-arn", 
+    "DomainName": {
+      "Default": "example.com", 
       "Type": "String"
     }
   }, 
@@ -36,7 +32,7 @@
         ]
       }
     }, 
-    "MyFunctionImplicitGetPermissionProd": {
+    "MyFunctionFetchPermissionProd": {
       "Type": "AWS::Lambda::Permission", 
       "Properties": {
         "Action": "lambda:invokeFunction", 
@@ -46,109 +42,146 @@
         }, 
         "SourceArn": {
           "Fn::Sub": [
-            "arn:aws:execute-api:${AWS::Region}:${AWS::AccountId}:${__ApiId__}/${__Stage__}/POST/implicit", 
+            "arn:aws:execute-api:${AWS::Region}:${AWS::AccountId}:${__ApiId__}/${__Stage__}/POST/fetch", 
             {
               "__Stage__": "*", 
               "__ApiId__": {
-                "Ref": "ServerlessRestApi"
+                "Ref": "MyApi"
               }
             }
           ]
         }
       }
     }, 
-    "RecordSetGroup2102f285a7": {
+    "ApiGatewayDomainName0caaf24ab1": {
+      "Type": "AWS::ApiGateway::DomainName", 
+      "Properties": {
+        "CertificateArn": "cert-arn-in-us-east-1", 
+        "EndpointConfiguration": {
+          "Types": [
+            "EDGE"
+          ]
+        }, 
+        "DomainName": "example.com"
+      }
+    }, 
+    "MyApiProdStage": {
+      "Type": "AWS::ApiGateway::Stage", 
+      "Properties": {
+        "DeploymentId": {
+          "Ref": "MyApiDeployment967cf1a6ff"
+        }, 
+        "RestApiId": {
+          "Ref": "MyApi"
+        }, 
+        "StageName": "Prod"
+      }
+    }, 
+    "RecordSetGroupbd00d962a4": {
       "Type": "AWS::Route53::RecordSetGroup", 
       "Properties": {
-        "HostedZoneId": "myregionalhostedzoneid", 
+        "HostedZoneId": "ZQ1UAL4EFZVME", 
         "RecordSets": [
           {
             "AliasTarget": {
-              "EvaluateTargetHealth": true, 
-              "HostedZoneId": {
+              "HostedZoneId": "Z2FDTNDATAQYW2", 
+              "DNSName": {
                 "Fn::GetAtt": [
-                  "ApiGatewayDomainNameb4325e3ba6", 
-                  "RegionalHostedZoneId"
+                  "Distribution", 
+                  "DomainName"
                 ]
-              }, 
+              }
+            }, 
+            "Type": "A", 
+            "Name": "example.com"
+          }, 
+          {
+            "AliasTarget": {
+              "HostedZoneId": "Z2FDTNDATAQYW2", 
               "DNSName": {
                 "Fn::GetAtt": [
-                  "ApiGatewayDomainNameb4325e3ba6", 
-                  "RegionalDomainName"
+                  "Distribution", 
+                  "DomainName"
                 ]
               }
             }, 
-            "Type": "A", 
-            "Name": "api-edge.com"
+            "Type": "AAAA", 
+            "Name": "example.com"
           }
         ]
       }
     }, 
-    "ServerlessRestApiBasePathMapping": {
+    "MyApifetchBasePathMapping": {
       "Type": "AWS::ApiGateway::BasePathMapping", 
       "Properties": {
-        "DomainName": "api-edge.com", 
+        "BasePath": "fetch", 
+        "DomainName": "example.com", 
         "RestApiId": {
-          "Ref": "ServerlessRestApi"
+          "Ref": "MyApi"
         }, 
         "Stage": {
-          "Ref": "ServerlessRestApiProdStage"
+          "Ref": "MyApiProdStage"
         }
       }
     }, 
-    "MyFunctionFetchPermissionProd": {
-      "Type": "AWS::Lambda::Permission", 
+    "Distribution": {
+      "Type": "AWS::CloudFront::Distribution", 
       "Properties": {
-        "Action": "lambda:invokeFunction", 
-        "Principal": "apigateway.amazonaws.com", 
-        "FunctionName": {
-          "Ref": "MyFunction"
-        }, 
-        "SourceArn": {
-          "Fn::Sub": [
-            "arn:aws:execute-api:${AWS::Region}:${AWS::AccountId}:${__ApiId__}/${__Stage__}/POST/fetch/another", 
+        "DistributionConfig": {
+          "Origins": [
             {
-              "__Stage__": "*", 
-              "__ApiId__": {
-                "Ref": "MyApi"
+              "DomainName": {
+                "Ref": "DomainName"
+              }, 
+              "Id": {
+                "Ref": "DomainName"
+              }, 
+              "CustomOriginConfig": {
+                "OriginProtocolPolicy": "https-only", 
+                "HTTPPort": 80, 
+                "HTTPSPort": 443
               }
             }
-          ]
+          ], 
+          "PriceClass": "PriceClass_100", 
+          "Enabled": true, 
+          "DefaultCacheBehavior": {
+            "Compress": true, 
+            "TargetOriginId": {
+              "Ref": "DomainName"
+            }, 
+            "ViewerProtocolPolicy": "redirect-to-https", 
+            "ForwardedValues": {
+              "QueryString": false
+            }, 
+            "SmoothStreaming": false, 
+            "AllowedMethods": [
+              "HEAD", 
+              "DELETE", 
+              "POST", 
+              "GET", 
+              "OPTIONS", 
+              "PUT", 
+              "PATCH"
+            ]
+          }, 
+          "ViewerCertificate": {
+            "SslSupportMethod": "sni-only", 
+            "AcmCertificateArn": {
+              "Ref": "ACMCertificateArn"
+            }
+          }, 
+          "HttpVersion": "http2"
         }
       }
     }, 
-    "ServerlessRestApiProdStage": {
-      "Type": "AWS::ApiGateway::Stage", 
-      "Properties": {
-        "DeploymentId": {
-          "Ref": "ServerlessRestApiDeployment5332408c06"
-        }, 
-        "RestApiId": {
-          "Ref": "ServerlessRestApi"
-        }, 
-        "StageName": "Prod"
-      }
-    }, 
-    "MyApiDeploymentb23755fe76": {
+    "MyApiDeployment967cf1a6ff": {
       "Type": "AWS::ApiGateway::Deployment", 
       "Properties": {
         "RestApiId": {
           "Ref": "MyApi"
         }, 
-        "Description": "RestApi deployment id: b23755fe76eda84d559e1656bb6251c157662141"
-      }
-    }, 
-    "MyApifetchBasePathMapping": {
-      "Type": "AWS::ApiGateway::BasePathMapping", 
-      "Properties": {
-        "BasePath": "fetch", 
-        "DomainName": "api-regional.com", 
-        "RestApiId": {
-          "Ref": "MyApi"
-        }, 
-        "Stage": {
-          "Ref": "MyApiProdStage"
-        }
+        "Description": "RestApi deployment id: 967cf1a6ff8e58a6e739bf5b7b59a7d658e01a40"
       }
     }, 
     "MyFunctionRole": {
@@ -175,42 +208,6 @@
         }
       }
     }, 
-    "RecordSetGroup3505b49f8a": {
-      "Type": "AWS::Route53::RecordSetGroup", 
-      "Properties": {
-        "HostedZoneId": "my-edge-hosted-zone", 
-        "RecordSets": [
-          {
-            "AliasTarget": {
-              "EvaluateTargetHealth": true, 
-              "HostedZoneId": "Z2FDTNDATAQYW2", 
-              "DNSName": "api-regional.com"
-            }, 
-            "Type": "AAAA", 
-            "Name": "api-regional.com"
-          }, 
-          {
-            "AliasTarget": {
-              "EvaluateTargetHealth": true, 
-              "HostedZoneId": "Z2FDTNDATAQYW2", 
-              "DNSName": "api-regional.com"
-            }, 
-            "Type": "AAAA", 
-            "Name": "api-regional.com"
-          }
-        ]
-      }
-    }, 
-    "ServerlessRestApiDeployment5332408c06": {
-      "Type": "AWS::ApiGateway::Deployment", 
-      "Properties": {
-        "RestApiId": {
-          "Ref": "ServerlessRestApi"
-        }, 
-        "Description": "RestApi deployment id: 5332408c060674292fe4785c8cfe8b3a70858887", 
-        "StageName": "Stage"
-      }
-    }, 
     "MyApi": {
       "Type": "AWS::ApiGateway::RestApi", 
       "Properties": {
@@ -222,7 +219,7 @@
             }
           }, 
           "paths": {
-            "/fetch/another": {
+            "/fetch": {
               "post": {
                 "x-amazon-apigateway-integration": {
                   "httpMethod": "POST", 
@@ -238,70 +235,6 @@
           "openapi": "3.0.1"
         }
       }
-    }, 
-    "ApiGatewayDomainNameb4325e3ba6": {
-      "Type": "AWS::ApiGateway::DomainName", 
-      "Properties": {
-        "EndpointConfiguration": {
-          "Types": [
-            "REGIONAL"
-          ]
-        }, 
-        "RegionalCertificateArn": "my-edge-api-arn", 
-        "DomainName": "api-edge.com"
-      }
-    }, 
-    "ApiGatewayDomainName80a04c0ec3": {
-      "Type": "AWS::ApiGateway::DomainName", 
-      "Properties": {
-        "CertificateArn": "my-regional-cert-arn", 
-        "EndpointConfiguration": {
-          "Types": [
-            "EDGE"
-          ]
-        }, 
-        "DomainName": "api-regional.com"
-      }
-    }, 
-    "MyApiProdStage": {
-      "Type": "AWS::ApiGateway::Stage", 
-      "Properties": {
-        "DeploymentId": {
-          "Ref": "MyApiDeploymentb23755fe76"
-        }, 
-        "RestApiId": {
-          "Ref": "MyApi"
-        }, 
-        "StageName": "Prod"
-      }
-    }, 
-    "ServerlessRestApi": {
-      "Type": "AWS::ApiGateway::RestApi", 
-      "Properties": {
-        "Body": {
-          "info": {
-            "version": "1.0", 
-            "title": {
-              "Ref": "AWS::StackName"
-            }
-          }, 
-          "paths": {
-            "/implicit": {
-              "post": {
-                "x-amazon-apigateway-integration": {
-                  "httpMethod": "POST", 
-                  "type": "aws_proxy", 
-                  "uri": {
-                    "Fn::Sub": "arn:aws:apigateway:${AWS::Region}:lambda:path/2015-03-31/functions/${MyFunction.Arn}/invocations"
-                  }
-                }, 
-                "responses": {}
-              }
-            }
-          }, 
-          "swagger": "2.0"
-        }
-      }
     }
   }
 }