aws-sdk-apigateway 1.18.0 → 1.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 2139dd9efcf10ab11e862865329839e14b84fc0e
-  data.tar.gz: 26f79ab20bc12b2570086dfcadaea36c56829b0b
+  metadata.gz: 1f248ec3182eb61d9585277830aebc2dc1859bc9
+  data.tar.gz: 5f5b549f3cc87d95dac640ab0a6643e2c0030fc9
 SHA512:
-  metadata.gz: 8944a844a3b904156ff76b294dd2032020dd63b24d6cefee54af738bf7f2de3c2440bd241911fe57530e4372972b04644109af38ae54556453c68207d998b991
-  data.tar.gz: 90d327c485d68557dcc6edbb29c6245f53f04919b51584d14115e46a75d0b20316512f41bb83e4474b55d5047aa08c3e9b74c080ba451e8a36bc6ada32256af6
+  metadata.gz: 682713a6803a6c9457152e62a3338b56f383e0d0835b33d34614c4135266ae1872d47272052a750948971f57fd07bd046d63bcbcf0ec6e41023744738b06c590
+  data.tar.gz: c24e8108068213b7788736733f3a37ff19df978e47697d47e81e4b0abccaeecdd9b22e12b096c6c6145e89f3d112d3207488cd115e8f94d7bd64b00eb606d440

data/lib/aws-sdk-apigateway.rb

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

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

@@ -181,10 +181,13 @@ module Aws::APIGateway
     # Create an ApiKey resource.
     #
     # <div class="seeAlso">
-    # [AWS
-    # CLI]([[AwsDocsUrlPrefix]]/cli/latest/reference/apigateway/create-api-key.html)
+    # [AWS CLI][1]
     # </div>
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/cli/latest/reference/apigateway/create-api-key.html
+    #
     # @option params [String] :name
     #   The name of the ApiKey.
     #
@@ -261,10 +264,13 @@ module Aws::APIGateway
     # Adds a new Authorizer resource to an existing RestApi resource.
     #
     # <div class="seeAlso">
-    # [AWS
-    # CLI]([[AwsDocsUrlPrefix]]/cli/latest/reference/apigateway/create-authorizer.html)
+    # [AWS CLI][1]
     # </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.
     #
@@ -285,7 +291,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 Swagger imports and exports
+    #   Optional customer-defined field, used in OpenAPI imports and exports
     #   without functional impact.
     #
     # @option params [String] :authorizer_uri
@@ -534,7 +540,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
-    #   Swagger-compliant key-value pairs can be exported and, hence,
+    #   OpenAPI-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:
@@ -725,7 +731,11 @@ module Aws::APIGateway
     #
     # @option params [String] :schema
     #   The schema for the model. For `application/json` models, this should
-    #   be [JSON schema draft 4]([[JsonSchemaUrl]]) model.
+    #   be [JSON schema draft 4][1] model.
+    #
+    #
+    #
+    #   [1]: https://tools.ietf.org/html/draft-zyp-json-schema-04
     #
     # @option params [required, String] :content_type
     #   \[Required\] The content-type for the model.
@@ -1317,10 +1327,13 @@ module Aws::APIGateway
     # Deletes an existing Authorizer resource.
     #
     # <div class="seeAlso">
-    # [AWS
-    # CLI]([[AwsDocsUrlPrefix]]/cli/latest/reference/apigateway/delete-authorizer.html)
+    # [AWS CLI][1]
     # </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.
     #
@@ -2053,10 +2066,13 @@ module Aws::APIGateway
     # Describe an existing Authorizer resource.
     #
     # <div class="seeAlso">
-    # [AWS
-    # CLI]([[AwsDocsUrlPrefix]]/cli/latest/reference/apigateway/get-authorizer.html)
+    # [AWS CLI][1]
     # </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.
     #
@@ -2107,10 +2123,13 @@ module Aws::APIGateway
     # Describe an existing Authorizers resource.
     #
     # <div class="seeAlso">
-    # [AWS
-    # CLI]([[AwsDocsUrlPrefix]]/cli/latest/reference/apigateway/get-authorizers.html)
+    # [AWS CLI][1]
     # </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.
     #
@@ -2677,15 +2696,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. Currently only 'swagger' is
-    #   supported.
+    #   \[Required\] The type of export. Acceptable values are 'oas30' for
+    #   OpenAPI 3.0.x and 'swagger' for Swagger/OpenAPI 2.0.
     #
     # @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`
-    #   `swagger`, any combination of the following parameters are supported:
-    #   `extensions='integrations'` or `extensions='apigateway'` will export
-    #   the API with x-amazon-apigateway-integration extensions.
+    #   `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.
     #   `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
@@ -2693,8 +2712,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 `swagger`. This should be specified in the `Accept`
-    #   header for direct API requests.
+    #   `exportType` of`oas30` and `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:
     #
@@ -4197,8 +4216,11 @@ 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]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/api-key-file-format.html).
+    #   format, see [API Key File Format][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/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.
@@ -4250,7 +4272,7 @@ module Aws::APIGateway
     #
     # @option params [required, String, IO] :body
     #   \[Required\] Raw byte array representing the to-be-imported
-    #   documentation parts. To import from a Swagger file, this is a JSON
+    #   documentation parts. To import from an OpenAPI file, this is a JSON
     #   object.
     #
     # @return [Types::DocumentationPartIds] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -4318,7 +4340,7 @@ module Aws::APIGateway
     #
     # @option params [required, String, IO] :body
     #   \[Required\] The POST request body containing external API
-    #   definitions. Currently, only Swagger definition JSON files are
+    #   definitions. Currently, only OpenAPI definition JSON/YAML 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:
@@ -4473,10 +4495,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]([[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.
+    #     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.
     #
     #   * For `AWS` or `AWS_PROXY` integrations, the URI is of the form
     #     `arn:aws:apigateway:\{region\}:\{subdomain.service|service\}:path|action/\{service_api\}`.
@@ -4495,6 +4517,10 @@ 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
@@ -4502,10 +4528,12 @@ module Aws::APIGateway
     #   a network load balancer in a VPC. The default value is `INTERNET`.
     #
     # @option params [String] :connection_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.
+    #   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
     #
     # @option params [String] :credentials
     #   Specifies whether credentials are required for a put integration.
@@ -4768,7 +4796,11 @@ 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]([[PetstoreDemoUrl]]) example.
+    #   method in [PetStore][1] example.
+    #
+    #
+    #
+    #   [1]: https://petstore-demo-endpoint.execute-api.com/petstore/pets
     #
     # @option params [Hash<String,Boolean>] :request_parameters
     #   A key-value map defining required or optional method request
@@ -4986,7 +5018,7 @@ module Aws::APIGateway
     #
     # @option params [required, String, IO] :body
     #   \[Required\] The PUT request body containing external API definitions.
-    #   Currently, only Swagger definition JSON files are supported. The
+    #   Currently, only OpenAPI definition JSON/YAML 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:
@@ -5073,10 +5105,13 @@ module Aws::APIGateway
     # parameters, and an incoming request body.
     #
     # <div class="seeAlso">
-    # [Enable custom
-    # authorizers]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/use-custom-authorizer.html)
+    # [Enable custom authorizers][1]
     # </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.
     #
@@ -5371,10 +5406,13 @@ module Aws::APIGateway
     # Updates an existing Authorizer resource.
     #
     # <div class="seeAlso">
-    # [AWS
-    # CLI]([[AwsDocsUrlPrefix]]/cli/latest/reference/apigateway/update-authorizer.html)
+    # [AWS CLI][1]
     # </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.
     #
@@ -6622,7 +6660,7 @@ module Aws::APIGateway
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-apigateway'
-      context[:gem_version] = '1.18.0'
+      context[:gem_version] = '1.19.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -13,9 +13,12 @@ module Aws::APIGateway
     #
     # @!attribute [rw] format
     #   A single line format of the access logs of data, as specified by
-    #   selected [$context
-    #   variables]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/api-gateway-mapping-template-reference.html#context-variable-reference).
-    #   The format must include at least `$context.requestId`.
+    #   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
     #   @return [String]
     #
     # @!attribute [rw] destination_arn
@@ -42,8 +45,7 @@ module Aws::APIGateway
     # * TooManyRequestsException
     #
     # For detailed error code information, including the corresponding HTTP
-    # Status Codes, see [API Gateway Error
-    # Codes]([[AwsDocsUrlPrefix]]/apigateway/api-reference/handling-errors/#api-error-codes)
+    # Status Codes, see [API Gateway Error Codes][1]
     #
     # #### Example: Get the information about an account.
     #
@@ -56,7 +58,7 @@ module Aws::APIGateway
     # The successful response returns a `200 OK` status code and a payload
     # similar to the following:
     #
-    #     \{ "_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 \} \}
+    #     \{ "_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 \} \}
     #
     # In addition to making the REST API call directly, you can use the AWS
     # CLI and an AWS SDK to access this resource.
@@ -64,14 +66,16 @@ module Aws::APIGateway
     # </div>
     #
     # <div class="seeAlso">
-    # [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)
+    # [API Gateway Limits][2] [Developer Guide][3], [AWS CLI][4]
     # </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]
@@ -103,10 +107,13 @@ module Aws::APIGateway
     # make requests to that stage.
     #
     # <div class="seeAlso">
-    # [Use API
-    # Keys]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/how-to-api-keys.html)
+    # [Use API Keys][1]
     # </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]
@@ -178,10 +185,13 @@ module Aws::APIGateway
     # resource.
     #
     # <div class="seeAlso">
-    # [Use API
-    # Keys]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/how-to-api-keys.html)
+    # [Use API Keys][1]
     # </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.
@@ -242,10 +252,13 @@ module Aws::APIGateway
     # method.
     #
     # <div class="seeAlso">
-    # [Enable custom
-    # authorization]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/use-custom-authorizer.html)
+    # [Enable custom authorization][1]
     # </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]
@@ -269,7 +282,7 @@ module Aws::APIGateway
     #   @return [Array<String>]
     #
     # @!attribute [rw] auth_type
-    #   Optional customer-defined field, used in Swagger imports and exports
+    #   Optional customer-defined field, used in OpenAPI imports and exports
     #   without functional impact.
     #   @return [String]
     #
@@ -352,10 +365,13 @@ module Aws::APIGateway
     # Represents a collection of Authorizer resources.
     #
     # <div class="seeAlso">
-    # [Enable custom
-    # authorization]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/use-custom-authorizer.html)
+    # [Enable custom authorization][1]
     # </div>
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/use-custom-authorizer.html
+    #
     # @!attribute [rw] position
     #   @return [String]
     #
@@ -378,10 +394,13 @@ module Aws::APIGateway
     # </div>
     #
     # <div class="seeAlso">
-    # [Use Custom Domain
-    # Names]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/how-to-custom-domains.html)
+    # [Use Custom Domain Names][1]
     # </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.
@@ -405,10 +424,13 @@ module Aws::APIGateway
     # Represents a collection of BasePathMapping resources.
     #
     # <div class="seeAlso">
-    # [Use Custom Domain
-    # Names]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/how-to-custom-domains.html)
+    # [Use Custom Domain Names][1]
     # </div>
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-custom-domains.html
+    #
     # @!attribute [rw] position
     #   @return [String]
     #
@@ -474,10 +496,13 @@ module Aws::APIGateway
     # </div>
     #
     # <div class="seeAlso">
-    # [Use Client-Side
-    # Certificate]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/getting-started-client-side-ssl-authentication.html)
+    # [Use Client-Side Certificate][1]
     # </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]
@@ -512,10 +537,13 @@ module Aws::APIGateway
     # Represents a collection of ClientCertificate resources.
     #
     # <div class="seeAlso">
-    # [Use Client-Side
-    # Certificate]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/getting-started-client-side-ssl-authentication.html)
+    # [Use Client-Side Certificate][1]
     # </div>
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/getting-started-client-side-ssl-authentication.html
+    #
     # @!attribute [rw] position
     #   @return [String]
     #
@@ -633,7 +661,7 @@ module Aws::APIGateway
     #   @return [Array<String>]
     #
     # @!attribute [rw] auth_type
-    #   Optional customer-defined field, used in Swagger imports and exports
+    #   Optional customer-defined field, used in OpenAPI imports and exports
     #   without functional impact.
     #   @return [String]
     #
@@ -867,7 +895,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
-    #   Swagger-compliant key-value pairs can be exported and, hence,
+    #   OpenAPI-compliant key-value pairs can be exported and, hence,
     #   published.
     #   @return [String]
     #
@@ -1027,7 +1055,11 @@ module Aws::APIGateway
     #
     # @!attribute [rw] schema
     #   The schema for the model. For `application/json` models, this should
-    #   be [JSON schema draft 4]([[JsonSchemaUrl]]) model.
+    #   be [JSON schema draft 4][1] model.
+    #
+    #
+    #
+    #   [1]: https://tools.ietf.org/html/draft-zyp-json-schema-04
     #   @return [String]
     #
     # @!attribute [rw] content_type
@@ -1971,11 +2003,14 @@ module Aws::APIGateway
     # </div>
     #
     # <div class="seeAlso">
-    # RestApi, Deployments, Stage, [AWS
-    # CLI]([[AwsDocsUrlPrefix]]/cli/latest/reference/apigateway/get-deployment.html),
-    # [AWS SDKs]([[AwsAmazonUrlPrefix]]/tools/)
+    # RestApi, Deployments, Stage, [AWS CLI][1], [AWS SDKs][2]
     # </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]
@@ -2052,13 +2087,15 @@ module Aws::APIGateway
     # </div>
     #
     # <div class="seeAlso">
-    # [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/)
+    # [Deploying an API][1], [AWS CLI][2], [AWS SDKs][3]
     # </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]
     #
@@ -2085,18 +2122,20 @@ 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
-    # Swagger-compliant documentation fields will be injected into the
-    # associated API entity definition in the exported Swagger definition
+    # OpenAPI-compliant documentation fields will be injected into the
+    # associated API entity definition in the exported OpenAPI definition
     # file.
     #
     # </div>
     #
     # <div class="seeAlso">
-    # [Documenting an
-    # API]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/api-gateway-documenting-api.html),
-    # DocumentationParts
+    # [Documenting an API][1], 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.
@@ -2115,12 +2154,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
-    #   Swagger-compliant documentation-related fields from the
+    #   OpenAPI-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 Swagger extension of `x-amazon-apigateway-documentation`.
+    #   a OpenAPI extension of `x-amazon-apigateway-documentation`.
     #   @return [String]
     #
     class DocumentationPart < Struct.new(
@@ -2134,16 +2173,19 @@ module Aws::APIGateway
     #
     # <div class="remarks">
     # This is used to return the result when documentation parts in an
-    # external (e.g., Swagger) file are imported into API Gateway
+    # external (e.g., OpenAPI) file are imported into API Gateway
     # </div>
     #
     # <div class="seeAlso">
-    # [Documenting an
-    # API]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/api-gateway-documenting-api.html),
-    # [documentationpart:import]([[AwsDocsUrlPrefix]]/apigateway/api-reference/link-relation/documentationpart-import/),
+    # [Documenting an API][1], [documentationpart:import][2],
     # 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>]
@@ -2236,11 +2278,13 @@ module Aws::APIGateway
     # <div class="remarks"></div>
     #
     # <div class="seeAlso">
-    # [Documenting an
-    # API]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/api-gateway-documenting-api.html),
-    # DocumentationPart
+    # [Documenting an API][1], DocumentationPart
     # </div>
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-documenting-api.html
+    #
     # @!attribute [rw] position
     #   @return [String]
     #
@@ -2259,16 +2303,18 @@ 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., Swagger) file.
+    # to an external (e.g., OpenAPI) file.
     #
     # </div>
     #
     # <div class="seeAlso">
-    # [Documenting an
-    # API]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/api-gateway-documenting-api.html),
-    # DocumentationPart, DocumentationVersions
+    # [Documenting an API][1], 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]
@@ -2297,11 +2343,13 @@ module Aws::APIGateway
     # </div>
     #
     # <div class="seeAlso">
-    # [Documenting an
-    # API]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/api-gateway-documenting-api.html),
-    # DocumentationPart, DocumentationVersion
+    # [Documenting an API][1], DocumentationPart, DocumentationVersion
     # </div>
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-documenting-api.html
+    #
     # @!attribute [rw] position
     #   @return [String]
     #
@@ -2333,10 +2381,13 @@ module Aws::APIGateway
     # </div>
     #
     # <div class="seeAlso">
-    # [Set a Custom Host Name for an
-    # API]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/how-to-custom-domains.html)
+    # [Set a Custom Host Name for an API][1]
     # </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`.
@@ -2369,9 +2420,12 @@ 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]([[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).
+    #   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
     #   @return [String]
     #
     # @!attribute [rw] regional_certificate_name
@@ -2391,17 +2445,23 @@ 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]([[AwsAmazonUrlPrefix]]/documentation/cloudfront/).
+    #   documentation][1].
+    #
+    #
+    #
+    #   [1]: https://aws.amazon.com/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]([[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).
+    #   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
     #   @return [String]
     #
     # @!attribute [rw] endpoint_configuration
@@ -2427,10 +2487,13 @@ module Aws::APIGateway
     # Represents a collection of DomainName resources.
     #
     # <div class="seeAlso">
-    # [Use Client-Side
-    # Certificate]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/how-to-custom-domains.html)
+    # [Use Client-Side Certificate][1]
     # </div>
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-custom-domains.html
+    #
     # @!attribute [rw] position
     #   @return [String]
     #
@@ -2543,8 +2606,7 @@ module Aws::APIGateway
     #
     # <div class="remarks">
     # For more information about valid gateway response types, see [Gateway
-    # Response Types Supported by API
-    # Gateway]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/supported-gateway-response-types.html)
+    # Response Types Supported by API Gateway][1]
     # <div class="example" markdown="1">
     # #### Example: Get a Gateway Response of a given response type
     #
@@ -2570,10 +2632,14 @@ module Aws::APIGateway
     # </div>
     #
     # <div class="seeAlso">
-    # [Customize Gateway
-    # Responses]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/customize-gateway-responses.html)
+    # [Customize Gateway Responses][2]
     # </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
@@ -2634,8 +2700,7 @@ module Aws::APIGateway
     #
     # <div class="remarks">
     # For more information about valid gateway response types, see [Gateway
-    # Response Types Supported by API
-    # Gateway]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/supported-gateway-response-types.html)
+    # Response Types Supported by API Gateway][1]
     # <div class="example" markdown="1">
     # #### Example: Get the collection of gateway responses of an API
     #
@@ -2661,10 +2726,14 @@ module Aws::APIGateway
     # </div>
     #
     # <div class="seeAlso">
-    # [Customize Gateway
-    # Responses]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/customize-gateway-responses.html)
+    # [Customize Gateway Responses][2]
     # </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]
     #
@@ -3214,15 +3283,15 @@ module Aws::APIGateway
     #   @return [String]
     #
     # @!attribute [rw] export_type
-    #   \[Required\] The type of export. Currently only 'swagger' is
-    #   supported.
+    #   \[Required\] The type of export. Acceptable values are 'oas30' for
+    #   OpenAPI 3.0.x and 'swagger' for Swagger/OpenAPI 2.0.
     #   @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` `swagger`, any combination of the following parameters
-    #   are supported: `extensions='integrations'` or
+    #   `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.
     #   `extensions='authorizers'` will export the API with
@@ -3233,8 +3302,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 `swagger`. This should be specified in the
-    #   `Accept` header for direct API requests.
+    #   for `exportType` of`oas30` and `swagger`. This should be specified
+    #   in the `Accept` header for direct API requests.
     #   @return [String]
     #
     class GetExportRequest < Struct.new(
@@ -4134,8 +4203,11 @@ 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]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/api-key-file-format.html).
+    #   format, see [API Key File Format][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/api-key-file-format.html
     #   @return [String]
     #
     # @!attribute [rw] format
@@ -4155,7 +4227,7 @@ module Aws::APIGateway
       include Aws::Structure
     end
 
-    # Import documentation parts from an external (e.g., Swagger) definition
+    # Import documentation parts from an external (e.g., OpenAPI) definition
     # file.
     #
     # @note When making an API call, you may pass ImportDocumentationPartsRequest
@@ -4186,7 +4258,7 @@ module Aws::APIGateway
     #
     # @!attribute [rw] body
     #   \[Required\] Raw byte array representing the to-be-imported
-    #   documentation parts. To import from a Swagger file, this is a JSON
+    #   documentation parts. To import from an OpenAPI file, this is a JSON
     #   object.
     #   @return [String]
     #
@@ -4249,7 +4321,7 @@ module Aws::APIGateway
     #
     # @!attribute [rw] body
     #   \[Required\] The POST request body containing external API
-    #   definitions. Currently, only Swagger definition JSON files are
+    #   definitions. Currently, only OpenAPI definition JSON/YAML files are
     #   supported. The maximum size of the API definition file is 2MB.
     #   @return [String]
     #
@@ -4268,10 +4340,13 @@ module Aws::APIGateway
     # </div>
     #
     # <div class="seeAlso">
-    # [Creating an
-    # API]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/how-to-create-api.html)
+    # [Creating an API][1]
     # </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:
@@ -4313,10 +4388,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]([[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.
+    #     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.
     #
     #   * For `AWS` or `AWS_PROXY` integrations, the URI is of the form
     #     `arn:aws:apigateway:\{region\}:\{subdomain.service|service\}:path|action/\{service_api\}`.
@@ -4335,6 +4410,10 @@ 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
@@ -4346,10 +4425,12 @@ module Aws::APIGateway
     #   @return [String]
     #
     # @!attribute [rw] connection_id
-    #   The
-    #   ([`id`]([[AwsDocsUrlPrefix]]/apigateway/api-reference/resource/vpc-link/#id))
-    #   of the VpcLink used for the integration when
+    #   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
     #   @return [String]
     #
     # @!attribute [rw] credentials
@@ -4458,16 +4539,19 @@ module Aws::APIGateway
     #   The successful response returns `200 OK` status and a payload as
     #   follows:
     #
-    #       \{ "_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" \}
+    #       \{ "_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" \}
     #
     #
     #
     #   </div>
     #
     #   <div class="seeAlso">
-    #   [Creating an
-    #   API]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/how-to-create-api.html)
+    #   [Creating an API][1]
     #   </div>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-create-api.html
     #   @return [Hash<String,Types::IntegrationResponse>]
     #
     class Integration < Struct.new(
@@ -4493,10 +4577,13 @@ module Aws::APIGateway
     # transform the back-end response.
     #
     # <div class="seeAlso">
-    # [Creating an
-    # API]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/how-to-create-api.html)
+    # [Creating an API][1]
     # </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.
@@ -4589,24 +4676,27 @@ module Aws::APIGateway
     # The successful response returns a `200 OK` status code and a payload
     # similar to the following:
     #
-    #     \{ "_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" \} \} \}
+    #     \{ "_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" \} \} \}
     #
     # 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()]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/api-gateway-mapping-template-reference.html#util-templat-reference)
-    # helper function.
+    # and the output is decoded using the [$util.urlDecode()][1] helper
+    # function.
     #
     # </div>
     #
     # <div class="seeAlso">
     # MethodResponse, Integration, IntegrationResponse, Resource, [Set up an
-    # API's
-    # method]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/how-to-method-settings.html)
+    # API's method][2]
     # </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]
@@ -4635,7 +4725,11 @@ 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]([[PetstoreDemoUrl]]) example.
+    #   method in [PetStore][1] example.
+    #
+    #
+    #
+    #   [1]: https://petstore-demo-endpoint.execute-api.com/petstore/pets
     #   @return [String]
     #
     # @!attribute [rw] request_parameters
@@ -4679,16 +4773,19 @@ module Aws::APIGateway
     #   The successful response returns a `200 OK` status code and a payload
     #   similar to the following:
     #
-    #       \{ "_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" \}
+    #       \{ "_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" \}
     #
     #
     #
     #   </div>
     #
     #   <div class="seeAlso">
-    #   [AWS
-    #   CLI]([[AwsDocsUrlPrefix]]/cli/latest/reference/apigateway/get-method-response.html)
+    #   [AWS CLI][1]
     #   </div>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/cli/latest/reference/apigateway/get-method-response.html
     #   @return [Hash<String,Types::MethodResponse>]
     #
     # @!attribute [rw] method_integration
@@ -4712,16 +4809,19 @@ module Aws::APIGateway
     #   The successful response returns a `200 OK` status code and a payload
     #   similar to the following:
     #
-    #       \{ "_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" \} \} \}
+    #       \{ "_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" \} \} \}
     #
     #
     #
     #   </div>
     #
     #   <div class="seeAlso">
-    #   [AWS
-    #   CLI]([[AwsDocsUrlPrefix]]/cli/latest/reference/apigateway/get-integration.html)
+    #   [AWS CLI][1]
     #   </div>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/cli/latest/reference/apigateway/get-integration.html
     #   @return [Types::Integration]
     #
     # @!attribute [rw] authorization_scopes
@@ -4773,17 +4873,20 @@ module Aws::APIGateway
     # The successful response returns `200 OK` status and a payload as
     # follows:
     #
-    #     \{ "_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" \}
+    #     \{ "_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" \}
     #
     #
     #
     # </div>
     #
     # <div class="seeAlso">
-    # Method, IntegrationResponse, Integration [Creating an
-    # API]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/how-to-create-api.html)
+    # Method, IntegrationResponse, Integration [Creating an API][1]
     # </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]
@@ -4943,10 +5046,13 @@ module Aws::APIGateway
     # </div>
     #
     # <div class="seeAlso">
-    # Method, MethodResponse, [Models and
-    # Mappings]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/models-mappings.html)
+    # Method, MethodResponse, [Models and Mappings][1]
     # </div>
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/models-mappings.html
+    #
     # @!attribute [rw] id
     #   The identifier for the model resource.
     #   @return [String]
@@ -4961,12 +5067,15 @@ module Aws::APIGateway
     #
     # @!attribute [rw] schema
     #   The schema for the model. For `application/json` models, this should
-    #   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.
+    #   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
     #   @return [String]
     #
     # @!attribute [rw] content_type
@@ -4985,10 +5094,13 @@ module Aws::APIGateway
     # Represents a collection of Model resources.
     #
     # <div class="seeAlso">
-    # Method, MethodResponse, [Models and
-    # Mappings]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/models-mappings.html)
+    # Method, MethodResponse, [Models and Mappings][1]
     # </div>
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/models-mappings.html
+    #
     # @!attribute [rw] position
     #   @return [String]
     #
@@ -5026,16 +5138,20 @@ module Aws::APIGateway
     #   @return [String]
     #
     # @!attribute [rw] path
-    #   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.
+    #   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
     #   @return [String]
     #
     # @!attribute [rw] value
@@ -5043,8 +5159,11 @@ 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]([[AwsDocsUrlPrefix]]/cli/latest/userguide/cli-using-param.html#cli-using-param-json).
+    #   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
     #   @return [String]
     #
     # @!attribute [rw] from
@@ -5190,10 +5309,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]([[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.
+    #     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.
     #
     #   * For `AWS` or `AWS_PROXY` integrations, the URI is of the form
     #     `arn:aws:apigateway:\{region\}:\{subdomain.service|service\}:path|action/\{service_api\}`.
@@ -5212,6 +5331,10 @@ 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
@@ -5223,10 +5346,12 @@ module Aws::APIGateway
     #   @return [String]
     #
     # @!attribute [rw] connection_id
-    #   The
-    #   ([`id`]([[AwsDocsUrlPrefix]]/apigateway/api-reference/resource/vpc-link/#id))
-    #   of the VpcLink used for the integration when
+    #   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
     #   @return [String]
     #
     # @!attribute [rw] credentials
@@ -5467,7 +5592,11 @@ 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]([[PetstoreDemoUrl]]) example.
+    #   method in [PetStore][1] example.
+    #
+    #
+    #
+    #   [1]: https://petstore-demo-endpoint.execute-api.com/petstore/pets
     #   @return [String]
     #
     # @!attribute [rw] request_parameters
@@ -5632,7 +5761,7 @@ module Aws::APIGateway
     #
     # @!attribute [rw] body
     #   \[Required\] The PUT request body containing external API
-    #   definitions. Currently, only Swagger definition JSON files are
+    #   definitions. Currently, only OpenAPI definition JSON/YAML files are
     #   supported. The maximum size of the API definition file is 2MB.
     #   @return [String]
     #
@@ -5681,19 +5810,23 @@ module Aws::APIGateway
     # A set of validation rules for incoming Method requests.
     #
     # <div class="remarks" markdown="1">
-    # 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)
+    # 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]
     # property.
     #
     # </div>
     #
     # <div class="seeAlso">
-    # [Enable Basic Request Validation in API
-    # Gateway]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/api-gateway-method-request-validation.html)
+    # [Enable Basic Request Validation in API Gateway][3]
     # </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]
@@ -5723,17 +5856,20 @@ module Aws::APIGateway
     # A collection of RequestValidator resources of a given RestApi.
     #
     # <div class="remarks" markdown="1">
-    # 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.
+    # In OpenAPI, the RequestValidators of an API is defined by the
+    # [x-amazon-apigateway-request-validators][1] extension.
     #
     # </div>
     #
     # <div class="seeAlso">
-    # [Enable Basic Request Validation in API
-    # Gateway]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/api-gateway-method-request-validation.html)
+    # [Enable Basic Request Validation in API Gateway][2]
     # </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]
     #
@@ -5750,10 +5886,13 @@ module Aws::APIGateway
     # Represents an API resource.
     #
     # <div class="seeAlso">
-    # [Create an
-    # API]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/how-to-create-api.html)
+    # [Create an API][1]
     # </div>
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-create-api.html
+    #
     # @!attribute [rw] id
     #   The resource's identifier.
     #   @return [String]
@@ -5789,7 +5928,7 @@ module Aws::APIGateway
     #
     #   ##### Response
     #
-    #       \{ "_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" \} \} \}
+    #       \{ "_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" \} \} \}
     #
     #   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
@@ -5812,10 +5951,13 @@ module Aws::APIGateway
     # Represents a collection of Resource resources.
     #
     # <div class="seeAlso">
-    # [Create an
-    # API]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/how-to-create-api.html)
+    # [Create an API][1]
     # </div>
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-create-api.html
+    #
     # @!attribute [rw] position
     #   @return [String]
     #
@@ -5832,10 +5974,13 @@ module Aws::APIGateway
     # Represents a REST API.
     #
     # <div class="seeAlso">
-    # [Create an
-    # API]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/how-to-create-api.html)
+    # [Create an API][1]
     # </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.
@@ -5914,10 +6059,13 @@ module Aws::APIGateway
     # your APIs.
     #
     # <div class="seeAlso">
-    # [Create an
-    # API]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/how-to-create-api.html)
+    # [Create an API][1]
     # </div>
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-create-api.html
+    #
     # @!attribute [rw] position
     #   @return [String]
     #
@@ -6031,10 +6179,13 @@ module Aws::APIGateway
     # that is callable by users.
     #
     # <div class="seeAlso">
-    # [Deploy an
-    # API]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/how-to-deploy-api.html)
+    # [Deploy an API][1]
     # </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]
@@ -6157,10 +6308,13 @@ module Aws::APIGateway
     # resource.
     #
     # <div class="seeAlso">
-    # [Deploying API in
-    # Stages]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/stages.html)
+    # [Deploying API in Stages][1]
     # </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>]
@@ -6217,13 +6371,20 @@ module Aws::APIGateway
     # Represents a mapping template used to transform a payload.
     #
     # <div class="seeAlso">
-    # [Mapping
-    # Templates]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/models-mappings.html#models-mappings-mappings)
+    # [Mapping Templates][1]
     # </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)]([[ApacheVtlUrl]])
-    #   template content used for the template resource.
+    #   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
     #   @return [String]
     #
     class Template < Struct.new(
@@ -6336,9 +6497,12 @@ module Aws::APIGateway
     #   @return [Hash<String,Array<String>>]
     #
     # @!attribute [rw] claims
-    #   The [open identity claims]([[OpenIdClaimsUrl]]), with any supported
-    #   custom attributes, returned from the Cognito Your User Pool
-    #   configured for the API.
+    #   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
     #   @return [Hash<String,String>]
     #
     class TestInvokeAuthorizerResponse < Struct.new(
@@ -6434,10 +6598,13 @@ 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]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/how-to-test-method.html#how-to-test-method-console)
+    # [Test API using the API Gateway console][1]
     # </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]
@@ -7395,12 +7562,14 @@ module Aws::APIGateway
     # <div class="remarks"></div>
     #
     # <div class="seeAlso">
-    # [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)
+    # [Create and Use Usage Plans][1], [Manage Usage in a Usage Plan][2]
     # </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]
@@ -7445,10 +7614,13 @@ module Aws::APIGateway
     # </div>
     #
     # <div class="seeAlso">
-    # [Create and Use Usage
-    # Plans]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/api-gateway-api-usage-plans.html)
+    # [Create and Use Usage Plans][1]
     # </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]
@@ -7499,10 +7671,13 @@ module Aws::APIGateway
     # </div>
     #
     # " <div class="seeAlso">
-    # [Create and Use Usage
-    # Plans]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/api-gateway-api-usage-plans.html)
+    # [Create and Use Usage Plans][1]
     # </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]
@@ -7532,10 +7707,13 @@ module Aws::APIGateway
     # the associated API keys and, possibly, other types of keys.
     #
     # <div class="seeAlso">
-    # [Create and Use Usage
-    # Plans]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/api-gateway-api-usage-plans.html)
+    # [Create and Use Usage Plans][1]
     # </div>
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-api-usage-plans.html
+    #
     # @!attribute [rw] position
     #   @return [String]
     #
@@ -7552,10 +7730,13 @@ module Aws::APIGateway
     # Represents a collection of usage plans for an AWS account.
     #
     # <div class="seeAlso">
-    # [Create and Use Usage
-    # Plans]([[AwsDocsUrlPrefix]]/apigateway/latest/developerguide/api-gateway-api-usage-plans.html)
+    # [Create and Use Usage Plans][1]
     # </div>
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-api-usage-plans.html
+    #
     # @!attribute [rw] position
     #   @return [String]
     #
@@ -7626,12 +7807,15 @@ module Aws::APIGateway
     # The collection of VPC links under the caller's account in a region.
     #
     # <div class="seeAlso">
-    # [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)
+    # [Getting Started with Private Integrations][1], [Set up Private
+    # Integrations][2]
     # </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]
     #