aws-sdk-apigateway 1.17.0 → 1.18.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 8c8b328d744567738b6888bd12728a799ef704d9
-  data.tar.gz: eb2e6ba26f6423f856075e19dd10cd6b84f23302
+  metadata.gz: 2139dd9efcf10ab11e862865329839e14b84fc0e
+  data.tar.gz: 26f79ab20bc12b2570086dfcadaea36c56829b0b
 SHA512:
-  metadata.gz: c523607acf00987ca6f0f069adc22f9ae18e27aec4dd9e8054f5185f7d7ff30602d87e6516d34dfb522d74c4e17f63f60636837d2630da95de46cda9b2cf5e09
-  data.tar.gz: 7d8ed3999748172459134980647026baaee0fb1fb77716ec953cac1a3acb7f73f05c7ebbc47f58acddb32d09954e13a8ba5ce01f20b7aa4c089852c5bcb79f00
+  metadata.gz: 8944a844a3b904156ff76b294dd2032020dd63b24d6cefee54af738bf7f2de3c2440bd241911fe57530e4372972b04644109af38ae54556453c68207d998b991
+  data.tar.gz: 90d327c485d68557dcc6edbb29c6245f53f04919b51584d14115e46a75d0b20316512f41bb83e4474b55d5047aa08c3e9b74c080ba451e8a36bc6ada32256af6

data/lib/aws-sdk-apigateway.rb

@@ -42,6 +42,6 @@ require_relative 'aws-sdk-apigateway/customizations'
 # @service
 module Aws::APIGateway
 
-  GEM_VERSION = '1.17.0'
+  GEM_VERSION = '1.18.0'
 
 end

data/lib/aws-sdk-apigateway/client.rb

@@ -181,13 +181,10 @@ module Aws::APIGateway
     # Create an ApiKey resource.
     #
     # <div class="seeAlso">
-    # [AWS CLI][1]
+    # [AWS
+    # CLI]([[AwsDocsUrlPrefix]]/cli/latest/reference/apigateway/create-api-key.html)
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/cli/latest/reference/apigateway/create-api-key.html
-    #
     # @option params [String] :name
     #   The name of the ApiKey.
     #
@@ -264,13 +261,10 @@ module Aws::APIGateway
     # Adds a new Authorizer resource to an existing RestApi resource.
     #
     # <div class="seeAlso">
-    # [AWS CLI][1]
+    # [AWS
+    # CLI]([[AwsDocsUrlPrefix]]/cli/latest/reference/apigateway/create-authorizer.html)
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/cli/latest/reference/apigateway/create-authorizer.html
-    #
     # @option params [required, String] :rest_api_id
     #   \[Required\] The string identifier of the associated RestApi.
     #
@@ -291,7 +285,7 @@ module Aws::APIGateway
     #   For a `TOKEN` or `REQUEST` authorizer, this is not defined.
     #
     # @option params [String] :auth_type
-    #   Optional customer-defined field, used in OpenAPI imports and exports
+    #   Optional customer-defined field, used in Swagger imports and exports
     #   without functional impact.
     #
     # @option params [String] :authorizer_uri
@@ -540,7 +534,7 @@ module Aws::APIGateway
     # @option params [required, String] :properties
     #   \[Required\] The new documentation content map of the targeted API
     #   entity. Enclosed key-value pairs are API-specific, but only
-    #   OpenAPI-compliant key-value pairs can be exported and, hence,
+    #   Swagger-compliant key-value pairs can be exported and, hence,
     #   published.
     #
     # @return [Types::DocumentationPart] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -731,11 +725,7 @@ module Aws::APIGateway
     #
     # @option params [String] :schema
     #   The schema for the model. For `application/json` models, this should
-    #   be [JSON schema draft 4][1] model.
-    #
-    #
-    #
-    #   [1]: https://tools.ietf.org/html/draft-zyp-json-schema-04
+    #   be [JSON schema draft 4]([[JsonSchemaUrl]]) model.
     #
     # @option params [required, String] :content_type
     #   \[Required\] The content-type for the model.
@@ -1327,13 +1317,10 @@ module Aws::APIGateway
     # Deletes an existing Authorizer resource.
     #
     # <div class="seeAlso">
-    # [AWS CLI][1]
+    # [AWS
+    # CLI]([[AwsDocsUrlPrefix]]/cli/latest/reference/apigateway/delete-authorizer.html)
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/cli/latest/reference/apigateway/delete-authorizer.html
-    #
     # @option params [required, String] :rest_api_id
     #   \[Required\] The string identifier of the associated RestApi.
     #
@@ -2066,13 +2053,10 @@ module Aws::APIGateway
     # Describe an existing Authorizer resource.
     #
     # <div class="seeAlso">
-    # [AWS CLI][1]
+    # [AWS
+    # CLI]([[AwsDocsUrlPrefix]]/cli/latest/reference/apigateway/get-authorizer.html)
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/cli/latest/reference/apigateway/get-authorizer.html
-    #
     # @option params [required, String] :rest_api_id
     #   \[Required\] The string identifier of the associated RestApi.
     #
@@ -2123,13 +2107,10 @@ module Aws::APIGateway
     # Describe an existing Authorizers resource.
     #
     # <div class="seeAlso">
-    # [AWS CLI][1]
+    # [AWS
+    # CLI]([[AwsDocsUrlPrefix]]/cli/latest/reference/apigateway/get-authorizers.html)
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/cli/latest/reference/apigateway/get-authorizers.html
-    #
     # @option params [required, String] :rest_api_id
     #   \[Required\] The string identifier of the associated RestApi.
     #
@@ -2696,15 +2677,15 @@ module Aws::APIGateway
     #   \[Required\] The name of the Stage that will be exported.
     #
     # @option params [required, String] :export_type
-    #   \[Required\] The type of export. Acceptable values are 'oas30' for
-    #   OpenAPI 3.0.x and 'swagger' for Swagger/OpenAPI 2.0.
+    #   \[Required\] The type of export. Currently only 'swagger' is
+    #   supported.
     #
     # @option params [Hash<String,String>] :parameters
     #   A key-value map of query string parameters that specify properties of
     #   the export, depending on the requested `exportType`. For `exportType`
-    #   `oas30` and `swagger`, any combination of the following parameters are
-    #   supported: `extensions='integrations'` or `extensions='apigateway'`
-    #   will export the API with x-amazon-apigateway-integration extensions.
+    #   `swagger`, any combination of the following parameters are supported:
+    #   `extensions='integrations'` or `extensions='apigateway'` will export
+    #   the API with x-amazon-apigateway-integration extensions.
     #   `extensions='authorizers'` will export the API with
     #   x-amazon-apigateway-authorizer extensions. `postman` will export the
     #   API with Postman extensions, allowing for import to the Postman tool
@@ -2712,8 +2693,8 @@ module Aws::APIGateway
     # @option params [String] :accepts
     #   The content-type of the export, for example `application/json`.
     #   Currently `application/json` and `application/yaml` are supported for
-    #   `exportType` of`oas30` and `swagger`. This should be specified in the
-    #   `Accept` header for direct API requests.
+    #   `exportType` of `swagger`. This should be specified in the `Accept`
+    #   header for direct API requests.
     #
     # @return [Types::ExportResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -4216,11 +4197,8 @@ module Aws::APIGateway
     #
     # @option params [required, String, IO] :body
     #   The payload of the POST request to import API keys. For the payload
-    #   format, see [API Key File Format][1].
-    #
-    #
-    #
-    #   [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/api-key-file-format.html
+    #   format, see [API Key File
+    #   Format]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/api-key-file-format.html).
     #
     # @option params [required, String] :format
     #   A query parameter to specify the input format to imported API keys.
@@ -4272,7 +4250,7 @@ module Aws::APIGateway
     #
     # @option params [required, String, IO] :body
     #   \[Required\] Raw byte array representing the to-be-imported
-    #   documentation parts. To import from an OpenAPI file, this is a JSON
+    #   documentation parts. To import from a Swagger file, this is a JSON
     #   object.
     #
     # @return [Types::DocumentationPartIds] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -4340,7 +4318,7 @@ module Aws::APIGateway
     #
     # @option params [required, String, IO] :body
     #   \[Required\] The POST request body containing external API
-    #   definitions. Currently, only OpenAPI definition JSON/YAML files are
+    #   definitions. Currently, only Swagger definition JSON files are
     #   supported. The maximum size of the API definition file is 2MB.
     #
     # @return [Types::RestApi] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -4495,10 +4473,10 @@ module Aws::APIGateway
     #
     #   * For `HTTP` or `HTTP_PROXY` integrations, the URI must be a fully
     #     formed, encoded HTTP(S) URL according to the [RFC-3986
-    #     specification][1], for either standard integration, where
-    #     `connectionType` is not `VPC_LINK`, or private integration, where
-    #     `connectionType` is `VPC_LINK`. For a private HTTP integration, the
-    #     URI is not used for routing.
+    #     specification]([[UriEntryWikipediaUrl]]), for either standard
+    #     integration, where `connectionType` is not `VPC_LINK`, or private
+    #     integration, where `connectionType` is `VPC_LINK`. For a private
+    #     HTTP integration, the URI is not used for routing.
     #
     #   * For `AWS` or `AWS_PROXY` integrations, the URI is of the form
     #     `arn:aws:apigateway:\{region\}:\{subdomain.service|service\}:path|action/\{service_api\}`.
@@ -4517,10 +4495,6 @@ module Aws::APIGateway
     #     `arn:aws:apigateway:us-west-2:s3:action/GetObject&Bucket=\{bucket\}&Key=\{key\}`
     #     or `arn:aws:apigateway:us-west-2:s3:path/\{bucket\}/\{key\}`
     #
-    #
-    #
-    #   [1]: https://en.wikipedia.org/wiki/Uniform_Resource_Identifier
-    #
     # @option params [String] :connection_type
     #   The type of the network connection to the integration endpoint. The
     #   valid value is `INTERNET` for connections through the public routable
@@ -4528,12 +4502,10 @@ module Aws::APIGateway
     #   a network load balancer in a VPC. The default value is `INTERNET`.
     #
     # @option params [String] :connection_id
-    #   The ([`id`][1]) of the VpcLink used for the integration when
-    #   `connectionType=VPC_LINK` and undefined, otherwise.
-    #
-    #
-    #
-    #   [1]: https://docs.aws.amazon.com/apigateway/api-reference/resource/vpc-link/#id
+    #   The
+    #   ([`id`]([[AwsDocsUrlPrefix]]/apigateway/api-reference/resource/vpc-link/#id))
+    #   of the VpcLink used for the integration when `connectionType=VPC_LINK`
+    #   and undefined, otherwise.
     #
     # @option params [String] :credentials
     #   Specifies whether credentials are required for a put integration.
@@ -4796,11 +4768,7 @@ module Aws::APIGateway
     # @option params [String] :operation_name
     #   A human-friendly operation identifier for the method. For example, you
     #   can assign the `operationName` of `ListPets` for the `GET /pets`
-    #   method in [PetStore][1] example.
-    #
-    #
-    #
-    #   [1]: https://petstore-demo-endpoint.execute-api.com/petstore/pets
+    #   method in [PetStore]([[PetstoreDemoUrl]]) example.
     #
     # @option params [Hash<String,Boolean>] :request_parameters
     #   A key-value map defining required or optional method request
@@ -5018,7 +4986,7 @@ module Aws::APIGateway
     #
     # @option params [required, String, IO] :body
     #   \[Required\] The PUT request body containing external API definitions.
-    #   Currently, only OpenAPI definition JSON/YAML files are supported. The
+    #   Currently, only Swagger definition JSON files are supported. The
     #   maximum size of the API definition file is 2MB.
     #
     # @return [Types::RestApi] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -5105,13 +5073,10 @@ module Aws::APIGateway
     # parameters, and an incoming request body.
     #
     # <div class="seeAlso">
-    # [Enable custom authorizers][1]
+    # [Enable custom
+    # authorizers]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/use-custom-authorizer.html)
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/use-custom-authorizer.html
-    #
     # @option params [required, String] :rest_api_id
     #   \[Required\] The string identifier of the associated RestApi.
     #
@@ -5124,6 +5089,11 @@ module Aws::APIGateway
     #   invocation request. This is where the incoming authorization token, or
     #   identity source, should be specified.
     #
+    # @option params [Hash<String,Array>] :multi_value_headers
+    #   \[Optional\] The headers as a map from string to list of values to
+    #   simulate an incoming invocation request. This is where the incoming
+    #   authorization token, or identity source, may be specified.
+    #
     # @option params [String] :path_with_query_string
     #   \[Optional\] The URI path, including query string, of the simulated
     #   invocation request. Use this to specify path parameters and query
@@ -5158,6 +5128,9 @@ module Aws::APIGateway
     #     headers: {
     #       "String" => "String",
     #     },
+    #     multi_value_headers: {
+    #       "String" => ["String"],
+    #     },
     #     path_with_query_string: "String",
     #     body: "String",
     #     stage_variables: {
@@ -5211,6 +5184,10 @@ module Aws::APIGateway
     # @option params [Hash<String,String>] :headers
     #   A key-value map of headers to simulate an incoming invocation request.
     #
+    # @option params [Hash<String,Array>] :multi_value_headers
+    #   The headers as a map from string to list of values to simulate an
+    #   incoming invocation request.
+    #
     # @option params [String] :client_certificate_id
     #   A ClientCertificate identifier to use in the test invocation. API
     #   Gateway will use the certificate when making the HTTPS request to the
@@ -5225,6 +5202,7 @@ module Aws::APIGateway
     #   * {Types::TestInvokeMethodResponse#status #status} => Integer
     #   * {Types::TestInvokeMethodResponse#body #body} => String
     #   * {Types::TestInvokeMethodResponse#headers #headers} => Hash&lt;String,String&gt;
+    #   * {Types::TestInvokeMethodResponse#multi_value_headers #multi_value_headers} => Hash&lt;String,Array&lt;String&gt;&gt;
     #   * {Types::TestInvokeMethodResponse#log #log} => String
     #   * {Types::TestInvokeMethodResponse#latency #latency} => Integer
     #
@@ -5239,6 +5217,9 @@ module Aws::APIGateway
     #     headers: {
     #       "String" => "String",
     #     },
+    #     multi_value_headers: {
+    #       "String" => ["String"],
+    #     },
     #     client_certificate_id: "String",
     #     stage_variables: {
     #       "String" => "String",
@@ -5251,6 +5232,9 @@ module Aws::APIGateway
     #   resp.body #=> String
     #   resp.headers #=> Hash
     #   resp.headers["String"] #=> String
+    #   resp.multi_value_headers #=> Hash
+    #   resp.multi_value_headers["String"] #=> Array
+    #   resp.multi_value_headers["String"][0] #=> String
     #   resp.log #=> String
     #   resp.latency #=> Integer
     #
@@ -5387,13 +5371,10 @@ module Aws::APIGateway
     # Updates an existing Authorizer resource.
     #
     # <div class="seeAlso">
-    # [AWS CLI][1]
+    # [AWS
+    # CLI]([[AwsDocsUrlPrefix]]/cli/latest/reference/apigateway/update-authorizer.html)
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/cli/latest/reference/apigateway/update-authorizer.html
-    #
     # @option params [required, String] :rest_api_id
     #   \[Required\] The string identifier of the associated RestApi.
     #
@@ -6641,7 +6622,7 @@ module Aws::APIGateway
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-apigateway'
-      context[:gem_version] = '1.17.0'
+      context[:gem_version] = '1.18.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-apigateway/client_api.rb

@@ -178,7 +178,6 @@ module Aws::APIGateway
     LocationStatusType = Shapes::StringShape.new(name: 'LocationStatusType')
     Long = Shapes::IntegerShape.new(name: 'Long')
     MapOfApiStageThrottleSettings = Shapes::MapShape.new(name: 'MapOfApiStageThrottleSettings')
-    MapOfHeaderValues = Shapes::MapShape.new(name: 'MapOfHeaderValues')
     MapOfIntegrationResponse = Shapes::MapShape.new(name: 'MapOfIntegrationResponse')
     MapOfKeyUsages = Shapes::MapShape.new(name: 'MapOfKeyUsages')
     MapOfMethod = Shapes::MapShape.new(name: 'MapOfMethod')
@@ -960,9 +959,6 @@ module Aws::APIGateway
     MapOfApiStageThrottleSettings.key = Shapes::ShapeRef.new(shape: String)
     MapOfApiStageThrottleSettings.value = Shapes::ShapeRef.new(shape: ThrottleSettings)
 
-    MapOfHeaderValues.key = Shapes::ShapeRef.new(shape: String)
-    MapOfHeaderValues.value = Shapes::ShapeRef.new(shape: String)
-
     MapOfIntegrationResponse.key = Shapes::ShapeRef.new(shape: String)
     MapOfIntegrationResponse.value = Shapes::ShapeRef.new(shape: IntegrationResponse)
 
@@ -1213,7 +1209,8 @@ module Aws::APIGateway
 
     TestInvokeAuthorizerRequest.add_member(:rest_api_id, Shapes::ShapeRef.new(shape: String, required: true, location: "uri", location_name: "restapi_id"))
     TestInvokeAuthorizerRequest.add_member(:authorizer_id, Shapes::ShapeRef.new(shape: String, required: true, location: "uri", location_name: "authorizer_id"))
-    TestInvokeAuthorizerRequest.add_member(:headers, Shapes::ShapeRef.new(shape: MapOfHeaderValues, location_name: "headers"))
+    TestInvokeAuthorizerRequest.add_member(:headers, Shapes::ShapeRef.new(shape: MapOfStringToString, location_name: "headers"))
+    TestInvokeAuthorizerRequest.add_member(:multi_value_headers, Shapes::ShapeRef.new(shape: MapOfStringToList, location_name: "multiValueHeaders"))
     TestInvokeAuthorizerRequest.add_member(:path_with_query_string, Shapes::ShapeRef.new(shape: String, location_name: "pathWithQueryString"))
     TestInvokeAuthorizerRequest.add_member(:body, Shapes::ShapeRef.new(shape: String, location_name: "body"))
     TestInvokeAuthorizerRequest.add_member(:stage_variables, Shapes::ShapeRef.new(shape: MapOfStringToString, location_name: "stageVariables"))
@@ -1234,14 +1231,16 @@ module Aws::APIGateway
     TestInvokeMethodRequest.add_member(:http_method, Shapes::ShapeRef.new(shape: String, required: true, location: "uri", location_name: "http_method"))
     TestInvokeMethodRequest.add_member(:path_with_query_string, Shapes::ShapeRef.new(shape: String, location_name: "pathWithQueryString"))
     TestInvokeMethodRequest.add_member(:body, Shapes::ShapeRef.new(shape: String, location_name: "body"))
-    TestInvokeMethodRequest.add_member(:headers, Shapes::ShapeRef.new(shape: MapOfHeaderValues, location_name: "headers"))
+    TestInvokeMethodRequest.add_member(:headers, Shapes::ShapeRef.new(shape: MapOfStringToString, location_name: "headers"))
+    TestInvokeMethodRequest.add_member(:multi_value_headers, Shapes::ShapeRef.new(shape: MapOfStringToList, location_name: "multiValueHeaders"))
     TestInvokeMethodRequest.add_member(:client_certificate_id, Shapes::ShapeRef.new(shape: String, location_name: "clientCertificateId"))
     TestInvokeMethodRequest.add_member(:stage_variables, Shapes::ShapeRef.new(shape: MapOfStringToString, location_name: "stageVariables"))
     TestInvokeMethodRequest.struct_class = Types::TestInvokeMethodRequest
 
     TestInvokeMethodResponse.add_member(:status, Shapes::ShapeRef.new(shape: Integer, location_name: "status"))
     TestInvokeMethodResponse.add_member(:body, Shapes::ShapeRef.new(shape: String, location_name: "body"))
-    TestInvokeMethodResponse.add_member(:headers, Shapes::ShapeRef.new(shape: MapOfHeaderValues, location_name: "headers"))
+    TestInvokeMethodResponse.add_member(:headers, Shapes::ShapeRef.new(shape: MapOfStringToString, location_name: "headers"))
+    TestInvokeMethodResponse.add_member(:multi_value_headers, Shapes::ShapeRef.new(shape: MapOfStringToList, location_name: "multiValueHeaders"))
     TestInvokeMethodResponse.add_member(:log, Shapes::ShapeRef.new(shape: String, location_name: "log"))
     TestInvokeMethodResponse.add_member(:latency, Shapes::ShapeRef.new(shape: Long, location_name: "latency"))
     TestInvokeMethodResponse.struct_class = Types::TestInvokeMethodResponse

data/lib/aws-sdk-apigateway/types.rb

@@ -13,12 +13,9 @@ module Aws::APIGateway
     #
     # @!attribute [rw] format
     #   A single line format of the access logs of data, as specified by
-    #   selected [$context variables][1]. The format must include at least
-    #   `$context.requestId`.
-    #
-    #
-    #
-    #   [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-mapping-template-reference.html#context-variable-reference
+    #   selected [$context
+    #   variables]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/api-gateway-mapping-template-reference.html#context-variable-reference).
+    #   The format must include at least `$context.requestId`.
     #   @return [String]
     #
     # @!attribute [rw] destination_arn
@@ -45,7 +42,8 @@ module Aws::APIGateway
     # * TooManyRequestsException
     #
     # For detailed error code information, including the corresponding HTTP
-    # Status Codes, see [API Gateway Error Codes][1]
+    # Status Codes, see [API Gateway Error
+    # Codes]([[AwsDocsUrlPrefix]]/apigateway/api-reference/handling-errors/#api-error-codes)
     #
     # #### Example: Get the information about an account.
     #
@@ -58,7 +56,7 @@ module Aws::APIGateway
     # The successful response returns a `200 OK` status code and a payload
     # similar to the following:
     #
-    #     \{ "_links": \{ "curies": \{ "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/account-apigateway-\{rel\}.html", "name": "account", "templated": true \}, "self": \{ "href": "/account" \}, "account:update": \{ "href": "/account" \} \}, "cloudwatchRoleArn": "arn:aws:iam::123456789012:role/apigAwsProxyRole", "throttleSettings": \{ "rateLimit": 500, "burstLimit": 1000 \} \}
+    #     \{ "_links": \{ "curies": \{ "href": "[[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/account-apigateway-\{rel\}.html", "name": "account", "templated": true \}, "self": \{ "href": "/account" \}, "account:update": \{ "href": "/account" \} \}, "cloudwatchRoleArn": "arn:aws:iam::123456789012:role/apigAwsProxyRole", "throttleSettings": \{ "rateLimit": 500, "burstLimit": 1000 \} \}
     #
     # In addition to making the REST API call directly, you can use the AWS
     # CLI and an AWS SDK to access this resource.
@@ -66,16 +64,14 @@ module Aws::APIGateway
     # </div>
     #
     # <div class="seeAlso">
-    # [API Gateway Limits][2] [Developer Guide][3], [AWS CLI][4]
+    # [API Gateway
+    # Limits]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/api-gateway-limits.html)
+    # [Developer
+    # Guide]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/welcome.html),
+    # [AWS
+    # CLI]([[AwsDocsUrlPrefix]]/cli/latest/reference/apigateway/get-account.html)
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/apigateway/api-reference/handling-errors/#api-error-codes
-    # [2]: https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-limits.html
-    # [3]: https://docs.aws.amazon.com/apigateway/latest/developerguide/welcome.html
-    # [4]: https://docs.aws.amazon.com/cli/latest/reference/apigateway/get-account.html
-    #
     # @!attribute [rw] cloudwatch_role_arn
     #   The ARN of an Amazon CloudWatch role for the current Account.
     #   @return [String]
@@ -107,13 +103,10 @@ module Aws::APIGateway
     # make requests to that stage.
     #
     # <div class="seeAlso">
-    # [Use API Keys][1]
+    # [Use API
+    # Keys]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/how-to-api-keys.html)
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-api-keys.html
-    #
     # @!attribute [rw] id
     #   The identifier of the API Key.
     #   @return [String]
@@ -185,13 +178,10 @@ module Aws::APIGateway
     # resource.
     #
     # <div class="seeAlso">
-    # [Use API Keys][1]
+    # [Use API
+    # Keys]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/how-to-api-keys.html)
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-api-keys.html
-    #
     # @!attribute [rw] warnings
     #   A list of warning messages logged during the import of API keys when
     #   the `failOnWarnings` option is set to true.
@@ -252,13 +242,10 @@ module Aws::APIGateway
     # method.
     #
     # <div class="seeAlso">
-    # [Enable custom authorization][1]
+    # [Enable custom
+    # authorization]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/use-custom-authorizer.html)
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/use-custom-authorizer.html
-    #
     # @!attribute [rw] id
     #   The identifier for the authorizer resource.
     #   @return [String]
@@ -282,7 +269,7 @@ module Aws::APIGateway
     #   @return [Array<String>]
     #
     # @!attribute [rw] auth_type
-    #   Optional customer-defined field, used in OpenAPI imports and exports
+    #   Optional customer-defined field, used in Swagger imports and exports
     #   without functional impact.
     #   @return [String]
     #
@@ -365,13 +352,10 @@ module Aws::APIGateway
     # Represents a collection of Authorizer resources.
     #
     # <div class="seeAlso">
-    # [Enable custom authorization][1]
+    # [Enable custom
+    # authorization]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/use-custom-authorizer.html)
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/use-custom-authorizer.html
-    #
     # @!attribute [rw] position
     #   @return [String]
     #
@@ -394,13 +378,10 @@ module Aws::APIGateway
     # </div>
     #
     # <div class="seeAlso">
-    # [Use Custom Domain Names][1]
+    # [Use Custom Domain
+    # Names]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/how-to-custom-domains.html)
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-custom-domains.html
-    #
     # @!attribute [rw] base_path
     #   The base path name that callers of the API must provide as part of
     #   the URL after the domain name.
@@ -424,13 +405,10 @@ module Aws::APIGateway
     # Represents a collection of BasePathMapping resources.
     #
     # <div class="seeAlso">
-    # [Use Custom Domain Names][1]
+    # [Use Custom Domain
+    # Names]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/how-to-custom-domains.html)
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-custom-domains.html
-    #
     # @!attribute [rw] position
     #   @return [String]
     #
@@ -496,13 +474,10 @@ module Aws::APIGateway
     # </div>
     #
     # <div class="seeAlso">
-    # [Use Client-Side Certificate][1]
+    # [Use Client-Side
+    # Certificate]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/getting-started-client-side-ssl-authentication.html)
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/getting-started-client-side-ssl-authentication.html
-    #
     # @!attribute [rw] client_certificate_id
     #   The identifier of the client certificate.
     #   @return [String]
@@ -537,13 +512,10 @@ module Aws::APIGateway
     # Represents a collection of ClientCertificate resources.
     #
     # <div class="seeAlso">
-    # [Use Client-Side Certificate][1]
+    # [Use Client-Side
+    # Certificate]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/getting-started-client-side-ssl-authentication.html)
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/getting-started-client-side-ssl-authentication.html
-    #
     # @!attribute [rw] position
     #   @return [String]
     #
@@ -661,7 +633,7 @@ module Aws::APIGateway
     #   @return [Array<String>]
     #
     # @!attribute [rw] auth_type
-    #   Optional customer-defined field, used in OpenAPI imports and exports
+    #   Optional customer-defined field, used in Swagger imports and exports
     #   without functional impact.
     #   @return [String]
     #
@@ -895,7 +867,7 @@ module Aws::APIGateway
     # @!attribute [rw] properties
     #   \[Required\] The new documentation content map of the targeted API
     #   entity. Enclosed key-value pairs are API-specific, but only
-    #   OpenAPI-compliant key-value pairs can be exported and, hence,
+    #   Swagger-compliant key-value pairs can be exported and, hence,
     #   published.
     #   @return [String]
     #
@@ -1055,11 +1027,7 @@ module Aws::APIGateway
     #
     # @!attribute [rw] schema
     #   The schema for the model. For `application/json` models, this should
-    #   be [JSON schema draft 4][1] model.
-    #
-    #
-    #
-    #   [1]: https://tools.ietf.org/html/draft-zyp-json-schema-04
+    #   be [JSON schema draft 4]([[JsonSchemaUrl]]) model.
     #   @return [String]
     #
     # @!attribute [rw] content_type
@@ -2003,14 +1971,11 @@ module Aws::APIGateway
     # </div>
     #
     # <div class="seeAlso">
-    # RestApi, Deployments, Stage, [AWS CLI][1], [AWS SDKs][2]
+    # RestApi, Deployments, Stage, [AWS
+    # CLI]([[AwsDocsUrlPrefix]]/cli/latest/reference/apigateway/get-deployment.html),
+    # [AWS SDKs]([[AwsAmazonUrlPrefix]]/tools/)
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/cli/latest/reference/apigateway/get-deployment.html
-    # [2]: https://aws.amazon.com/tools/
-    #
     # @!attribute [rw] id
     #   The identifier for the deployment resource.
     #   @return [String]
@@ -2087,15 +2052,13 @@ module Aws::APIGateway
     # </div>
     #
     # <div class="seeAlso">
-    # [Deploying an API][1], [AWS CLI][2], [AWS SDKs][3]
+    # [Deploying an
+    # API]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/how-to-deploy-api.html),
+    # [AWS
+    # CLI]([[AwsDocsUrlPrefix]]/cli/latest/reference/apigateway/get-deployment.html),
+    # [AWS SDKs]([[AwsAmazonUrlPrefix]]/tools/)
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-deploy-api.html
-    # [2]: https://docs.aws.amazon.com/cli/latest/reference/apigateway/get-deployment.html
-    # [3]: https://aws.amazon.com/tools/
-    #
     # @!attribute [rw] position
     #   @return [String]
     #
@@ -2122,20 +2085,18 @@ module Aws::APIGateway
     #
     # The content map is a JSON string of API-specific key-value pairs.
     # Although an API can use any shape for the content map, only the
-    # OpenAPI-compliant documentation fields will be injected into the
-    # associated API entity definition in the exported OpenAPI definition
+    # Swagger-compliant documentation fields will be injected into the
+    # associated API entity definition in the exported Swagger definition
     # file.
     #
     # </div>
     #
     # <div class="seeAlso">
-    # [Documenting an API][1], DocumentationParts
+    # [Documenting an
+    # API]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/api-gateway-documenting-api.html),
+    # DocumentationParts
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-documenting-api.html
-    #
     # @!attribute [rw] id
     #   The DocumentationPart identifier, generated by API Gateway when the
     #   `DocumentationPart` is created.
@@ -2154,12 +2115,12 @@ module Aws::APIGateway
     #   A content map of API-specific key-value pairs describing the
     #   targeted API entity. The map must be encoded as a JSON string, e.g.,
     #   `"\{ "description": "The API does ..." \}"`. Only
-    #   OpenAPI-compliant documentation-related fields from the
+    #   Swagger-compliant documentation-related fields from the
     #   <literal>properties</literal>
     #
     #    map are exported and, hence, published as part of the API entity
     #   definitions, while the original documentation parts are exported in
-    #   a OpenAPI extension of `x-amazon-apigateway-documentation`.
+    #   a Swagger extension of `x-amazon-apigateway-documentation`.
     #   @return [String]
     #
     class DocumentationPart < Struct.new(
@@ -2173,19 +2134,16 @@ module Aws::APIGateway
     #
     # <div class="remarks">
     # This is used to return the result when documentation parts in an
-    # external (e.g., OpenAPI) file are imported into API Gateway
+    # external (e.g., Swagger) file are imported into API Gateway
     # </div>
     #
     # <div class="seeAlso">
-    # [Documenting an API][1], [documentationpart:import][2],
+    # [Documenting an
+    # API]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/api-gateway-documenting-api.html),
+    # [documentationpart:import]([[AwsDocsUrlPrefix]]/apigateway/api-reference/link-relation/documentationpart-import/),
     # DocumentationPart
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-documenting-api.html
-    # [2]: https://docs.aws.amazon.com/apigateway/api-reference/link-relation/documentationpart-import/
-    #
     # @!attribute [rw] ids
     #   A list of the returned documentation part identifiers.
     #   @return [Array<String>]
@@ -2278,13 +2236,11 @@ module Aws::APIGateway
     # <div class="remarks"></div>
     #
     # <div class="seeAlso">
-    # [Documenting an API][1], DocumentationPart
+    # [Documenting an
+    # API]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/api-gateway-documenting-api.html),
+    # DocumentationPart
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-documenting-api.html
-    #
     # @!attribute [rw] position
     #   @return [String]
     #
@@ -2303,18 +2259,16 @@ module Aws::APIGateway
     # <div class="remarks" markdown="1">
     # Publishing API documentation involves creating a documentation version
     # associated with an API stage and exporting the versioned documentation
-    # to an external (e.g., OpenAPI) file.
+    # to an external (e.g., Swagger) file.
     #
     # </div>
     #
     # <div class="seeAlso">
-    # [Documenting an API][1], DocumentationPart, DocumentationVersions
+    # [Documenting an
+    # API]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/api-gateway-documenting-api.html),
+    # DocumentationPart, DocumentationVersions
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-documenting-api.html
-    #
     # @!attribute [rw] version
     #   The version identifier of the API documentation snapshot.
     #   @return [String]
@@ -2343,13 +2297,11 @@ module Aws::APIGateway
     # </div>
     #
     # <div class="seeAlso">
-    # [Documenting an API][1], DocumentationPart, DocumentationVersion
+    # [Documenting an
+    # API]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/api-gateway-documenting-api.html),
+    # DocumentationPart, DocumentationVersion
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-documenting-api.html
-    #
     # @!attribute [rw] position
     #   @return [String]
     #
@@ -2381,13 +2333,10 @@ module Aws::APIGateway
     # </div>
     #
     # <div class="seeAlso">
-    # [Set a Custom Host Name for an API][1]
+    # [Set a Custom Host Name for an
+    # API]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/how-to-custom-domains.html)
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-custom-domains.html
-    #
     # @!attribute [rw] domain_name
     #   The custom domain name as an API host name, for example,
     #   `my-api.example.com`.
@@ -2420,12 +2369,9 @@ module Aws::APIGateway
     # @!attribute [rw] regional_hosted_zone_id
     #   The region-specific Amazon Route 53 Hosted Zone ID of the regional
     #   endpoint. For more information, see [Set up a Regional Custom Domain
-    #   Name][1] and [AWS Regions and Endpoints for API Gateway][2].
-    #
-    #
-    #
-    #   [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-regional-api-custom-domain-create.html
-    #   [2]: https://docs.aws.amazon.com/general/latest/gr/rande.html#apigateway_region
+    #   Name]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/apigateway-regional-api-custom-domain-create.html)
+    #   and [AWS Regions and Endpoints for API
+    #   Gateway]([[AwsDocsUrlPrefix]]/general/latest/gr/rande.html#apigateway_region).
     #   @return [String]
     #
     # @!attribute [rw] regional_certificate_name
@@ -2445,23 +2391,17 @@ module Aws::APIGateway
     #   up this association when adding a DNS record pointing the custom
     #   domain name to this distribution name. For more information about
     #   CloudFront distributions, see the [Amazon CloudFront
-    #   documentation][1].
-    #
-    #
-    #
-    #   [1]: https://aws.amazon.com/documentation/cloudfront/
+    #   documentation]([[AwsAmazonUrlPrefix]]/documentation/cloudfront/).
     #   @return [String]
     #
     # @!attribute [rw] distribution_hosted_zone_id
     #   The region-agnostic Amazon Route 53 Hosted Zone ID of the
     #   edge-optimized endpoint. The valid value is `Z2FDTNDATAQYW2` for all
     #   the regions. For more information, see [Set up a Regional Custom
-    #   Domain Name][1] and [AWS Regions and Endpoints for API Gateway][2].
-    #
-    #
-    #
-    #   [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-regional-api-custom-domain-create.html
-    #   [2]: https://docs.aws.amazon.com/general/latest/gr/rande.html#apigateway_region
+    #   Domain
+    #   Name]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/apigateway-regional-api-custom-domain-create.html)
+    #   and [AWS Regions and Endpoints for API
+    #   Gateway]([[AwsDocsUrlPrefix]]/general/latest/gr/rande.html#apigateway_region).
     #   @return [String]
     #
     # @!attribute [rw] endpoint_configuration
@@ -2487,13 +2427,10 @@ module Aws::APIGateway
     # Represents a collection of DomainName resources.
     #
     # <div class="seeAlso">
-    # [Use Client-Side Certificate][1]
+    # [Use Client-Side
+    # Certificate]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/how-to-custom-domains.html)
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-custom-domains.html
-    #
     # @!attribute [rw] position
     #   @return [String]
     #
@@ -2606,7 +2543,8 @@ module Aws::APIGateway
     #
     # <div class="remarks">
     # For more information about valid gateway response types, see [Gateway
-    # Response Types Supported by API Gateway][1]
+    # Response Types Supported by API
+    # Gateway]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/supported-gateway-response-types.html)
     # <div class="example" markdown="1">
     # #### Example: Get a Gateway Response of a given response type
     #
@@ -2632,14 +2570,10 @@ module Aws::APIGateway
     # </div>
     #
     # <div class="seeAlso">
-    # [Customize Gateway Responses][2]
+    # [Customize Gateway
+    # Responses]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/customize-gateway-responses.html)
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/supported-gateway-response-types.html
-    # [2]: https://docs.aws.amazon.com/apigateway/latest/developerguide/customize-gateway-responses.html
-    #
     # @!attribute [rw] response_type
     #   The response type of the associated GatewayResponse. Valid values
     #   are * ACCESS\_DENIED
@@ -2700,7 +2634,8 @@ module Aws::APIGateway
     #
     # <div class="remarks">
     # For more information about valid gateway response types, see [Gateway
-    # Response Types Supported by API Gateway][1]
+    # Response Types Supported by API
+    # Gateway]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/supported-gateway-response-types.html)
     # <div class="example" markdown="1">
     # #### Example: Get the collection of gateway responses of an API
     #
@@ -2726,14 +2661,10 @@ module Aws::APIGateway
     # </div>
     #
     # <div class="seeAlso">
-    # [Customize Gateway Responses][2]
+    # [Customize Gateway
+    # Responses]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/customize-gateway-responses.html)
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/supported-gateway-response-types.html
-    # [2]: https://docs.aws.amazon.com/apigateway/latest/developerguide/customize-gateway-responses.html
-    #
     # @!attribute [rw] position
     #   @return [String]
     #
@@ -3283,15 +3214,15 @@ module Aws::APIGateway
     #   @return [String]
     #
     # @!attribute [rw] export_type
-    #   \[Required\] The type of export. Acceptable values are 'oas30' for
-    #   OpenAPI 3.0.x and 'swagger' for Swagger/OpenAPI 2.0.
+    #   \[Required\] The type of export. Currently only 'swagger' is
+    #   supported.
     #   @return [String]
     #
     # @!attribute [rw] parameters
     #   A key-value map of query string parameters that specify properties
     #   of the export, depending on the requested `exportType`. For
-    #   `exportType` `oas30` and `swagger`, any combination of the following
-    #   parameters are supported: `extensions='integrations'` or
+    #   `exportType` `swagger`, any combination of the following parameters
+    #   are supported: `extensions='integrations'` or
     #   `extensions='apigateway'` will export the API with
     #   x-amazon-apigateway-integration extensions.
     #   `extensions='authorizers'` will export the API with
@@ -3302,8 +3233,8 @@ module Aws::APIGateway
     # @!attribute [rw] accepts
     #   The content-type of the export, for example `application/json`.
     #   Currently `application/json` and `application/yaml` are supported
-    #   for `exportType` of`oas30` and `swagger`. This should be specified
-    #   in the `Accept` header for direct API requests.
+    #   for `exportType` of `swagger`. This should be specified in the
+    #   `Accept` header for direct API requests.
     #   @return [String]
     #
     class GetExportRequest < Struct.new(
@@ -4203,11 +4134,8 @@ module Aws::APIGateway
     #
     # @!attribute [rw] body
     #   The payload of the POST request to import API keys. For the payload
-    #   format, see [API Key File Format][1].
-    #
-    #
-    #
-    #   [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/api-key-file-format.html
+    #   format, see [API Key File
+    #   Format]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/api-key-file-format.html).
     #   @return [String]
     #
     # @!attribute [rw] format
@@ -4227,7 +4155,7 @@ module Aws::APIGateway
       include Aws::Structure
     end
 
-    # Import documentation parts from an external (e.g., OpenAPI) definition
+    # Import documentation parts from an external (e.g., Swagger) definition
     # file.
     #
     # @note When making an API call, you may pass ImportDocumentationPartsRequest
@@ -4258,7 +4186,7 @@ module Aws::APIGateway
     #
     # @!attribute [rw] body
     #   \[Required\] Raw byte array representing the to-be-imported
-    #   documentation parts. To import from an OpenAPI file, this is a JSON
+    #   documentation parts. To import from a Swagger file, this is a JSON
     #   object.
     #   @return [String]
     #
@@ -4321,7 +4249,7 @@ module Aws::APIGateway
     #
     # @!attribute [rw] body
     #   \[Required\] The POST request body containing external API
-    #   definitions. Currently, only OpenAPI definition JSON/YAML files are
+    #   definitions. Currently, only Swagger definition JSON files are
     #   supported. The maximum size of the API definition file is 2MB.
     #   @return [String]
     #
@@ -4340,13 +4268,10 @@ module Aws::APIGateway
     # </div>
     #
     # <div class="seeAlso">
-    # [Creating an API][1]
+    # [Creating an
+    # API]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/how-to-create-api.html)
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-create-api.html
-    #
     # @!attribute [rw] type
     #   Specifies an API method integration type. The valid value is one of
     #   the following:
@@ -4388,10 +4313,10 @@ module Aws::APIGateway
     #
     #   * For `HTTP` or `HTTP_PROXY` integrations, the URI must be a fully
     #     formed, encoded HTTP(S) URL according to the [RFC-3986
-    #     specification][1], for either standard integration, where
-    #     `connectionType` is not `VPC_LINK`, or private integration, where
-    #     `connectionType` is `VPC_LINK`. For a private HTTP integration,
-    #     the URI is not used for routing.
+    #     specification]([[UriEntryWikipediaUrl]]), for either standard
+    #     integration, where `connectionType` is not `VPC_LINK`, or private
+    #     integration, where `connectionType` is `VPC_LINK`. For a private
+    #     HTTP integration, the URI is not used for routing.
     #
     #   * For `AWS` or `AWS_PROXY` integrations, the URI is of the form
     #     `arn:aws:apigateway:\{region\}:\{subdomain.service|service\}:path|action/\{service_api\}`.
@@ -4410,10 +4335,6 @@ module Aws::APIGateway
     #     either
     #     `arn:aws:apigateway:us-west-2:s3:action/GetObject&Bucket=\{bucket\}&Key=\{key\}`
     #     or `arn:aws:apigateway:us-west-2:s3:path/\{bucket\}/\{key\}`
-    #
-    #
-    #
-    #   [1]: https://en.wikipedia.org/wiki/Uniform_Resource_Identifier
     #   @return [String]
     #
     # @!attribute [rw] connection_type
@@ -4425,12 +4346,10 @@ module Aws::APIGateway
     #   @return [String]
     #
     # @!attribute [rw] connection_id
-    #   The ([`id`][1]) of the VpcLink used for the integration when
+    #   The
+    #   ([`id`]([[AwsDocsUrlPrefix]]/apigateway/api-reference/resource/vpc-link/#id))
+    #   of the VpcLink used for the integration when
     #   `connectionType=VPC_LINK` and undefined, otherwise.
-    #
-    #
-    #
-    #   [1]: https://docs.aws.amazon.com/apigateway/api-reference/resource/vpc-link/#id
     #   @return [String]
     #
     # @!attribute [rw] credentials
@@ -4539,19 +4458,16 @@ module Aws::APIGateway
     #   The successful response returns `200 OK` status and a payload as
     #   follows:
     #
-    #       \{ "_links": \{ "curies": \{ "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-integration-response-\{rel\}.html", "name": "integrationresponse", "templated": true \}, "self": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200", "title": "200" \}, "integrationresponse:delete": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200" \}, "integrationresponse:update": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200" \} \}, "responseParameters": \{ "method.response.header.Content-Type": "'application/xml'" \}, "responseTemplates": \{ "application/json": "$util.urlDecode("%3CkinesisStreams%3E#foreach($stream in $input.path('$.StreamNames'))%3Cstream%3E%3Cname%3E$stream%3C/name%3E%3C/stream%3E#end%3C/kinesisStreams%3E")\n" \}, "statusCode": "200" \}
+    #       \{ "_links": \{ "curies": \{ "href": "[[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/restapi-integration-response-\{rel\}.html", "name": "integrationresponse", "templated": true \}, "self": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200", "title": "200" \}, "integrationresponse:delete": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200" \}, "integrationresponse:update": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200" \} \}, "responseParameters": \{ "method.response.header.Content-Type": "'application/xml'" \}, "responseTemplates": \{ "application/json": "$util.urlDecode("%3CkinesisStreams%3E#foreach($stream in $input.path('$.StreamNames'))%3Cstream%3E%3Cname%3E$stream%3C/name%3E%3C/stream%3E#end%3C/kinesisStreams%3E")\n" \}, "statusCode": "200" \}
     #
     #
     #
     #   </div>
     #
     #   <div class="seeAlso">
-    #   [Creating an API][1]
+    #   [Creating an
+    #   API]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/how-to-create-api.html)
     #   </div>
-    #
-    #
-    #
-    #   [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-create-api.html
     #   @return [Hash<String,Types::IntegrationResponse>]
     #
     class Integration < Struct.new(
@@ -4577,13 +4493,10 @@ module Aws::APIGateway
     # transform the back-end response.
     #
     # <div class="seeAlso">
-    # [Creating an API][1]
+    # [Creating an
+    # API]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/how-to-create-api.html)
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-create-api.html
-    #
     # @!attribute [rw] status_code
     #   Specifies the status code that is used to map the integration
     #   response to an existing MethodResponse.
@@ -4676,27 +4589,24 @@ module Aws::APIGateway
     # The successful response returns a `200 OK` status code and a payload
     # similar to the following:
     #
-    #     \{ "_links": \{ "curies": [ \{ "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-integration-\{rel\}.html", "name": "integration", "templated": true \}, \{ "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-integration-response-\{rel\}.html", "name": "integrationresponse", "templated": true \}, \{ "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-method-\{rel\}.html", "name": "method", "templated": true \}, \{ "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-method-response-\{rel\}.html", "name": "methodresponse", "templated": true \} ], "self": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET", "name": "GET", "title": "GET" \}, "integration:put": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" \}, "method:delete": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET" \}, "method:integration": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" \}, "method:responses": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200", "name": "200", "title": "200" \}, "method:update": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET" \}, "methodresponse:put": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/\{status_code\}", "templated": true \} \}, "apiKeyRequired": true, "authorizationType": "NONE", "httpMethod": "GET", "_embedded": \{ "method:integration": \{ "_links": \{ "self": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" \}, "integration:delete": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" \}, "integration:responses": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200", "name": "200", "title": "200" \}, "integration:update": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" \}, "integrationresponse:put": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/\{status_code\}", "templated": true \} \}, "cacheKeyParameters": [], "cacheNamespace": "3kzxbg5sa2", "credentials": "arn:aws:iam::123456789012:role/apigAwsProxyRole", "httpMethod": "POST", "passthroughBehavior": "WHEN_NO_MATCH", "requestParameters": \{ "integration.request.header.Content-Type": "'application/x-amz-json-1.1'" \}, "requestTemplates": \{ "application/json": "\{\n\}" \}, "type": "AWS", "uri": "arn:aws:apigateway:us-east-1:kinesis:action/ListStreams", "_embedded": \{ "integration:responses": \{ "_links": \{ "self": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200", "name": "200", "title": "200" \}, "integrationresponse:delete": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200" \}, "integrationresponse:update": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200" \} \}, "responseParameters": \{ "method.response.header.Content-Type": "'application/xml'" \}, "responseTemplates": \{ "application/json": "$util.urlDecode("%3CkinesisStreams%3E%23foreach(%24stream%20in%20%24input.path(%27%24.StreamNames%27))%3Cstream%3E%3Cname%3E%24stream%3C%2Fname%3E%3C%2Fstream%3E%23end%3C%2FkinesisStreams%3E")" \}, "statusCode": "200" \} \} \}, "method:responses": \{ "_links": \{ "self": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200", "name": "200", "title": "200" \}, "methodresponse:delete": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200" \}, "methodresponse:update": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200" \} \}, "responseModels": \{ "application/json": "Empty" \}, "responseParameters": \{ "method.response.header.Content-Type": false \}, "statusCode": "200" \} \} \}
+    #     \{ "_links": \{ "curies": [ \{ "href": "[[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/restapi-integration-\{rel\}.html", "name": "integration", "templated": true \}, \{ "href": "[[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/restapi-integration-response-\{rel\}.html", "name": "integrationresponse", "templated": true \}, \{ "href": "[[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/restapi-method-\{rel\}.html", "name": "method", "templated": true \}, \{ "href": "[[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/restapi-method-response-\{rel\}.html", "name": "methodresponse", "templated": true \} ], "self": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET", "name": "GET", "title": "GET" \}, "integration:put": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" \}, "method:delete": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET" \}, "method:integration": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" \}, "method:responses": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200", "name": "200", "title": "200" \}, "method:update": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET" \}, "methodresponse:put": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/\{status_code\}", "templated": true \} \}, "apiKeyRequired": true, "authorizationType": "NONE", "httpMethod": "GET", "_embedded": \{ "method:integration": \{ "_links": \{ "self": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" \}, "integration:delete": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" \}, "integration:responses": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200", "name": "200", "title": "200" \}, "integration:update": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" \}, "integrationresponse:put": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/\{status_code\}", "templated": true \} \}, "cacheKeyParameters": [], "cacheNamespace": "3kzxbg5sa2", "credentials": "arn:aws:iam::123456789012:role/apigAwsProxyRole", "httpMethod": "POST", "passthroughBehavior": "WHEN_NO_MATCH", "requestParameters": \{ "integration.request.header.Content-Type": "'application/x-amz-json-1.1'" \}, "requestTemplates": \{ "application/json": "\{\n\}" \}, "type": "AWS", "uri": "arn:aws:apigateway:us-east-1:kinesis:action/ListStreams", "_embedded": \{ "integration:responses": \{ "_links": \{ "self": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200", "name": "200", "title": "200" \}, "integrationresponse:delete": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200" \}, "integrationresponse:update": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200" \} \}, "responseParameters": \{ "method.response.header.Content-Type": "'application/xml'" \}, "responseTemplates": \{ "application/json": "$util.urlDecode("%3CkinesisStreams%3E%23foreach(%24stream%20in%20%24input.path(%27%24.StreamNames%27))%3Cstream%3E%3Cname%3E%24stream%3C%2Fname%3E%3C%2Fstream%3E%23end%3C%2FkinesisStreams%3E")" \}, "statusCode": "200" \} \} \}, "method:responses": \{ "_links": \{ "self": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200", "name": "200", "title": "200" \}, "methodresponse:delete": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200" \}, "methodresponse:update": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200" \} \}, "responseModels": \{ "application/json": "Empty" \}, "responseParameters": \{ "method.response.header.Content-Type": false \}, "statusCode": "200" \} \} \}
     #
     # In the example above, the response template for the `200 OK` response
     # maps the JSON output from the `ListStreams` action in the back end to
     # an XML output. The mapping template is URL-encoded as
     # `%3CkinesisStreams%3E%23foreach(%24stream%20in%20%24input.path(%27%24.StreamNames%27))%3Cstream%3E%3Cname%3E%24stream%3C%2Fname%3E%3C%2Fstream%3E%23end%3C%2FkinesisStreams%3E`
-    # and the output is decoded using the [$util.urlDecode()][1] helper
-    # function.
+    # and the output is decoded using the
+    # [$util.urlDecode()]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/api-gateway-mapping-template-reference.html#util-templat-reference)
+    # helper function.
     #
     # </div>
     #
     # <div class="seeAlso">
     # MethodResponse, Integration, IntegrationResponse, Resource, [Set up an
-    # API's method][2]
+    # API's
+    # method]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/how-to-method-settings.html)
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-mapping-template-reference.html#util-templat-reference
-    # [2]: https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-method-settings.html
-    #
     # @!attribute [rw] http_method
     #   The method's HTTP verb.
     #   @return [String]
@@ -4725,11 +4635,7 @@ module Aws::APIGateway
     # @!attribute [rw] operation_name
     #   A human-friendly operation identifier for the method. For example,
     #   you can assign the `operationName` of `ListPets` for the `GET /pets`
-    #   method in [PetStore][1] example.
-    #
-    #
-    #
-    #   [1]: https://petstore-demo-endpoint.execute-api.com/petstore/pets
+    #   method in [PetStore]([[PetstoreDemoUrl]]) example.
     #   @return [String]
     #
     # @!attribute [rw] request_parameters
@@ -4773,19 +4679,16 @@ module Aws::APIGateway
     #   The successful response returns a `200 OK` status code and a payload
     #   similar to the following:
     #
-    #       \{ "_links": \{ "curies": \{ "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-method-response-\{rel\}.html", "name": "methodresponse", "templated": true \}, "self": \{ "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/responses/200", "title": "200" \}, "methodresponse:delete": \{ "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/responses/200" \}, "methodresponse:update": \{ "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/responses/200" \} \}, "responseModels": \{ "application/json": "Empty" \}, "responseParameters": \{ "method.response.header.operator": false, "method.response.header.operand_2": false, "method.response.header.operand_1": false \}, "statusCode": "200" \}
+    #       \{ "_links": \{ "curies": \{ "href": "[[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/restapi-method-response-\{rel\}.html", "name": "methodresponse", "templated": true \}, "self": \{ "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/responses/200", "title": "200" \}, "methodresponse:delete": \{ "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/responses/200" \}, "methodresponse:update": \{ "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/responses/200" \} \}, "responseModels": \{ "application/json": "Empty" \}, "responseParameters": \{ "method.response.header.operator": false, "method.response.header.operand_2": false, "method.response.header.operand_1": false \}, "statusCode": "200" \}
     #
     #
     #
     #   </div>
     #
     #   <div class="seeAlso">
-    #   [AWS CLI][1]
+    #   [AWS
+    #   CLI]([[AwsDocsUrlPrefix]]/cli/latest/reference/apigateway/get-method-response.html)
     #   </div>
-    #
-    #
-    #
-    #   [1]: https://docs.aws.amazon.com/cli/latest/reference/apigateway/get-method-response.html
     #   @return [Hash<String,Types::MethodResponse>]
     #
     # @!attribute [rw] method_integration
@@ -4809,19 +4712,16 @@ module Aws::APIGateway
     #   The successful response returns a `200 OK` status code and a payload
     #   similar to the following:
     #
-    #       \{ "_links": \{ "curies": [ \{ "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-integration-\{rel\}.html", "name": "integration", "templated": true \}, \{ "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-integration-response-\{rel\}.html", "name": "integrationresponse", "templated": true \} ], "self": \{ "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration" \}, "integration:delete": \{ "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration" \}, "integration:responses": \{ "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration/responses/200", "name": "200", "title": "200" \}, "integration:update": \{ "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration" \}, "integrationresponse:put": \{ "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration/responses/\{status_code\}", "templated": true \} \}, "cacheKeyParameters": [], "cacheNamespace": "0cjtch", "credentials": "arn:aws:iam::123456789012:role/apigAwsProxyRole", "httpMethod": "POST", "passthroughBehavior": "WHEN_NO_MATCH", "requestTemplates": \{ "application/json": "\{\n "a": "$input.params('operand1')",\n "b": "$input.params('operand2')", \n "op": "$input.params('operator')" \n\}" \}, "type": "AWS", "uri": "arn:aws:apigateway:us-west-2:lambda:path//2015-03-31/functions/arn:aws:lambda:us-west-2:123456789012:function:Calc/invocations", "_embedded": \{ "integration:responses": \{ "_links": \{ "self": \{ "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration/responses/200", "name": "200", "title": "200" \}, "integrationresponse:delete": \{ "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration/responses/200" \}, "integrationresponse:update": \{ "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration/responses/200" \} \}, "responseParameters": \{ "method.response.header.operator": "integration.response.body.op", "method.response.header.operand_2": "integration.response.body.b", "method.response.header.operand_1": "integration.response.body.a" \}, "responseTemplates": \{ "application/json": "#set($res = $input.path('$'))\n\{\n "result": "$res.a, $res.b, $res.op => $res.c",\n "a" : "$res.a",\n "b" : "$res.b",\n "op" : "$res.op",\n "c" : "$res.c"\n\}" \}, "selectionPattern": "", "statusCode": "200" \} \} \}
+    #       \{ "_links": \{ "curies": [ \{ "href": "[[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/restapi-integration-\{rel\}.html", "name": "integration", "templated": true \}, \{ "href": "[[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/restapi-integration-response-\{rel\}.html", "name": "integrationresponse", "templated": true \} ], "self": \{ "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration" \}, "integration:delete": \{ "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration" \}, "integration:responses": \{ "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration/responses/200", "name": "200", "title": "200" \}, "integration:update": \{ "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration" \}, "integrationresponse:put": \{ "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration/responses/\{status_code\}", "templated": true \} \}, "cacheKeyParameters": [], "cacheNamespace": "0cjtch", "credentials": "arn:aws:iam::123456789012:role/apigAwsProxyRole", "httpMethod": "POST", "passthroughBehavior": "WHEN_NO_MATCH", "requestTemplates": \{ "application/json": "\{\n "a": "$input.params('operand1')",\n "b": "$input.params('operand2')", \n "op": "$input.params('operator')" \n\}" \}, "type": "AWS", "uri": "arn:aws:apigateway:us-west-2:lambda:path//2015-03-31/functions/arn:aws:lambda:us-west-2:123456789012:function:Calc/invocations", "_embedded": \{ "integration:responses": \{ "_links": \{ "self": \{ "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration/responses/200", "name": "200", "title": "200" \}, "integrationresponse:delete": \{ "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration/responses/200" \}, "integrationresponse:update": \{ "href": "/restapis/uojnr9hd57/resources/0cjtch/methods/GET/integration/responses/200" \} \}, "responseParameters": \{ "method.response.header.operator": "integration.response.body.op", "method.response.header.operand_2": "integration.response.body.b", "method.response.header.operand_1": "integration.response.body.a" \}, "responseTemplates": \{ "application/json": "#set($res = $input.path('$'))\n\{\n "result": "$res.a, $res.b, $res.op => $res.c",\n "a" : "$res.a",\n "b" : "$res.b",\n "op" : "$res.op",\n "c" : "$res.c"\n\}" \}, "selectionPattern": "", "statusCode": "200" \} \} \}
     #
     #
     #
     #   </div>
     #
     #   <div class="seeAlso">
-    #   [AWS CLI][1]
+    #   [AWS
+    #   CLI]([[AwsDocsUrlPrefix]]/cli/latest/reference/apigateway/get-integration.html)
     #   </div>
-    #
-    #
-    #
-    #   [1]: https://docs.aws.amazon.com/cli/latest/reference/apigateway/get-integration.html
     #   @return [Types::Integration]
     #
     # @!attribute [rw] authorization_scopes
@@ -4873,20 +4773,17 @@ module Aws::APIGateway
     # The successful response returns `200 OK` status and a payload as
     # follows:
     #
-    #     \{ "_links": \{ "curies": \{ "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-method-response-\{rel\}.html", "name": "methodresponse", "templated": true \}, "self": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200", "title": "200" \}, "methodresponse:delete": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200" \}, "methodresponse:update": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200" \} \}, "responseModels": \{ "application/json": "Empty" \}, "responseParameters": \{ "method.response.header.Content-Type": false \}, "statusCode": "200" \}
+    #     \{ "_links": \{ "curies": \{ "href": "[[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/restapi-method-response-\{rel\}.html", "name": "methodresponse", "templated": true \}, "self": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200", "title": "200" \}, "methodresponse:delete": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200" \}, "methodresponse:update": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200" \} \}, "responseModels": \{ "application/json": "Empty" \}, "responseParameters": \{ "method.response.header.Content-Type": false \}, "statusCode": "200" \}
     #
     #
     #
     # </div>
     #
     # <div class="seeAlso">
-    # Method, IntegrationResponse, Integration [Creating an API][1]
+    # Method, IntegrationResponse, Integration [Creating an
+    # API]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/how-to-create-api.html)
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-create-api.html
-    #
     # @!attribute [rw] status_code
     #   The method response's status code.
     #   @return [String]
@@ -5046,13 +4943,10 @@ module Aws::APIGateway
     # </div>
     #
     # <div class="seeAlso">
-    # Method, MethodResponse, [Models and Mappings][1]
+    # Method, MethodResponse, [Models and
+    # Mappings]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/models-mappings.html)
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/models-mappings.html
-    #
     # @!attribute [rw] id
     #   The identifier for the model resource.
     #   @return [String]
@@ -5067,15 +4961,12 @@ module Aws::APIGateway
     #
     # @!attribute [rw] schema
     #   The schema for the model. For `application/json` models, this should
-    #   be [JSON schema draft 4][1] model. Do not include "\\*/"
-    #   characters in the description of any properties because such
-    #   "\\*/" characters may be interpreted as the closing marker for
-    #   comments in some languages, such as Java or JavaScript, causing the
-    #   installation of your API's SDK generated by API Gateway to fail.
-    #
-    #
-    #
-    #   [1]: https://tools.ietf.org/html/draft-zyp-json-schema-04
+    #   be [JSON schema draft 4]([[JsonSchemaUrl]]) model. Do not include
+    #   "\\*/" characters in the description of any properties because
+    #   such "\\*/" characters may be interpreted as the closing marker
+    #   for comments in some languages, such as Java or JavaScript, causing
+    #   the installation of your API's SDK generated by API Gateway to
+    #   fail.
     #   @return [String]
     #
     # @!attribute [rw] content_type
@@ -5094,13 +4985,10 @@ module Aws::APIGateway
     # Represents a collection of Model resources.
     #
     # <div class="seeAlso">
-    # Method, MethodResponse, [Models and Mappings][1]
+    # Method, MethodResponse, [Models and
+    # Mappings]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/models-mappings.html)
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/models-mappings.html
-    #
     # @!attribute [rw] position
     #   @return [String]
     #
@@ -5138,20 +5026,16 @@ module Aws::APIGateway
     #   @return [String]
     #
     # @!attribute [rw] path
-    #   The `op` operation's target, as identified by a [JSON Pointer][1]
-    #   value that references a location within the targeted resource. For
-    #   example, if the target resource has an updateable property of
-    #   `\{"name":"value"\}`, the path for this property is `/name`. If the
-    #   `name` property value is a JSON object (e.g., `\{"name":
-    #   \{"child/name": "child-value"\}\}`), the path for the `child/name`
-    #   property will be `/name/child~1name`. Any slash ("/") character
-    #   appearing in path names must be escaped with "~1", as shown in the
-    #   example above. Each `op` operation can have only one `path`
-    #   associated with it.
-    #
-    #
-    #
-    #   [1]: https://tools.ietf.org/html/draft-ietf-appsawg-json-pointer-08
+    #   The `op` operation's target, as identified by a [JSON
+    #   Pointer]([[JsonPointerRefUrl]]) value that references a location
+    #   within the targeted resource. For example, if the target resource
+    #   has an updateable property of `\{"name":"value"\}`, the path for
+    #   this property is `/name`. If the `name` property value is a JSON
+    #   object (e.g., `\{"name": \{"child/name": "child-value"\}\}`), the
+    #   path for the `child/name` property will be `/name/child~1name`. Any
+    #   slash ("/") character appearing in path names must be escaped with
+    #   "~1", as shown in the example above. Each `op` operation can have
+    #   only one `path` associated with it.
     #   @return [String]
     #
     # @!attribute [rw] value
@@ -5159,11 +5043,8 @@ module Aws::APIGateway
     #   the `add` or `replace` operation. When using AWS CLI to update a
     #   property of a JSON value, enclose the JSON object with a pair of
     #   single quotes in a Linux shell, e.g., '\\\{"a": ...\\}'. In a
-    #   Windows shell, see [Using JSON for Parameters][1].
-    #
-    #
-    #
-    #   [1]: https://docs.aws.amazon.com/cli/latest/userguide/cli-using-param.html#cli-using-param-json
+    #   Windows shell, see [Using JSON for
+    #   Parameters]([[AwsDocsUrlPrefix]]/cli/latest/userguide/cli-using-param.html#cli-using-param-json).
     #   @return [String]
     #
     # @!attribute [rw] from
@@ -5309,10 +5190,10 @@ module Aws::APIGateway
     #
     #   * For `HTTP` or `HTTP_PROXY` integrations, the URI must be a fully
     #     formed, encoded HTTP(S) URL according to the [RFC-3986
-    #     specification][1], for either standard integration, where
-    #     `connectionType` is not `VPC_LINK`, or private integration, where
-    #     `connectionType` is `VPC_LINK`. For a private HTTP integration,
-    #     the URI is not used for routing.
+    #     specification]([[UriEntryWikipediaUrl]]), for either standard
+    #     integration, where `connectionType` is not `VPC_LINK`, or private
+    #     integration, where `connectionType` is `VPC_LINK`. For a private
+    #     HTTP integration, the URI is not used for routing.
     #
     #   * For `AWS` or `AWS_PROXY` integrations, the URI is of the form
     #     `arn:aws:apigateway:\{region\}:\{subdomain.service|service\}:path|action/\{service_api\}`.
@@ -5331,10 +5212,6 @@ module Aws::APIGateway
     #     either
     #     `arn:aws:apigateway:us-west-2:s3:action/GetObject&Bucket=\{bucket\}&Key=\{key\}`
     #     or `arn:aws:apigateway:us-west-2:s3:path/\{bucket\}/\{key\}`
-    #
-    #
-    #
-    #   [1]: https://en.wikipedia.org/wiki/Uniform_Resource_Identifier
     #   @return [String]
     #
     # @!attribute [rw] connection_type
@@ -5346,12 +5223,10 @@ module Aws::APIGateway
     #   @return [String]
     #
     # @!attribute [rw] connection_id
-    #   The ([`id`][1]) of the VpcLink used for the integration when
+    #   The
+    #   ([`id`]([[AwsDocsUrlPrefix]]/apigateway/api-reference/resource/vpc-link/#id))
+    #   of the VpcLink used for the integration when
     #   `connectionType=VPC_LINK` and undefined, otherwise.
-    #
-    #
-    #
-    #   [1]: https://docs.aws.amazon.com/apigateway/api-reference/resource/vpc-link/#id
     #   @return [String]
     #
     # @!attribute [rw] credentials
@@ -5592,11 +5467,7 @@ module Aws::APIGateway
     # @!attribute [rw] operation_name
     #   A human-friendly operation identifier for the method. For example,
     #   you can assign the `operationName` of `ListPets` for the `GET /pets`
-    #   method in [PetStore][1] example.
-    #
-    #
-    #
-    #   [1]: https://petstore-demo-endpoint.execute-api.com/petstore/pets
+    #   method in [PetStore]([[PetstoreDemoUrl]]) example.
     #   @return [String]
     #
     # @!attribute [rw] request_parameters
@@ -5761,7 +5632,7 @@ module Aws::APIGateway
     #
     # @!attribute [rw] body
     #   \[Required\] The PUT request body containing external API
-    #   definitions. Currently, only OpenAPI definition JSON/YAML files are
+    #   definitions. Currently, only Swagger definition JSON files are
     #   supported. The maximum size of the API definition file is 2MB.
     #   @return [String]
     #
@@ -5810,23 +5681,19 @@ module Aws::APIGateway
     # A set of validation rules for incoming Method requests.
     #
     # <div class="remarks" markdown="1">
-    # In OpenAPI, a RequestValidator of an API is defined by the
-    # [x-amazon-apigateway-request-validators.requestValidator][1] object.
-    # It the referenced using the [x-amazon-apigateway-request-validator][2]
+    # In Swagger, a RequestValidator of an API is defined by the
+    # [x-amazon-apigateway-request-validators.requestValidator]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/api-gateway-swagger-extensions.html#api-gateway-swagger-extensions-request-validators.requestValidator.html)
+    # object. It the referenced using the
+    # [x-amazon-apigateway-request-validator]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/api-gateway-swagger-extensions.html#api-gateway-swagger-extensions-request-validator)
     # property.
     #
     # </div>
     #
     # <div class="seeAlso">
-    # [Enable Basic Request Validation in API Gateway][3]
+    # [Enable Basic Request Validation in API
+    # Gateway]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/api-gateway-method-request-validation.html)
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-swagger-extensions.html#api-gateway-swagger-extensions-request-validators.requestValidator.html
-    # [2]: https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-swagger-extensions.html#api-gateway-swagger-extensions-request-validator
-    # [3]: https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-method-request-validation.html
-    #
     # @!attribute [rw] id
     #   The identifier of this RequestValidator.
     #   @return [String]
@@ -5856,20 +5723,17 @@ module Aws::APIGateway
     # A collection of RequestValidator resources of a given RestApi.
     #
     # <div class="remarks" markdown="1">
-    # In OpenAPI, the RequestValidators of an API is defined by the
-    # [x-amazon-apigateway-request-validators][1] extension.
+    # In Swagger, the RequestValidators of an API is defined by the
+    # [x-amazon-apigateway-request-validators]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/api-gateway-swagger-extensions.html#api-gateway-swagger-extensions-request-validators.html)
+    # extension.
     #
     # </div>
     #
     # <div class="seeAlso">
-    # [Enable Basic Request Validation in API Gateway][2]
+    # [Enable Basic Request Validation in API
+    # Gateway]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/api-gateway-method-request-validation.html)
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-swagger-extensions.html#api-gateway-swagger-extensions-request-validators.html
-    # [2]: https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-method-request-validation.html
-    #
     # @!attribute [rw] position
     #   @return [String]
     #
@@ -5886,13 +5750,10 @@ module Aws::APIGateway
     # Represents an API resource.
     #
     # <div class="seeAlso">
-    # [Create an API][1]
+    # [Create an
+    # API]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/how-to-create-api.html)
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-create-api.html
-    #
     # @!attribute [rw] id
     #   The resource's identifier.
     #   @return [String]
@@ -5928,7 +5789,7 @@ module Aws::APIGateway
     #
     #   ##### Response
     #
-    #       \{ "_links": \{ "curies": [ \{ "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-integration-\{rel\}.html", "name": "integration", "templated": true \}, \{ "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-integration-response-\{rel\}.html", "name": "integrationresponse", "templated": true \}, \{ "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-method-\{rel\}.html", "name": "method", "templated": true \}, \{ "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-method-response-\{rel\}.html", "name": "methodresponse", "templated": true \} ], "self": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET", "name": "GET", "title": "GET" \}, "integration:put": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" \}, "method:delete": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET" \}, "method:integration": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" \}, "method:responses": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200", "name": "200", "title": "200" \}, "method:update": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET" \}, "methodresponse:put": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/\{status_code\}", "templated": true \} \}, "apiKeyRequired": false, "authorizationType": "NONE", "httpMethod": "GET", "_embedded": \{ "method:integration": \{ "_links": \{ "self": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" \}, "integration:delete": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" \}, "integration:responses": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200", "name": "200", "title": "200" \}, "integration:update": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" \}, "integrationresponse:put": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/\{status_code\}", "templated": true \} \}, "cacheKeyParameters": [], "cacheNamespace": "3kzxbg5sa2", "credentials": "arn:aws:iam::123456789012:role/apigAwsProxyRole", "httpMethod": "POST", "passthroughBehavior": "WHEN_NO_MATCH", "requestParameters": \{ "integration.request.header.Content-Type": "'application/x-amz-json-1.1'" \}, "requestTemplates": \{ "application/json": "\{\n\}" \}, "type": "AWS", "uri": "arn:aws:apigateway:us-east-1:kinesis:action/ListStreams", "_embedded": \{ "integration:responses": \{ "_links": \{ "self": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200", "name": "200", "title": "200" \}, "integrationresponse:delete": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200" \}, "integrationresponse:update": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200" \} \}, "responseParameters": \{ "method.response.header.Content-Type": "'application/xml'" \}, "responseTemplates": \{ "application/json": "$util.urlDecode("%3CkinesisStreams%3E#foreach($stream in $input.path('$.StreamNames'))%3Cstream%3E%3Cname%3E$stream%3C/name%3E%3C/stream%3E#end%3C/kinesisStreams%3E")\n" \}, "statusCode": "200" \} \} \}, "method:responses": \{ "_links": \{ "self": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200", "name": "200", "title": "200" \}, "methodresponse:delete": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200" \}, "methodresponse:update": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200" \} \}, "responseModels": \{ "application/json": "Empty" \}, "responseParameters": \{ "method.response.header.Content-Type": false \}, "statusCode": "200" \} \} \}
+    #       \{ "_links": \{ "curies": [ \{ "href": "[[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/restapi-integration-\{rel\}.html", "name": "integration", "templated": true \}, \{ "href": "[[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/restapi-integration-response-\{rel\}.html", "name": "integrationresponse", "templated": true \}, \{ "href": "[[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/restapi-method-\{rel\}.html", "name": "method", "templated": true \}, \{ "href": "[[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/restapi-method-response-\{rel\}.html", "name": "methodresponse", "templated": true \} ], "self": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET", "name": "GET", "title": "GET" \}, "integration:put": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" \}, "method:delete": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET" \}, "method:integration": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" \}, "method:responses": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200", "name": "200", "title": "200" \}, "method:update": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET" \}, "methodresponse:put": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/\{status_code\}", "templated": true \} \}, "apiKeyRequired": false, "authorizationType": "NONE", "httpMethod": "GET", "_embedded": \{ "method:integration": \{ "_links": \{ "self": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" \}, "integration:delete": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" \}, "integration:responses": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200", "name": "200", "title": "200" \}, "integration:update": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration" \}, "integrationresponse:put": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/\{status_code\}", "templated": true \} \}, "cacheKeyParameters": [], "cacheNamespace": "3kzxbg5sa2", "credentials": "arn:aws:iam::123456789012:role/apigAwsProxyRole", "httpMethod": "POST", "passthroughBehavior": "WHEN_NO_MATCH", "requestParameters": \{ "integration.request.header.Content-Type": "'application/x-amz-json-1.1'" \}, "requestTemplates": \{ "application/json": "\{\n\}" \}, "type": "AWS", "uri": "arn:aws:apigateway:us-east-1:kinesis:action/ListStreams", "_embedded": \{ "integration:responses": \{ "_links": \{ "self": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200", "name": "200", "title": "200" \}, "integrationresponse:delete": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200" \}, "integrationresponse:update": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/integration/responses/200" \} \}, "responseParameters": \{ "method.response.header.Content-Type": "'application/xml'" \}, "responseTemplates": \{ "application/json": "$util.urlDecode("%3CkinesisStreams%3E#foreach($stream in $input.path('$.StreamNames'))%3Cstream%3E%3Cname%3E$stream%3C/name%3E%3C/stream%3E#end%3C/kinesisStreams%3E")\n" \}, "statusCode": "200" \} \} \}, "method:responses": \{ "_links": \{ "self": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200", "name": "200", "title": "200" \}, "methodresponse:delete": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200" \}, "methodresponse:update": \{ "href": "/restapis/fugvjdxtri/resources/3kzxbg5sa2/methods/GET/responses/200" \} \}, "responseModels": \{ "application/json": "Empty" \}, "responseParameters": \{ "method.response.header.Content-Type": false \}, "statusCode": "200" \} \} \}
     #
     #   If the `OPTIONS` is enabled on the resource, you can follow the
     #   example here to get that method. Just replace the `GET` of the last
@@ -5951,13 +5812,10 @@ module Aws::APIGateway
     # Represents a collection of Resource resources.
     #
     # <div class="seeAlso">
-    # [Create an API][1]
+    # [Create an
+    # API]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/how-to-create-api.html)
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-create-api.html
-    #
     # @!attribute [rw] position
     #   @return [String]
     #
@@ -5974,13 +5832,10 @@ module Aws::APIGateway
     # Represents a REST API.
     #
     # <div class="seeAlso">
-    # [Create an API][1]
+    # [Create an
+    # API]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/how-to-create-api.html)
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-create-api.html
-    #
     # @!attribute [rw] id
     #   The API's identifier. This identifier is unique across all of your
     #   APIs in API Gateway.
@@ -6059,13 +5914,10 @@ module Aws::APIGateway
     # your APIs.
     #
     # <div class="seeAlso">
-    # [Create an API][1]
+    # [Create an
+    # API]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/how-to-create-api.html)
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-create-api.html
-    #
     # @!attribute [rw] position
     #   @return [String]
     #
@@ -6179,13 +6031,10 @@ module Aws::APIGateway
     # that is callable by users.
     #
     # <div class="seeAlso">
-    # [Deploy an API][1]
+    # [Deploy an
+    # API]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/how-to-deploy-api.html)
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-deploy-api.html
-    #
     # @!attribute [rw] deployment_id
     #   The identifier of the Deployment that the stage points to.
     #   @return [String]
@@ -6308,13 +6157,10 @@ module Aws::APIGateway
     # resource.
     #
     # <div class="seeAlso">
-    # [Deploying API in Stages][1]
+    # [Deploying API in
+    # Stages]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/stages.html)
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/stages.html
-    #
     # @!attribute [rw] item
     #   The current page of elements from this collection.
     #   @return [Array<Types::Stage>]
@@ -6371,20 +6217,13 @@ module Aws::APIGateway
     # Represents a mapping template used to transform a payload.
     #
     # <div class="seeAlso">
-    # [Mapping Templates][1]
+    # [Mapping
+    # Templates]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/models-mappings.html#models-mappings-mappings)
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/models-mappings.html#models-mappings-mappings
-    #
     # @!attribute [rw] value
-    #   The Apache [Velocity Template Language (VTL)][1] template content
-    #   used for the template resource.
-    #
-    #
-    #
-    #   [1]: https://velocity.apache.org/engine/devel/vtl-reference-guide.html
+    #   The Apache [Velocity Template Language (VTL)]([[ApacheVtlUrl]])
+    #   template content used for the template resource.
     #   @return [String]
     #
     class Template < Struct.new(
@@ -6403,6 +6242,9 @@ module Aws::APIGateway
     #         headers: {
     #           "String" => "String",
     #         },
+    #         multi_value_headers: {
+    #           "String" => ["String"],
+    #         },
     #         path_with_query_string: "String",
     #         body: "String",
     #         stage_variables: {
@@ -6428,6 +6270,12 @@ module Aws::APIGateway
     #   or identity source, should be specified.
     #   @return [Hash<String,String>]
     #
+    # @!attribute [rw] multi_value_headers
+    #   \[Optional\] The headers as a map from string to list of values to
+    #   simulate an incoming invocation request. This is where the incoming
+    #   authorization token, or identity source, may be specified.
+    #   @return [Hash<String,Array<String>>]
+    #
     # @!attribute [rw] path_with_query_string
     #   \[Optional\] The URI path, including query string, of the simulated
     #   invocation request. Use this to specify path parameters and query
@@ -6452,6 +6300,7 @@ module Aws::APIGateway
       :rest_api_id,
       :authorizer_id,
       :headers,
+      :multi_value_headers,
       :path_with_query_string,
       :body,
       :stage_variables,
@@ -6487,12 +6336,9 @@ module Aws::APIGateway
     #   @return [Hash<String,Array<String>>]
     #
     # @!attribute [rw] claims
-    #   The [open identity claims][1], with any supported custom attributes,
-    #   returned from the Cognito Your User Pool configured for the API.
-    #
-    #
-    #
-    #   [1]: https://openid.net/specs/openid-connect-core-1_0.html#StandardClaims
+    #   The [open identity claims]([[OpenIdClaimsUrl]]), with any supported
+    #   custom attributes, returned from the Cognito Your User Pool
+    #   configured for the API.
     #   @return [Hash<String,String>]
     #
     class TestInvokeAuthorizerResponse < Struct.new(
@@ -6520,6 +6366,9 @@ module Aws::APIGateway
     #         headers: {
     #           "String" => "String",
     #         },
+    #         multi_value_headers: {
+    #           "String" => ["String"],
+    #         },
     #         client_certificate_id: "String",
     #         stage_variables: {
     #           "String" => "String",
@@ -6553,6 +6402,11 @@ module Aws::APIGateway
     #   request.
     #   @return [Hash<String,String>]
     #
+    # @!attribute [rw] multi_value_headers
+    #   The headers as a map from string to list of values to simulate an
+    #   incoming invocation request.
+    #   @return [Hash<String,Array<String>>]
+    #
     # @!attribute [rw] client_certificate_id
     #   A ClientCertificate identifier to use in the test invocation. API
     #   Gateway will use the certificate when making the HTTPS request to
@@ -6571,6 +6425,7 @@ module Aws::APIGateway
       :path_with_query_string,
       :body,
       :headers,
+      :multi_value_headers,
       :client_certificate_id,
       :stage_variables)
       include Aws::Structure
@@ -6579,13 +6434,10 @@ module Aws::APIGateway
     # Represents the response of the test invoke request in the HTTP method.
     #
     # <div class="seeAlso">
-    # [Test API using the API Gateway console][1]
+    # [Test API using the API Gateway
+    # console]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/how-to-test-method.html#how-to-test-method-console)
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-test-method.html#how-to-test-method-console
-    #
     # @!attribute [rw] status
     #   The HTTP status code.
     #   @return [Integer]
@@ -6598,6 +6450,11 @@ module Aws::APIGateway
     #   The headers of the HTTP response.
     #   @return [Hash<String,String>]
     #
+    # @!attribute [rw] multi_value_headers
+    #   The headers of the HTTP response as a map from string to list of
+    #   values.
+    #   @return [Hash<String,Array<String>>]
+    #
     # @!attribute [rw] log
     #   The API Gateway execution log for the test invoke request.
     #   @return [String]
@@ -6610,6 +6467,7 @@ module Aws::APIGateway
       :status,
       :body,
       :headers,
+      :multi_value_headers,
       :log,
       :latency)
       include Aws::Structure
@@ -7537,14 +7395,12 @@ module Aws::APIGateway
     # <div class="remarks"></div>
     #
     # <div class="seeAlso">
-    # [Create and Use Usage Plans][1], [Manage Usage in a Usage Plan][2]
+    # [Create and Use Usage
+    # Plans]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/api-gateway-api-usage-plans.html),
+    # [Manage Usage in a Usage
+    # Plan]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/api-gateway-create-usage-plans-with-console.html#api-gateway-usage-plan-manage-usage)
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-api-usage-plans.html
-    # [2]: https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-create-usage-plans-with-console.html#api-gateway-usage-plan-manage-usage
-    #
     # @!attribute [rw] usage_plan_id
     #   The plan Id associated with this usage data.
     #   @return [String]
@@ -7589,13 +7445,10 @@ module Aws::APIGateway
     # </div>
     #
     # <div class="seeAlso">
-    # [Create and Use Usage Plans][1]
+    # [Create and Use Usage
+    # Plans]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/api-gateway-api-usage-plans.html)
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-api-usage-plans.html
-    #
     # @!attribute [rw] id
     #   The identifier of a UsagePlan resource.
     #   @return [String]
@@ -7646,13 +7499,10 @@ module Aws::APIGateway
     # </div>
     #
     # " <div class="seeAlso">
-    # [Create and Use Usage Plans][1]
+    # [Create and Use Usage
+    # Plans]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/api-gateway-api-usage-plans.html)
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-api-usage-plans.html
-    #
     # @!attribute [rw] id
     #   The Id of a usage plan key.
     #   @return [String]
@@ -7682,13 +7532,10 @@ module Aws::APIGateway
     # the associated API keys and, possibly, other types of keys.
     #
     # <div class="seeAlso">
-    # [Create and Use Usage Plans][1]
+    # [Create and Use Usage
+    # Plans]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/api-gateway-api-usage-plans.html)
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-api-usage-plans.html
-    #
     # @!attribute [rw] position
     #   @return [String]
     #
@@ -7705,13 +7552,10 @@ module Aws::APIGateway
     # Represents a collection of usage plans for an AWS account.
     #
     # <div class="seeAlso">
-    # [Create and Use Usage Plans][1]
+    # [Create and Use Usage
+    # Plans]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/api-gateway-api-usage-plans.html)
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-api-usage-plans.html
-    #
     # @!attribute [rw] position
     #   @return [String]
     #
@@ -7782,15 +7626,12 @@ module Aws::APIGateway
     # The collection of VPC links under the caller's account in a region.
     #
     # <div class="seeAlso">
-    # [Getting Started with Private Integrations][1], [Set up Private
-    # Integrations][2]
+    # [Getting Started with Private
+    # Integrations]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/getting-started-with-private-integration.html),
+    # [Set up Private
+    # Integrations]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/set-up-private-integration.html)
     # </div>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/getting-started-with-private-integration.html
-    # [2]: https://docs.aws.amazon.com/apigateway/latest/developerguide/set-up-private-integration.html
-    #
     # @!attribute [rw] position
     #   @return [String]
     #