aws-sdk-apigateway 1.74.0 → 1.77.0

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

@@ -27,6 +27,7 @@ require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
 require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
 require 'aws-sdk-core/plugins/transfer_encoding.rb'
 require 'aws-sdk-core/plugins/http_checksum.rb'
+require 'aws-sdk-core/plugins/checksum_algorithm.rb'
 require 'aws-sdk-core/plugins/defaults_mode.rb'
 require 'aws-sdk-core/plugins/recursion_detection.rb'
 require 'aws-sdk-core/plugins/signature_v4.rb'
@@ -76,6 +77,7 @@ module Aws::APIGateway
     add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
     add_plugin(Aws::Plugins::TransferEncoding)
     add_plugin(Aws::Plugins::HttpChecksum)
+    add_plugin(Aws::Plugins::ChecksumAlgorithm)
     add_plugin(Aws::Plugins::DefaultsMode)
     add_plugin(Aws::Plugins::RecursionDetection)
     add_plugin(Aws::Plugins::SignatureV4)
@@ -353,14 +355,6 @@ module Aws::APIGateway
 
     # Create an ApiKey resource.
     #
-    # <div class="seeAlso" markdown="1">
-    # [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.
     #
@@ -448,26 +442,17 @@ module Aws::APIGateway
 
     # Adds a new Authorizer resource to an existing RestApi resource.
     #
-    # <div class="seeAlso" markdown="1">
-    # [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.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :name
-    #   \[Required\] The name of the authorizer.
+    #   The name of the authorizer.
     #
     # @option params [required, String] :type
-    #   \[Required\] The authorizer type. Valid values are `TOKEN` for a
-    #   Lambda function using a single authorization token submitted in a
-    #   custom header, `REQUEST` for a Lambda function using incoming request
-    #   parameters, and `COGNITO_USER_POOLS` for using an Amazon Cognito user
-    #   pool.
+    #   The authorizer type. Valid values are `TOKEN` for a Lambda function
+    #   using a single authorization token submitted in a custom header,
+    #   `REQUEST` for a Lambda function using incoming request parameters, and
+    #   `COGNITO_USER_POOLS` for using an Amazon Cognito user pool.
     #
     # @option params [Array<String>] :provider_arns
     #   A list of the Amazon Cognito user pool ARNs for the
@@ -499,27 +484,26 @@ module Aws::APIGateway
     #   resource-based permissions on the Lambda function, specify null.
     #
     # @option params [String] :identity_source
-    #   The identity source for which authorization is requested. * For a
-    #   `TOKEN` or `COGNITO_USER_POOLS` authorizer, this is required
-    #     and specifies the request header mapping expression for the custom
-    #     header holding the authorization token submitted by the client. For
-    #     example, if the token header name is `Auth`, the header mapping
-    #     expression is `method.request.header.Auth`.
-    #   * For the `REQUEST` authorizer, this is required when authorization
-    #     caching is enabled. The value is a comma-separated string of one or
-    #     more mapping expressions of the specified request parameters. For
-    #     example, if an `Auth` header, a `Name` query string parameter are
-    #     defined as identity sources, this value is
-    #     `method.request.header.Auth, method.request.querystring.Name`. These
-    #     parameters will be used to derive the authorization caching key and
-    #     to perform runtime validation of the `REQUEST` authorizer by
-    #     verifying all of the identity-related request parameters are
-    #     present, not null and non-empty. Only when this is true does the
-    #     authorizer invoke the authorizer Lambda function, otherwise, it
-    #     returns a 401 Unauthorized response without calling the Lambda
-    #     function. The valid value is a string of comma-separated mapping
-    #     expressions of the specified request parameters. When the
-    #     authorization caching is not enabled, this property is optional.
+    #   The identity source for which authorization is requested. For a
+    #   `TOKEN` or `COGNITO_USER_POOLS` authorizer, this is required and
+    #   specifies the request header mapping expression for the custom header
+    #   holding the authorization token submitted by the client. For example,
+    #   if the token header name is `Auth`, the header mapping expression is
+    #   `method.request.header.Auth`. For the `REQUEST` authorizer, this is
+    #   required when authorization caching is enabled. The value is a
+    #   comma-separated string of one or more mapping expressions of the
+    #   specified request parameters. For example, if an `Auth` header, a
+    #   `Name` query string parameter are defined as identity sources, this
+    #   value is `method.request.header.Auth,
+    #   method.request.querystring.Name`. These parameters will be used to
+    #   derive the authorization caching key and to perform runtime validation
+    #   of the `REQUEST` authorizer by verifying all of the identity-related
+    #   request parameters are present, not null and non-empty. Only when this
+    #   is true does the authorizer invoke the authorizer Lambda function,
+    #   otherwise, it returns a 401 Unauthorized response without calling the
+    #   Lambda function. The valid value is a string of comma-separated
+    #   mapping expressions of the specified request parameters. When the
+    #   authorization caching is not enabled, this property is optional.
     #
     # @option params [String] :identity_validation_expression
     #   A validation expression for the incoming identity token. For `TOKEN`
@@ -589,8 +573,7 @@ module Aws::APIGateway
     # Creates a new BasePathMapping resource.
     #
     # @option params [required, String] :domain_name
-    #   \[Required\] The domain name of the BasePathMapping resource to
-    #   create.
+    #   The domain name of the BasePathMapping resource to create.
     #
     # @option params [String] :base_path
     #   The base path name that callers of the API must provide as part of the
@@ -599,7 +582,7 @@ module Aws::APIGateway
     #   callers to specify a base path name after the domain name.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [String] :stage
     #   The name of the API's stage that you want to use for this mapping.
@@ -638,7 +621,7 @@ module Aws::APIGateway
     # callable over the internet.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [String] :stage_name
     #   The name of the Stage resource for the Deployment resource to create.
@@ -716,18 +699,19 @@ module Aws::APIGateway
       req.send_request(options)
     end
 
+    # Creates a documentation part.
+    #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, Types::DocumentationPartLocation] :location
-    #   \[Required\] The location of the targeted API entity of the
-    #   to-be-created documentation part.
+    #   The location of the targeted API entity of the to-be-created
+    #   documentation part.
     #
     # @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,
-    #   published.
+    #   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, published.
     #
     # @return [Types::DocumentationPart] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -766,11 +750,13 @@ module Aws::APIGateway
       req.send_request(options)
     end
 
+    # Creates a documentation version
+    #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :documentation_version
-    #   \[Required\] The version identifier of the new snapshot.
+    #   The version identifier of the new snapshot.
     #
     # @option params [String] :stage_name
     #   The stage name to be associated with the new documentation snapshot.
@@ -809,7 +795,7 @@ module Aws::APIGateway
     # Creates a new domain name.
     #
     # @option params [required, String] :domain_name
-    #   \[Required\] The name of the DomainName resource.
+    #   The name of the DomainName resource.
     #
     # @option params [String] :certificate_name
     #   The user-friendly name of the certificate that will be used by
@@ -861,9 +847,10 @@ module Aws::APIGateway
     #   DomainName. The valid values are `TLS_1_0` and `TLS_1_2`.
     #
     # @option params [Types::MutualTlsAuthenticationInput] :mutual_tls_authentication
+    #   The mutual TLS authentication configuration for a custom domain name.
     #   If specified, API Gateway performs two-way authentication between the
     #   client and the server. Clients must present a trusted certificate to
-    #   access your custom domain name.
+    #   access your API.
     #
     # @option params [String] :ownership_verification_certificate_arn
     #   The ARN of the public certificate issued by ACM to validate ownership
@@ -954,25 +941,20 @@ module Aws::APIGateway
     # Adds a new Model resource to an existing RestApi resource.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The RestApi identifier under which the Model will be
-    #   created.
+    #   The RestApi identifier under which the Model will be created.
     #
     # @option params [required, String] :name
-    #   \[Required\] The name of the model. Must be alphanumeric.
+    #   The name of the model. Must be alphanumeric.
     #
     # @option params [String] :description
     #   The description of the model.
     #
     # @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 model.
     #
     # @option params [required, String] :content_type
-    #   \[Required\] The content-type for the model.
+    #   The content-type for the model.
     #
     # @return [Types::Model] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1007,10 +989,10 @@ module Aws::APIGateway
       req.send_request(options)
     end
 
-    # Creates a ReqeustValidator of a given RestApi.
+    # Creates a RequestValidator of a given RestApi.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [String] :name
     #   The name of the to-be-created RequestValidator.
@@ -1057,10 +1039,10 @@ module Aws::APIGateway
     # Creates a Resource resource.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :parent_id
-    #   \[Required\] The parent resource's identifier.
+    #   The parent resource's identifier.
     #
     # @option params [required, String] :path_part
     #   The last path segment for this resource.
@@ -1142,7 +1124,7 @@ module Aws::APIGateway
     # Creates a new RestApi resource.
     #
     # @option params [required, String] :name
-    #   \[Required\] The name of the RestApi.
+    #   The name of the RestApi.
     #
     # @option params [String] :description
     #   The description of the RestApi.
@@ -1167,18 +1149,17 @@ module Aws::APIGateway
     #
     # @option params [String] :api_key_source
     #   The source of the API key for metering requests according to a usage
-    #   plan. Valid values are: * `HEADER` to read the API key from the
-    #   `X-API-Key` header of a
-    #     request.
-    #   * `AUTHORIZER` to read the API key from the `UsageIdentifierKey` from
-    #     a custom authorizer.
+    #   plan. Valid values are: &gt;`HEADER` to read the API key from the
+    #   `X-API-Key` header of a request. `AUTHORIZER` to read the API key from
+    #   the `UsageIdentifierKey` from a custom authorizer.
     #
     # @option params [Types::EndpointConfiguration] :endpoint_configuration
     #   The endpoint configuration of this RestApi showing the endpoint types
     #   of the API.
     #
     # @option params [String] :policy
-    #   A stringified JSON policy document that applies to this RestApi regardless of the caller and Method configuration.
+    #   A stringified JSON policy document that applies to this RestApi
+    #   regardless of the caller and Method configuration.
     #
     # @option params [Hash<String,String>] :tags
     #   The key-value map of strings. The valid character set is
@@ -1188,10 +1169,9 @@ module Aws::APIGateway
     # @option params [Boolean] :disable_execute_api_endpoint
     #   Specifies whether clients can invoke your API by using the default
     #   `execute-api` endpoint. By default, clients can invoke your API with
-    #   the default
-    #   https://\\\{api\_id\\}.execute-api.\\\{region\\}.amazonaws.com
+    #   the default `https://\{api_id\}.execute-api.\{region\}.amazonaws.com`
     #   endpoint. To require that clients use a custom domain name to invoke
-    #   your API, disable the default endpoint.
+    #   your API, disable the default endpoint
     #
     # @return [Types::RestApi] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1263,16 +1243,15 @@ module Aws::APIGateway
     # for the API.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :stage_name
-    #   \[Required\] The name for the Stage resource. Stage names can only
-    #   contain alphanumeric characters, hyphens, and underscores. Maximum
-    #   length is 128 characters.
+    #   The name for the Stage resource. Stage names can only contain
+    #   alphanumeric characters, hyphens, and underscores. Maximum length is
+    #   128 characters.
     #
     # @option params [required, String] :deployment_id
-    #   \[Required\] The identifier of the Deployment resource for the Stage
-    #   resource.
+    #   The identifier of the Deployment resource for the Stage resource.
     #
     # @option params [String] :description
     #   The description of the Stage resource.
@@ -1397,7 +1376,7 @@ module Aws::APIGateway
     # the associated API stages, specified in the payload.
     #
     # @option params [required, String] :name
-    #   \[Required\] The name of the usage plan.
+    #   The name of the usage plan.
     #
     # @option params [String] :description
     #   The description of the usage plan.
@@ -1489,16 +1468,15 @@ module Aws::APIGateway
     # plan.
     #
     # @option params [required, String] :usage_plan_id
-    #   \[Required\] The Id of the UsagePlan resource representing the usage
-    #   plan containing the to-be-created UsagePlanKey resource representing a
-    #   plan customer.
+    #   The Id of the UsagePlan resource representing the usage plan
+    #   containing the to-be-created UsagePlanKey resource representing a plan
+    #   customer.
     #
     # @option params [required, String] :key_id
-    #   \[Required\] The identifier of a UsagePlanKey resource for a plan
-    #   customer.
+    #   The identifier of a UsagePlanKey resource for a plan customer.
     #
     # @option params [required, String] :key_type
-    #   \[Required\] The type of a UsagePlanKey resource for a plan customer.
+    #   The type of a UsagePlanKey resource for a plan customer.
     #
     # @return [Types::UsagePlanKey] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1535,15 +1513,15 @@ module Aws::APIGateway
     # create and update VPC Endpoint services.
     #
     # @option params [required, String] :name
-    #   \[Required\] The name used to label and identify the VPC link.
+    #   The name used to label and identify the VPC link.
     #
     # @option params [String] :description
     #   The description of the VPC link.
     #
     # @option params [required, Array<String>] :target_arns
-    #   \[Required\] The ARN of the network load balancer of the VPC targeted
-    #   by the VPC link. The network load balancer must be owned by the same
-    #   AWS account of the API owner.
+    #   The ARN of the network load balancer of the VPC targeted by the VPC
+    #   link. The network load balancer must be owned by the same AWS account
+    #   of the API owner.
     #
     # @option params [Hash<String,String>] :tags
     #   The key-value map of strings. The valid character set is
@@ -1593,7 +1571,7 @@ module Aws::APIGateway
     # Deletes the ApiKey resource.
     #
     # @option params [required, String] :api_key
-    #   \[Required\] The identifier of the ApiKey resource to be deleted.
+    #   The identifier of the ApiKey resource to be deleted.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1612,19 +1590,11 @@ module Aws::APIGateway
 
     # Deletes an existing Authorizer resource.
     #
-    # <div class="seeAlso" markdown="1">
-    # [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.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :authorizer_id
-    #   \[Required\] The identifier of the Authorizer resource.
+    #   The identifier of the Authorizer resource.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1645,12 +1615,10 @@ module Aws::APIGateway
     # Deletes the BasePathMapping resource.
     #
     # @option params [required, String] :domain_name
-    #   \[Required\] The domain name of the BasePathMapping resource to
-    #   delete.
+    #   The domain name of the BasePathMapping resource to delete.
     #
     # @option params [required, String] :base_path
-    #   \[Required\] The base path name of the BasePathMapping resource to
-    #   delete.
+    #   The base path name of the BasePathMapping resource to delete.
     #
     #   To specify an empty base path, set this parameter to `'(none)'`.
     #
@@ -1673,8 +1641,7 @@ module Aws::APIGateway
     # Deletes the ClientCertificate resource.
     #
     # @option params [required, String] :client_certificate_id
-    #   \[Required\] The identifier of the ClientCertificate resource to be
-    #   deleted.
+    #   The identifier of the ClientCertificate resource to be deleted.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1695,10 +1662,10 @@ module Aws::APIGateway
     # if there are no Stage resources associated with it.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :deployment_id
-    #   \[Required\] The identifier of the Deployment resource to delete.
+    #   The identifier of the Deployment resource to delete.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1716,11 +1683,13 @@ module Aws::APIGateway
       req.send_request(options)
     end
 
+    # Deletes a documentation part
+    #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :documentation_part_id
-    #   \[Required\] The identifier of the to-be-deleted documentation part.
+    #   The identifier of the to-be-deleted documentation part.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1738,12 +1707,13 @@ module Aws::APIGateway
       req.send_request(options)
     end
 
+    # Deletes a documentation version.
+    #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :documentation_version
-    #   \[Required\] The version identifier of a to-be-deleted documentation
-    #   snapshot.
+    #   The version identifier of a to-be-deleted documentation snapshot.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1764,7 +1734,7 @@ module Aws::APIGateway
     # Deletes the DomainName resource.
     #
     # @option params [required, String] :domain_name
-    #   \[Required\] The name of the DomainName resource to be deleted.
+    #   The name of the DomainName resource to be deleted.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1785,10 +1755,10 @@ module Aws::APIGateway
     # type on the given RestApi and resets it with the default settings.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :response_type
-    #   \[Required\] The response type of the associated GatewayResponse.
+    #   The response type of the associated GatewayResponse.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1809,14 +1779,13 @@ module Aws::APIGateway
     # Represents a delete integration.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :resource_id
-    #   \[Required\] Specifies a delete integration request's resource
-    #   identifier.
+    #   Specifies a delete integration request's resource identifier.
     #
     # @option params [required, String] :http_method
-    #   \[Required\] Specifies a delete integration request's HTTP method.
+    #   Specifies a delete integration request's HTTP method.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1838,19 +1807,17 @@ module Aws::APIGateway
     # Represents a delete integration response.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :resource_id
-    #   \[Required\] Specifies a delete integration response request's
-    #   resource identifier.
+    #   Specifies a delete integration response request's resource
+    #   identifier.
     #
     # @option params [required, String] :http_method
-    #   \[Required\] Specifies a delete integration response request's HTTP
-    #   method.
+    #   Specifies a delete integration response request's HTTP method.
     #
     # @option params [required, String] :status_code
-    #   \[Required\] Specifies a delete integration response request's status
-    #   code.
+    #   Specifies a delete integration response request's status code.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1873,13 +1840,13 @@ module Aws::APIGateway
     # Deletes an existing Method resource.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :resource_id
-    #   \[Required\] The Resource identifier for the Method resource.
+    #   The Resource identifier for the Method resource.
     #
     # @option params [required, String] :http_method
-    #   \[Required\] The HTTP verb of the Method resource.
+    #   The HTTP verb of the Method resource.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1901,17 +1868,16 @@ module Aws::APIGateway
     # Deletes an existing MethodResponse resource.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :resource_id
-    #   \[Required\] The Resource identifier for the MethodResponse resource.
+    #   The Resource identifier for the MethodResponse resource.
     #
     # @option params [required, String] :http_method
-    #   \[Required\] The HTTP verb of the Method resource.
+    #   The HTTP verb of the Method resource.
     #
     # @option params [required, String] :status_code
-    #   \[Required\] The status code identifier for the MethodResponse
-    #   resource.
+    #   The status code identifier for the MethodResponse resource.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1934,10 +1900,10 @@ module Aws::APIGateway
     # Deletes a model.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :model_name
-    #   \[Required\] The name of the model to delete.
+    #   The name of the model to delete.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1958,10 +1924,10 @@ module Aws::APIGateway
     # Deletes a RequestValidator of a given RestApi.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :request_validator_id
-    #   \[Required\] The identifier of the RequestValidator to be deleted.
+    #   The identifier of the RequestValidator to be deleted.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1982,10 +1948,10 @@ module Aws::APIGateway
     # Deletes a Resource resource.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :resource_id
-    #   \[Required\] The identifier of the Resource resource.
+    #   The identifier of the Resource resource.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -2006,7 +1972,7 @@ module Aws::APIGateway
     # Deletes the specified API.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -2026,10 +1992,10 @@ module Aws::APIGateway
     # Deletes a Stage resource.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :stage_name
-    #   \[Required\] The name of the Stage resource to delete.
+    #   The name of the Stage resource to delete.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -2050,7 +2016,7 @@ module Aws::APIGateway
     # Deletes a usage plan of a given plan Id.
     #
     # @option params [required, String] :usage_plan_id
-    #   \[Required\] The Id of the to-be-deleted usage plan.
+    #   The Id of the to-be-deleted usage plan.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -2071,12 +2037,12 @@ module Aws::APIGateway
     # associated usage plan.
     #
     # @option params [required, String] :usage_plan_id
-    #   \[Required\] The Id of the UsagePlan resource representing the usage
-    #   plan containing the to-be-deleted UsagePlanKey resource representing a
-    #   plan customer.
+    #   The Id of the UsagePlan resource representing the usage plan
+    #   containing the to-be-deleted UsagePlanKey resource representing a plan
+    #   customer.
     #
     # @option params [required, String] :key_id
-    #   \[Required\] The Id of the UsagePlanKey resource to be deleted.
+    #   The Id of the UsagePlanKey resource to be deleted.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -2097,8 +2063,8 @@ module Aws::APIGateway
     # Deletes an existing VpcLink of a specified identifier.
     #
     # @option params [required, String] :vpc_link_id
-    #   \[Required\] The identifier of the VpcLink. It is used in an
-    #   Integration to reference this VpcLink.
+    #   The identifier of the VpcLink. It is used in an Integration to
+    #   reference this VpcLink.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -2142,10 +2108,10 @@ module Aws::APIGateway
     # Flushes a stage's cache.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :stage_name
-    #   \[Required\] The name of the stage to flush its cache.
+    #   The name of the stage to flush its cache.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -2236,7 +2202,7 @@ module Aws::APIGateway
     # Gets information about the current ApiKey resource.
     #
     # @option params [required, String] :api_key
-    #   \[Required\] The identifier of the ApiKey resource.
+    #   The identifier of the ApiKey resource.
     #
     # @option params [Boolean] :include_value
     #   A boolean flag to specify whether (`true`) or not (`false`) the result
@@ -2350,19 +2316,11 @@ module Aws::APIGateway
 
     # Describe an existing Authorizer resource.
     #
-    # <div class="seeAlso" markdown="1">
-    # [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.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :authorizer_id
-    #   \[Required\] The identifier of the Authorizer resource.
+    #   The identifier of the Authorizer resource.
     #
     # @return [Types::Authorizer] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2407,16 +2365,8 @@ module Aws::APIGateway
 
     # Describe an existing Authorizers resource.
     #
-    # <div class="seeAlso" markdown="1">
-    # [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.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [String] :position
     #   The current pagination position in the paged result set.
@@ -2464,15 +2414,13 @@ module Aws::APIGateway
     # Describe a BasePathMapping resource.
     #
     # @option params [required, String] :domain_name
-    #   \[Required\] The domain name of the BasePathMapping resource to be
-    #   described.
+    #   The domain name of the BasePathMapping resource to be described.
     #
     # @option params [required, String] :base_path
-    #   \[Required\] The base path name that callers of the API must provide
-    #   as part of the URL after the domain name. This value must be unique
-    #   for all of the mappings across a single API. Specify '(none)' if you
-    #   do not want callers to specify any base path name after the domain
-    #   name.
+    #   The base path name that callers of the API must provide as part of the
+    #   URL after the domain name. This value must be unique for all of the
+    #   mappings across a single API. Specify '(none)' if you do not want
+    #   callers to specify any base path name after the domain name.
     #
     # @return [Types::BasePathMapping] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2503,7 +2451,7 @@ module Aws::APIGateway
     # Represents a collection of BasePathMapping resources.
     #
     # @option params [required, String] :domain_name
-    #   \[Required\] The domain name of a BasePathMapping resource.
+    #   The domain name of a BasePathMapping resource.
     #
     # @option params [String] :position
     #   The current pagination position in the paged result set.
@@ -2545,8 +2493,7 @@ module Aws::APIGateway
     # Gets information about the current ClientCertificate resource.
     #
     # @option params [required, String] :client_certificate_id
-    #   \[Required\] The identifier of the ClientCertificate resource to be
-    #   described.
+    #   The identifier of the ClientCertificate resource to be described.
     #
     # @return [Types::ClientCertificate] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2625,11 +2572,10 @@ module Aws::APIGateway
     # Gets information about a Deployment resource.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :deployment_id
-    #   \[Required\] The identifier of the Deployment resource to get
-    #   information about.
+    #   The identifier of the Deployment resource to get information about.
     #
     # @option params [Array<String>] :embed
     #   A query parameter to retrieve the specified embedded resources of the
@@ -2679,7 +2625,7 @@ module Aws::APIGateway
     # Gets information about a Deployments collection.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [String] :position
     #   The current pagination position in the paged result set.
@@ -2722,11 +2668,13 @@ module Aws::APIGateway
       req.send_request(options)
     end
 
+    # Gets a documentation part.
+    #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :documentation_part_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @return [Types::DocumentationPart] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2758,8 +2706,10 @@ module Aws::APIGateway
       req.send_request(options)
     end
 
+    # Gets documentation parts.
+    #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [String] :type
     #   The type of API entities of the to-be-retrieved documentation parts.
@@ -2819,12 +2769,13 @@ module Aws::APIGateway
       req.send_request(options)
     end
 
+    # Gets a documentation version.
+    #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :documentation_version
-    #   \[Required\] The version identifier of the to-be-retrieved
-    #   documentation snapshot.
+    #   The version identifier of the to-be-retrieved documentation snapshot.
     #
     # @return [Types::DocumentationVersion] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2852,8 +2803,10 @@ module Aws::APIGateway
       req.send_request(options)
     end
 
+    # Gets documentation versions.
+    #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [String] :position
     #   The current pagination position in the paged result set.
@@ -2894,7 +2847,7 @@ module Aws::APIGateway
     # intuitive URL that can be called.
     #
     # @option params [required, String] :domain_name
-    #   \[Required\] The name of the DomainName resource.
+    #   The name of the DomainName resource.
     #
     # @return [Types::DomainName] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -3018,14 +2971,14 @@ module Aws::APIGateway
     # Exports a deployed version of a RestApi in a specified format.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :stage_name
-    #   \[Required\] The name of the Stage that will be exported.
+    #   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.
+    #   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
@@ -3078,10 +3031,10 @@ module Aws::APIGateway
     # RestApi.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :response_type
-    #   \[Required\] The response type of the associated GatewayResponse.
+    #   The response type of the associated GatewayResponse.
     #
     # @return [Types::GatewayResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -3121,7 +3074,7 @@ module Aws::APIGateway
     # collection for the supported response types.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [String] :position
     #   The current pagination position in the paged result set. The
@@ -3168,14 +3121,13 @@ module Aws::APIGateway
     # Get the integration settings.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :resource_id
-    #   \[Required\] Specifies a get integration request's resource
-    #   identifier
+    #   Specifies a get integration request's resource identifier
     #
     # @option params [required, String] :http_method
-    #   \[Required\] Specifies a get integration request's HTTP method.
+    #   Specifies a get integration request's HTTP method.
     #
     # @return [Types::Integration] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -3241,19 +3193,16 @@ module Aws::APIGateway
     # Represents a get integration response.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :resource_id
-    #   \[Required\] Specifies a get integration response request's resource
-    #   identifier.
+    #   Specifies a get integration response request's resource identifier.
     #
     # @option params [required, String] :http_method
-    #   \[Required\] Specifies a get integration response request's HTTP
-    #   method.
+    #   Specifies a get integration response request's HTTP method.
     #
     # @option params [required, String] :status_code
-    #   \[Required\] Specifies a get integration response request's status
-    #   code.
+    #   Specifies a get integration response request's status code.
     #
     # @return [Types::IntegrationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -3292,13 +3241,13 @@ module Aws::APIGateway
     # Describe an existing Method resource.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :resource_id
-    #   \[Required\] The Resource identifier for the Method resource.
+    #   The Resource identifier for the Method resource.
     #
     # @option params [required, String] :http_method
-    #   \[Required\] Specifies the method request's HTTP method type.
+    #   Specifies the method request's HTTP method type.
     #
     # @return [Types::Method] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -3378,16 +3327,16 @@ module Aws::APIGateway
     # Describes a MethodResponse resource.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :resource_id
-    #   \[Required\] The Resource identifier for the MethodResponse resource.
+    #   The Resource identifier for the MethodResponse resource.
     #
     # @option params [required, String] :http_method
-    #   \[Required\] The HTTP verb of the Method resource.
+    #   The HTTP verb of the Method resource.
     #
     # @option params [required, String] :status_code
-    #   \[Required\] The status code for the MethodResponse resource.
+    #   The status code for the MethodResponse resource.
     #
     # @return [Types::MethodResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -3422,10 +3371,10 @@ module Aws::APIGateway
     # Describes an existing model defined for a RestApi resource.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The RestApi identifier under which the Model exists.
+    #   The RestApi identifier under which the Model exists.
     #
     # @option params [required, String] :model_name
-    #   \[Required\] The name of the model as an identifier.
+    #   The name of the model as an identifier.
     #
     # @option params [Boolean] :flatten
     #   A query parameter of a Boolean value to resolve (`true`) all external
@@ -3467,10 +3416,10 @@ module Aws::APIGateway
     # payload into the structure of a model.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :model_name
-    #   \[Required\] The name of the model for which to generate a template.
+    #   The name of the model for which to generate a template.
     #
     # @return [Types::Template] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -3497,7 +3446,7 @@ module Aws::APIGateway
     # Describes existing Models defined for a RestApi resource.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [String] :position
     #   The current pagination position in the paged result set.
@@ -3541,10 +3490,10 @@ module Aws::APIGateway
     # Gets a RequestValidator of a given RestApi.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :request_validator_id
-    #   \[Required\] The identifier of the RequestValidator to be retrieved.
+    #   The identifier of the RequestValidator to be retrieved.
     #
     # @return [Types::RequestValidator] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -3577,7 +3526,7 @@ module Aws::APIGateway
     # Gets the RequestValidators collection of a given RestApi.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [String] :position
     #   The current pagination position in the paged result set.
@@ -3618,10 +3567,10 @@ module Aws::APIGateway
     # Lists information about a resource.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :resource_id
-    #   \[Required\] The identifier for the Resource resource.
+    #   The identifier for the Resource resource.
     #
     # @option params [Array<String>] :embed
     #   A query parameter to retrieve the specified resources embedded in the
@@ -3709,7 +3658,7 @@ module Aws::APIGateway
     # Lists information about a collection of Resource resources.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [String] :position
     #   The current pagination position in the paged result set.
@@ -3806,7 +3755,7 @@ module Aws::APIGateway
     # Lists the RestApi resource in the collection.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @return [Types::RestApi] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -3916,15 +3865,15 @@ module Aws::APIGateway
     # Generates a client SDK for a RestApi and Stage.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :stage_name
-    #   \[Required\] The name of the Stage that the SDK will use.
+    #   The name of the Stage that the SDK will use.
     #
     # @option params [required, String] :sdk_type
-    #   \[Required\] The language for the generated SDK. Currently `java`,
-    #   `javascript`, `android`, `objectivec` (for iOS), `swift` (for iOS),
-    #   and `ruby` are supported.
+    #   The language for the generated SDK. Currently `java`, `javascript`,
+    #   `android`, `objectivec` (for iOS), `swift` (for iOS), and `ruby` are
+    #   supported.
     #
     # @option params [Hash<String,String>] :parameters
     #   A string-to-string key-value map of query parameters
@@ -3965,8 +3914,10 @@ module Aws::APIGateway
       req.send_request(options)
     end
 
+    # Gets an SDK type.
+    #
     # @option params [required, String] :id
-    #   \[Required\] The identifier of the queried SdkType instance.
+    #   The identifier of the queried SdkType instance.
     #
     # @return [Types::SdkType] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -4000,6 +3951,8 @@ module Aws::APIGateway
       req.send_request(options)
     end
 
+    # Gets SDK types
+    #
     # @option params [String] :position
     #   The current pagination position in the paged result set.
     #
@@ -4043,10 +3996,10 @@ module Aws::APIGateway
     # Gets information about a Stage resource.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :stage_name
-    #   \[Required\] The name of the Stage resource to get information about.
+    #   The name of the Stage resource to get information about.
     #
     # @return [Types::Stage] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -4122,7 +4075,7 @@ module Aws::APIGateway
     # Gets information about one or more Stage resources.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [String] :deployment_id
     #   The stages' deployment identifiers.
@@ -4186,7 +4139,7 @@ module Aws::APIGateway
     # Gets the Tags collection for a given resource.
     #
     # @option params [required, String] :resource_arn
-    #   \[Required\] The ARN of a resource that can be tagged.
+    #   The ARN of a resource that can be tagged.
     #
     # @option params [String] :position
     #   (Not currently supported) The current pagination position in the paged
@@ -4223,16 +4176,16 @@ module Aws::APIGateway
     # Gets the usage data of a usage plan in a specified time interval.
     #
     # @option params [required, String] :usage_plan_id
-    #   \[Required\] The Id of the usage plan associated with the usage data.
+    #   The Id of the usage plan associated with the usage data.
     #
     # @option params [String] :key_id
     #   The Id of the API key associated with the resultant usage data.
     #
     # @option params [required, String] :start_date
-    #   \[Required\] The starting date (e.g., 2016-01-01) of the usage data.
+    #   The starting date (e.g., 2016-01-01) of the usage data.
     #
     # @option params [required, String] :end_date
-    #   \[Required\] The ending date (e.g., 2016-12-31) of the usage data.
+    #   The ending date (e.g., 2016-12-31) of the usage data.
     #
     # @option params [String] :position
     #   The current pagination position in the paged result set.
@@ -4283,7 +4236,7 @@ module Aws::APIGateway
     # Gets a usage plan of a given plan identifier.
     #
     # @option params [required, String] :usage_plan_id
-    #   \[Required\] The identifier of the UsagePlan resource to be retrieved.
+    #   The identifier of the UsagePlan resource to be retrieved.
     #
     # @return [Types::UsagePlan] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -4332,13 +4285,13 @@ module Aws::APIGateway
     # Gets a usage plan key of a given key identifier.
     #
     # @option params [required, String] :usage_plan_id
-    #   \[Required\] The Id of the UsagePlan resource representing the usage
-    #   plan containing the to-be-retrieved UsagePlanKey resource representing
-    #   a plan customer.
+    #   The Id of the UsagePlan resource representing the usage plan
+    #   containing the to-be-retrieved UsagePlanKey resource representing a
+    #   plan customer.
     #
     # @option params [required, String] :key_id
-    #   \[Required\] The key Id of the to-be-retrieved UsagePlanKey resource
-    #   representing a plan customer.
+    #   The key Id of the to-be-retrieved UsagePlanKey resource representing a
+    #   plan customer.
     #
     # @return [Types::UsagePlanKey] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -4372,9 +4325,9 @@ module Aws::APIGateway
     # specified usage plan.
     #
     # @option params [required, String] :usage_plan_id
-    #   \[Required\] The Id of the UsagePlan resource representing the usage
-    #   plan containing the to-be-retrieved UsagePlanKey resource representing
-    #   a plan customer.
+    #   The Id of the UsagePlan resource representing the usage plan
+    #   containing the to-be-retrieved UsagePlanKey resource representing a
+    #   plan customer.
     #
     # @option params [String] :position
     #   The current pagination position in the paged result set.
@@ -4478,8 +4431,8 @@ module Aws::APIGateway
     # Gets a specified VPC link under the caller's account in a region.
     #
     # @option params [required, String] :vpc_link_id
-    #   \[Required\] The identifier of the VpcLink. It is used in an
-    #   Integration to reference this VpcLink.
+    #   The identifier of the VpcLink. It is used in an Integration to
+    #   reference this VpcLink.
     #
     # @return [Types::VpcLink] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -4565,11 +4518,7 @@ module Aws::APIGateway
     #
     # @option params [required, String, StringIO, File] :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.
     #
     # @option params [required, String] :format
     #   A query parameter to specify the input format to imported API keys.
@@ -4606,8 +4555,10 @@ module Aws::APIGateway
       req.send_request(options)
     end
 
+    # Imports documentation parts
+    #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [String] :mode
     #   A query parameter to indicate whether to overwrite (`OVERWRITE`) any
@@ -4620,9 +4571,8 @@ module Aws::APIGateway
     #   The default value is `false`.
     #
     # @option params [required, String, StringIO, File] :body
-    #   \[Required\] Raw byte array representing the to-be-imported
-    #   documentation parts. To import from an OpenAPI file, this is a JSON
-    #   object.
+    #   Raw byte array representing the to-be-imported 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:
     #
@@ -4680,17 +4630,13 @@ module Aws::APIGateway
     #   For example, the AWS CLI command to exclude documentation from the
     #   imported API is:
     #
-    #       aws apigateway import-rest-api --parameters ignore=documentation --body 'file:///path/to/imported-api-body.json'
-    #
     #   The AWS CLI command to set the regional endpoint on the imported API
     #   is:
     #
-    #       aws apigateway import-rest-api --parameters endpointConfigurationTypes=REGIONAL --body 'file:///path/to/imported-api-body.json'
-    #
     # @option params [required, String, StringIO, File] :body
-    #   \[Required\] The POST request body containing external API
-    #   definitions. Currently, only OpenAPI definition JSON/YAML files are
-    #   supported. The maximum size of the API definition file is 6MB.
+    #   The POST request body containing external API definitions. Currently,
+    #   only OpenAPI definition JSON/YAML files are supported. The maximum
+    #   size of the API definition file is 6MB.
     #
     # @return [Types::RestApi] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -4751,10 +4697,10 @@ module Aws::APIGateway
     # type and status code on the given RestApi.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :response_type
-    #   \[Required\] The response type of the associated GatewayResponse.
+    #   The response type of the associated GatewayResponse
     #
     # @option params [String] :status_code
     #   The HTTP status code of the GatewayResponse.
@@ -4809,52 +4755,45 @@ module Aws::APIGateway
     # Sets up a method's integration.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :resource_id
-    #   \[Required\] Specifies a put integration request's resource ID.
+    #   Specifies a put integration request's resource ID.
     #
     # @option params [required, String] :http_method
-    #   \[Required\] Specifies a put integration request's HTTP method.
+    #   Specifies the HTTP method for the integration.
     #
     # @option params [required, String] :type
-    #   \[Required\] Specifies a put integration input's type.
+    #   Specifies a put integration input's type.
     #
     # @option params [String] :integration_http_method
-    #   Specifies a put integration HTTP method. When the integration type is
-    #   HTTP or AWS, this field is required.
+    #   The HTTP method for the integration.
     #
     # @option params [String] :uri
     #   Specifies Uniform Resource Identifier (URI) of the integration
-    #   endpoint.
-    #
-    #   * 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.
-    #
-    #   * For `AWS` or `AWS_PROXY` integrations, the URI is of the form
-    #     `arn:aws:apigateway:\{region\}:\{subdomain.service|service\}:path|action/\{service_api\}`.
-    #     Here, `\{Region\}` is the API Gateway region (e.g., `us-east-1`);
-    #     `\{service\}` is the name of the integrated AWS service (e.g.,
-    #     `s3`); and `\{subdomain\}` is a designated subdomain supported by
-    #     certain AWS service for fast host-name lookup. `action` can be used
-    #     for an AWS service action-based API, using an
-    #     `Action=\{name\}&\{p1\}=\{v1\}&p2=\{v2\}...` query string. The
-    #     ensuing `\{service_api\}` refers to a supported action `\{name\}`
-    #     plus any required input parameters. Alternatively, `path` can be
-    #     used for an AWS service path-based API. The ensuing `service_api`
-    #     refers to the path to an AWS service resource, including the region
-    #     of the integrated AWS service, if applicable. For example, for
-    #     integration with the S3 API of `GetObject`, the `uri` can be 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
+    #   endpoint. For HTTP or `HTTP_PROXY` integrations, the URI must be a
+    #   fully formed, encoded HTTP(S) URL according to the RFC-3986
+    #   specification, 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`\\}.
+    #   Here, \\\{Region\\} is the API Gateway region (e.g., us-east-1);
+    #   \\\{service\\} is the name of the integrated Amazon Web Services
+    #   service (e.g., s3); and \\\{subdomain\\} is a designated subdomain
+    #   supported by certain Amazon Web Services service for fast host-name
+    #   lookup. action can be used for an Amazon Web Services service
+    #   action-based API, using an
+    #   Action=\\\{name\\}&amp;\\\{p1\\}=\\\{v1\\}&amp;p2=\\\{v2\\}... query
+    #   string. The ensuing \\\{service\_api\\} refers to a supported action
+    #   \\\{name\\} plus any required input parameters. Alternatively, path
+    #   can be used for an Amazon Web Services service path-based API. The
+    #   ensuing service\_api refers to the path to an Amazon Web Services
+    #   service resource, including the region of the integrated Amazon Web
+    #   Services service, if applicable. For example, for integration with the
+    #   S3 API of `GetObject`, the `uri` can be 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\}`.
     #
     # @option params [String] :connection_type
     #   The type of the network connection to the integration endpoint. The
@@ -4863,12 +4802,8 @@ 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 of the VpcLink used for the integration. Specify this value
+    #   only if you specify `VPC_LINK` as the connection type.
     #
     # @option params [String] :credentials
     #   Specifies whether credentials are required for a put integration.
@@ -4897,17 +4832,6 @@ module Aws::APIGateway
     #   Integration resource. There are three valid values: `WHEN_NO_MATCH`,
     #   `WHEN_NO_TEMPLATES`, and `NEVER`.
     #
-    #   * `WHEN_NO_MATCH` passes the request body for unmapped content types
-    #     through to the integration back end without transformation.
-    #
-    #   * `NEVER` rejects unmapped content types with an HTTP 415
-    #     'Unsupported Media Type' response.
-    #
-    #   * `WHEN_NO_TEMPLATES` allows pass-through when the integration has NO
-    #     content types mapped to templates. However if there is at least one
-    #     content type defined, unmapped content types will be rejected with
-    #     the same 415 response.
-    #
     # @option params [String] :cache_namespace
     #   Specifies a group of related cached parameters. By default, API
     #   Gateway uses the resource ID as the `cacheNamespace`. You can specify
@@ -4924,12 +4848,6 @@ module Aws::APIGateway
     #   Supported values are `CONVERT_TO_BINARY` and `CONVERT_TO_TEXT`, with
     #   the following behaviors:
     #
-    #   * `CONVERT_TO_BINARY`\: Converts a request payload from a
-    #     Base64-encoded string to the corresponding binary blob.
-    #
-    #   * `CONVERT_TO_TEXT`\: Converts a request payload from a binary blob to
-    #     a Base64-encoded string.
-    #
     #   If this property is not defined, the request payload will be passed
     #   through from the method request to integration request without
     #   modification, provided that the `passthroughBehavior` is configured to
@@ -4940,6 +4858,7 @@ module Aws::APIGateway
     #   is 29,000 milliseconds or 29 seconds.
     #
     # @option params [Types::TlsConfig] :tls_config
+    #   Specifies the TLS configuration for an integration.
     #
     # @return [Types::Integration] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -5025,19 +4944,17 @@ module Aws::APIGateway
     # Represents a put integration.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :resource_id
-    #   \[Required\] Specifies a put integration response request's resource
-    #   identifier.
+    #   Specifies a put integration response request's resource identifier.
     #
     # @option params [required, String] :http_method
-    #   \[Required\] Specifies a put integration response request's HTTP
-    #   method.
+    #   Specifies a put integration response request's HTTP method.
     #
     # @option params [required, String] :status_code
-    #   \[Required\] Specifies the status code that is used to map the
-    #   integration response to an existing MethodResponse.
+    #   Specifies the status code that is used to map the integration response
+    #   to an existing MethodResponse.
     #
     # @option params [String] :selection_pattern
     #   Specifies the selection pattern of a put integration response.
@@ -5063,12 +4980,6 @@ module Aws::APIGateway
     #   Supported values are `CONVERT_TO_BINARY` and `CONVERT_TO_TEXT`, with
     #   the following behaviors:
     #
-    #   * `CONVERT_TO_BINARY`\: Converts a response payload from a
-    #     Base64-encoded string to the corresponding binary blob.
-    #
-    #   * `CONVERT_TO_TEXT`\: Converts a response payload from a binary blob
-    #     to a Base64-encoded string.
-    #
     #   If this property is not defined, the response payload will be passed
     #   through from the integration response to the method response without
     #   modification.
@@ -5118,19 +5029,19 @@ module Aws::APIGateway
     # Add a method to an existing Resource resource.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :resource_id
-    #   \[Required\] The Resource identifier for the new Method resource.
+    #   The Resource identifier for the new Method resource.
     #
     # @option params [required, String] :http_method
-    #   \[Required\] Specifies the method request's HTTP method type.
+    #   Specifies the method request's HTTP method type.
     #
     # @option params [required, String] :authorization_type
-    #   \[Required\] The method's authorization type. Valid values are `NONE`
-    #   for open access, `AWS_IAM` for using AWS IAM permissions, `CUSTOM` for
-    #   using a custom authorizer, or `COGNITO_USER_POOLS` for using a Cognito
-    #   user pool.
+    #   The method's authorization type. Valid values are `NONE` for open
+    #   access, `AWS_IAM` for using AWS IAM permissions, `CUSTOM` for using a
+    #   custom authorizer, or `COGNITO_USER_POOLS` for using a Cognito user
+    #   pool.
     #
     # @option params [String] :authorizer_id
     #   Specifies the identifier of an Authorizer to use on this Method, if
@@ -5267,16 +5178,16 @@ module Aws::APIGateway
     # Adds a MethodResponse to an existing Method resource.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :resource_id
-    #   \[Required\] The Resource identifier for the Method resource.
+    #   The Resource identifier for the Method resource.
     #
     # @option params [required, String] :http_method
-    #   \[Required\] The HTTP verb of the Method resource.
+    #   The HTTP verb of the Method resource.
     #
     # @option params [required, String] :status_code
-    #   \[Required\] The method response's status code.
+    #   The method response's status code.
     #
     # @option params [Hash<String,Boolean>] :response_parameters
     #   A key-value map specifying required or optional response parameters
@@ -5341,7 +5252,7 @@ module Aws::APIGateway
     # overwriting the existing API.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [String] :mode
     #   The `mode` query parameter to specify the update mode. Valid values
@@ -5361,9 +5272,9 @@ module Aws::APIGateway
     #   ignore=documentation --body 'file:///path/to/imported-api-body.json'`.
     #
     # @option params [required, String, StringIO, File] :body
-    #   \[Required\] The PUT request body containing external API definitions.
-    #   Currently, only OpenAPI definition JSON/YAML files are supported. The
-    #   maximum size of the API definition file is 6MB.
+    #   The PUT request body containing external API definitions. Currently,
+    #   only OpenAPI definition JSON/YAML files are supported. The maximum
+    #   size of the API definition file is 6MB.
     #
     # @return [Types::RestApi] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -5425,10 +5336,10 @@ module Aws::APIGateway
     # Adds or updates a tag on a given resource.
     #
     # @option params [required, String] :resource_arn
-    #   \[Required\] The ARN of a resource that can be tagged.
+    #   The ARN of a resource that can be tagged.
     #
     # @option params [required, Hash<String,String>] :tags
-    #   \[Required\] The key-value map of strings. The valid character set is
+    #   The key-value map of strings. The valid character set is
     #   \[a-zA-Z+-=.\_:/\]. The tag key can be up to 128 characters and must
     #   not start with `aws:`. The tag value can be up to 256 characters.
     #
@@ -5453,48 +5364,36 @@ module Aws::APIGateway
     # Simulate the execution of an Authorizer in your RestApi with headers,
     # parameters, and an incoming request body.
     #
-    # <div class="seeAlso" markdown="1">
-    # [Use Lambda Function as Authorizer][1] [Use Cognito User Pool as
-    # Authorizer][2]
-    # </div>
-    #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-use-lambda-authorizer.html
-    # [2]: https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-integrate-with-cognito.html
-    #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :authorizer_id
-    #   \[Required\] Specifies a test invoke authorizer request's Authorizer
-    #   ID.
+    #   Specifies a test invoke authorizer request's Authorizer ID.
     #
     # @option params [Hash<String,String>] :headers
-    #   \[Required\] A key-value map of headers to simulate an incoming
-    #   invocation request. This is where the incoming authorization token, or
-    #   identity source, should be specified.
+    #   A key-value map of headers to simulate an incoming 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.
+    #   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
-    #   string parameters.
+    #   The URI path, including query string, of the simulated invocation
+    #   request. Use this to specify path parameters and query string
+    #   parameters.
     #
     # @option params [String] :body
-    #   \[Optional\] The simulated request body of an incoming invocation
-    #   request.
+    #   The simulated request body of an incoming invocation request.
     #
     # @option params [Hash<String,String>] :stage_variables
     #   A key-value map of stage variables to simulate an invocation on a
     #   deployed Stage.
     #
     # @option params [Hash<String,String>] :additional_context
-    #   \[Optional\] A key-value map of additional context variables.
+    #   A key-value map of additional context variables.
     #
     # @return [Types::TestInvokeAuthorizerResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -5547,17 +5446,17 @@ module Aws::APIGateway
       req.send_request(options)
     end
 
-    # Simulate the execution of a Method in your RestApi with headers,
+    # Simulate the invocation of a Method in your RestApi with headers,
     # parameters, and an incoming request body.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :resource_id
-    #   \[Required\] Specifies a test invoke method request's resource ID.
+    #   Specifies a test invoke method request's resource ID.
     #
     # @option params [required, String] :http_method
-    #   \[Required\] Specifies a test invoke method request's HTTP method.
+    #   Specifies a test invoke method request's HTTP method.
     #
     # @option params [String] :path_with_query_string
     #   The URI path, including query string, of the simulated invocation
@@ -5634,10 +5533,10 @@ module Aws::APIGateway
     # Removes a tag from a given resource.
     #
     # @option params [required, String] :resource_arn
-    #   \[Required\] The ARN of a resource that can be tagged.
+    #   The ARN of a resource that can be tagged.
     #
     # @option params [required, Array<String>] :tag_keys
-    #   \[Required\] The Tag keys to delete.
+    #   The Tag keys to delete.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -5658,8 +5557,12 @@ module Aws::APIGateway
     # Changes information about the current Account resource.
     #
     # @option params [Array<Types::PatchOperation>] :patch_operations
-    #   A list of update operations to be applied to the specified resource
-    #   and in the order specified in this list.
+    #   For more information about supported patch operations, see [Patch
+    #   Operations][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/apigateway/latest/api/patch-operations.html
     #
     # @return [Types::Account] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -5700,11 +5603,15 @@ module Aws::APIGateway
     # Changes information about an ApiKey resource.
     #
     # @option params [required, String] :api_key
-    #   \[Required\] The identifier of the ApiKey resource to be updated.
+    #   The identifier of the ApiKey resource to be updated.
     #
     # @option params [Array<Types::PatchOperation>] :patch_operations
-    #   A list of update operations to be applied to the specified resource
-    #   and in the order specified in this list.
+    #   For more information about supported patch operations, see [Patch
+    #   Operations][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/apigateway/latest/api/patch-operations.html
     #
     # @return [Types::ApiKey] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -5757,23 +5664,19 @@ module Aws::APIGateway
 
     # Updates an existing Authorizer resource.
     #
-    # <div class="seeAlso" markdown="1">
-    # [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.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :authorizer_id
-    #   \[Required\] The identifier of the Authorizer resource.
+    #   The identifier of the Authorizer resource.
     #
     # @option params [Array<Types::PatchOperation>] :patch_operations
-    #   A list of update operations to be applied to the specified resource
-    #   and in the order specified in this list.
+    #   For more information about supported patch operations, see [Patch
+    #   Operations][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/apigateway/latest/api/patch-operations.html
     #
     # @return [Types::Authorizer] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -5827,17 +5730,20 @@ module Aws::APIGateway
     # Changes information about the BasePathMapping resource.
     #
     # @option params [required, String] :domain_name
-    #   \[Required\] The domain name of the BasePathMapping resource to
-    #   change.
+    #   The domain name of the BasePathMapping resource to change.
     #
     # @option params [required, String] :base_path
-    #   \[Required\] The base path of the BasePathMapping resource to change.
+    #   The base path of the BasePathMapping resource to change.
     #
     #   To specify an empty base path, set this parameter to `'(none)'`.
     #
     # @option params [Array<Types::PatchOperation>] :patch_operations
-    #   A list of update operations to be applied to the specified resource
-    #   and in the order specified in this list.
+    #   For more information about supported patch operations, see [Patch
+    #   Operations][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/apigateway/latest/api/patch-operations.html
     #
     # @return [Types::BasePathMapping] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -5876,12 +5782,15 @@ module Aws::APIGateway
     # Changes information about an ClientCertificate resource.
     #
     # @option params [required, String] :client_certificate_id
-    #   \[Required\] The identifier of the ClientCertificate resource to be
-    #   updated.
+    #   The identifier of the ClientCertificate resource to be updated.
     #
     # @option params [Array<Types::PatchOperation>] :patch_operations
-    #   A list of update operations to be applied to the specified resource
-    #   and in the order specified in this list.
+    #   For more information about supported patch operations, see [Patch
+    #   Operations][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/apigateway/latest/api/patch-operations.html
     #
     # @return [Types::ClientCertificate] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -5926,15 +5835,19 @@ module Aws::APIGateway
     # Changes information about a Deployment resource.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :deployment_id
     #   The replacement identifier for the Deployment resource to change
     #   information about.
     #
     # @option params [Array<Types::PatchOperation>] :patch_operations
-    #   A list of update operations to be applied to the specified resource
-    #   and in the order specified in this list.
+    #   For more information about supported patch operations, see [Patch
+    #   Operations][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/apigateway/latest/api/patch-operations.html
     #
     # @return [Types::Deployment] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -5975,15 +5888,21 @@ module Aws::APIGateway
       req.send_request(options)
     end
 
+    # Updates a documentation part.
+    #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :documentation_part_id
-    #   \[Required\] The identifier of the to-be-updated documentation part.
+    #   The identifier of the to-be-updated documentation part.
     #
     # @option params [Array<Types::PatchOperation>] :patch_operations
-    #   A list of update operations to be applied to the specified resource
-    #   and in the order specified in this list.
+    #   For more information about supported patch operations, see [Patch
+    #   Operations][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/apigateway/latest/api/patch-operations.html
     #
     # @return [Types::DocumentationPart] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -6023,16 +5942,21 @@ module Aws::APIGateway
       req.send_request(options)
     end
 
+    # Updates a documentation version.
+    #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi..
+    #   The string identifier of the associated RestApi..
     #
     # @option params [required, String] :documentation_version
-    #   \[Required\] The version identifier of the to-be-updated documentation
-    #   version.
+    #   The version identifier of the to-be-updated documentation version.
     #
     # @option params [Array<Types::PatchOperation>] :patch_operations
-    #   A list of update operations to be applied to the specified resource
-    #   and in the order specified in this list.
+    #   For more information about supported patch operations, see [Patch
+    #   Operations][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/apigateway/latest/api/patch-operations.html
     #
     # @return [Types::DocumentationVersion] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -6071,11 +5995,15 @@ module Aws::APIGateway
     # Changes information about the DomainName resource.
     #
     # @option params [required, String] :domain_name
-    #   \[Required\] The name of the DomainName resource to be changed.
+    #   The name of the DomainName resource to be changed.
     #
     # @option params [Array<Types::PatchOperation>] :patch_operations
-    #   A list of update operations to be applied to the specified resource
-    #   and in the order specified in this list.
+    #   For more information about supported patch operations, see [Patch
+    #   Operations][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/apigateway/latest/api/patch-operations.html
     #
     # @return [Types::DomainName] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -6149,14 +6077,18 @@ module Aws::APIGateway
     # RestApi.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :response_type
-    #   \[Required\] The response type of the associated GatewayResponse.
+    #   The response type of the associated GatewayResponse.
     #
     # @option params [Array<Types::PatchOperation>] :patch_operations
-    #   A list of update operations to be applied to the specified resource
-    #   and in the order specified in this list.
+    #   For more information about supported patch operations, see [Patch
+    #   Operations][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/apigateway/latest/api/patch-operations.html
     #
     # @return [Types::GatewayResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -6201,18 +6133,21 @@ module Aws::APIGateway
     # Represents an update integration.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :resource_id
-    #   \[Required\] Represents an update integration request's resource
-    #   identifier.
+    #   Represents an update integration request's resource identifier.
     #
     # @option params [required, String] :http_method
-    #   \[Required\] Represents an update integration request's HTTP method.
+    #   Represents an update integration request's HTTP method.
     #
     # @option params [Array<Types::PatchOperation>] :patch_operations
-    #   A list of update operations to be applied to the specified resource
-    #   and in the order specified in this list.
+    #   For more information about supported patch operations, see [Patch
+    #   Operations][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/apigateway/latest/api/patch-operations.html
     #
     # @return [Types::Integration] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -6286,23 +6221,25 @@ module Aws::APIGateway
     # Represents an update integration response.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :resource_id
-    #   \[Required\] Specifies an update integration response request's
-    #   resource identifier.
+    #   Specifies an update integration response request's resource
+    #   identifier.
     #
     # @option params [required, String] :http_method
-    #   \[Required\] Specifies an update integration response request's HTTP
-    #   method.
+    #   Specifies an update integration response request's HTTP method.
     #
     # @option params [required, String] :status_code
-    #   \[Required\] Specifies an update integration response request's
-    #   status code.
+    #   Specifies an update integration response request's status code.
     #
     # @option params [Array<Types::PatchOperation>] :patch_operations
-    #   A list of update operations to be applied to the specified resource
-    #   and in the order specified in this list.
+    #   For more information about supported patch operations, see [Patch
+    #   Operations][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/apigateway/latest/api/patch-operations.html
     #
     # @return [Types::IntegrationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -6349,17 +6286,21 @@ module Aws::APIGateway
     # Updates an existing Method resource.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :resource_id
-    #   \[Required\] The Resource identifier for the Method resource.
+    #   The Resource identifier for the Method resource.
     #
     # @option params [required, String] :http_method
-    #   \[Required\] The HTTP verb of the Method resource.
+    #   The HTTP verb of the Method resource.
     #
     # @option params [Array<Types::PatchOperation>] :patch_operations
-    #   A list of update operations to be applied to the specified resource
-    #   and in the order specified in this list.
+    #   For more information about supported patch operations, see [Patch
+    #   Operations][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/apigateway/latest/api/patch-operations.html
     #
     # @return [Types::Method] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -6447,20 +6388,24 @@ module Aws::APIGateway
     # Updates an existing MethodResponse resource.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :resource_id
-    #   \[Required\] The Resource identifier for the MethodResponse resource.
+    #   The Resource identifier for the MethodResponse resource.
     #
     # @option params [required, String] :http_method
-    #   \[Required\] The HTTP verb of the Method resource.
+    #   The HTTP verb of the Method resource.
     #
     # @option params [required, String] :status_code
-    #   \[Required\] The status code for the MethodResponse resource.
+    #   The status code for the MethodResponse resource.
     #
     # @option params [Array<Types::PatchOperation>] :patch_operations
-    #   A list of update operations to be applied to the specified resource
-    #   and in the order specified in this list.
+    #   For more information about supported patch operations, see [Patch
+    #   Operations][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/apigateway/latest/api/patch-operations.html
     #
     # @return [Types::MethodResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -6503,14 +6448,18 @@ module Aws::APIGateway
     # Changes information about a model.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :model_name
-    #   \[Required\] The name of the model to update.
+    #   The name of the model to update.
     #
     # @option params [Array<Types::PatchOperation>] :patch_operations
-    #   A list of update operations to be applied to the specified resource
-    #   and in the order specified in this list.
+    #   For more information about supported patch operations, see [Patch
+    #   Operations][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/apigateway/latest/api/patch-operations.html
     #
     # @return [Types::Model] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -6553,14 +6502,18 @@ module Aws::APIGateway
     # Updates a RequestValidator of a given RestApi.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :request_validator_id
-    #   \[Required\] The identifier of RequestValidator to be updated.
+    #   The identifier of RequestValidator to be updated.
     #
     # @option params [Array<Types::PatchOperation>] :patch_operations
-    #   A list of update operations to be applied to the specified resource
-    #   and in the order specified in this list.
+    #   For more information about supported patch operations, see [Patch
+    #   Operations][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/apigateway/latest/api/patch-operations.html
     #
     # @return [Types::RequestValidator] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -6601,14 +6554,18 @@ module Aws::APIGateway
     # Changes information about a Resource resource.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :resource_id
-    #   \[Required\] The identifier of the Resource resource.
+    #   The identifier of the Resource resource.
     #
     # @option params [Array<Types::PatchOperation>] :patch_operations
-    #   A list of update operations to be applied to the specified resource
-    #   and in the order specified in this list.
+    #   For more information about supported patch operations, see [Patch
+    #   Operations][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/apigateway/latest/api/patch-operations.html
     #
     # @return [Types::Resource] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -6694,11 +6651,15 @@ module Aws::APIGateway
     # Changes information about the specified API.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [Array<Types::PatchOperation>] :patch_operations
-    #   A list of update operations to be applied to the specified resource
-    #   and in the order specified in this list.
+    #   For more information about supported patch operations, see [Patch
+    #   Operations][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/apigateway/latest/api/patch-operations.html
     #
     # @return [Types::RestApi] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -6762,15 +6723,18 @@ module Aws::APIGateway
     # Changes information about a Stage resource.
     #
     # @option params [required, String] :rest_api_id
-    #   \[Required\] The string identifier of the associated RestApi.
+    #   The string identifier of the associated RestApi.
     #
     # @option params [required, String] :stage_name
-    #   \[Required\] The name of the Stage resource to change information
-    #   about.
+    #   The name of the Stage resource to change information about.
     #
     # @option params [Array<Types::PatchOperation>] :patch_operations
-    #   A list of update operations to be applied to the specified resource
-    #   and in the order specified in this list.
+    #   For more information about supported patch operations, see [Patch
+    #   Operations][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/apigateway/latest/api/patch-operations.html
     #
     # @return [Types::Stage] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -6855,15 +6819,19 @@ module Aws::APIGateway
     # associated with a specified API key.
     #
     # @option params [required, String] :usage_plan_id
-    #   \[Required\] The Id of the usage plan associated with the usage data.
+    #   The Id of the usage plan associated with the usage data.
     #
     # @option params [required, String] :key_id
-    #   \[Required\] The identifier of the API key associated with the usage
-    #   plan in which a temporary extension is granted to the remaining quota.
+    #   The identifier of the API key associated with the usage plan in which
+    #   a temporary extension is granted to the remaining quota.
     #
     # @option params [Array<Types::PatchOperation>] :patch_operations
-    #   A list of update operations to be applied to the specified resource
-    #   and in the order specified in this list.
+    #   For more information about supported patch operations, see [Patch
+    #   Operations][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/apigateway/latest/api/patch-operations.html
     #
     # @return [Types::Usage] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -6909,11 +6877,15 @@ module Aws::APIGateway
     # Updates a usage plan of a given plan Id.
     #
     # @option params [required, String] :usage_plan_id
-    #   \[Required\] The Id of the to-be-updated usage plan.
+    #   The Id of the to-be-updated usage plan.
     #
     # @option params [Array<Types::PatchOperation>] :patch_operations
-    #   A list of update operations to be applied to the specified resource
-    #   and in the order specified in this list.
+    #   For more information about supported patch operations, see [Patch
+    #   Operations][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/apigateway/latest/api/patch-operations.html
     #
     # @return [Types::UsagePlan] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -6970,12 +6942,16 @@ module Aws::APIGateway
     # Updates an existing VpcLink of a specified identifier.
     #
     # @option params [required, String] :vpc_link_id
-    #   \[Required\] The identifier of the VpcLink. It is used in an
-    #   Integration to reference this VpcLink.
+    #   The identifier of the VpcLink. It is used in an Integration to
+    #   reference this VpcLink.
     #
     # @option params [Array<Types::PatchOperation>] :patch_operations
-    #   A list of update operations to be applied to the specified resource
-    #   and in the order specified in this list.
+    #   For more information about supported patch operations, see [Patch
+    #   Operations][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/apigateway/latest/api/patch-operations.html
     #
     # @return [Types::VpcLink] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -7033,7 +7009,7 @@ module Aws::APIGateway
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-apigateway'
-      context[:gem_version] = '1.74.0'
+      context[:gem_version] = '1.77.0'
       Seahorse::Client::Request.new(handlers, context)
     end