RubyGems - aws-sdk-apigateway - Versions diffs - 1.76.0 → 1.77.0 - Mend

aws-sdk-apigateway 1.76.0 → 1.77.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (7) hide show

checksums.yaml +4 -4
data/CHANGELOG.md +5 -0
data/VERSION +1 -1
data/lib/aws-sdk-apigateway/client.rb +481 -507
data/lib/aws-sdk-apigateway/types.rb +609 -1445
data/lib/aws-sdk-apigateway.rb +1 -1
metadata +2 -2

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

@@ -355,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.
     #
@@ -450,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
@@ -501,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`
@@ -591,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
@@ -601,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.
@@ -640,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.
@@ -718,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:
     #
@@ -768,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.
@@ -811,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
@@ -863,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
@@ -956,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:
     #
@@ -1009,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.
@@ -1059,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.
@@ -1144,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.
@@ -1169,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
@@ -1190,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:
     #
@@ -1265,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.
@@ -1399,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.
@@ -1491,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:
     #
@@ -1537,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
@@ -1595,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}.
     #
@@ -1614,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}.
     #
@@ -1647,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)'`.
     #
@@ -1675,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}.
     #
@@ -1697,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}.
     #
@@ -1718,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}.
     #
@@ -1740,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}.
     #
@@ -1766,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}.
     #
@@ -1787,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}.
     #
@@ -1811,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}.
     #
@@ -1840,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}.
     #
@@ -1875,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}.
     #
@@ -1903,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}.
     #
@@ -1936,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}.
     #
@@ -1960,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}.
     #
@@ -1984,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}.
     #
@@ -2008,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}.
     #
@@ -2028,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}.
     #
@@ -2052,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}.
     #
@@ -2073,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}.
     #
@@ -2099,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}.
     #
@@ -2144,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}.
     #
@@ -2238,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
@@ -2352,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:
     #
@@ -2409,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.
@@ -2466,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:
     #
@@ -2505,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.
@@ -2547,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:
     #
@@ -2627,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
@@ -2681,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.
@@ -2724,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:
     #
@@ -2760,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.
@@ -2821,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:
     #
@@ -2854,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.
@@ -2896,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:
     #
@@ -3020,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
@@ -3080,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:
     #
@@ -3123,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
@@ -3170,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:
     #
@@ -3243,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:
     #
@@ -3294,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:
     #
@@ -3380,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:
     #
@@ -3424,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
@@ -3469,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:
     #
@@ -3499,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.
@@ -3543,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:
     #
@@ -3579,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.
@@ -3620,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
@@ -3711,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.
@@ -3808,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:
     #
@@ -3918,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
@@ -3967,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:
     #
@@ -4002,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.
     #
@@ -4045,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:
     #
@@ -4124,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.
@@ -4188,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
@@ -4225,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.
@@ -4285,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:
     #
@@ -4334,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:
     #
@@ -4374,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.
@@ -4480,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:
     #
@@ -4567,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.
@@ -4608,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
@@ -4622,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:
     #
@@ -4682,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:
     #
@@ -4753,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.
@@ -4811,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
@@ -4865,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.
@@ -4899,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
@@ -4926,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
@@ -4942,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:
     #
@@ -5027,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.
@@ -5065,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.
@@ -5120,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
@@ -5269,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
@@ -5343,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
@@ -5363,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:
     #
@@ -5427,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.
     #
@@ -5455,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:
     #
@@ -5549,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
@@ -5636,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}.
     #
@@ -5660,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:
     #
@@ -5702,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:
     #
@@ -5759,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:
     #
@@ -5829,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:
     #
@@ -5878,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:
     #
@@ -5928,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:
     #
@@ -5977,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:
     #
@@ -6025,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:
     #
@@ -6073,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:
     #
@@ -6151,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:
     #
@@ -6203,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:
     #
@@ -6288,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:
     #
@@ -6351,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:
     #
@@ -6449,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:
     #
@@ -6505,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:
     #
@@ -6555,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:
     #
@@ -6603,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:
     #
@@ -6696,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:
     #
@@ -6764,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:
     #
@@ -6857,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:
     #
@@ -6911,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:
     #
@@ -6972,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:
     #
@@ -7035,7 +7009,7 @@ module Aws::APIGateway
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-apigateway'
-      context[:gem_version] = '1.76.0'
+      context[:gem_version] = '1.77.0'
       Seahorse::Client::Request.new(handlers, context)
     end