Amazon API Gateway Update: Documentation updates for Amazon API Gateway

Author: AWS

.changes/next-release/feature-AmazonAPIGateway-1b03658.json

@@ -0,0 +1,5 @@
+{
+    "type": "feature",
+    "category": "Amazon API Gateway",
+    "description": "Documentation updates for Amazon API Gateway"
+}

services/apigateway/src/main/resources/codegen-resources/service-2.json

@@ -4957,7 +4957,7 @@
         },
         "body":{
           "shape":"Blob",
-          "documentation":"<p>[Required] The POST request body containing external API definitions. Currently, only OpenAPI definition JSON/YAML files are supported. The maximum size of the API definition file is 2MB.</p>"
+          "documentation":"<p>[Required] The POST request body containing external API definitions. Currently, only OpenAPI definition JSON/YAML files are supported. The maximum size of the API definition file is 6MB.</p>"
         }
       },
       "documentation":"<p>A POST request to import an API to API Gateway using an input of an API definition file.</p>",
@@ -5013,7 +5013,7 @@
         },
         "cacheNamespace":{
           "shape":"String",
-          "documentation":"<p>An API-specific tag group of related cached parameters. To be valid values for <code>cacheKeyParameters</code>, these parameters must also be specified for <a>Method</a> <code>requestParameters</code>.</p>"
+          "documentation":"<p>Specifies a group of related cached parameters. By default, API Gateway uses the resource ID as the <code>cacheNamespace</code>. You can specify the same <code>cacheNamespace</code> across resources to return the same cached data for requests to different resources.</p>"
         },
         "cacheKeyParameters":{
           "shape":"ListOfString",
@@ -5564,11 +5564,11 @@
         },
         "cacheNamespace":{
           "shape":"String",
-          "documentation":"<p>A list of request parameters whose values are to be cached.</p>"
+          "documentation":"<p>Specifies a group of related cached parameters. By default, API Gateway uses the resource ID as the <code>cacheNamespace</code>. You can specify the same <code>cacheNamespace</code> across resources to return the same cached data for requests to different resources.</p>"
         },
         "cacheKeyParameters":{
           "shape":"ListOfString",
-          "documentation":"<p>An API-specific tag group of related cached parameters.</p>"
+          "documentation":"<p>A list of request parameters whose values API Gateway caches. To be valid values for <code>cacheKeyParameters</code>, these parameters must also be specified for <a>Method</a> <code>requestParameters</code>.</p>"
         },
         "contentHandling":{
           "shape":"ContentHandlingStrategy",
@@ -5779,7 +5779,7 @@
         },
         "body":{
           "shape":"Blob",
-          "documentation":"<p>[Required] The PUT request body containing external API definitions. Currently, only OpenAPI definition JSON/YAML files are supported. The maximum size of the API definition file is 2MB.</p>"
+          "documentation":"<p>[Required] The PUT request body containing external API definitions. Currently, only OpenAPI definition JSON/YAML files are supported. The maximum size of the API definition file is 6MB.</p>"
         }
       },
       "documentation":"<p>A PUT request to update an existing API, with external API definitions specified as the request body.</p>",
@@ -6378,7 +6378,7 @@
       "members":{
         "insecureSkipVerification":{
           "shape":"Boolean",
-          "documentation":"<p>Specifies whether API Gateway skips trust chain validation of the server certificate during the TLS handshake. Supported only for <code>HTTP</code> and <code>HTTP_PROXY</code> integrations. By default, API Gateway validates that certificates for integration endpoints are issued by a <a href=\"https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-supported-certificate-authorities-for-http-endpoints.html\">supported Certificate Authority</a>. If enabled, API Gateway skips trust chain validation of the server certificate. This is not recommended, but it enables you to use certificates that are signed by private Certificate Authorities, or certificates that are self-signed.</p>"
+          "documentation":"<p>Specifies whether or not API Gateway skips verification that the certificate for an integration endpoint is issued by a <a href=\"https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-supported-certificate-authorities-for-http-endpoints.html\">supported certificate authority</a>. This isn’t recommended, but it enables you to use certificates that are signed by private certificate authorities, or certificates that are self-signed. If enabled, API Gateway still performs basic certificate validation, which includes checking the certificate's expiration date, hostname, and presence of a root certificate authority. Supported only for <code>HTTP</code> and <code>HTTP_PROXY</code> integrations.</p>"
         }
       }
     },