RubyGems - aws-sdk-apigateway - Versions diffs - 1.9.0 → 1.10.0 - Mend

aws-sdk-apigateway 1.9.0 → 1.10.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 (6) hide show

checksums.yaml +4 -4
data/lib/aws-sdk-apigateway.rb +1 -1
data/lib/aws-sdk-apigateway/client.rb +331 -270
data/lib/aws-sdk-apigateway/client_api.rb +2 -0
data/lib/aws-sdk-apigateway/types.rb +380 -307
metadata +3 -3

checksums.yaml CHANGED

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f00d08b5cb94857cdb5c87951ec35a9487699a66
-  data.tar.gz: b8600cb912484bf24bd34f4e458c439876c536ef
+  metadata.gz: 6ea9b35c945782365efcabb04af42664ed0b15ff
+  data.tar.gz: f36e1c6820f78c33b88e16e8bd33bffc56742ab4
 SHA512:
-  metadata.gz: 96a52394a1b05ba946ad13b52cf4bf74a76e50f8c9344976008f7dc7e434b0fbd41a4efe802f0dc6ff7262ea8497350ec686a21c404b58be03153bfb5c92df2b
-  data.tar.gz: 382e089aac2ec94d6356308148089cbfb49c3a43f7c2bb3ed6198480197c639174a700aa04604e64dd143c32e8689215b0bbe5d9d7fe2530b228f4313b0a4ed3
+  metadata.gz: c0aea8a1b1092316634cd29b56a8ae3f78ce27907d967cb8dec11507c6b0d54ba1f69e272cc6bdfd25934be29e316e9b2af49db384d40a93dd2b41b8215872e0
+  data.tar.gz: e8ea20f13908b5176442391c489efad743ba56c0f769b071f7c09373a4c916f443d6226aa64621b5f7180cd66f225b04608d34c7caf9f3933a4bf3a6ca805ca1

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

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

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

@@ -241,7 +241,7 @@ module Aws::APIGateway
     # [1]: http://docs.aws.amazon.com/cli/latest/reference/apigateway/create-authorizer.html
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [required, String] :name
     #   \[Required\] The name of the authorizer.
@@ -284,11 +284,11 @@ module Aws::APIGateway
     #
     # @option params [String] :identity_source
     #   The identity source for which authorization is requested. * For a
-    #   `TOKEN` 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`.
+    #   `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
@@ -304,16 +304,15 @@ module Aws::APIGateway
     #     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.
-    #   * For a `COGNITO_USER_POOLS` authorizer, this property is not used.
     #
     # @option params [String] :identity_validation_expression
     #   A validation expression for the incoming identity token. For `TOKEN`
     #   authorizers, this value is a regular expression. API Gateway will
-    #   match the incoming token from the client against the specified regular
-    #   expression. It will invoke the authorizer's Lambda function there is
-    #   a match. Otherwise, it will return a 401 Unauthorized response without
-    #   calling the Lambda function. The validation expression does not apply
-    #   to the `REQUEST` authorizer.
+    #   match the `aud` field of the incoming token from the client against
+    #   the specified regular expression. It will invoke the authorizer's
+    #   Lambda function when there is a match. Otherwise, it will return a 401
+    #   Unauthorized response without calling the Lambda function. The
+    #   validation expression does not apply to the `REQUEST` authorizer.
     #
     # @option params [Integer] :authorizer_result_ttl_in_seconds
     #   The TTL in seconds of cached authorizer results. If it equals 0,
@@ -373,7 +372,8 @@ module Aws::APIGateway
     # Creates a new BasePathMapping resource.
     #
     # @option params [required, String] :domain_name
-    #   The domain name of the BasePathMapping resource to create.
+    #   \[Required\] 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
@@ -382,7 +382,7 @@ module Aws::APIGateway
     #   callers to specify a base path name after the domain name.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] 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.
@@ -421,7 +421,7 @@ module Aws::APIGateway
     # callable over the internet.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [String] :stage_name
     #   The name of the Stage resource for the Deployment resource to create.
@@ -588,7 +588,7 @@ module Aws::APIGateway
     # Creates a new domain name.
     #
     # @option params [required, String] :domain_name
-    #   (Required) The name of the DomainName resource.
+    #   \[Required\] The name of the DomainName resource.
     #
     # @option params [String] :certificate_name
     #   The user-friendly name of the certificate that will be used by
@@ -685,24 +685,25 @@ module Aws::APIGateway
     # Adds a new Model resource to an existing RestApi resource.
     #
     # @option params [required, String] :rest_api_id
-    #   The RestApi identifier under which the Model will be created.
+    #   \[Required\] The RestApi identifier under which the Model will be
+    #   created.
     #
     # @option params [required, String] :name
-    #   The name of the model. Must be alphanumeric.
+    #   \[Required\] 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 v4][1] model.
+    #   be [JSON schema draft 4][1] model.
     #
     #
     #
-    #   [1]: http://json-schema.org/documentation.html
+    #   [1]: https://tools.ietf.org/html/draft-zyp-json-schema-04
     #
     # @option params [required, String] :content_type
-    #   The content-type for the model.
+    #   \[Required\] The content-type for the model.
     #
     # @return [Types::Model] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -740,7 +741,7 @@ module Aws::APIGateway
     # Creates a ReqeustValidator of a given RestApi.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [String] :name
     #   The name of the to-be-created RequestValidator.
@@ -787,10 +788,10 @@ module Aws::APIGateway
     # Creates a Resource resource.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [required, String] :parent_id
-    #   The parent resource's identifier.
+    #   \[Required\] The parent resource's identifier.
     #
     # @option params [required, String] :path_part
     #   The last path segment for this resource.
@@ -871,7 +872,7 @@ module Aws::APIGateway
     # Creates a new RestApi resource.
     #
     # @option params [required, String] :name
-    #   The name of the RestApi.
+    #   \[Required\] The name of the RestApi.
     #
     # @option params [String] :description
     #   The description of the RestApi.
@@ -887,15 +888,16 @@ module Aws::APIGateway
     #   the RestApi supports only UTF-8-encoded text payloads.
     #
     # @option params [Integer] :minimum_compression_size
-    #   A nullable integer used to enable (non-negative between 0 and 10485760
-    #   (10M) bytes, inclusive) or disable (null) compression on an API. When
-    #   compression is enabled, compression or decompression are not applied
-    #   on the payload if the payload size is smaller than this value. Setting
-    #   it to zero allows compression for any payload size.
+    #   A nullable integer that is used to enable compression (with
+    #   non-negative between 0 and 10485760 (10M) bytes, inclusive) or disable
+    #   compression (with a null value) on an API. When compression is
+    #   enabled, compression or decompression is not applied on the payload if
+    #   the payload size is smaller than this value. Setting it to zero allows
+    #   compression for any payload size.
     #
     # @option params [String] :api_key_source
-    #   The source of the API key for metring requests according to a usage
-    #   plan. Valid values are * `HEADER` to read the API key from the
+    #   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
@@ -905,6 +907,9 @@ module Aws::APIGateway
     #   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.
+    #
     # @return [Types::RestApi] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::RestApi#id #id} => String
@@ -917,6 +922,7 @@ module Aws::APIGateway
     #   * {Types::RestApi#minimum_compression_size #minimum_compression_size} => Integer
     #   * {Types::RestApi#api_key_source #api_key_source} => String
     #   * {Types::RestApi#endpoint_configuration #endpoint_configuration} => Types::EndpointConfiguration
+    #   * {Types::RestApi#policy #policy} => String
     #
     # @example Request syntax with placeholder values
     #
@@ -931,6 +937,7 @@ module Aws::APIGateway
     #     endpoint_configuration: {
     #       types: ["REGIONAL"], # accepts REGIONAL, EDGE
     #     },
+    #     policy: "String",
     #   })
     #
     # @example Response structure
@@ -948,6 +955,7 @@ module Aws::APIGateway
     #   resp.api_key_source #=> String, one of "HEADER", "AUTHORIZER"
     #   resp.endpoint_configuration.types #=> Array
     #   resp.endpoint_configuration.types[0] #=> String, one of "REGIONAL", "EDGE"
+    #   resp.policy #=> String
     #
     # @overload create_rest_api(params = {})
     # @param [Hash] params ({})
@@ -960,7 +968,7 @@ module Aws::APIGateway
     # for the API.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [required, String] :stage_name
     #   \[Required\] The name for the Stage resource.
@@ -990,9 +998,9 @@ module Aws::APIGateway
     #   The canary deployment settings of this stage.
     #
     # @option params [Hash<String,String>] :tags
-    #   Key/Value map of strings. Valid character set is \[a-zA-Z+-=.\_:/\].
-    #   Tag key can be up to 128 characters and must not start with "aws:".
-    #   Tag value can be up to 256 characters.
+    #   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.
     #
     # @return [Types::Stage] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1084,7 +1092,7 @@ module Aws::APIGateway
     # the associated API stages, specified in the payload.
     #
     # @option params [required, String] :name
-    #   The name of the usage plan.
+    #   \[Required\] The name of the usage plan.
     #
     # @option params [String] :description
     #   The description of the usage plan.
@@ -1156,15 +1164,16 @@ module Aws::APIGateway
     # plan.
     #
     # @option params [required, String] :usage_plan_id
-    #   The Id of the UsagePlan resource representing the usage plan
-    #   containing the to-be-created UsagePlanKey resource representing a plan
-    #   customer.
+    #   \[Required\] 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
-    #   The identifier of a UsagePlanKey resource for a plan customer.
+    #   \[Required\] The identifier of a UsagePlanKey resource for a plan
+    #   customer.
     #
     # @option params [required, String] :key_type
-    #   The type of a UsagePlanKey resource for a plan customer.
+    #   \[Required\] 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:
     #
@@ -1248,7 +1257,7 @@ module Aws::APIGateway
     # Deletes the ApiKey resource.
     #
     # @option params [required, String] :api_key
-    #   The identifier of the ApiKey resource to be deleted.
+    #   \[Required\] The identifier of the ApiKey resource to be deleted.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1276,10 +1285,10 @@ module Aws::APIGateway
     # [1]: http://docs.aws.amazon.com/cli/latest/reference/apigateway/delete-authorizer.html
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [required, String] :authorizer_id
-    #   The identifier of the Authorizer resource.
+    #   \[Required\] The identifier of the Authorizer resource.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1300,10 +1309,12 @@ module Aws::APIGateway
     # Deletes the BasePathMapping resource.
     #
     # @option params [required, String] :domain_name
-    #   The domain name of the BasePathMapping resource to delete.
+    #   \[Required\] The domain name of the BasePathMapping resource to
+    #   delete.
     #
     # @option params [required, String] :base_path
-    #   The base path name of the BasePathMapping resource to delete.
+    #   \[Required\] The base path name of the BasePathMapping resource to
+    #   delete.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1324,7 +1335,8 @@ module Aws::APIGateway
     # Deletes the ClientCertificate resource.
     #
     # @option params [required, String] :client_certificate_id
-    #   The identifier of the ClientCertificate resource to be deleted.
+    #   \[Required\] The identifier of the ClientCertificate resource to be
+    #   deleted.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1345,10 +1357,10 @@ module Aws::APIGateway
     # if there are no Stage resources associated with it.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [required, String] :deployment_id
-    #   The identifier of the Deployment resource to delete.
+    #   \[Required\] The identifier of the Deployment resource to delete.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1414,7 +1426,7 @@ module Aws::APIGateway
     # Deletes the DomainName resource.
     #
     # @option params [required, String] :domain_name
-    #   The name of the DomainName resource to be deleted.
+    #   \[Required\] The name of the DomainName resource to be deleted.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1435,10 +1447,11 @@ module Aws::APIGateway
     # type on the given RestApi and resets it with the default settings.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [required, String] :response_type
-    #   The response type of the associated GatewayResponse. Valid values are
+    #   \[Required\] The response type of the associated GatewayResponse.
+    #   Valid values are
     #   * ACCESS\_DENIED
     #   * API\_CONFIGURATION\_ERROR
     #   * AUTHORIZER\_FAILURE
@@ -1458,7 +1471,7 @@ module Aws::APIGateway
     #   * RESOURCE\_NOT\_FOUND
     #   * THROTTLED
     #   * UNAUTHORIZED
-    #   * UNSUPPORTED\_MEDIA\_TYPES
+    #   * UNSUPPORTED\_MEDIA\_TYPE
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1479,13 +1492,14 @@ module Aws::APIGateway
     # Represents a delete integration.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [required, String] :resource_id
-    #   Specifies a delete integration request's resource identifier.
+    #   \[Required\] Specifies a delete integration request's resource
+    #   identifier.
     #
     # @option params [required, String] :http_method
-    #   Specifies a delete integration request's HTTP method.
+    #   \[Required\] Specifies a delete integration request's HTTP method.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1507,17 +1521,19 @@ module Aws::APIGateway
     # Represents a delete integration response.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [required, String] :resource_id
-    #   Specifies a delete integration response request's resource
-    #   identifier.
+    #   \[Required\] Specifies a delete integration response request's
+    #   resource identifier.
     #
     # @option params [required, String] :http_method
-    #   Specifies a delete integration response request's HTTP method.
+    #   \[Required\] Specifies a delete integration response request's HTTP
+    #   method.
     #
     # @option params [required, String] :status_code
-    #   Specifies a delete integration response request's status code.
+    #   \[Required\] Specifies a delete integration response request's status
+    #   code.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1540,13 +1556,13 @@ module Aws::APIGateway
     # Deletes an existing Method resource.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [required, String] :resource_id
-    #   The Resource identifier for the Method resource.
+    #   \[Required\] The Resource identifier for the Method resource.
     #
     # @option params [required, String] :http_method
-    #   The HTTP verb of the Method resource.
+    #   \[Required\] The HTTP verb of the Method resource.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1568,16 +1584,17 @@ module Aws::APIGateway
     # Deletes an existing MethodResponse resource.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [required, String] :resource_id
-    #   The Resource identifier for the MethodResponse resource.
+    #   \[Required\] The Resource identifier for the MethodResponse resource.
     #
     # @option params [required, String] :http_method
-    #   The HTTP verb of the Method resource.
+    #   \[Required\] The HTTP verb of the Method resource.
     #
     # @option params [required, String] :status_code
-    #   The status code identifier for the MethodResponse resource.
+    #   \[Required\] The status code identifier for the MethodResponse
+    #   resource.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1600,10 +1617,10 @@ module Aws::APIGateway
     # Deletes a model.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [required, String] :model_name
-    #   The name of the model to delete.
+    #   \[Required\] The name of the model to delete.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1624,7 +1641,7 @@ module Aws::APIGateway
     # Deletes a RequestValidator of a given RestApi.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [required, String] :request_validator_id
     #   \[Required\] The identifier of the RequestValidator to be deleted.
@@ -1648,10 +1665,10 @@ module Aws::APIGateway
     # Deletes a Resource resource.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [required, String] :resource_id
-    #   The identifier of the Resource resource.
+    #   \[Required\] The identifier of the Resource resource.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1672,7 +1689,7 @@ module Aws::APIGateway
     # Deletes the specified API.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1692,10 +1709,10 @@ module Aws::APIGateway
     # Deletes a Stage resource.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [required, String] :stage_name
-    #   The name of the Stage resource to delete.
+    #   \[Required\] The name of the Stage resource to delete.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1716,7 +1733,7 @@ module Aws::APIGateway
     # Deletes a usage plan of a given plan Id.
     #
     # @option params [required, String] :usage_plan_id
-    #   The Id of the to-be-deleted usage plan.
+    #   \[Required\] The Id of the to-be-deleted usage plan.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1737,12 +1754,12 @@ module Aws::APIGateway
     # associated usage plan.
     #
     # @option params [required, String] :usage_plan_id
-    #   The Id of the UsagePlan resource representing the usage plan
-    #   containing the to-be-deleted UsagePlanKey resource representing a plan
-    #   customer.
+    #   \[Required\] 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
-    #   The Id of the UsagePlanKey resource to be deleted.
+    #   \[Required\] The Id of the UsagePlanKey resource to be deleted.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1808,10 +1825,10 @@ module Aws::APIGateway
     # Flushes a stage's cache.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [required, String] :stage_name
-    #   The name of the stage to flush its cache.
+    #   \[Required\] The name of the stage to flush its cache.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1891,7 +1908,7 @@ module Aws::APIGateway
     # Gets information about the current ApiKey resource.
     #
     # @option params [required, String] :api_key
-    #   The identifier of the ApiKey resource.
+    #   \[Required\] The identifier of the ApiKey resource.
     #
     # @option params [Boolean] :include_value
     #   A boolean flag to specify whether (`true`) or not (`false`) the result
@@ -1942,7 +1959,8 @@ module Aws::APIGateway
     #   The current pagination position in the paged result set.
     #
     # @option params [Integer] :limit
-    #   The maximum number of returned results per page.
+    #   The maximum number of returned results per page. The default value is
+    #   25 and the maximum value is 500.
     #
     # @option params [String] :name_query
     #   The name of queried API keys.
@@ -2006,10 +2024,10 @@ module Aws::APIGateway
     # [1]: http://docs.aws.amazon.com/cli/latest/reference/apigateway/get-authorizer.html
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [required, String] :authorizer_id
-    #   The identifier of the Authorizer resource.
+    #   \[Required\] The identifier of the Authorizer resource.
     #
     # @return [Types::Authorizer] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2063,13 +2081,14 @@ module Aws::APIGateway
     # [1]: http://docs.aws.amazon.com/cli/latest/reference/apigateway/get-authorizers.html
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [String] :position
     #   The current pagination position in the paged result set.
     #
     # @option params [Integer] :limit
-    #   The maximum number of returned results per page.
+    #   The maximum number of returned results per page. The default value is
+    #   25 and the maximum value is 500.
     #
     # @return [Types::Authorizers] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2110,13 +2129,15 @@ module Aws::APIGateway
     # Describe a BasePathMapping resource.
     #
     # @option params [required, String] :domain_name
-    #   The domain name of the BasePathMapping resource to be described.
+    #   \[Required\] The domain name of the BasePathMapping resource to be
+    #   described.
     #
     # @option params [required, String] :base_path
-    #   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. Leave this blank if you do not want
-    #   callers to specify any base path name after the domain name.
+    #   \[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. Leave this blank 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:
     #
@@ -2147,14 +2168,14 @@ module Aws::APIGateway
     # Represents a collection of BasePathMapping resources.
     #
     # @option params [required, String] :domain_name
-    #   The domain name of a BasePathMapping resource.
+    #   \[Required\] The domain name of a BasePathMapping resource.
     #
     # @option params [String] :position
     #   The current pagination position in the paged result set.
     #
     # @option params [Integer] :limit
-    #   The maximum number of returned results per page. The value is 25 by
-    #   default and could be between 1 - 500.
+    #   The maximum number of returned results per page. The default value is
+    #   25 and the maximum value is 500.
     #
     # @return [Types::BasePathMappings] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2187,7 +2208,8 @@ module Aws::APIGateway
     # Gets information about the current ClientCertificate resource.
     #
     # @option params [required, String] :client_certificate_id
-    #   The identifier of the ClientCertificate resource to be described.
+    #   \[Required\] 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:
     #
@@ -2224,8 +2246,8 @@ module Aws::APIGateway
     #   The current pagination position in the paged result set.
     #
     # @option params [Integer] :limit
-    #   The maximum number of returned results per page. The value is 25 by
-    #   default and could be between 1 - 500.
+    #   The maximum number of returned results per page. The default value is
+    #   25 and the maximum value is 500.
     #
     # @return [Types::ClientCertificates] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2259,10 +2281,11 @@ module Aws::APIGateway
     # Gets information about a Deployment resource.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [required, String] :deployment_id
-    #   The identifier of the Deployment resource to get information about.
+    #   \[Required\] 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
@@ -2312,14 +2335,14 @@ module Aws::APIGateway
     # Gets information about a Deployments collection.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [String] :position
     #   The current pagination position in the paged result set.
     #
     # @option params [Integer] :limit
-    #   The maximum number of returned results per page. The value is 25 by
-    #   default and could be between 1 - 500.
+    #   The maximum number of returned results per page. The default value is
+    #   25 and the maximum value is 500.
     #
     # @return [Types::Deployments] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2405,7 +2428,8 @@ module Aws::APIGateway
     #   The current pagination position in the paged result set.
     #
     # @option params [Integer] :limit
-    #   The maximum number of returned results per page.
+    #   The maximum number of returned results per page. The default value is
+    #   25 and the maximum value is 500.
     #
     # @option params [String] :location_status
     #   The status of the API documentation parts to retrieve. Valid values
@@ -2489,7 +2513,8 @@ module Aws::APIGateway
     #   The current pagination position in the paged result set.
     #
     # @option params [Integer] :limit
-    #   The maximum number of returned results per page.
+    #   The maximum number of returned results per page. The default value is
+    #   25 and the maximum value is 500.
     #
     # @return [Types::DocumentationVersions] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2523,7 +2548,7 @@ module Aws::APIGateway
     # intuitive URL that can be called.
     #
     # @option params [required, String] :domain_name
-    #   The name of the DomainName resource.
+    #   \[Required\] The name of the DomainName resource.
     #
     # @return [Types::DomainName] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2573,8 +2598,8 @@ module Aws::APIGateway
     #   The current pagination position in the paged result set.
     #
     # @option params [Integer] :limit
-    #   The maximum number of returned results per page. The value is 25 by
-    #   default and could be between 1 - 500.
+    #   The maximum number of returned results per page. The default value is
+    #   25 and the maximum value is 500.
     #
     # @return [Types::DomainNames] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2615,13 +2640,14 @@ module Aws::APIGateway
     # Exports a deployed version of a RestApi in a specified format.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [required, String] :stage_name
-    #   The name of the Stage that will be exported.
+    #   \[Required\] The name of the Stage that will be exported.
     #
     # @option params [required, String] :export_type
-    #   The type of export. Currently only 'swagger' is supported.
+    #   \[Required\] The type of export. Currently only 'swagger' is
+    #   supported.
     #
     # @option params [Hash<String,String>] :parameters
     #   A key-value map of query string parameters that specify properties of
@@ -2674,10 +2700,11 @@ module Aws::APIGateway
     # RestApi.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [required, String] :response_type
-    #   The response type of the associated GatewayResponse. Valid values are
+    #   \[Required\] The response type of the associated GatewayResponse.
+    #   Valid values are
     #   * ACCESS\_DENIED
     #   * API\_CONFIGURATION\_ERROR
     #   * AUTHORIZER\_FAILURE
@@ -2697,7 +2724,7 @@ module Aws::APIGateway
     #   * RESOURCE\_NOT\_FOUND
     #   * THROTTLED
     #   * UNAUTHORIZED
-    #   * UNSUPPORTED\_MEDIA\_TYPES
+    #   * UNSUPPORTED\_MEDIA\_TYPE
     #
     # @return [Types::GatewayResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2737,7 +2764,7 @@ module Aws::APIGateway
     # collection for the supported response types.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [String] :position
     #   The current pagination position in the paged result set. The
@@ -2745,9 +2772,9 @@ module Aws::APIGateway
     #   position does not apply here.
     #
     # @option params [Integer] :limit
-    #   The maximum number of returned results per page. The GatewayResponses
-    #   collection does not support pagination and the limit does not apply
-    #   here.
+    #   The maximum number of returned results per page. The default value is
+    #   25 and the maximum value is 500. The GatewayResponses collection does
+    #   not support pagination and the limit does not apply here.
     #
     # @return [Types::GatewayResponses] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2784,13 +2811,14 @@ module Aws::APIGateway
     # Get the integration settings.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [required, String] :resource_id
-    #   Specifies a get integration request's resource identifier
+    #   \[Required\] Specifies a get integration request's resource
+    #   identifier
     #
     # @option params [required, String] :http_method
-    #   Specifies a get integration request's HTTP method.
+    #   \[Required\] Specifies a get integration request's HTTP method.
     #
     # @return [Types::Integration] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2854,16 +2882,19 @@ module Aws::APIGateway
     # Represents a get integration response.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [required, String] :resource_id
-    #   Specifies a get integration response request's resource identifier.
+    #   \[Required\] Specifies a get integration response request's resource
+    #   identifier.
     #
     # @option params [required, String] :http_method
-    #   Specifies a get integration response request's HTTP method.
+    #   \[Required\] Specifies a get integration response request's HTTP
+    #   method.
     #
     # @option params [required, String] :status_code
-    #   Specifies a get integration response request's status code.
+    #   \[Required\] 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:
     #
@@ -2902,13 +2933,13 @@ module Aws::APIGateway
     # Describe an existing Method resource.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [required, String] :resource_id
-    #   The Resource identifier for the Method resource.
+    #   \[Required\] The Resource identifier for the Method resource.
     #
     # @option params [required, String] :http_method
-    #   Specifies the method request's HTTP method type.
+    #   \[Required\] Specifies the method request's HTTP method type.
     #
     # @return [Types::Method] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2987,16 +3018,16 @@ module Aws::APIGateway
     # Describes a MethodResponse resource.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [required, String] :resource_id
-    #   The Resource identifier for the MethodResponse resource.
+    #   \[Required\] The Resource identifier for the MethodResponse resource.
     #
     # @option params [required, String] :http_method
-    #   The HTTP verb of the Method resource.
+    #   \[Required\] The HTTP verb of the Method resource.
     #
     # @option params [required, String] :status_code
-    #   The status code for the MethodResponse resource.
+    #   \[Required\] The status code for the MethodResponse resource.
     #
     # @return [Types::MethodResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -3031,10 +3062,10 @@ module Aws::APIGateway
     # Describes an existing model defined for a RestApi resource.
     #
     # @option params [required, String] :rest_api_id
-    #   The RestApi identifier under which the Model exists.
+    #   \[Required\] The RestApi identifier under which the Model exists.
     #
     # @option params [required, String] :model_name
-    #   The name of the model as an identifier.
+    #   \[Required\] The name of the model as an identifier.
     #
     # @option params [Boolean] :flatten
     #   A query parameter of a Boolean value to resolve (`true`) all external
@@ -3076,10 +3107,10 @@ module Aws::APIGateway
     # payload into the structure of a model.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [required, String] :model_name
-    #   The name of the model for which to generate a template.
+    #   \[Required\] 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:
     #
@@ -3106,14 +3137,14 @@ module Aws::APIGateway
     # Describes existing Models defined for a RestApi resource.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [String] :position
     #   The current pagination position in the paged result set.
     #
     # @option params [Integer] :limit
-    #   The maximum number of returned results per page. The value is 25 by
-    #   default and could be between 1 - 500.
+    #   The maximum number of returned results per page. The default value is
+    #   25 and the maximum value is 500.
     #
     # @return [Types::Models] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -3148,7 +3179,7 @@ module Aws::APIGateway
     # Gets a RequestValidator of a given RestApi.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [required, String] :request_validator_id
     #   \[Required\] The identifier of the RequestValidator to be retrieved.
@@ -3184,13 +3215,14 @@ module Aws::APIGateway
     # Gets the RequestValidators collection of a given RestApi.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [String] :position
     #   The current pagination position in the paged result set.
     #
     # @option params [Integer] :limit
-    #   The maximum number of returned results per page.
+    #   The maximum number of returned results per page. The default value is
+    #   25 and the maximum value is 500.
     #
     # @return [Types::RequestValidators] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -3224,10 +3256,10 @@ module Aws::APIGateway
     # Lists information about a resource.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [required, String] :resource_id
-    #   The identifier for the Resource resource.
+    #   \[Required\] The identifier for the Resource resource.
     #
     # @option params [Array<String>] :embed
     #   A query parameter to retrieve the specified resources embedded in the
@@ -3314,14 +3346,14 @@ module Aws::APIGateway
     # Lists information about a collection of Resource resources.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [String] :position
     #   The current pagination position in the paged result set.
     #
     # @option params [Integer] :limit
-    #   The maximum number of returned results per page. The value is 25 by
-    #   default and could be between 1 - 500.
+    #   The maximum number of returned results per page. The default value is
+    #   25 and the maximum value is 500.
     #
     # @option params [Array<String>] :embed
     #   A query parameter used to retrieve the specified resources embedded in
@@ -3408,7 +3440,7 @@ module Aws::APIGateway
     # Lists the RestApi resource in the collection.
     #
     # @option params [required, String] :rest_api_id
-    #   The identifier of the RestApi resource.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @return [Types::RestApi] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -3422,6 +3454,7 @@ module Aws::APIGateway
     #   * {Types::RestApi#minimum_compression_size #minimum_compression_size} => Integer
     #   * {Types::RestApi#api_key_source #api_key_source} => String
     #   * {Types::RestApi#endpoint_configuration #endpoint_configuration} => Types::EndpointConfiguration
+    #   * {Types::RestApi#policy #policy} => String
     #
     # @example Request syntax with placeholder values
     #
@@ -3444,6 +3477,7 @@ module Aws::APIGateway
     #   resp.api_key_source #=> String, one of "HEADER", "AUTHORIZER"
     #   resp.endpoint_configuration.types #=> Array
     #   resp.endpoint_configuration.types[0] #=> String, one of "REGIONAL", "EDGE"
+    #   resp.policy #=> String
     #
     # @overload get_rest_api(params = {})
     # @param [Hash] params ({})
@@ -3458,8 +3492,8 @@ module Aws::APIGateway
     #   The current pagination position in the paged result set.
     #
     # @option params [Integer] :limit
-    #   The maximum number of returned results per page. The value is 25 by
-    #   default and could be between 1 - 500.
+    #   The maximum number of returned results per page. The default value is
+    #   25 and the maximum value is 500.
     #
     # @return [Types::RestApis] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -3490,6 +3524,7 @@ module Aws::APIGateway
     #   resp.items[0].api_key_source #=> String, one of "HEADER", "AUTHORIZER"
     #   resp.items[0].endpoint_configuration.types #=> Array
     #   resp.items[0].endpoint_configuration.types[0] #=> String, one of "REGIONAL", "EDGE"
+    #   resp.items[0].policy #=> String
     #
     # @overload get_rest_apis(params = {})
     # @param [Hash] params ({})
@@ -3501,15 +3536,15 @@ module Aws::APIGateway
     # Generates a client SDK for a RestApi and Stage.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [required, String] :stage_name
-    #   The name of the Stage that the SDK will use.
+    #   \[Required\] The name of the Stage that the SDK will use.
     #
     # @option params [required, String] :sdk_type
-    #   The language for the generated SDK. Currently `java`, `javascript`,
-    #   `android`, `objectivec` (for iOS), `swift` (for iOS), and `ruby` are
-    #   supported.
+    #   \[Required\] 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
@@ -3551,7 +3586,7 @@ module Aws::APIGateway
     end
     # @option params [required, String] :id
-    #   The identifier of the queried SdkType instance.
+    #   \[Required\] The identifier of the queried SdkType instance.
     #
     # @return [Types::SdkType] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -3589,7 +3624,8 @@ module Aws::APIGateway
     #   The current pagination position in the paged result set.
     #
     # @option params [Integer] :limit
-    #   The maximum number of returned results per page.
+    #   The maximum number of returned results per page. The default value is
+    #   25 and the maximum value is 500.
     #
     # @return [Types::SdkTypes] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -3627,10 +3663,10 @@ module Aws::APIGateway
     # Gets information about a Stage resource.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [required, String] :stage_name
-    #   The name of the Stage resource to get information about.
+    #   \[Required\] 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:
     #
@@ -3702,7 +3738,7 @@ module Aws::APIGateway
     # Gets information about one or more Stage resources.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [String] :deployment_id
     #   The stages' deployment identifiers.
@@ -3764,8 +3800,9 @@ 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. At present,
-    #   Stage is the only taggable resource.
+    #   \[Required\] The ARN of a resource that can be tagged. The resource
+    #   ARN must be URL-encoded. At present, Stage is the only taggable
+    #   resource.
     #
     # @option params [String] :position
     #   (Not currently supported) The current pagination position in the paged
@@ -3773,7 +3810,7 @@ module Aws::APIGateway
     #
     # @option params [Integer] :limit
     #   (Not currently supported) The maximum number of returned results per
-    #   page.
+    #   page. The default value is 25 and the maximum value is 500.
     #
     # @return [Types::Tags] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -3802,22 +3839,23 @@ module Aws::APIGateway
     # Gets the usage data of a usage plan in a specified time interval.
     #
     # @option params [required, String] :usage_plan_id
-    #   The Id of the usage plan associated with the usage data.
+    #   \[Required\] 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
-    #   The starting date (e.g., 2016-01-01) of the usage data.
+    #   \[Required\] The starting date (e.g., 2016-01-01) of the usage data.
     #
     # @option params [required, String] :end_date
-    #   The ending date (e.g., 2016-12-31) of the usage data.
+    #   \[Required\] 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.
     #
     # @option params [Integer] :limit
-    #   The maximum number of returned results per page.
+    #   The maximum number of returned results per page. The default value is
+    #   25 and the maximum value is 500.
     #
     # @return [Types::Usage] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -3859,7 +3897,7 @@ module Aws::APIGateway
     # Gets a usage plan of a given plan identifier.
     #
     # @option params [required, String] :usage_plan_id
-    #   The identifier of the UsagePlan resource to be retrieved.
+    #   \[Required\] 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:
     #
@@ -3902,13 +3940,13 @@ module Aws::APIGateway
     # Gets a usage plan key of a given key identifier.
     #
     # @option params [required, String] :usage_plan_id
-    #   The Id of the UsagePlan resource representing the usage plan
-    #   containing the to-be-retrieved UsagePlanKey resource representing a
-    #   plan customer.
+    #   \[Required\] 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
-    #   The key Id of the to-be-retrieved UsagePlanKey resource representing a
-    #   plan customer.
+    #   \[Required\] 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:
     #
@@ -3942,15 +3980,16 @@ module Aws::APIGateway
     # specified usage plan.
     #
     # @option params [required, String] :usage_plan_id
-    #   The Id of the UsagePlan resource representing the usage plan
-    #   containing the to-be-retrieved UsagePlanKey resource representing a
-    #   plan customer.
+    #   \[Required\] 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.
     #
     # @option params [Integer] :limit
-    #   The maximum number of returned results per page.
+    #   The maximum number of returned results per page. The default value is
+    #   25 and the maximum value is 500.
     #
     # @option params [String] :name_query
     #   A query parameter specifying the name of the to-be-returned usage plan
@@ -3995,7 +4034,8 @@ module Aws::APIGateway
     #   The identifier of the API key associated with the usage plans.
     #
     # @option params [Integer] :limit
-    #   The maximum number of returned results per page.
+    #   The maximum number of returned results per page. The default value is
+    #   25 and the maximum value is 500.
     #
     # @return [Types::UsagePlans] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -4079,7 +4119,8 @@ module Aws::APIGateway
     #   The current pagination position in the paged result set.
     #
     # @option params [Integer] :limit
-    #   The maximum number of returned results per page.
+    #   The maximum number of returned results per page. The default value is
+    #   25 and the maximum value is 500.
     #
     # @return [Types::VpcLinks] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -4238,9 +4279,9 @@ module Aws::APIGateway
     #       aws apigateway import-rest-api --parameters endpointConfigurationTypes=REGIONAL --body 'file:///path/to/imported-api-body.json
     #
     # @option params [required, String, IO] :body
-    #   The POST request body containing external API definitions. Currently,
-    #   only Swagger definition JSON files are supported. The maximum size of
-    #   the API definition file is 2MB.
+    #   \[Required\] The POST request body containing external API
+    #   definitions. Currently, only Swagger definition JSON files are
+    #   supported. The maximum size of the API definition file is 2MB.
     #
     # @return [Types::RestApi] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -4254,6 +4295,7 @@ module Aws::APIGateway
     #   * {Types::RestApi#minimum_compression_size #minimum_compression_size} => Integer
     #   * {Types::RestApi#api_key_source #api_key_source} => String
     #   * {Types::RestApi#endpoint_configuration #endpoint_configuration} => Types::EndpointConfiguration
+    #   * {Types::RestApi#policy #policy} => String
     #
     # @example Request syntax with placeholder values
     #
@@ -4280,6 +4322,7 @@ module Aws::APIGateway
     #   resp.api_key_source #=> String, one of "HEADER", "AUTHORIZER"
     #   resp.endpoint_configuration.types #=> Array
     #   resp.endpoint_configuration.types[0] #=> String, one of "REGIONAL", "EDGE"
+    #   resp.policy #=> String
     #
     # @overload import_rest_api(params = {})
     # @param [Hash] params ({})
@@ -4292,10 +4335,11 @@ module Aws::APIGateway
     # type and status code on the given RestApi.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [required, String] :response_type
-    #   The response type of the associated GatewayResponse. Valid values are
+    #   \[Required\] The response type of the associated GatewayResponse.
+    #   Valid values are
     #   * ACCESS\_DENIED
     #   * API\_CONFIGURATION\_ERROR
     #   * AUTHORIZER\_FAILURE
@@ -4315,7 +4359,7 @@ module Aws::APIGateway
     #   * RESOURCE\_NOT\_FOUND
     #   * THROTTLED
     #   * UNAUTHORIZED
-    #   * UNSUPPORTED\_MEDIA\_TYPES
+    #   * UNSUPPORTED\_MEDIA\_TYPE
     #
     # @option params [String] :status_code
     #   The HTTP status code of the GatewayResponse.
@@ -4370,16 +4414,16 @@ module Aws::APIGateway
     # Sets up a method's integration.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [required, String] :resource_id
-    #   Specifies a put integration request's resource ID.
+    #   \[Required\] Specifies a put integration request's resource ID.
     #
     # @option params [required, String] :http_method
-    #   Specifies a put integration request's HTTP method.
+    #   \[Required\] Specifies a put integration request's HTTP method.
     #
     # @option params [required, String] :type
-    #   Specifies a put integration input's type.
+    #   \[Required\] Specifies a put integration input's type.
     #
     # @option params [String] :integration_http_method
     #   Specifies a put integration HTTP method. When the integration type is
@@ -4574,17 +4618,19 @@ module Aws::APIGateway
     # Represents a put integration.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [required, String] :resource_id
-    #   Specifies a put integration response request's resource identifier.
+    #   \[Required\] Specifies a put integration response request's resource
+    #   identifier.
     #
     # @option params [required, String] :http_method
-    #   Specifies a put integration response request's HTTP method.
+    #   \[Required\] Specifies a put integration response request's HTTP
+    #   method.
     #
     # @option params [required, String] :status_code
-    #   Specifies the status code that is used to map the integration response
-    #   to an existing MethodResponse.
+    #   \[Required\] 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.
@@ -4665,23 +4711,24 @@ module Aws::APIGateway
     # Add a method to an existing Resource resource.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [required, String] :resource_id
-    #   The Resource identifier for the new Method resource.
+    #   \[Required\] The Resource identifier for the new Method resource.
     #
     # @option params [required, String] :http_method
-    #   Specifies the method request's HTTP method type.
+    #   \[Required\] Specifies the method request's HTTP method type.
     #
     # @option params [required, String] :authorization_type
-    #   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.
+    #   \[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.
     #
     # @option params [String] :authorizer_id
     #   Specifies the identifier of an Authorizer to use on this Method, if
-    #   the type is CUSTOM.
+    #   the type is CUSTOM or COGNITO\_USER\_POOLS. The authorizer identifier
+    #   is generated by API Gateway when you created the authorizer.
     #
     # @option params [Boolean] :api_key_required
     #   Specifies whether the method required a valid ApiKey.
@@ -4718,9 +4765,9 @@ module Aws::APIGateway
     #
     # @option params [Array<String>] :authorization_scopes
     #   A list of authorization scopes configured on the method. The scopes
-    #   are used with a `COGNITO_USER_POOL` authorizer to authorize the method
-    #   invocation. The authorization works by matching the method scopes
-    #   against the scopes parsed from the access token in the incoming
+    #   are used with a `COGNITO_USER_POOLS` authorizer to authorize the
+    #   method invocation. The authorization works by matching the method
+    #   scopes against the scopes parsed from the access token in the incoming
     #   request. The method invocation is authorized if any method scopes
     #   matches a claimed scope in the access token. Otherwise, the invocation
     #   is not authorized. When the method scope is configured, the client
@@ -4816,16 +4863,16 @@ module Aws::APIGateway
     # Adds a MethodResponse to an existing Method resource.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [required, String] :resource_id
-    #   The Resource identifier for the Method resource.
+    #   \[Required\] The Resource identifier for the Method resource.
     #
     # @option params [required, String] :http_method
-    #   The HTTP verb of the Method resource.
+    #   \[Required\] The HTTP verb of the Method resource.
     #
     # @option params [required, String] :status_code
-    #   The method response's status code.
+    #   \[Required\] The method response's status code.
     #
     # @option params [Hash<String,Boolean>] :response_parameters
     #   A key-value map specifying required or optional response parameters
@@ -4890,7 +4937,7 @@ module Aws::APIGateway
     # overwriting the existing API.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [String] :mode
     #   The `mode` query parameter to specify the update mode. Valid values
@@ -4910,9 +4957,9 @@ module Aws::APIGateway
     #   ignore=documentation --body 'file:///path/to/imported-api-body.json`.
     #
     # @option params [required, String, IO] :body
-    #   The PUT request body containing external API definitions. Currently,
-    #   only Swagger definition JSON files are supported. The maximum size of
-    #   the API definition file is 2MB.
+    #   \[Required\] The PUT request body containing external API definitions.
+    #   Currently, only Swagger definition JSON files are supported. The
+    #   maximum size of the API definition file is 2MB.
     #
     # @return [Types::RestApi] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -4926,6 +4973,7 @@ module Aws::APIGateway
     #   * {Types::RestApi#minimum_compression_size #minimum_compression_size} => Integer
     #   * {Types::RestApi#api_key_source #api_key_source} => String
     #   * {Types::RestApi#endpoint_configuration #endpoint_configuration} => Types::EndpointConfiguration
+    #   * {Types::RestApi#policy #policy} => String
     #
     # @example Request syntax with placeholder values
     #
@@ -4954,6 +5002,7 @@ module Aws::APIGateway
     #   resp.api_key_source #=> String, one of "HEADER", "AUTHORIZER"
     #   resp.endpoint_configuration.types #=> Array
     #   resp.endpoint_configuration.types[0] #=> String, one of "REGIONAL", "EDGE"
+    #   resp.policy #=> String
     #
     # @overload put_rest_api(params = {})
     # @param [Hash] params ({})
@@ -4962,16 +5011,17 @@ module Aws::APIGateway
       req.send_request(options)
     end
-    # Adds or updates Tags on a gievn resource.
+    # 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. At present,
-    #   Stage is the only taggable resource.
+    #   \[Required\] The ARN of a resource that can be tagged. The resource
+    #   ARN must be URL-encoded. At present, Stage is the only taggable
+    #   resource.
     #
     # @option params [required, Hash<String,String>] :tags
-    #   \[Required\] Key/Value map of strings. Valid character set is
-    #   \[a-zA-Z+-=.\_:/\]. Tag key can be up to 128 characters and must not
-    #   start with "aws:". Tag value can be up to 256 characters.
+    #   \[Required\] 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.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -5003,10 +5053,11 @@ module Aws::APIGateway
     # [1]: http://docs.aws.amazon.com/apigateway/latest/developerguide/use-custom-authorizer.html
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [required, String] :authorizer_id
-    #   Specifies a test invoke authorizer request's Authorizer ID.
+    #   \[Required\] 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
@@ -5081,13 +5132,13 @@ module Aws::APIGateway
     # parameters, and an incoming request body.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [required, String] :resource_id
-    #   Specifies a test invoke method request's resource ID.
+    #   \[Required\] Specifies a test invoke method request's resource ID.
     #
     # @option params [required, String] :http_method
-    #   Specifies a test invoke method request's HTTP method.
+    #   \[Required\] 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
@@ -5150,14 +5201,15 @@ module Aws::APIGateway
       req.send_request(options)
     end
-    # Removes Tags from a given resource.
+    # Removes a tag from a given resource.
     #
     # @option params [required, String] :resource_arn
-    #   \[Required\] The ARN of a resource that can be tagged. At present,
-    #   Stage is the only taggable resource.
+    #   \[Required\] The ARN of a resource that can be tagged. The resource
+    #   ARN must be URL-encoded. At present, Stage is the only taggable
+    #   resource.
     #
     # @option params [required, Array<String>] :tag_keys
-    #   The Tag keys to delete.
+    #   \[Required\] The Tag keys to delete.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -5220,7 +5272,7 @@ module Aws::APIGateway
     # Changes information about an ApiKey resource.
     #
     # @option params [required, String] :api_key
-    #   The identifier of the ApiKey resource to be updated.
+    #   \[Required\] 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
@@ -5283,10 +5335,10 @@ module Aws::APIGateway
     # [1]: http://docs.aws.amazon.com/cli/latest/reference/apigateway/update-authorizer.html
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [required, String] :authorizer_id
-    #   The identifier of the Authorizer resource.
+    #   \[Required\] 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
@@ -5344,10 +5396,11 @@ module Aws::APIGateway
     # Changes information about the BasePathMapping resource.
     #
     # @option params [required, String] :domain_name
-    #   The domain name of the BasePathMapping resource to change.
+    #   \[Required\] The domain name of the BasePathMapping resource to
+    #   change.
     #
     # @option params [required, String] :base_path
-    #   The base path of the BasePathMapping resource to change.
+    #   \[Required\] The base path of the BasePathMapping resource to change.
     #
     # @option params [Array<Types::PatchOperation>] :patch_operations
     #   A list of update operations to be applied to the specified resource
@@ -5390,7 +5443,8 @@ module Aws::APIGateway
     # Changes information about an ClientCertificate resource.
     #
     # @option params [required, String] :client_certificate_id
-    #   The identifier of the ClientCertificate resource to be updated.
+    #   \[Required\] 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
@@ -5436,7 +5490,7 @@ module Aws::APIGateway
     # Changes information about a Deployment resource.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [required, String] :deployment_id
     #   The replacement identifier for the Deployment resource to change
@@ -5581,7 +5635,7 @@ module Aws::APIGateway
     # Changes information about the DomainName resource.
     #
     # @option params [required, String] :domain_name
-    #   The name of the DomainName resource to be changed.
+    #   \[Required\] 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
@@ -5641,10 +5695,11 @@ module Aws::APIGateway
     # RestApi.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [required, String] :response_type
-    #   The response type of the associated GatewayResponse. Valid values are
+    #   \[Required\] The response type of the associated GatewayResponse.
+    #   Valid values are
     #   * ACCESS\_DENIED
     #   * API\_CONFIGURATION\_ERROR
     #   * AUTHORIZER\_FAILURE
@@ -5664,7 +5719,7 @@ module Aws::APIGateway
     #   * RESOURCE\_NOT\_FOUND
     #   * THROTTLED
     #   * UNAUTHORIZED
-    #   * UNSUPPORTED\_MEDIA\_TYPES
+    #   * UNSUPPORTED\_MEDIA\_TYPE
     #
     # @option params [Array<Types::PatchOperation>] :patch_operations
     #   A list of update operations to be applied to the specified resource
@@ -5713,13 +5768,14 @@ module Aws::APIGateway
     # Represents an update integration.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [required, String] :resource_id
-    #   Represents an update integration request's resource identifier.
+    #   \[Required\] Represents an update integration request's resource
+    #   identifier.
     #
     # @option params [required, String] :http_method
-    #   Represents an update integration request's HTTP method.
+    #   \[Required\] 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
@@ -5795,17 +5851,19 @@ module Aws::APIGateway
     # Represents an update integration response.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [required, String] :resource_id
-    #   Specifies an update integration response request's resource
-    #   identifier.
+    #   \[Required\] Specifies an update integration response request's
+    #   resource identifier.
     #
     # @option params [required, String] :http_method
-    #   Specifies an update integration response request's HTTP method.
+    #   \[Required\] Specifies an update integration response request's HTTP
+    #   method.
     #
     # @option params [required, String] :status_code
-    #   Specifies an update integration response request's status code.
+    #   \[Required\] 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
@@ -5856,13 +5914,13 @@ module Aws::APIGateway
     # Updates an existing Method resource.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [required, String] :resource_id
-    #   The Resource identifier for the Method resource.
+    #   \[Required\] The Resource identifier for the Method resource.
     #
     # @option params [required, String] :http_method
-    #   The HTTP verb of the Method resource.
+    #   \[Required\] 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
@@ -5953,16 +6011,16 @@ module Aws::APIGateway
     # Updates an existing MethodResponse resource.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [required, String] :resource_id
-    #   The Resource identifier for the MethodResponse resource.
+    #   \[Required\] The Resource identifier for the MethodResponse resource.
     #
     # @option params [required, String] :http_method
-    #   The HTTP verb of the Method resource.
+    #   \[Required\] The HTTP verb of the Method resource.
     #
     # @option params [required, String] :status_code
-    #   The status code for the MethodResponse resource.
+    #   \[Required\] 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
@@ -6009,10 +6067,10 @@ module Aws::APIGateway
     # Changes information about a model.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [required, String] :model_name
-    #   The name of the model to update.
+    #   \[Required\] 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
@@ -6059,7 +6117,7 @@ module Aws::APIGateway
     # Updates a RequestValidator of a given RestApi.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [required, String] :request_validator_id
     #   \[Required\] The identifier of RequestValidator to be updated.
@@ -6107,10 +6165,10 @@ module Aws::APIGateway
     # Changes information about a Resource resource.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [required, String] :resource_id
-    #   The identifier of the Resource resource.
+    #   \[Required\] 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
@@ -6199,7 +6257,7 @@ module Aws::APIGateway
     # Changes information about the specified API.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] 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
@@ -6217,6 +6275,7 @@ module Aws::APIGateway
     #   * {Types::RestApi#minimum_compression_size #minimum_compression_size} => Integer
     #   * {Types::RestApi#api_key_source #api_key_source} => String
     #   * {Types::RestApi#endpoint_configuration #endpoint_configuration} => Types::EndpointConfiguration
+    #   * {Types::RestApi#policy #policy} => String
     #
     # @example Request syntax with placeholder values
     #
@@ -6247,6 +6306,7 @@ module Aws::APIGateway
     #   resp.api_key_source #=> String, one of "HEADER", "AUTHORIZER"
     #   resp.endpoint_configuration.types #=> Array
     #   resp.endpoint_configuration.types[0] #=> String, one of "REGIONAL", "EDGE"
+    #   resp.policy #=> String
     #
     # @overload update_rest_api(params = {})
     # @param [Hash] params ({})
@@ -6258,10 +6318,11 @@ module Aws::APIGateway
     # Changes information about a Stage resource.
     #
     # @option params [required, String] :rest_api_id
-    #   The string identifier of the associated RestApi.
+    #   \[Required\] The string identifier of the associated RestApi.
     #
     # @option params [required, String] :stage_name
-    #   The name of the Stage resource to change information about.
+    #   \[Required\] 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
@@ -6346,11 +6407,11 @@ module Aws::APIGateway
     # associated with a specified API key.
     #
     # @option params [required, String] :usage_plan_id
-    #   The Id of the usage plan associated with the usage data.
+    #   \[Required\] The Id of the usage plan associated with the usage data.
     #
     # @option params [required, String] :key_id
-    #   The identifier of the API key associated with the usage plan in which
-    #   a temporary extension is granted to the remaining quota.
+    #   \[Required\] 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
@@ -6400,7 +6461,7 @@ module Aws::APIGateway
     # Updates a usage plan of a given plan Id.
     #
     # @option params [required, String] :usage_plan_id
-    #   The Id of the to-be-updated usage plan.
+    #   \[Required\] 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
@@ -6515,7 +6576,7 @@ module Aws::APIGateway
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-apigateway'
-      context[:gem_version] = '1.9.0'
+      context[:gem_version] = '1.10.0'
       Seahorse::Client::Request.new(handlers, context)
     end