aws-sdk-appconfig 1.19.0 → 1.23.0

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

@@ -27,6 +27,7 @@ require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
 require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
 require 'aws-sdk-core/plugins/transfer_encoding.rb'
 require 'aws-sdk-core/plugins/http_checksum.rb'
+require 'aws-sdk-core/plugins/defaults_mode.rb'
 require 'aws-sdk-core/plugins/signature_v4.rb'
 require 'aws-sdk-core/plugins/protocols/rest_json.rb'
 
@@ -73,6 +74,7 @@ module Aws::AppConfig
     add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
     add_plugin(Aws::Plugins::TransferEncoding)
     add_plugin(Aws::Plugins::HttpChecksum)
+    add_plugin(Aws::Plugins::DefaultsMode)
     add_plugin(Aws::Plugins::SignatureV4)
     add_plugin(Aws::Plugins::Protocols::RestJson)
 
@@ -119,7 +121,9 @@ module Aws::AppConfig
     #     * EC2/ECS IMDS instance profile - When used by default, the timeouts
     #       are very aggressive. Construct and pass an instance of
     #       `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
-    #       enable retries and extended timeouts.
+    #       enable retries and extended timeouts. Instance profile credential
+    #       fetching can be disabled by setting ENV['AWS_EC2_METADATA_DISABLED']
+    #       to true.
     #
     #   @option options [required, String] :region
     #     The AWS region to connect to.  The configured `:region` is
@@ -173,6 +177,10 @@ module Aws::AppConfig
     #     Used only in `standard` and adaptive retry modes. Specifies whether to apply
     #     a clock skew correction and retry requests with skewed client clocks.
     #
+    #   @option options [String] :defaults_mode ("legacy")
+    #     See {Aws::DefaultsModeConfiguration} for a list of the
+    #     accepted modes and the configuration defaults that are included.
+    #
     #   @option options [Boolean] :disable_host_prefix_injection (false)
     #     Set to true to disable SDK automatically adding host prefix
     #     to default service endpoint when available.
@@ -295,7 +303,7 @@ module Aws::AppConfig
     #     seconds to wait when opening a HTTP session before raising a
     #     `Timeout::Error`.
     #
-    #   @option options [Integer] :http_read_timeout (60) The default
+    #   @option options [Float] :http_read_timeout (60) The default
     #     number of seconds to wait for response data.  This value can
     #     safely be set per-request on the session.
     #
@@ -311,6 +319,9 @@ module Aws::AppConfig
     #     disables this behaviour.  This value can safely be set per
     #     request on the session.
     #
+    #   @option options [Float] :ssl_timeout (nil) Sets the SSL timeout
+    #     in seconds.
+    #
     #   @option options [Boolean] :http_wire_trace (false) When `true`,
     #     HTTP debug output will be sent to the `:logger`.
     #
@@ -336,11 +347,12 @@ module Aws::AppConfig
 
     # @!group API Operations
 
-    # An application in AppConfig is a logical unit of code that provides
-    # capabilities for your customers. For example, an application can be a
-    # microservice that runs on Amazon EC2 instances, a mobile application
-    # installed by your users, a serverless application using Amazon API
-    # Gateway and AWS Lambda, or any system you run on behalf of others.
+    # Creates an application. An application in AppConfig is a logical unit
+    # of code that provides capabilities for your customers. For example, an
+    # application can be a microservice that runs on Amazon EC2 instances, a
+    # mobile application installed by your users, a serverless application
+    # using Amazon API Gateway and Lambda, or any system you run on behalf
+    # of others.
     #
     # @option params [required, String] :name
     #   A name for the application.
@@ -359,6 +371,23 @@ module Aws::AppConfig
     #   * {Types::Application#name #name} => String
     #   * {Types::Application#description #description} => String
     #
+    #
+    # @example Example: To create an application
+    #
+    #   # The following create-application example creates an application in AWS AppConfig.
+    #
+    #   resp = client.create_application({
+    #     description: "An application used for creating an example.", 
+    #     name: "example-application", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     description: "An application used for creating an example.", 
+    #     id: "339ohji", 
+    #     name: "example-application", 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.create_application({
@@ -384,25 +413,29 @@ module Aws::AppConfig
       req.send_request(options)
     end
 
-    # Information that enables AppConfig to access the configuration source.
-    # Valid configuration sources include Systems Manager (SSM) documents,
-    # SSM Parameter Store parameters, and Amazon S3 objects. A configuration
-    # profile includes the following information.
+    # Creates a configuration profile, which is information that enables
+    # AppConfig to access the configuration source. Valid configuration
+    # sources include the AppConfig hosted configuration store, Amazon Web
+    # Services Systems Manager (SSM) documents, SSM Parameter Store
+    # parameters, Amazon S3 objects, or any [integration source action][1]
+    # supported by CodePipeline. A configuration profile includes the
+    # following information:
     #
-    # * The Uri location of the configuration data.
+    # * The URI location of the configuration data.
     #
-    # * The AWS Identity and Access Management (IAM) role that provides
-    #   access to the configuration data.
+    # * The Identity and Access Management (IAM) role that provides access
+    #   to the configuration data.
     #
     # * A validator for the configuration data. Available validators include
-    #   either a JSON Schema or an AWS Lambda function.
+    #   either a JSON Schema or an Amazon Web Services Lambda function.
     #
     # For more information, see [Create a Configuration and a Configuration
-    # Profile][1] in the *AWS AppConfig User Guide*.
+    # Profile][2] in the *AppConfig User Guide*.
     #
     #
     #
-    # [1]: http://docs.aws.amazon.com/systems-manager/latest/userguide/appconfig-creating-configuration-and-profile.html
+    # [1]: http://docs.aws.amazon.com/codepipeline/latest/userguide/integrations-action-type.html#integrations-source
+    # [2]: http://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-configuration-and-profile.html
     #
     # @option params [required, String] :application_id
     #   The application ID.
@@ -414,19 +447,25 @@ module Aws::AppConfig
     #   A description of the configuration profile.
     #
     # @option params [required, String] :location_uri
-    #   A URI to locate the configuration. You can specify a Systems Manager
-    #   (SSM) document, an SSM Parameter Store parameter, or an Amazon S3
-    #   object. For an SSM document, specify either the document name in the
-    #   format `ssm-document://<Document_name>` or the Amazon Resource Name
-    #   (ARN). For a parameter, specify either the parameter name in the
-    #   format `ssm-parameter://<Parameter_name>` or the ARN. For an Amazon S3
+    #   A URI to locate the configuration. You can specify the AppConfig
+    #   hosted configuration store, Systems Manager (SSM) document, an SSM
+    #   Parameter Store parameter, or an Amazon S3 object. For the hosted
+    #   configuration store and for feature flags, specify `hosted`. For an
+    #   SSM document, specify either the document name in the format
+    #   `ssm-document://<Document_name>` or the Amazon Resource Name (ARN).
+    #   For a parameter, specify either the parameter name in the format
+    #   `ssm-parameter://<Parameter_name>` or the ARN. For an Amazon S3
     #   object, specify the URI in the following format:
     #   `s3://<bucket>/<objectKey> `. Here is an example:
-    #   s3://my-bucket/my-app/us-east-1/my-config.json
+    #   `s3://my-bucket/my-app/us-east-1/my-config.json`
     #
     # @option params [String] :retrieval_role_arn
     #   The ARN of an IAM role with permission to access the configuration at
-    #   the specified LocationUri.
+    #   the specified `LocationUri`.
+    #
+    #   A retrieval role ARN is not required for configurations stored in the
+    #   AppConfig hosted configuration store. It is required for all other
+    #   sources that store your configuration.
     #
     # @option params [Array<Types::Validator>] :validators
     #   A list of methods for validating the configuration.
@@ -436,6 +475,18 @@ module Aws::AppConfig
     #   and categorize your AppConfig resources. Each tag consists of a key
     #   and an optional value, both of which you define.
     #
+    # @option params [String] :type
+    #   The type of configurations contained in the profile. AppConfig
+    #   supports `feature flags` and `freeform` configurations. We recommend
+    #   you create feature flag configurations to enable or disable new
+    #   features and freeform configurations to distribute configurations to
+    #   an application. When calling this API, enter one of the following
+    #   values for `Type`\:
+    #
+    #   `AWS.AppConfig.FeatureFlags`
+    #
+    #   `AWS.Freeform`
+    #
     # @return [Types::ConfigurationProfile] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::ConfigurationProfile#application_id #application_id} => String
@@ -445,6 +496,29 @@ module Aws::AppConfig
     #   * {Types::ConfigurationProfile#location_uri #location_uri} => String
     #   * {Types::ConfigurationProfile#retrieval_role_arn #retrieval_role_arn} => String
     #   * {Types::ConfigurationProfile#validators #validators} => Array&lt;Types::Validator&gt;
+    #   * {Types::ConfigurationProfile#type #type} => String
+    #
+    #
+    # @example Example: To create a configuration profile
+    #
+    #   # The following create-configuration-profile example creates a configuration profile using a configuration stored in
+    #   # Parameter Store, a capability of Systems Manager.
+    #
+    #   resp = client.create_configuration_profile({
+    #     application_id: "339ohji", 
+    #     location_uri: "ssm-parameter://Example-Parameter", 
+    #     name: "Example-Configuration-Profile", 
+    #     retrieval_role_arn: "arn:aws:iam::111122223333:role/Example-App-Config-Role", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     application_id: "339ohji", 
+    #     id: "ur8hx2f", 
+    #     location_uri: "ssm-parameter://Example-Parameter", 
+    #     name: "Example-Configuration-Profile", 
+    #     retrieval_role_arn: "arn:aws:iam::111122223333:role/Example-App-Config-Role", 
+    #   }
     #
     # @example Request syntax with placeholder values
     #
@@ -463,6 +537,7 @@ module Aws::AppConfig
     #     tags: {
     #       "TagKey" => "TagValue",
     #     },
+    #     type: "ConfigurationProfileType",
     #   })
     #
     # @example Response structure
@@ -476,6 +551,7 @@ module Aws::AppConfig
     #   resp.validators #=> Array
     #   resp.validators[0].type #=> String, one of "JSON_SCHEMA", "LAMBDA"
     #   resp.validators[0].content #=> String
+    #   resp.type #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/appconfig-2019-10-09/CreateConfigurationProfile AWS API Documentation
     #
@@ -486,11 +562,11 @@ module Aws::AppConfig
       req.send_request(options)
     end
 
-    # A deployment strategy defines important criteria for rolling out your
-    # configuration to the designated targets. A deployment strategy
-    # includes: the overall duration required, a percentage of targets to
-    # receive the deployment during each interval, an algorithm that defines
-    # how percentage grows, and bake time.
+    # Creates a deployment strategy that defines important criteria for
+    # rolling out your configuration to the designated targets. A deployment
+    # strategy includes the overall duration required, a percentage of
+    # targets to receive the deployment during each interval, an algorithm
+    # that defines how percentage grows, and bake time.
     #
     # @option params [required, String] :name
     #   A name for the deployment strategy.
@@ -511,8 +587,8 @@ module Aws::AppConfig
     #   each interval.
     #
     # @option params [String] :growth_type
-    #   The algorithm used to define how percentage grows over time. AWS
-    #   AppConfig supports the following growth types:
+    #   The algorithm used to define how percentage grows over time. AppConfig
+    #   supports the following growth types:
     #
     #   **Linear**\: For this type, AppConfig processes the deployment by
     #   dividing the total number of targets by the value specified for `Step
@@ -558,6 +634,31 @@ module Aws::AppConfig
     #   * {Types::DeploymentStrategy#final_bake_time_in_minutes #final_bake_time_in_minutes} => Integer
     #   * {Types::DeploymentStrategy#replicate_to #replicate_to} => String
     #
+    #
+    # @example Example: To create a deployment strategy
+    #
+    #   # The following create-deployment-strategy example creates a deployment strategy called Example-Deployment that takes 15
+    #   # minutes and deploys the configuration to 25% of the application at a time. The strategy is also copied to an SSM
+    #   # Document.
+    #
+    #   resp = client.create_deployment_strategy({
+    #     deployment_duration_in_minutes: 15, 
+    #     growth_factor: 25, 
+    #     name: "Example-Deployment", 
+    #     replicate_to: "SSM_DOCUMENT", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     deployment_duration_in_minutes: 15, 
+    #     final_bake_time_in_minutes: 0, 
+    #     growth_factor: 25, 
+    #     growth_type: "LINEAR", 
+    #     id: "1225qzk", 
+    #     name: "Example-Deployment", 
+    #     replicate_to: "SSM_DOCUMENT", 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.create_deployment_strategy({
@@ -593,14 +694,15 @@ module Aws::AppConfig
       req.send_request(options)
     end
 
-    # For each application, you define one or more environments. An
-    # environment is a logical deployment group of AppConfig targets, such
-    # as applications in a `Beta` or `Production` environment. You can also
-    # define environments for application subcomponents such as the `Web`,
-    # `Mobile` and `Back-end` components for your application. You can
-    # configure Amazon CloudWatch alarms for each environment. The system
-    # monitors alarms during a configuration deployment. If an alarm is
-    # triggered, the system rolls back the configuration.
+    # Creates an environment. For each application, you define one or more
+    # environments. An environment is a logical deployment group of
+    # AppConfig targets, such as applications in a `Beta` or `Production`
+    # environment. You can also define environments for application
+    # subcomponents such as the `Web`, `Mobile` and `Back-end` components
+    # for your application. You can configure Amazon CloudWatch alarms for
+    # each environment. The system monitors alarms during a configuration
+    # deployment. If an alarm is triggered, the system rolls back the
+    # configuration.
     #
     # @option params [required, String] :application_id
     #   The application ID.
@@ -628,6 +730,25 @@ module Aws::AppConfig
     #   * {Types::Environment#state #state} => String
     #   * {Types::Environment#monitors #monitors} => Array&lt;Types::Monitor&gt;
     #
+    #
+    # @example Example: To create an environment
+    #
+    #   # The following create-environment example creates an AWS AppConfig environment named Example-Environment using the
+    #   # application you created using create-application
+    #
+    #   resp = client.create_environment({
+    #     application_id: "339ohji", 
+    #     name: "Example-Environment", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     application_id: "339ohji", 
+    #     id: "54j1r29", 
+    #     name: "Example-Environment", 
+    #     state: "READY_FOR_DEPLOYMENT", 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.create_environment({
@@ -636,7 +757,7 @@ module Aws::AppConfig
     #     description: "Description",
     #     monitors: [
     #       {
-    #         alarm_arn: "Arn",
+    #         alarm_arn: "StringWithLengthBetween1And2048", # required
     #         alarm_role_arn: "RoleArn",
     #       },
     #     ],
@@ -665,7 +786,8 @@ module Aws::AppConfig
       req.send_request(options)
     end
 
-    # Create a new configuration in the AppConfig configuration store.
+    # Creates a new configuration in the AppConfig hosted configuration
+    # store.
     #
     # @option params [required, String] :application_id
     #   The application ID.
@@ -685,14 +807,14 @@ module Aws::AppConfig
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/https:/www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.17
+    #   [1]: https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.17
     #
     # @option params [Integer] :latest_version_number
     #   An optional locking token used to prevent race conditions from
     #   overwriting configuration updates when creating a new version. To
     #   ensure your data is not overwritten when creating multiple hosted
-    #   configuration versions in rapid succession, specify the version of the
-    #   latest hosted configuration version.
+    #   configuration versions in rapid succession, specify the version number
+    #   of the latest hosted configuration version.
     #
     # @return [Types::HostedConfigurationVersion] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -703,6 +825,28 @@ module Aws::AppConfig
     #   * {Types::HostedConfigurationVersion#content #content} => String
     #   * {Types::HostedConfigurationVersion#content_type #content_type} => String
     #
+    #
+    # @example Example: To create a hosted configuration version
+    #
+    #   # The following create-hosted-configuration-version example creates a new configuration in the AWS AppConfig configuration
+    #   # store.
+    #
+    #   resp = client.create_hosted_configuration_version({
+    #     application_id: "339ohji", 
+    #     configuration_profile_id: "ur8hx2f", 
+    #     content: "eyAiTmFtZSI6ICJFeGFtcGxlQXBwbGljYXRpb24iLCAiSWQiOiBFeGFtcGxlSUQsICJSYW5rIjogNyB9", 
+    #     content_type: "text", 
+    #     latest_version_number: 1, 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     application_id: "339ohji", 
+    #     configuration_profile_id: "ur8hx2f", 
+    #     content_type: "text", 
+    #     version_number: 1, 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.create_hosted_configuration_version({
@@ -732,7 +876,7 @@ module Aws::AppConfig
       req.send_request(options)
     end
 
-    # Delete an application. Deleting an application does not delete a
+    # Deletes an application. Deleting an application does not delete a
     # configuration from a host.
     #
     # @option params [required, String] :application_id
@@ -740,6 +884,15 @@ module Aws::AppConfig
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
+    #
+    # @example Example: To delete an application
+    #
+    #   # The following delete-application example deletes the specified application. 
+    #
+    #   resp = client.delete_application({
+    #     application_id: "339ohji", 
+    #   })
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.delete_application({
@@ -755,7 +908,7 @@ module Aws::AppConfig
       req.send_request(options)
     end
 
-    # Delete a configuration profile. Deleting a configuration profile does
+    # Deletes a configuration profile. Deleting a configuration profile does
     # not delete a configuration from a host.
     #
     # @option params [required, String] :application_id
@@ -767,6 +920,16 @@ module Aws::AppConfig
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
+    #
+    # @example Example: To delete a configuration profile
+    #
+    #   # The following delete-configuration-profile example deletes the specified configuration profile.
+    #
+    #   resp = client.delete_configuration_profile({
+    #     application_id: "339ohji", 
+    #     configuration_profile_id: "ur8hx2f", 
+    #   })
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.delete_configuration_profile({
@@ -783,7 +946,7 @@ module Aws::AppConfig
       req.send_request(options)
     end
 
-    # Delete a deployment strategy. Deleting a deployment strategy does not
+    # Deletes a deployment strategy. Deleting a deployment strategy does not
     # delete a configuration from a host.
     #
     # @option params [required, String] :deployment_strategy_id
@@ -791,6 +954,15 @@ module Aws::AppConfig
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
+    #
+    # @example Example: To delete a deployment strategy
+    #
+    #   # The following delete-deployment-strategy example deletes the specified deployment strategy.
+    #
+    #   resp = client.delete_deployment_strategy({
+    #     deployment_strategy_id: "1225qzk", 
+    #   })
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.delete_deployment_strategy({
@@ -806,17 +978,28 @@ module Aws::AppConfig
       req.send_request(options)
     end
 
-    # Delete an environment. Deleting an environment does not delete a
+    # Deletes an environment. Deleting an environment does not delete a
     # configuration from a host.
     #
     # @option params [required, String] :application_id
-    #   The application ID that includes the environment you want to delete.
+    #   The application ID that includes the environment that you want to
+    #   delete.
     #
     # @option params [required, String] :environment_id
-    #   The ID of the environment you want to delete.
+    #   The ID of the environment that you want to delete.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
+    #
+    # @example Example: To delete an environment
+    #
+    #   # The following delete-environment example deletes the specified application environment.
+    #
+    #   resp = client.delete_environment({
+    #     application_id: "339ohji", 
+    #     environment_id: "54j1r29", 
+    #   })
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.delete_environment({
@@ -833,8 +1016,8 @@ module Aws::AppConfig
       req.send_request(options)
     end
 
-    # Delete a version of a configuration from the AppConfig configuration
-    # store.
+    # Deletes a version of a configuration from the AppConfig hosted
+    # configuration store.
     #
     # @option params [required, String] :application_id
     #   The application ID.
@@ -847,6 +1030,18 @@ module Aws::AppConfig
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
+    #
+    # @example Example: To delete a hosted configuration version
+    #
+    #   # The following delete-hosted-configuration-version example deletes a configuration version hosted in the AWS AppConfig
+    #   # configuration store.
+    #
+    #   resp = client.delete_hosted_configuration_version({
+    #     application_id: "339ohji", 
+    #     configuration_profile_id: "ur8hx2f", 
+    #     version_number: 1, 
+    #   })
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.delete_hosted_configuration_version({
@@ -864,7 +1059,7 @@ module Aws::AppConfig
       req.send_request(options)
     end
 
-    # Retrieve information about an application.
+    # Retrieves information about an application.
     #
     # @option params [required, String] :application_id
     #   The ID of the application you want to get.
@@ -875,6 +1070,21 @@ module Aws::AppConfig
     #   * {Types::Application#name #name} => String
     #   * {Types::Application#description #description} => String
     #
+    #
+    # @example Example: To list details of an application
+    #
+    #   # The following get-application example lists the details of the specified application.
+    #
+    #   resp = client.get_application({
+    #     application_id: "339ohji", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     id: "339ohji", 
+    #     name: "example-application", 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.get_application({
@@ -896,19 +1106,41 @@ module Aws::AppConfig
       req.send_request(options)
     end
 
-    # Receive information about a configuration.
+    # Retrieves the latest deployed configuration.
+    #
+    # Note the following important information.
     #
-    # AWS AppConfig uses the value of the `ClientConfigurationVersion`
-    # parameter to identify the configuration version on your clients. If
-    # you don’t send `ClientConfigurationVersion` with each call to
-    # `GetConfiguration`, your clients receive the current configuration.
-    # You are charged each time your clients receive a configuration.
+    #  * This API action has been deprecated. Calls to receive configuration
+    #   data should use the [StartConfigurationSession][1] and
+    #   [GetLatestConfiguration][2] APIs instead.
     #
-    #  To avoid excess charges, we recommend that you include the
-    # `ClientConfigurationVersion` value with every call to
-    # `GetConfiguration`. This value must be saved on your client.
-    # Subsequent calls to `GetConfiguration` must pass this value by using
-    # the `ClientConfigurationVersion` parameter.
+    # * `GetConfiguration` is a priced call. For more information, see
+    #   [Pricing][3].
+    #
+    # * AppConfig uses the value of the `ClientConfigurationVersion`
+    #   parameter to identify the configuration version on your clients. If
+    #   you don’t send `ClientConfigurationVersion` with each call to
+    #   `GetConfiguration`, your clients receive the current configuration.
+    #   You are charged each time your clients receive a configuration.
+    #
+    #   To avoid excess charges, we recommend you use the
+    #   [StartConfigurationSession][4] and [GetLatestConfiguration][5] APIs,
+    #   which track the client configuration version on your behalf. If you
+    #   choose to continue using `GetConfiguration`, we recommend that you
+    #   include the `ClientConfigurationVersion` value with every call to
+    #   `GetConfiguration`. The value to use for
+    #   `ClientConfigurationVersion` comes from the `ConfigurationVersion`
+    #   attribute returned by `GetConfiguration` when there is new or
+    #   updated data, and should be saved for subsequent calls to
+    #   `GetConfiguration`.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_appconfigdata_StartConfigurationSession.html
+    # [2]: https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_appconfigdata_GetLatestConfiguration.html
+    # [3]: https://aws.amazon.com/systems-manager/pricing/
+    # [4]: https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/StartConfigurationSession.html
+    # [5]: https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/GetLatestConfiguration.html
     #
     # @option params [required, String] :application
     #   The application to get. Specify either the application name or the
@@ -923,17 +1155,18 @@ module Aws::AppConfig
     #   configuration ID.
     #
     # @option params [required, String] :client_id
-    #   A unique ID to identify the client for the configuration. This ID
-    #   enables AppConfig to deploy the configuration in intervals, as defined
-    #   in the deployment strategy.
+    #   The clientId parameter in the following command is a unique,
+    #   user-specified ID to identify the client for the configuration. This
+    #   ID enables AppConfig to deploy the configuration in intervals, as
+    #   defined in the deployment strategy.
     #
     # @option params [String] :client_configuration_version
     #   The configuration version returned in the most recent
     #   `GetConfiguration` response.
     #
-    #   AWS AppConfig uses the value of the `ClientConfigurationVersion`
-    #   parameter to identify the configuration version on your clients. If
-    #   you don’t send `ClientConfigurationVersion` with each call to
+    #   AppConfig uses the value of the `ClientConfigurationVersion` parameter
+    #   to identify the configuration version on your clients. If you don’t
+    #   send `ClientConfigurationVersion` with each call to
     #   `GetConfiguration`, your clients receive the current configuration.
     #   You are charged each time your clients receive a configuration.
     #
@@ -944,11 +1177,11 @@ module Aws::AppConfig
     #   the `ClientConfigurationVersion` parameter.
     #
     #   For more information about working with configurations, see
-    #   [Retrieving the Configuration][1] in the *AWS AppConfig User Guide*.
+    #   [Retrieving the Configuration][1] in the *AppConfig User Guide*.
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/appconfig-retrieving-the-configuration.html
+    #   [1]: http://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-retrieving-the-configuration.html
     #
     # @return [Types::Configuration] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -956,6 +1189,27 @@ module Aws::AppConfig
     #   * {Types::Configuration#configuration_version #configuration_version} => String
     #   * {Types::Configuration#content_type #content_type} => String
     #
+    #
+    # @example Example: To retrieve configuration details
+    #
+    #   # The following get-configuration example returns the configuration details of the example application. On subsequent
+    #   # calls to get-configuration, use the client-configuration-version parameter to only update the configuration of your
+    #   # application if the version has changed. Only updating the configuration when the version has changed avoids excess
+    #   # charges incurred by calling get-configuration.
+    #
+    #   resp = client.get_configuration({
+    #     application: "example-application", 
+    #     client_id: "example-id", 
+    #     configuration: "Example-Configuration-Profile", 
+    #     environment: "Example-Environment", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     configuration_version: "1", 
+    #     content_type: "application/octet-stream", 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.get_configuration({
@@ -981,14 +1235,14 @@ module Aws::AppConfig
       req.send_request(options)
     end
 
-    # Retrieve information about a configuration profile.
+    # Retrieves information about a configuration profile.
     #
     # @option params [required, String] :application_id
     #   The ID of the application that includes the configuration profile you
     #   want to get.
     #
     # @option params [required, String] :configuration_profile_id
-    #   The ID of the configuration profile you want to get.
+    #   The ID of the configuration profile that you want to get.
     #
     # @return [Types::ConfigurationProfile] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -999,6 +1253,26 @@ module Aws::AppConfig
     #   * {Types::ConfigurationProfile#location_uri #location_uri} => String
     #   * {Types::ConfigurationProfile#retrieval_role_arn #retrieval_role_arn} => String
     #   * {Types::ConfigurationProfile#validators #validators} => Array&lt;Types::Validator&gt;
+    #   * {Types::ConfigurationProfile#type #type} => String
+    #
+    #
+    # @example Example: To retrieve configuration profile details
+    #
+    #   # The following get-configuration-profile example returns the details of the specified configuration profile.
+    #
+    #   resp = client.get_configuration_profile({
+    #     application_id: "339ohji", 
+    #     configuration_profile_id: "ur8hx2f", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     application_id: "339ohji", 
+    #     id: "ur8hx2f", 
+    #     location_uri: "ssm-parameter://Example-Parameter", 
+    #     name: "Example-Configuration-Profile", 
+    #     retrieval_role_arn: "arn:aws:iam::111122223333:role/Example-App-Config-Role", 
+    #   }
     #
     # @example Request syntax with placeholder values
     #
@@ -1018,6 +1292,7 @@ module Aws::AppConfig
     #   resp.validators #=> Array
     #   resp.validators[0].type #=> String, one of "JSON_SCHEMA", "LAMBDA"
     #   resp.validators[0].content #=> String
+    #   resp.type #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/appconfig-2019-10-09/GetConfigurationProfile AWS API Documentation
     #
@@ -1028,7 +1303,7 @@ module Aws::AppConfig
       req.send_request(options)
     end
 
-    # Retrieve information about a configuration deployment.
+    # Retrieves information about a configuration deployment.
     #
     # @option params [required, String] :application_id
     #   The ID of the application that includes the deployment you want to
@@ -1062,6 +1337,82 @@ module Aws::AppConfig
     #   * {Types::Deployment#started_at #started_at} => Time
     #   * {Types::Deployment#completed_at #completed_at} => Time
     #
+    #
+    # @example Example: To retrieve deployment details
+    #
+    #   # The following get-deployment example lists details of the deployment to the application in the specified environment and
+    #   # deployment.
+    #
+    #   resp = client.get_deployment({
+    #     application_id: "339ohji", 
+    #     deployment_number: 1, 
+    #     environment_id: "54j1r29", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     application_id: "339ohji", 
+    #     completed_at: Time.parse("2021-09-17T21:59:03.888000+00:00"), 
+    #     configuration_location_uri: "ssm-parameter://Example-Parameter", 
+    #     configuration_name: "Example-Configuration-Profile", 
+    #     configuration_profile_id: "ur8hx2f", 
+    #     configuration_version: "1", 
+    #     deployment_duration_in_minutes: 15, 
+    #     deployment_number: 1, 
+    #     deployment_strategy_id: "1225qzk", 
+    #     environment_id: "54j1r29", 
+    #     event_log: [
+    #       {
+    #         description: "Deployment completed", 
+    #         event_type: "DEPLOYMENT_COMPLETED", 
+    #         occurred_at: Time.parse("2021-09-17T21:59:03.888000+00:00"), 
+    #         triggered_by: "APPCONFIG", 
+    #       }, 
+    #       {
+    #         description: "Deployment bake time started", 
+    #         event_type: "BAKE_TIME_STARTED", 
+    #         occurred_at: Time.parse("2021-09-17T21:58:57.722000+00:00"), 
+    #         triggered_by: "APPCONFIG", 
+    #       }, 
+    #       {
+    #         description: "Configuration available to 100.00% of clients", 
+    #         event_type: "PERCENTAGE_UPDATED", 
+    #         occurred_at: Time.parse("2021-09-17T21:55:56.816000+00:00"), 
+    #         triggered_by: "APPCONFIG", 
+    #       }, 
+    #       {
+    #         description: "Configuration available to 75.00% of clients", 
+    #         event_type: "PERCENTAGE_UPDATED", 
+    #         occurred_at: Time.parse("2021-09-17T21:52:56.567000+00:00"), 
+    #         triggered_by: "APPCONFIG", 
+    #       }, 
+    #       {
+    #         description: "Configuration available to 50.00% of clients", 
+    #         event_type: "PERCENTAGE_UPDATED", 
+    #         occurred_at: Time.parse("2021-09-17T21:49:55.737000+00:00"), 
+    #         triggered_by: "APPCONFIG", 
+    #       }, 
+    #       {
+    #         description: "Configuration available to 25.00% of clients", 
+    #         event_type: "PERCENTAGE_UPDATED", 
+    #         occurred_at: Time.parse("2021-09-17T21:46:55.187000+00:00"), 
+    #         triggered_by: "APPCONFIG", 
+    #       }, 
+    #       {
+    #         description: "Deployment started", 
+    #         event_type: "DEPLOYMENT_STARTED", 
+    #         occurred_at: Time.parse("2021-09-17T21:43:54.205000+00:00"), 
+    #         triggered_by: "USER", 
+    #       }, 
+    #     ], 
+    #     final_bake_time_in_minutes: 0, 
+    #     growth_factor: 25, 
+    #     growth_type: "LINEAR", 
+    #     percentage_complete: 100, 
+    #     started_at: Time.parse("2021-09-17T21:43:54.205000+00:00"), 
+    #     state: "COMPLETE", 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.get_deployment({
@@ -1104,9 +1455,9 @@ module Aws::AppConfig
       req.send_request(options)
     end
 
-    # Retrieve information about a deployment strategy. A deployment
+    # Retrieves information about a deployment strategy. A deployment
     # strategy defines important criteria for rolling out your configuration
-    # to the designated targets. A deployment strategy includes: the overall
+    # to the designated targets. A deployment strategy includes the overall
     # duration required, a percentage of targets to receive the deployment
     # during each interval, an algorithm that defines how percentage grows,
     # and bake time.
@@ -1125,6 +1476,26 @@ module Aws::AppConfig
     #   * {Types::DeploymentStrategy#final_bake_time_in_minutes #final_bake_time_in_minutes} => Integer
     #   * {Types::DeploymentStrategy#replicate_to #replicate_to} => String
     #
+    #
+    # @example Example: To retrieve details of a deployment strategy
+    #
+    #   # The following get-deployment-strategy example lists the details of the specified deployment strategy.
+    #
+    #   resp = client.get_deployment_strategy({
+    #     deployment_strategy_id: "1225qzk", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     deployment_duration_in_minutes: 15, 
+    #     final_bake_time_in_minutes: 0, 
+    #     growth_factor: 25, 
+    #     growth_type: "LINEAR", 
+    #     id: "1225qzk", 
+    #     name: "Example-Deployment", 
+    #     replicate_to: "SSM_DOCUMENT", 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.get_deployment_strategy({
@@ -1151,19 +1522,20 @@ module Aws::AppConfig
       req.send_request(options)
     end
 
-    # Retrieve information about an environment. An environment is a logical
-    # deployment group of AppConfig applications, such as applications in a
-    # `Production` environment or in an `EU_Region` environment. Each
-    # configuration deployment targets an environment. You can enable one or
-    # more Amazon CloudWatch alarms for an environment. If an alarm is
-    # triggered during a deployment, AppConfig roles back the configuration.
+    # Retrieves information about an environment. An environment is a
+    # logical deployment group of AppConfig applications, such as
+    # applications in a `Production` environment or in an `EU_Region`
+    # environment. Each configuration deployment targets an environment. You
+    # can enable one or more Amazon CloudWatch alarms for an environment. If
+    # an alarm is triggered during a deployment, AppConfig roles back the
+    # configuration.
     #
     # @option params [required, String] :application_id
     #   The ID of the application that includes the environment you want to
     #   get.
     #
     # @option params [required, String] :environment_id
-    #   The ID of the environment you wnat to get.
+    #   The ID of the environment that you want to get.
     #
     # @return [Types::Environment] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1174,6 +1546,24 @@ module Aws::AppConfig
     #   * {Types::Environment#state #state} => String
     #   * {Types::Environment#monitors #monitors} => Array&lt;Types::Monitor&gt;
     #
+    #
+    # @example Example: To retrieve environment details
+    #
+    #   # The following get-environment example returns the details and state of the specified environment.
+    #
+    #   resp = client.get_environment({
+    #     application_id: "339ohji", 
+    #     environment_id: "54j1r29", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     application_id: "339ohji", 
+    #     id: "54j1r29", 
+    #     name: "Example-Environment", 
+    #     state: "READY_FOR_DEPLOYMENT", 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.get_environment({
@@ -1201,7 +1591,7 @@ module Aws::AppConfig
       req.send_request(options)
     end
 
-    # Get information about a specific configuration version.
+    # Retrieves information about a specific configuration version.
     #
     # @option params [required, String] :application_id
     #   The application ID.
@@ -1221,6 +1611,26 @@ module Aws::AppConfig
     #   * {Types::HostedConfigurationVersion#content #content} => String
     #   * {Types::HostedConfigurationVersion#content_type #content_type} => String
     #
+    #
+    # @example Example: To retrieve hosted configuration details
+    #
+    #   # The following get-hosted-configuration-version example retrieves the configuration details of the AWS AppConfig hosted
+    #   # configuration.
+    #
+    #   resp = client.get_hosted_configuration_version({
+    #     application_id: "339ohji", 
+    #     configuration_profile_id: "ur8hx2f", 
+    #     version_number: 1, 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     application_id: "339ohji", 
+    #     configuration_profile_id: "ur8hx2f", 
+    #     content_type: "application/json", 
+    #     version_number: 1, 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.get_hosted_configuration_version({
@@ -1247,7 +1657,7 @@ module Aws::AppConfig
       req.send_request(options)
     end
 
-    # List all applications in your AWS account.
+    # Lists all applications in your Amazon Web Services account.
     #
     # @option params [Integer] :max_results
     #   The maximum number of items to return for this call. The call also
@@ -1255,8 +1665,12 @@ module Aws::AppConfig
     #   next set of results.
     #
     # @option params [String] :next_token
-    #   A token to start the list. Use this token to get the next set of
-    #   results.
+    #   A token to start the list. Next token is a pagination token generated
+    #   by AppConfig to describe what page the previous List call ended on.
+    #   For the first List request, the nextToken should not be set. On
+    #   subsequent calls, the nextToken parameter should be set to the
+    #   previous responses nextToken value. Use this token to get the next set
+    #   of results.
     #
     # @return [Types::Applications] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1265,6 +1679,29 @@ module Aws::AppConfig
     #
     # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
     #
+    #
+    # @example Example: To list the available applications
+    #
+    #   # The following list-applications example lists the available applications in your AWS account.
+    #
+    #   resp = client.list_applications({
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     items: [
+    #       {
+    #         description: "An application used for creating an example.", 
+    #         id: "339ohji", 
+    #         name: "test-application", 
+    #       }, 
+    #       {
+    #         id: "rwalwu7", 
+    #         name: "Test-Application", 
+    #       }, 
+    #     ], 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_applications({
@@ -1303,6 +1740,11 @@ module Aws::AppConfig
     #   A token to start the list. Use this token to get the next set of
     #   results.
     #
+    # @option params [String] :type
+    #   A filter based on the type of configurations that the configuration
+    #   profile contains. A configuration can be a feature flag or a freeform
+    #   configuration.
+    #
     # @return [Types::ConfigurationProfiles] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::ConfigurationProfiles#items #items} => Array&lt;Types::ConfigurationProfileSummary&gt;
@@ -1310,12 +1752,35 @@ module Aws::AppConfig
     #
     # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
     #
+    #
+    # @example Example: To list the available configuration profiles
+    #
+    #   # The following list-configuration-profiles example lists the available configuration profiles for the specified
+    #   # application.
+    #
+    #   resp = client.list_configuration_profiles({
+    #     application_id: "339ohji", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     items: [
+    #       {
+    #         application_id: "339ohji", 
+    #         id: "ur8hx2f", 
+    #         location_uri: "ssm-parameter://Example-Parameter", 
+    #         name: "Example-Configuration-Profile", 
+    #       }, 
+    #     ], 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_configuration_profiles({
     #     application_id: "Id", # required
     #     max_results: 1,
     #     next_token: "NextToken",
+    #     type: "ConfigurationProfileType",
     #   })
     #
     # @example Response structure
@@ -1327,6 +1792,7 @@ module Aws::AppConfig
     #   resp.items[0].location_uri #=> String
     #   resp.items[0].validator_types #=> Array
     #   resp.items[0].validator_types[0] #=> String, one of "JSON_SCHEMA", "LAMBDA"
+    #   resp.items[0].type #=> String
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/appconfig-2019-10-09/ListConfigurationProfiles AWS API Documentation
@@ -1338,7 +1804,7 @@ module Aws::AppConfig
       req.send_request(options)
     end
 
-    # List deployment strategies.
+    # Lists deployment strategies.
     #
     # @option params [Integer] :max_results
     #   The maximum number of items to return for this call. The call also
@@ -1356,6 +1822,29 @@ module Aws::AppConfig
     #
     # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
     #
+    #
+    # @example Example: To list the available deployment strategies
+    #
+    #   # The following list-deployment-strategies example lists the available deployment strategies in your AWS account.
+    #
+    #   resp = client.list_deployment_strategies({
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     items: [
+    #       {
+    #         deployment_duration_in_minutes: 15, 
+    #         final_bake_time_in_minutes: 0, 
+    #         growth_factor: 25, 
+    #         growth_type: "LINEAR", 
+    #         id: "1225qzk", 
+    #         name: "Example-Deployment", 
+    #         replicate_to: "SSM_DOCUMENT", 
+    #       }, 
+    #     ], 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_deployment_strategies({
@@ -1385,7 +1874,8 @@ module Aws::AppConfig
       req.send_request(options)
     end
 
-    # Lists the deployments for an environment.
+    # Lists the deployments for an environment in descending deployment
+    # number order.
     #
     # @option params [required, String] :application_id
     #   The application ID.
@@ -1394,13 +1884,15 @@ module Aws::AppConfig
     #   The environment ID.
     #
     # @option params [Integer] :max_results
-    #   The maximum number of items to return for this call. The call also
-    #   returns a token that you can specify in a subsequent call to get the
-    #   next set of results.
+    #   The maximum number of items that may be returned for this call. If
+    #   there are items that have not yet been returned, the response will
+    #   include a non-null `NextToken` that you can provide in a subsequent
+    #   call to get the next set of results.
     #
     # @option params [String] :next_token
-    #   A token to start the list. Use this token to get the next set of
-    #   results.
+    #   The token returned by a prior call to this operation indicating the
+    #   next set of results to be returned. If not specified, the operation
+    #   will return the first set of results.
     #
     # @return [Types::Deployments] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1409,6 +1901,36 @@ module Aws::AppConfig
     #
     # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
     #
+    #
+    # @example Example: To list the available deployments
+    #
+    #   # The following list-deployments example lists the available deployments in your AWS account for the specified application
+    #   # and environment.
+    #
+    #   resp = client.list_deployments({
+    #     application_id: "339ohji", 
+    #     environment_id: "54j1r29", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     items: [
+    #       {
+    #         completed_at: Time.parse("2021-09-17T21:59:03.888000+00:00"), 
+    #         configuration_name: "Example-Configuration-Profile", 
+    #         configuration_version: "1", 
+    #         deployment_duration_in_minutes: 15, 
+    #         deployment_number: 1, 
+    #         final_bake_time_in_minutes: 0, 
+    #         growth_factor: 25, 
+    #         growth_type: "LINEAR", 
+    #         percentage_complete: 100, 
+    #         started_at: Time.parse("2021-09-17T21:43:54.205000+00:00"), 
+    #         state: "COMPLETE", 
+    #       }, 
+    #     ], 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_deployments({
@@ -1443,7 +1965,7 @@ module Aws::AppConfig
       req.send_request(options)
     end
 
-    # List the environments for an application.
+    # Lists the environments for an application.
     #
     # @option params [required, String] :application_id
     #   The application ID.
@@ -1464,6 +1986,28 @@ module Aws::AppConfig
     #
     # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
     #
+    #
+    # @example Example: To list the available environments
+    #
+    #   # The following list-environments example lists the available environments in your AWS account for the specified
+    #   # application.
+    #
+    #   resp = client.list_environments({
+    #     application_id: "339ohji", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     items: [
+    #       {
+    #         application_id: "339ohji", 
+    #         id: "54j1r29", 
+    #         name: "Example-Environment", 
+    #         state: "READY_FOR_DEPLOYMENT", 
+    #       }, 
+    #     ], 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_environments({
@@ -1494,7 +2038,7 @@ module Aws::AppConfig
       req.send_request(options)
     end
 
-    # View a list of configurations stored in the AppConfig configuration
+    # Lists configurations stored in the AppConfig hosted configuration
     # store by version.
     #
     # @option params [required, String] :application_id
@@ -1519,6 +2063,29 @@ module Aws::AppConfig
     #
     # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
     #
+    #
+    # @example Example: To list the available hosted configuration versions
+    #
+    #   # The following list-hosted-configuration-versions example lists the configurations versions hosted in the AWS AppConfig
+    #   # hosted configuration store for the specified application and configuration profile.
+    #
+    #   resp = client.list_hosted_configuration_versions({
+    #     application_id: "339ohji", 
+    #     configuration_profile_id: "ur8hx2f", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     items: [
+    #       {
+    #         application_id: "339ohji", 
+    #         configuration_profile_id: "ur8hx2f", 
+    #         content_type: "application/json", 
+    #         version_number: 1, 
+    #       }, 
+    #     ], 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_hosted_configuration_versions({
@@ -1556,6 +2123,22 @@ module Aws::AppConfig
     #
     #   * {Types::ResourceTags#tags #tags} => Hash&lt;String,String&gt;
     #
+    #
+    # @example Example: To list the tags of an application
+    #
+    #   # The following list-tags-for-resource example lists the tags of a specified application.
+    #
+    #   resp = client.list_tags_for_resource({
+    #     resource_arn: "arn:aws:appconfig:us-east-1:111122223333:application/339ohji", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     tags: {
+    #       "group1" => "1", 
+    #     }, 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_tags_for_resource({
@@ -1622,6 +2205,50 @@ module Aws::AppConfig
     #   * {Types::Deployment#started_at #started_at} => Time
     #   * {Types::Deployment#completed_at #completed_at} => Time
     #
+    #
+    # @example Example: To start a configuration deployment
+    #
+    #   # The following start-deployment example starts a deployment to the application using the specified environment,
+    #   # deployment strategy, and configuration profile.
+    #
+    #   resp = client.start_deployment({
+    #     application_id: "339ohji", 
+    #     configuration_profile_id: "ur8hx2f", 
+    #     configuration_version: "1", 
+    #     deployment_strategy_id: "1225qzk", 
+    #     description: "", 
+    #     environment_id: "54j1r29", 
+    #     tags: {
+    #     }, 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     application_id: "339ohji", 
+    #     configuration_location_uri: "ssm-parameter://Example-Parameter", 
+    #     configuration_name: "Example-Configuration-Profile", 
+    #     configuration_profile_id: "ur8hx2f", 
+    #     configuration_version: "1", 
+    #     deployment_duration_in_minutes: 15, 
+    #     deployment_number: 1, 
+    #     deployment_strategy_id: "1225qzk", 
+    #     environment_id: "54j1r29", 
+    #     event_log: [
+    #       {
+    #         description: "Deployment started", 
+    #         event_type: "DEPLOYMENT_STARTED", 
+    #         occurred_at: Time.parse("2021-09-17T21:43:54.205000+00:00"), 
+    #         triggered_by: "USER", 
+    #       }, 
+    #     ], 
+    #     final_bake_time_in_minutes: 0, 
+    #     growth_factor: 25, 
+    #     growth_type: "LINEAR", 
+    #     percentage_complete: 1.0, 
+    #     started_at: Time.parse("2021-09-17T21:43:54.205000+00:00"), 
+    #     state: "DEPLOYING", 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.start_deployment({
@@ -1704,6 +2331,26 @@ module Aws::AppConfig
     #   * {Types::Deployment#started_at #started_at} => Time
     #   * {Types::Deployment#completed_at #completed_at} => Time
     #
+    #
+    # @example Example: To stop configuration deployment
+    #
+    #   # The following stop-deployment example stops the deployment of an application configuration to the specified environment.
+    #
+    #   resp = client.stop_deployment({
+    #     application_id: "339ohji", 
+    #     deployment_number: 2, 
+    #     environment_id: "54j1r29", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     deployment_duration_in_minutes: 15, 
+    #     deployment_number: 2, 
+    #     final_bake_time_in_minutes: 0, 
+    #     growth_factor: 25.0, 
+    #     percentage_complete: 1.0, 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.stop_deployment({
@@ -1746,7 +2393,7 @@ module Aws::AppConfig
       req.send_request(options)
     end
 
-    # Metadata to assign to an AppConfig resource. Tags help organize and
+    # Assigns metadata to an AppConfig resource. Tags help organize and
     # categorize your AppConfig resources. Each tag consists of a key and an
     # optional value, both of which you define. You can specify a maximum of
     # 50 tags for a resource.
@@ -1761,6 +2408,18 @@ module Aws::AppConfig
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
+    #
+    # @example Example: To tag an application
+    #
+    #   # The following tag-resource example tags an application resource.
+    #
+    #   resp = client.tag_resource({
+    #     resource_arn: "arn:aws:appconfig:us-east-1:111122223333:application/339ohji", 
+    #     tags: {
+    #       "group1" => "1", 
+    #     }, 
+    #   })
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.tag_resource({
@@ -1789,6 +2448,18 @@ module Aws::AppConfig
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
+    #
+    # @example Example: To remove a tag from an application
+    #
+    #   # The following untag-resource example removes the group1 tag from the specified application.
+    #
+    #   resp = client.untag_resource({
+    #     resource_arn: "arn:aws:appconfig:us-east-1:111122223333:application/339ohji", 
+    #     tag_keys: [
+    #       "group1", 
+    #     ], 
+    #   })
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.untag_resource({
@@ -1822,6 +2493,24 @@ module Aws::AppConfig
     #   * {Types::Application#name #name} => String
     #   * {Types::Application#description #description} => String
     #
+    #
+    # @example Example: To update an application
+    #
+    #   # The following update-application example updates the name of the specified application.
+    #
+    #   resp = client.update_application({
+    #     application_id: "339ohji", 
+    #     description: "", 
+    #     name: "Example-Application", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     description: "An application used for creating an example.", 
+    #     id: "339ohji", 
+    #     name: "Example-Application", 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.update_application({
@@ -1861,7 +2550,7 @@ module Aws::AppConfig
     #
     # @option params [String] :retrieval_role_arn
     #   The ARN of an IAM role with permission to access the configuration at
-    #   the specified LocationUri.
+    #   the specified `LocationUri`.
     #
     # @option params [Array<Types::Validator>] :validators
     #   A list of methods for validating the configuration.
@@ -1875,6 +2564,28 @@ module Aws::AppConfig
     #   * {Types::ConfigurationProfile#location_uri #location_uri} => String
     #   * {Types::ConfigurationProfile#retrieval_role_arn #retrieval_role_arn} => String
     #   * {Types::ConfigurationProfile#validators #validators} => Array&lt;Types::Validator&gt;
+    #   * {Types::ConfigurationProfile#type #type} => String
+    #
+    #
+    # @example Example: To update a configuration profile
+    #
+    #   # The following update-configuration-profile example updates the description of the specified configuration profile.
+    #
+    #   resp = client.update_configuration_profile({
+    #     application_id: "339ohji", 
+    #     configuration_profile_id: "ur8hx2f", 
+    #     description: "Configuration profile used for examples.", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     application_id: "339ohji", 
+    #     description: "Configuration profile used for examples.", 
+    #     id: "ur8hx2f", 
+    #     location_uri: "ssm-parameter://Example-Parameter", 
+    #     name: "Example-Configuration-Profile", 
+    #     retrieval_role_arn: "arn:aws:iam::111122223333:role/Example-App-Config-Role", 
+    #   }
     #
     # @example Request syntax with placeholder values
     #
@@ -1903,6 +2614,7 @@ module Aws::AppConfig
     #   resp.validators #=> Array
     #   resp.validators[0].type #=> String, one of "JSON_SCHEMA", "LAMBDA"
     #   resp.validators[0].content #=> String
+    #   resp.type #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/appconfig-2019-10-09/UpdateConfigurationProfile AWS API Documentation
     #
@@ -1925,17 +2637,17 @@ module Aws::AppConfig
     #   Total amount of time for a deployment to last.
     #
     # @option params [Integer] :final_bake_time_in_minutes
-    #   The amount of time AppConfig monitors for alarms before considering
-    #   the deployment to be complete and no longer eligible for automatic
-    #   roll back.
+    #   The amount of time that AppConfig monitors for alarms before
+    #   considering the deployment to be complete and no longer eligible for
+    #   automatic rollback.
     #
     # @option params [Float] :growth_factor
     #   The percentage of targets to receive a deployed configuration during
     #   each interval.
     #
     # @option params [String] :growth_type
-    #   The algorithm used to define how percentage grows over time. AWS
-    #   AppConfig supports the following growth types:
+    #   The algorithm used to define how percentage grows over time. AppConfig
+    #   supports the following growth types:
     #
     #   **Linear**\: For this type, AppConfig processes the deployment by
     #   increments of the growth factor evenly distributed over the deployment
@@ -1973,6 +2685,28 @@ module Aws::AppConfig
     #   * {Types::DeploymentStrategy#final_bake_time_in_minutes #final_bake_time_in_minutes} => Integer
     #   * {Types::DeploymentStrategy#replicate_to #replicate_to} => String
     #
+    #
+    # @example Example: To update a deployment strategy
+    #
+    #   # The following update-deployment-strategy example updates final bake time to 20 minutes in the specified deployment
+    #   # strategy. ::
+    #
+    #   resp = client.update_deployment_strategy({
+    #     deployment_strategy_id: "1225qzk", 
+    #     final_bake_time_in_minutes: 20, 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     deployment_duration_in_minutes: 15, 
+    #     final_bake_time_in_minutes: 20, 
+    #     growth_factor: 25, 
+    #     growth_type: "LINEAR", 
+    #     id: "1225qzk", 
+    #     name: "Example-Deployment", 
+    #     replicate_to: "SSM_DOCUMENT", 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.update_deployment_strategy({
@@ -2030,6 +2764,26 @@ module Aws::AppConfig
     #   * {Types::Environment#state #state} => String
     #   * {Types::Environment#monitors #monitors} => Array&lt;Types::Monitor&gt;
     #
+    #
+    # @example Example: To update an environment
+    #
+    #   # The following update-environment example updates an environment's description.
+    #
+    #   resp = client.update_environment({
+    #     application_id: "339ohji", 
+    #     description: "An environment for examples.", 
+    #     environment_id: "54j1r29", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     application_id: "339ohji", 
+    #     description: "An environment for examples.", 
+    #     id: "54j1r29", 
+    #     name: "Example-Environment", 
+    #     state: "ROLLED_BACK", 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.update_environment({
@@ -2039,7 +2793,7 @@ module Aws::AppConfig
     #     description: "Description",
     #     monitors: [
     #       {
-    #         alarm_arn: "Arn",
+    #         alarm_arn: "StringWithLengthBetween1And2048", # required
     #         alarm_role_arn: "RoleArn",
     #       },
     #     ],
@@ -2079,6 +2833,17 @@ module Aws::AppConfig
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
+    #
+    # @example Example: To validate a configuration
+    #
+    #   # The following validate-configuration example uses the validators in a configuration profile to validate a configuration.
+    #
+    #   resp = client.validate_configuration({
+    #     application_id: "abc1234", 
+    #     configuration_profile_id: "ur8hx2f", 
+    #     configuration_version: "1", 
+    #   })
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.validate_configuration({
@@ -2109,7 +2874,7 @@ module Aws::AppConfig
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-appconfig'
-      context[:gem_version] = '1.19.0'
+      context[:gem_version] = '1.23.0'
       Seahorse::Client::Request.new(handlers, context)
     end