aws-sdk-costexplorer 1.69.0 → 1.92.0

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

@@ -26,8 +26,8 @@ module Aws::CostExplorer
     #   @return [String]
     #
     # @!attribute [rw] dimension_value
-    #   The dimension for the anomaly (for example, an Amazon Web Services
-    #   service in a service monitor).
+    #   The dimension for the anomaly (for example, an Amazon Web Service in
+    #   a service monitor).
     #   @return [String]
     #
     # @!attribute [rw] root_causes
@@ -69,14 +69,6 @@ module Aws::CostExplorer
 
     # The time period for an anomaly.
     #
-    # @note When making an API call, you may pass AnomalyDateInterval
-    #   data as a hash:
-    #
-    #       {
-    #         start_date: "YearMonthDay", # required
-    #         end_date: "YearMonthDay",
-    #       }
-    #
     # @!attribute [rw] start_date
     #   The first date an anomaly was observed.
     #   @return [String]
@@ -99,50 +91,6 @@ module Aws::CostExplorer
     # The content consists of detailed metadata and the current status of
     # the monitor object.
     #
-    # @note When making an API call, you may pass AnomalyMonitor
-    #   data as a hash:
-    #
-    #       {
-    #         monitor_arn: "GenericString",
-    #         monitor_name: "GenericString", # required
-    #         creation_date: "YearMonthDay",
-    #         last_updated_date: "YearMonthDay",
-    #         last_evaluated_date: "YearMonthDay",
-    #         monitor_type: "DIMENSIONAL", # required, accepts DIMENSIONAL, CUSTOM
-    #         monitor_dimension: "SERVICE", # accepts SERVICE
-    #         monitor_specification: {
-    #           or: [
-    #             {
-    #               # recursive Expression
-    #             },
-    #           ],
-    #           and: [
-    #             {
-    #               # recursive Expression
-    #             },
-    #           ],
-    #           not: {
-    #             # recursive Expression
-    #           },
-    #           dimensions: {
-    #             key: "AZ", # accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, LINKED_ACCOUNT_NAME, OPERATION, PURCHASE_TYPE, REGION, SERVICE, SERVICE_CODE, USAGE_TYPE, USAGE_TYPE_GROUP, RECORD_TYPE, OPERATING_SYSTEM, TENANCY, SCOPE, PLATFORM, SUBSCRIPTION_ID, LEGAL_ENTITY_NAME, DEPLOYMENT_OPTION, DATABASE_ENGINE, CACHE_ENGINE, INSTANCE_TYPE_FAMILY, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION, AGREEMENT_END_DATE_TIME_AFTER, AGREEMENT_END_DATE_TIME_BEFORE
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #           tags: {
-    #             key: "TagKey",
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #           cost_categories: {
-    #             key: "CostCategoryName",
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #         },
-    #         dimensional_value_count: 1,
-    #       }
-    #
     # @!attribute [rw] monitor_arn
     #   The Amazon Resource Name (ARN) value.
     #   @return [String]
@@ -172,46 +120,84 @@ module Aws::CostExplorer
     #   @return [String]
     #
     # @!attribute [rw] monitor_specification
-    #   Use `Expression` to filter by cost or by usage. There are two
-    #   patterns:
-    #
-    #   * Simple dimension values - You can set the dimension name and
-    #     values for the filters that you plan to use. For example, you can
-    #     filter for `REGION==us-east-1 OR REGION==us-west-1`. For
-    #     `GetRightsizingRecommendation`, the Region is a full name (for
-    #     example, `REGION==US East (N. Virginia)`. The `Expression` example
-    #     is as follows:
-    #
-    #     `\{ "Dimensions": \{ "Key": "REGION", "Values": [ "us-east-1",
-    #     “us-west-1” ] \} \}`
-    #
-    #     The list of dimension values are OR'd together to retrieve cost
-    #     or usage data. You can create `Expression` and `DimensionValues`
-    #     objects using either `with*` methods or `set*` methods in multiple
-    #     lines.
-    #
-    #   * Compound dimension values with logical operations - You can use
-    #     multiple `Expression` types and the logical operators `AND/OR/NOT`
-    #     to create a list of one or more `Expression` objects. By doing
-    #     this, you can filter on more advanced options. For example, you
-    #     can filter on `((REGION == us-east-1 OR REGION == us-west-1) OR
-    #     (TAG.Type == Type1)) AND (USAGE_TYPE != DataTransfer)`. The
-    #     `Expression` for that is as follows:
-    #
-    #     `\{ "And": [ \{"Or": [ \{"Dimensions": \{ "Key": "REGION",
-    #     "Values": [ "us-east-1", "us-west-1" ] \}\}, \{"Tags": \{ "Key":
-    #     "TagName", "Values": ["Value1"] \} \} ]\}, \{"Not":
-    #     \{"Dimensions": \{ "Key": "USAGE_TYPE", "Values": ["DataTransfer"]
-    #     \}\}\} ] \} `
+    #   Use `Expression` to filter in various Cost Explorer APIs.
+    #
+    #   Not all `Expression` types are supported in each API. Refer to the
+    #   documentation for each specific API to see what is supported.
+    #
+    #   There are two patterns:
+    #
+    #   * Simple dimension values.
+    #
+    #     * There are three types of simple dimension values:
+    #       `CostCategories`, `Tags`, and `Dimensions`.
+    #
+    #       * Specify the `CostCategories` field to define a filter that
+    #         acts on Cost Categories.
+    #
+    #       * Specify the `Tags` field to define a filter that acts on Cost
+    #         Allocation Tags.
+    #
+    #       * Specify the `Dimensions` field to define a filter that acts on
+    #         the [ `DimensionValues` ][1].
+    #
+    #     * For each filter type, you can set the dimension name and values
+    #       for the filters that you plan to use.
+    #
+    #       * For example, you can filter for `REGION==us-east-1 OR
+    #         REGION==us-west-1`. For `GetRightsizingRecommendation`, the
+    #         Region is a full name (for example, `REGION==US East (N.
+    #         Virginia)`.
+    #
+    #       * The corresponding `Expression` for this example is as follows:
+    #         `\{ "Dimensions": \{ "Key": "REGION", "Values": [ "us-east-1",
+    #         "us-west-1" ] \} \}`
+    #
+    #       * As shown in the previous example, lists of dimension values
+    #         are combined with `OR` when applying the filter.
+    #
+    #     * You can also set different match options to further control how
+    #       the filter behaves. Not all APIs support match options. Refer to
+    #       the documentation for each specific API to see what is
+    #       supported.
+    #
+    #       * For example, you can filter for linked account names that
+    #         start with "a".
+    #
+    #       * The corresponding `Expression` for this example is as follows:
+    #         `\{ "Dimensions": \{ "Key": "LINKED_ACCOUNT_NAME",
+    #         "MatchOptions": [ "STARTS_WITH" ], "Values": [ "a" ] \} \}`
+    #
+    #   * Compound `Expression` types with logical operations.
+    #
+    #     * You can use multiple `Expression` types and the logical
+    #       operators `AND/OR/NOT` to create a list of one or more
+    #       `Expression` objects. By doing this, you can filter by more
+    #       advanced options.
+    #
+    #     * For example, you can filter by `((REGION == us-east-1 OR REGION
+    #       == us-west-1) OR (TAG.Type == Type1)) AND (USAGE_TYPE !=
+    #       DataTransfer)`.
+    #
+    #     * The corresponding `Expression` for this example is as follows:
+    #       `\{ "And": [ \{"Or": [ \{"Dimensions": \{ "Key": "REGION",
+    #       "Values": [ "us-east-1", "us-west-1" ] \}\}, \{"Tags": \{ "Key":
+    #       "TagName", "Values": ["Value1"] \} \} ]\}, \{"Not":
+    #       \{"Dimensions": \{ "Key": "USAGE_TYPE", "Values":
+    #       ["DataTransfer"] \}\}\} ] \} `
     #
     #     <note markdown="1"> Because each `Expression` can have only one operator, the service
     #     returns an error if more than one is specified. The following
-    #     example shows an `Expression` object that creates an error.
+    #     example shows an `Expression` object that creates an error: ` \{
+    #     "And": [ ... ], "Dimensions": \{ "Key": "USAGE_TYPE", "Values": [
+    #     "DataTransfer" ] \} \} `
     #
-    #      </note>
+    #      The following is an example of the corresponding error message:
+    #     `"Expression has more than one roots. Only one root operator is
+    #     allowed for each expression: And, Or, Not, Dimensions, Tags,
+    #     CostCategories"`
     #
-    #     ` \{ "And": [ ... ], "DimensionValues": \{ "Dimension":
-    #     "USAGE_TYPE", "Values": [ "DataTransfer" ] \} \} `
+    #      </note>
     #
     #   <note markdown="1"> For the `GetRightsizingRecommendation` action, a combination of OR
     #   and NOT isn't supported. OR isn't supported between different
@@ -224,6 +210,10 @@ module Aws::CostExplorer
     #   `LINKED_ACCOUNT`.
     #
     #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_DimensionValues.html
     #   @return [Types::Expression]
     #
     # @!attribute [rw] dimensional_value_count
@@ -266,29 +256,27 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # The association between a monitor, threshold, and list of subscribers
-    # used to deliver notifications about anomalies detected by a monitor
-    # that exceeds a threshold. The content consists of the detailed
-    # metadata and the current status of the `AnomalySubscription` object.
+    # An `AnomalySubscription` resource (also referred to as an alert
+    # subscription) sends notifications about specific anomalies that meet
+    # an alerting criteria defined by you.
+    #
+    # You can specify the frequency of the alerts and the subscribers to
+    # notify.
+    #
+    # Anomaly subscriptions can be associated with one or more [
+    # `AnomalyMonitor` ][1] resources, and they only send notifications
+    # about anomalies detected by those associated monitors. You can also
+    # configure a threshold to further control which anomalies are included
+    # in the notifications.
     #
-    # @note When making an API call, you may pass AnomalySubscription
-    #   data as a hash:
+    # Anomalies that don’t exceed the chosen threshold and therefore don’t
+    # trigger notifications from an anomaly subscription will still be
+    # available on the console and from the [ `GetAnomalies` ][2] API.
     #
-    #       {
-    #         subscription_arn: "GenericString",
-    #         account_id: "GenericString",
-    #         monitor_arn_list: ["Arn"], # required
-    #         subscribers: [ # required
-    #           {
-    #             address: "SubscriberAddress",
-    #             type: "EMAIL", # accepts EMAIL, SNS
-    #             status: "CONFIRMED", # accepts CONFIRMED, DECLINED
-    #           },
-    #         ],
-    #         threshold: 1.0, # required
-    #         frequency: "DAILY", # required, accepts DAILY, IMMEDIATE, WEEKLY
-    #         subscription_name: "GenericString", # required
-    #       }
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_AnomalyMonitor.html
+    # [2]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_GetAnomalies.html
     #
     # @!attribute [rw] subscription_arn
     #   The `AnomalySubscription` Amazon Resource Name (ARN).
@@ -307,18 +295,84 @@ module Aws::CostExplorer
     #   @return [Array<Types::Subscriber>]
     #
     # @!attribute [rw] threshold
-    #   The dollar value that triggers a notification if the threshold is
-    #   exceeded.
+    #   (deprecated)
+    #
+    #   An absolute dollar value that must be exceeded by the anomaly's
+    #   total impact (see [Impact][1] for more details) for an anomaly
+    #   notification to be generated.
+    #
+    #   This field has been deprecated. To specify a threshold, use
+    #   ThresholdExpression. Continued use of Threshold will be treated as
+    #   shorthand syntax for a ThresholdExpression.
+    #
+    #   One of Threshold or ThresholdExpression is required for this
+    #   resource. You cannot specify both.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Impact.html
     #   @return [Float]
     #
     # @!attribute [rw] frequency
-    #   The frequency that anomaly reports are sent over email.
+    #   The frequency that anomaly notifications are sent. Notifications are
+    #   sent either over email (for DAILY and WEEKLY frequencies) or SNS
+    #   (for IMMEDIATE frequency). For more information, see [Creating an
+    #   Amazon SNS topic for anomaly notifications][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/cost-management/latest/userguide/ad-SNS.html
     #   @return [String]
     #
     # @!attribute [rw] subscription_name
     #   The name for the subscription.
     #   @return [String]
     #
+    # @!attribute [rw] threshold_expression
+    #   An [Expression][1] object used to specify the anomalies that you
+    #   want to generate alerts for. This supports dimensions and nested
+    #   expressions. The supported dimensions are
+    #   `ANOMALY_TOTAL_IMPACT_ABSOLUTE` and
+    #   `ANOMALY_TOTAL_IMPACT_PERCENTAGE`, corresponding to an anomaly’s
+    #   TotalImpact and TotalImpactPercentage, respectively (see [Impact][2]
+    #   for more details). The supported nested expression types are `AND`
+    #   and `OR`. The match option `GREATER_THAN_OR_EQUAL` is required.
+    #   Values must be numbers between 0 and 10,000,000,000 in string
+    #   format.
+    #
+    #   One of Threshold or ThresholdExpression is required for this
+    #   resource. You cannot specify both.
+    #
+    #   The following are examples of valid ThresholdExpressions:
+    #
+    #   * Absolute threshold: `\{ "Dimensions": \{ "Key":
+    #     "ANOMALY_TOTAL_IMPACT_ABSOLUTE", "MatchOptions": [
+    #     "GREATER_THAN_OR_EQUAL" ], "Values": [ "100" ] \} \}`
+    #
+    #   * Percentage threshold: `\{ "Dimensions": \{ "Key":
+    #     "ANOMALY_TOTAL_IMPACT_PERCENTAGE", "MatchOptions": [
+    #     "GREATER_THAN_OR_EQUAL" ], "Values": [ "100" ] \} \}`
+    #
+    #   * `AND` two thresholds together: `\{ "And": [ \{ "Dimensions": \{
+    #     "Key": "ANOMALY_TOTAL_IMPACT_ABSOLUTE", "MatchOptions": [
+    #     "GREATER_THAN_OR_EQUAL" ], "Values": [ "100" ] \} \}, \{
+    #     "Dimensions": \{ "Key": "ANOMALY_TOTAL_IMPACT_PERCENTAGE",
+    #     "MatchOptions": [ "GREATER_THAN_OR_EQUAL" ], "Values": [ "100" ]
+    #     \} \} ] \}`
+    #
+    #   * `OR` two thresholds together: `\{ "Or": [ \{ "Dimensions": \{
+    #     "Key": "ANOMALY_TOTAL_IMPACT_ABSOLUTE", "MatchOptions": [
+    #     "GREATER_THAN_OR_EQUAL" ], "Values": [ "100" ] \} \}, \{
+    #     "Dimensions": \{ "Key": "ANOMALY_TOTAL_IMPACT_PERCENTAGE",
+    #     "MatchOptions": [ "GREATER_THAN_OR_EQUAL" ], "Values": [ "100" ]
+    #     \} \} ] \}`
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
+    #   [2]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Impact.html
+    #   @return [Types::Expression]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/AnomalySubscription AWS API Documentation
     #
     class AnomalySubscription < Struct.new(
@@ -328,7 +382,8 @@ module Aws::CostExplorer
       :subscribers,
       :threshold,
       :frequency,
-      :subscription_name)
+      :subscription_name,
+      :threshold_expression)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -346,6 +401,66 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
+    # The cost allocation tag structure. This includes detailed metadata for
+    # the `CostAllocationTag` object.
+    #
+    # @!attribute [rw] tag_key
+    #   The key for the cost allocation tag.
+    #   @return [String]
+    #
+    # @!attribute [rw] type
+    #   The type of cost allocation tag. You can use `AWSGenerated` or
+    #   `UserDefined` type tags. `AWSGenerated` type tags are tags that
+    #   Amazon Web Services defines and applies to support Amazon Web
+    #   Services resources for cost allocation purposes. `UserDefined` type
+    #   tags are tags that you define, create, and apply to resources.
+    #   @return [String]
+    #
+    # @!attribute [rw] status
+    #   The status of a cost allocation tag.
+    #   @return [String]
+    #
+    # @!attribute [rw] last_updated_date
+    #   The last date that the tag was either activated or deactivated.
+    #   @return [String]
+    #
+    # @!attribute [rw] last_used_date
+    #   The last month that the tag was used on an Amazon Web Services
+    #   resource.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/CostAllocationTag AWS API Documentation
+    #
+    class CostAllocationTag < Struct.new(
+      :tag_key,
+      :type,
+      :status,
+      :last_updated_date,
+      :last_used_date)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # The cost allocation tag status. The status of a key can either be
+    # active or inactive.
+    #
+    # @!attribute [rw] tag_key
+    #   The key for the cost allocation tag.
+    #   @return [String]
+    #
+    # @!attribute [rw] status
+    #   The status of a cost allocation tag.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/CostAllocationTagStatusEntry AWS API Documentation
+    #
+    class CostAllocationTagStatusEntry < Struct.new(
+      :tag_key,
+      :status)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # The structure of Cost Categories. This includes detailed metadata and
     # the set of rules for the `CostCategory` object.
     #
@@ -354,11 +469,11 @@ module Aws::CostExplorer
     #   @return [String]
     #
     # @!attribute [rw] effective_start
-    #   The effective state data of your Cost Category.
+    #   The effective start date of your Cost Category.
     #   @return [String]
     #
     # @!attribute [rw] effective_end
-    #   The effective end data of your Cost Category.
+    #   The effective end date of your Cost Category.
     #   @return [String]
     #
     # @!attribute [rw] name
@@ -405,29 +520,21 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # When creating or updating a cost category, you can define the
+    # When you create or update a cost category, you can define the
     # `CostCategoryRule` rule type as `INHERITED_VALUE`. This rule type adds
-    # the flexibility of defining a rule that dynamically inherits the cost
-    # category value from the dimension value defined by
-    # `CostCategoryInheritedValueDimension`. For example, if you want to
-    # dynamically group costs that are based on the value of a specific tag
-    # key, first choose an inherited value rule type, then choose the tag
-    # dimension and specify the tag key to use.
-    #
-    # @note When making an API call, you may pass CostCategoryInheritedValueDimension
-    #   data as a hash:
-    #
-    #       {
-    #         dimension_name: "LINKED_ACCOUNT_NAME", # accepts LINKED_ACCOUNT_NAME, TAG
-    #         dimension_key: "GenericString",
-    #       }
+    # the flexibility to define a rule that dynamically inherits the cost
+    # category value from the dimension value that's defined by
+    # `CostCategoryInheritedValueDimension`. For example, suppose that you
+    # want to dynamically group costs that are based on the value of a
+    # specific tag key. First, choose an inherited value rule type, and then
+    # choose the tag dimension and specify the tag key to use.
     #
     # @!attribute [rw] dimension_name
     #   The name of the dimension that's used to group costs.
     #
     #   If you specify `LINKED_ACCOUNT_NAME`, the cost category value is
     #   based on account name. If you specify `TAG`, the cost category value
-    #   will be based on the value of the specified tag key.
+    #   is based on the value of the specified tag key.
     #   @return [String]
     #
     # @!attribute [rw] dimension_key
@@ -522,48 +629,6 @@ module Aws::CostExplorer
     # the line item, then the first rule to match is used to determine that
     # Cost Category value.
     #
-    # @note When making an API call, you may pass CostCategoryRule
-    #   data as a hash:
-    #
-    #       {
-    #         value: "CostCategoryValue",
-    #         rule: {
-    #           or: [
-    #             {
-    #               # recursive Expression
-    #             },
-    #           ],
-    #           and: [
-    #             {
-    #               # recursive Expression
-    #             },
-    #           ],
-    #           not: {
-    #             # recursive Expression
-    #           },
-    #           dimensions: {
-    #             key: "AZ", # accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, LINKED_ACCOUNT_NAME, OPERATION, PURCHASE_TYPE, REGION, SERVICE, SERVICE_CODE, USAGE_TYPE, USAGE_TYPE_GROUP, RECORD_TYPE, OPERATING_SYSTEM, TENANCY, SCOPE, PLATFORM, SUBSCRIPTION_ID, LEGAL_ENTITY_NAME, DEPLOYMENT_OPTION, DATABASE_ENGINE, CACHE_ENGINE, INSTANCE_TYPE_FAMILY, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION, AGREEMENT_END_DATE_TIME_AFTER, AGREEMENT_END_DATE_TIME_BEFORE
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #           tags: {
-    #             key: "TagKey",
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #           cost_categories: {
-    #             key: "CostCategoryName",
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #         },
-    #         inherited_value: {
-    #           dimension_name: "LINKED_ACCOUNT_NAME", # accepts LINKED_ACCOUNT_NAME, TAG
-    #           dimension_key: "GenericString",
-    #         },
-    #         type: "REGULAR", # accepts REGULAR, INHERITED_VALUE
-    #       }
-    #
     # @!attribute [rw] value
     #   The default value for the cost category.
     #   @return [String]
@@ -572,10 +637,7 @@ module Aws::CostExplorer
     #   An [Expression][1] object used to categorize costs. This supports
     #   dimensions, tags, and nested expressions. Currently the only
     #   dimensions supported are `LINKED_ACCOUNT`, `SERVICE_CODE`,
-    #   `RECORD_TYPE`, and `LINKED_ACCOUNT_NAME`.
-    #
-    #   Root level `OR` isn't supported. We recommend that you create a
-    #   separate rule instead.
+    #   `RECORD_TYPE`, `LINKED_ACCOUNT_NAME`, `REGION`, and `USAGE_TYPE`.
     #
     #   `RECORD_TYPE` is a dimension used for Cost Explorer APIs, and is
     #   also supported for Cost Category expressions. This dimension uses
@@ -597,12 +659,13 @@ module Aws::CostExplorer
     # @!attribute [rw] type
     #   You can define the `CostCategoryRule` rule type as either `REGULAR`
     #   or `INHERITED_VALUE`. The `INHERITED_VALUE` rule type adds the
-    #   flexibility of defining a rule that dynamically inherits the cost
-    #   category value from the dimension value defined by
-    #   `CostCategoryInheritedValueDimension`. For example, if you want to
-    #   dynamically group costs based on the value of a specific tag key,
-    #   first choose an inherited value rule type, then choose the tag
-    #   dimension and specify the tag key to use.
+    #   flexibility to define a rule that dynamically inherits the cost
+    #   category value. This value is from the dimension value that's
+    #   defined by `CostCategoryInheritedValueDimension`. For example,
+    #   suppose that you want to costs to be dynamically grouped based on
+    #   the value of a specific tag key. First, choose an inherited value
+    #   rule type, and then choose the tag dimension and specify the tag key
+    #   to use.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/CostCategoryRule AWS API Documentation
@@ -619,21 +682,6 @@ module Aws::CostExplorer
     # Use the split charge rule to split the cost of one Cost Category value
     # across several other target values.
     #
-    # @note When making an API call, you may pass CostCategorySplitChargeRule
-    #   data as a hash:
-    #
-    #       {
-    #         source: "GenericString", # required
-    #         targets: ["GenericString"], # required
-    #         method: "FIXED", # required, accepts FIXED, PROPORTIONAL, EVEN
-    #         parameters: [
-    #           {
-    #             type: "ALLOCATION_PERCENTAGES", # required, accepts ALLOCATION_PERCENTAGES
-    #             values: ["GenericString"], # required
-    #           },
-    #         ],
-    #       }
-    #
     # @!attribute [rw] source
     #   The Cost Category value that you want to split. That value can't be
     #   used as a source or a target in other split charge rules. To
@@ -677,14 +725,6 @@ module Aws::CostExplorer
 
     # The parameters for a split charge method.
     #
-    # @note When making an API call, you may pass CostCategorySplitChargeRuleParameter
-    #   data as a hash:
-    #
-    #       {
-    #         type: "ALLOCATION_PERCENTAGES", # required, accepts ALLOCATION_PERCENTAGES
-    #         values: ["GenericString"], # required
-    #       }
-    #
     # @!attribute [rw] type
     #   The parameter type.
     #   @return [String]
@@ -712,15 +752,6 @@ module Aws::CostExplorer
     # `MatchOption` is applied to the Cost Categories `Key` only. That is,
     # it filters on resources without the given Cost Categories key.
     #
-    # @note When making an API call, you may pass CostCategoryValues
-    #   data as a hash:
-    #
-    #       {
-    #         key: "CostCategoryName",
-    #         values: ["Value"],
-    #         match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #       }
-    #
     # @!attribute [rw] key
     #   The unique name of the Cost Category.
     #   @return [String]
@@ -886,60 +917,47 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass CreateAnomalyMonitorRequest
-    #   data as a hash:
-    #
-    #       {
-    #         anomaly_monitor: { # required
-    #           monitor_arn: "GenericString",
-    #           monitor_name: "GenericString", # required
-    #           creation_date: "YearMonthDay",
-    #           last_updated_date: "YearMonthDay",
-    #           last_evaluated_date: "YearMonthDay",
-    #           monitor_type: "DIMENSIONAL", # required, accepts DIMENSIONAL, CUSTOM
-    #           monitor_dimension: "SERVICE", # accepts SERVICE
-    #           monitor_specification: {
-    #             or: [
-    #               {
-    #                 # recursive Expression
-    #               },
-    #             ],
-    #             and: [
-    #               {
-    #                 # recursive Expression
-    #               },
-    #             ],
-    #             not: {
-    #               # recursive Expression
-    #             },
-    #             dimensions: {
-    #               key: "AZ", # accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, LINKED_ACCOUNT_NAME, OPERATION, PURCHASE_TYPE, REGION, SERVICE, SERVICE_CODE, USAGE_TYPE, USAGE_TYPE_GROUP, RECORD_TYPE, OPERATING_SYSTEM, TENANCY, SCOPE, PLATFORM, SUBSCRIPTION_ID, LEGAL_ENTITY_NAME, DEPLOYMENT_OPTION, DATABASE_ENGINE, CACHE_ENGINE, INSTANCE_TYPE_FAMILY, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION, AGREEMENT_END_DATE_TIME_AFTER, AGREEMENT_END_DATE_TIME_BEFORE
-    #               values: ["Value"],
-    #               match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #             },
-    #             tags: {
-    #               key: "TagKey",
-    #               values: ["Value"],
-    #               match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #             },
-    #             cost_categories: {
-    #               key: "CostCategoryName",
-    #               values: ["Value"],
-    #               match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #             },
-    #           },
-    #           dimensional_value_count: 1,
-    #         },
-    #       }
-    #
     # @!attribute [rw] anomaly_monitor
     #   The cost anomaly detection monitor object that you want to create.
     #   @return [Types::AnomalyMonitor]
     #
+    # @!attribute [rw] resource_tags
+    #   An optional list of tags to associate with the specified [
+    #   `AnomalyMonitor` ][1]. You can use resource tags to control access
+    #   to your `monitor` using IAM policies.
+    #
+    #   Each tag consists of a key and a value, and each key must be unique
+    #   for the resource. The following restrictions apply to resource tags:
+    #
+    #   * Although the maximum number of array members is 200, you can
+    #     assign a maximum of 50 user-tags to one resource. The remaining
+    #     are reserved for Amazon Web Services use
+    #
+    #   * The maximum length of a key is 128 characters
+    #
+    #   * The maximum length of a value is 256 characters
+    #
+    #   * Keys and values can only contain alphanumeric characters, spaces,
+    #     and any of the following: `_.:/=+@-`
+    #
+    #   * Keys and values are case sensitive
+    #
+    #   * Keys and values are trimmed for any leading or trailing
+    #     whitespaces
+    #
+    #   * Don’t use `aws:` as a prefix for your keys. This prefix is
+    #     reserved for Amazon Web Services use
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_AnomalyMonitor.html
+    #   @return [Array<Types::ResourceTag>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/CreateAnomalyMonitorRequest AWS API Documentation
     #
     class CreateAnomalyMonitorRequest < Struct.new(
-      :anomaly_monitor)
+      :anomaly_monitor,
+      :resource_tags)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -957,35 +975,47 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass CreateAnomalySubscriptionRequest
-    #   data as a hash:
-    #
-    #       {
-    #         anomaly_subscription: { # required
-    #           subscription_arn: "GenericString",
-    #           account_id: "GenericString",
-    #           monitor_arn_list: ["Arn"], # required
-    #           subscribers: [ # required
-    #             {
-    #               address: "SubscriberAddress",
-    #               type: "EMAIL", # accepts EMAIL, SNS
-    #               status: "CONFIRMED", # accepts CONFIRMED, DECLINED
-    #             },
-    #           ],
-    #           threshold: 1.0, # required
-    #           frequency: "DAILY", # required, accepts DAILY, IMMEDIATE, WEEKLY
-    #           subscription_name: "GenericString", # required
-    #         },
-    #       }
-    #
     # @!attribute [rw] anomaly_subscription
     #   The cost anomaly subscription object that you want to create.
     #   @return [Types::AnomalySubscription]
     #
+    # @!attribute [rw] resource_tags
+    #   An optional list of tags to associate with the specified [
+    #   `AnomalySubscription` ][1]. You can use resource tags to control
+    #   access to your `subscription` using IAM policies.
+    #
+    #   Each tag consists of a key and a value, and each key must be unique
+    #   for the resource. The following restrictions apply to resource tags:
+    #
+    #   * Although the maximum number of array members is 200, you can
+    #     assign a maximum of 50 user-tags to one resource. The remaining
+    #     are reserved for Amazon Web Services use
+    #
+    #   * The maximum length of a key is 128 characters
+    #
+    #   * The maximum length of a value is 256 characters
+    #
+    #   * Keys and values can only contain alphanumeric characters, spaces,
+    #     and any of the following: `_.:/=+@-`
+    #
+    #   * Keys and values are case sensitive
+    #
+    #   * Keys and values are trimmed for any leading or trailing
+    #     whitespaces
+    #
+    #   * Don’t use `aws:` as a prefix for your keys. This prefix is
+    #     reserved for Amazon Web Services use
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_AnomalySubscription.html
+    #   @return [Array<Types::ResourceTag>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/CreateAnomalySubscriptionRequest AWS API Documentation
     #
     class CreateAnomalySubscriptionRequest < Struct.new(
-      :anomaly_subscription)
+      :anomaly_subscription,
+      :resource_tags)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1003,72 +1033,17 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass CreateCostCategoryDefinitionRequest
-    #   data as a hash:
-    #
-    #       {
-    #         name: "CostCategoryName", # required
-    #         rule_version: "CostCategoryExpression.v1", # required, accepts CostCategoryExpression.v1
-    #         rules: [ # required
-    #           {
-    #             value: "CostCategoryValue",
-    #             rule: {
-    #               or: [
-    #                 {
-    #                   # recursive Expression
-    #                 },
-    #               ],
-    #               and: [
-    #                 {
-    #                   # recursive Expression
-    #                 },
-    #               ],
-    #               not: {
-    #                 # recursive Expression
-    #               },
-    #               dimensions: {
-    #                 key: "AZ", # accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, LINKED_ACCOUNT_NAME, OPERATION, PURCHASE_TYPE, REGION, SERVICE, SERVICE_CODE, USAGE_TYPE, USAGE_TYPE_GROUP, RECORD_TYPE, OPERATING_SYSTEM, TENANCY, SCOPE, PLATFORM, SUBSCRIPTION_ID, LEGAL_ENTITY_NAME, DEPLOYMENT_OPTION, DATABASE_ENGINE, CACHE_ENGINE, INSTANCE_TYPE_FAMILY, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION, AGREEMENT_END_DATE_TIME_AFTER, AGREEMENT_END_DATE_TIME_BEFORE
-    #                 values: ["Value"],
-    #                 match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #               },
-    #               tags: {
-    #                 key: "TagKey",
-    #                 values: ["Value"],
-    #                 match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #               },
-    #               cost_categories: {
-    #                 key: "CostCategoryName",
-    #                 values: ["Value"],
-    #                 match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #               },
-    #             },
-    #             inherited_value: {
-    #               dimension_name: "LINKED_ACCOUNT_NAME", # accepts LINKED_ACCOUNT_NAME, TAG
-    #               dimension_key: "GenericString",
-    #             },
-    #             type: "REGULAR", # accepts REGULAR, INHERITED_VALUE
-    #           },
-    #         ],
-    #         default_value: "CostCategoryValue",
-    #         split_charge_rules: [
-    #           {
-    #             source: "GenericString", # required
-    #             targets: ["GenericString"], # required
-    #             method: "FIXED", # required, accepts FIXED, PROPORTIONAL, EVEN
-    #             parameters: [
-    #               {
-    #                 type: "ALLOCATION_PERCENTAGES", # required, accepts ALLOCATION_PERCENTAGES
-    #                 values: ["GenericString"], # required
-    #               },
-    #             ],
-    #           },
-    #         ],
-    #       }
-    #
     # @!attribute [rw] name
     #   The unique name of the Cost Category.
     #   @return [String]
     #
+    # @!attribute [rw] effective_start
+    #   The Cost Category's effective start date. It can only be a billing
+    #   start date (first day of the month). If the date isn't provided,
+    #   it's the first day of the current month. Dates can't be before the
+    #   previous twelve months, or in the future.
+    #   @return [String]
+    #
     # @!attribute [rw] rule_version
     #   The rule schema version in this particular Cost Category.
     #   @return [String]
@@ -1091,14 +1066,48 @@ module Aws::CostExplorer
     #   Cost Category values.
     #   @return [Array<Types::CostCategorySplitChargeRule>]
     #
+    # @!attribute [rw] resource_tags
+    #   An optional list of tags to associate with the specified [
+    #   `CostCategory` ][1]. You can use resource tags to control access to
+    #   your `cost category` using IAM policies.
+    #
+    #   Each tag consists of a key and a value, and each key must be unique
+    #   for the resource. The following restrictions apply to resource tags:
+    #
+    #   * Although the maximum number of array members is 200, you can
+    #     assign a maximum of 50 user-tags to one resource. The remaining
+    #     are reserved for Amazon Web Services use
+    #
+    #   * The maximum length of a key is 128 characters
+    #
+    #   * The maximum length of a value is 256 characters
+    #
+    #   * Keys and values can only contain alphanumeric characters, spaces,
+    #     and any of the following: `_.:/=+@-`
+    #
+    #   * Keys and values are case sensitive
+    #
+    #   * Keys and values are trimmed for any leading or trailing
+    #     whitespaces
+    #
+    #   * Don’t use `aws:` as a prefix for your keys. This prefix is
+    #     reserved for Amazon Web Services use
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_CostCategory.html
+    #   @return [Array<Types::ResourceTag>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/CreateCostCategoryDefinitionRequest AWS API Documentation
     #
     class CreateCostCategoryDefinitionRequest < Struct.new(
       :name,
+      :effective_start,
       :rule_version,
       :rules,
       :default_value,
-      :split_charge_rules)
+      :split_charge_rules,
+      :resource_tags)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1108,7 +1117,8 @@ module Aws::CostExplorer
     #   @return [String]
     #
     # @!attribute [rw] effective_start
-    #   The Cost Category's effective start date.
+    #   The Cost Category's effective start date. It can only be a billing
+    #   start date (first day of the month).
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/CreateCostCategoryDefinitionResponse AWS API Documentation
@@ -1207,14 +1217,6 @@ module Aws::CostExplorer
 
     # The time period of the request.
     #
-    # @note When making an API call, you may pass DateInterval
-    #   data as a hash:
-    #
-    #       {
-    #         start: "YearMonthDay", # required
-    #         end: "YearMonthDay", # required
-    #       }
-    #
     # @!attribute [rw] start
     #   The beginning of the time period. The start date is inclusive. For
     #   example, if `start` is `2017-01-01`, Amazon Web Services retrieves
@@ -1239,13 +1241,6 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass DeleteAnomalyMonitorRequest
-    #   data as a hash:
-    #
-    #       {
-    #         monitor_arn: "GenericString", # required
-    #       }
-    #
     # @!attribute [rw] monitor_arn
     #   The unique identifier of the cost anomaly monitor that you want to
     #   delete.
@@ -1263,13 +1258,6 @@ module Aws::CostExplorer
     #
     class DeleteAnomalyMonitorResponse < Aws::EmptyStructure; end
 
-    # @note When making an API call, you may pass DeleteAnomalySubscriptionRequest
-    #   data as a hash:
-    #
-    #       {
-    #         subscription_arn: "GenericString", # required
-    #       }
-    #
     # @!attribute [rw] subscription_arn
     #   The unique identifier of the cost anomaly subscription that you want
     #   to delete.
@@ -1287,13 +1275,6 @@ module Aws::CostExplorer
     #
     class DeleteAnomalySubscriptionResponse < Aws::EmptyStructure; end
 
-    # @note When making an API call, you may pass DeleteCostCategoryDefinitionRequest
-    #   data as a hash:
-    #
-    #       {
-    #         cost_category_arn: "Arn", # required
-    #       }
-    #
     # @!attribute [rw] cost_category_arn
     #   The unique identifier for your Cost Category.
     #   @return [String]
@@ -1312,7 +1293,7 @@ module Aws::CostExplorer
     #
     # @!attribute [rw] effective_end
     #   The effective end date of the Cost Category as a result of deleting
-    #   it. No costs after this date will be categorized by the deleted Cost
+    #   it. No costs after this date is categorized by the deleted Cost
     #   Category.
     #   @return [String]
     #
@@ -1325,14 +1306,6 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass DescribeCostCategoryDefinitionRequest
-    #   data as a hash:
-    #
-    #       {
-    #         cost_category_arn: "Arn", # required
-    #         effective_on: "ZonedDateTime",
-    #       }
-    #
     # @!attribute [rw] cost_category_arn
     #   The unique identifier for your Cost Category.
     #   @return [String]
@@ -1366,19 +1339,25 @@ module Aws::CostExplorer
     # The metadata that you can use to filter and group your results. You
     # can use `GetDimensionValues` to find specific values.
     #
-    # @note When making an API call, you may pass DimensionValues
-    #   data as a hash:
-    #
-    #       {
-    #         key: "AZ", # accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, LINKED_ACCOUNT_NAME, OPERATION, PURCHASE_TYPE, REGION, SERVICE, SERVICE_CODE, USAGE_TYPE, USAGE_TYPE_GROUP, RECORD_TYPE, OPERATING_SYSTEM, TENANCY, SCOPE, PLATFORM, SUBSCRIPTION_ID, LEGAL_ENTITY_NAME, DEPLOYMENT_OPTION, DATABASE_ENGINE, CACHE_ENGINE, INSTANCE_TYPE_FAMILY, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION, AGREEMENT_END_DATE_TIME_AFTER, AGREEMENT_END_DATE_TIME_BEFORE
-    #         values: ["Value"],
-    #         match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #       }
-    #
     # @!attribute [rw] key
     #   The names of the metadata types that you can use to filter and group
     #   your results. For example, `AZ` returns a list of Availability
     #   Zones.
+    #
+    #   Not all dimensions are supported in each API. Refer to the
+    #   documentation for each specific API to see what is supported.
+    #
+    #   `LINK_ACCOUNT_NAME` and `SERVICE_CODE` can only be used in
+    #   [CostCategoryRule][1].
+    #
+    #   `ANOMALY_TOTAL_IMPACT_ABSOLUTE` and
+    #   `ANOMALY_TOTAL_IMPACT_PERCENTAGE` can only be used in
+    #   [AnomalySubscriptions][2].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_CostCategoryRule.html
+    #   [2]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_AnomalySubscription.html
     #   @return [String]
     #
     # @!attribute [rw] values
@@ -1388,8 +1367,12 @@ module Aws::CostExplorer
     #
     # @!attribute [rw] match_options
     #   The match options that you can use to filter your results.
+    #
     #   `MatchOptions` is only applicable for actions related to Cost
-    #   Category. The default values for `MatchOptions` are `EQUALS` and
+    #   Category and Anomaly Subscriptions. Refer to the documentation for
+    #   each specific API to see what is supported.
+    #
+    #   The default values for `MatchOptions` are `EQUALS` and
     #   `CASE_SENSITIVE`.
     #   @return [Array<String>]
     #
@@ -1484,7 +1467,7 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # Details about the Amazon EC2 instances that Amazon Web Services
+    # Details about the Amazon EC2 reservations that Amazon Web Services
     # recommends that you purchase.
     #
     # @!attribute [rw] family
@@ -1596,7 +1579,7 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # Utilization metrics of the instance.
+    # Utilization metrics for the instance.
     #
     # @!attribute [rw] max_cpu_utilization_percentage
     #   The maximum observed or expected CPU utilization of the instance.
@@ -1642,13 +1625,6 @@ module Aws::CostExplorer
     # The Amazon EC2 hardware specifications that you want Amazon Web
     # Services to provide recommendations for.
     #
-    # @note When making an API call, you may pass EC2Specification
-    #   data as a hash:
-    #
-    #       {
-    #         offering_class: "STANDARD", # accepts STANDARD, CONVERTIBLE
-    #       }
-    #
     # @!attribute [rw] offering_class
     #   Indicates whether you want a recommendation for standard or
     #   convertible reservations.
@@ -1662,8 +1638,8 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # Details about the Amazon ES instances that Amazon Web Services
-    # recommends that you purchase.
+    # Details about the Amazon OpenSearch Service reservations that Amazon
+    # Web Services recommends that you purchase.
     #
     # @!attribute [rw] instance_class
     #   The class of instance that Amazon Web Services recommends.
@@ -1698,7 +1674,7 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # Details about the Amazon ElastiCache instances that Amazon Web
+    # Details about the Amazon ElastiCache reservations that Amazon Web
     # Services recommends that you purchase.
     #
     # @!attribute [rw] family
@@ -1739,45 +1715,81 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # Use `Expression` to filter by cost or by usage. There are two
-    # patterns:
+    # Use `Expression` to filter in various Cost Explorer APIs.
+    #
+    # Not all `Expression` types are supported in each API. Refer to the
+    # documentation for each specific API to see what is supported.
+    #
+    # There are two patterns:
+    #
+    # * Simple dimension values.
+    #
+    #   * There are three types of simple dimension values:
+    #     `CostCategories`, `Tags`, and `Dimensions`.
+    #
+    #     * Specify the `CostCategories` field to define a filter that acts
+    #       on Cost Categories.
+    #
+    #     * Specify the `Tags` field to define a filter that acts on Cost
+    #       Allocation Tags.
+    #
+    #     * Specify the `Dimensions` field to define a filter that acts on
+    #       the [ `DimensionValues` ][1].
     #
-    # * Simple dimension values - You can set the dimension name and values
-    #   for the filters that you plan to use. For example, you can filter
-    #   for `REGION==us-east-1 OR REGION==us-west-1`. For
-    #   `GetRightsizingRecommendation`, the Region is a full name (for
-    #   example, `REGION==US East (N. Virginia)`. The `Expression` example
-    #   is as follows:
+    #   * For each filter type, you can set the dimension name and values
+    #     for the filters that you plan to use.
     #
-    #   `\{ "Dimensions": \{ "Key": "REGION", "Values": [ "us-east-1",
-    #   “us-west-1” ] \} \}`
+    #     * For example, you can filter for `REGION==us-east-1 OR
+    #       REGION==us-west-1`. For `GetRightsizingRecommendation`, the
+    #       Region is a full name (for example, `REGION==US East (N.
+    #       Virginia)`.
     #
-    #   The list of dimension values are OR'd together to retrieve cost or
-    #   usage data. You can create `Expression` and `DimensionValues`
-    #   objects using either `with*` methods or `set*` methods in multiple
-    #   lines.
+    #     * The corresponding `Expression` for this example is as follows:
+    #       `\{ "Dimensions": \{ "Key": "REGION", "Values": [ "us-east-1",
+    #       "us-west-1" ] \} \}`
     #
-    # * Compound dimension values with logical operations - You can use
-    #   multiple `Expression` types and the logical operators `AND/OR/NOT`
-    #   to create a list of one or more `Expression` objects. By doing this,
-    #   you can filter on more advanced options. For example, you can filter
-    #   on `((REGION == us-east-1 OR REGION == us-west-1) OR (TAG.Type ==
-    #   Type1)) AND (USAGE_TYPE != DataTransfer)`. The `Expression` for that
-    #   is as follows:
+    #     * As shown in the previous example, lists of dimension values are
+    #       combined with `OR` when applying the filter.
     #
-    #   `\{ "And": [ \{"Or": [ \{"Dimensions": \{ "Key": "REGION", "Values":
-    #   [ "us-east-1", "us-west-1" ] \}\}, \{"Tags": \{ "Key": "TagName",
-    #   "Values": ["Value1"] \} \} ]\}, \{"Not": \{"Dimensions": \{ "Key":
-    #   "USAGE_TYPE", "Values": ["DataTransfer"] \}\}\} ] \} `
+    #   * You can also set different match options to further control how
+    #     the filter behaves. Not all APIs support match options. Refer to
+    #     the documentation for each specific API to see what is supported.
+    #
+    #     * For example, you can filter for linked account names that start
+    #       with "a".
+    #
+    #     * The corresponding `Expression` for this example is as follows:
+    #       `\{ "Dimensions": \{ "Key": "LINKED_ACCOUNT_NAME",
+    #       "MatchOptions": [ "STARTS_WITH" ], "Values": [ "a" ] \} \}`
+    #
+    # * Compound `Expression` types with logical operations.
+    #
+    #   * You can use multiple `Expression` types and the logical operators
+    #     `AND/OR/NOT` to create a list of one or more `Expression` objects.
+    #     By doing this, you can filter by more advanced options.
+    #
+    #   * For example, you can filter by `((REGION == us-east-1 OR REGION ==
+    #     us-west-1) OR (TAG.Type == Type1)) AND (USAGE_TYPE !=
+    #     DataTransfer)`.
+    #
+    #   * The corresponding `Expression` for this example is as follows: `\{
+    #     "And": [ \{"Or": [ \{"Dimensions": \{ "Key": "REGION", "Values": [
+    #     "us-east-1", "us-west-1" ] \}\}, \{"Tags": \{ "Key": "TagName",
+    #     "Values": ["Value1"] \} \} ]\}, \{"Not": \{"Dimensions": \{ "Key":
+    #     "USAGE_TYPE", "Values": ["DataTransfer"] \}\}\} ] \} `
     #
     #   <note markdown="1"> Because each `Expression` can have only one operator, the service
     #   returns an error if more than one is specified. The following
-    #   example shows an `Expression` object that creates an error.
+    #   example shows an `Expression` object that creates an error: ` \{
+    #   "And": [ ... ], "Dimensions": \{ "Key": "USAGE_TYPE", "Values": [
+    #   "DataTransfer" ] \} \} `
     #
-    #    </note>
+    #    The following is an example of the corresponding error message:
+    #   `"Expression has more than one roots. Only one root operator is
+    #   allowed for each expression: And, Or, Not, Dimensions, Tags,
+    #   CostCategories"`
     #
-    #   ` \{ "And": [ ... ], "DimensionValues": \{ "Dimension":
-    #   "USAGE_TYPE", "Values": [ "DataTransfer" ] \} \} `
+    #    </note>
     #
     # <note markdown="1"> For the `GetRightsizingRecommendation` action, a combination of OR and
     # NOT isn't supported. OR isn't supported between different
@@ -1791,112 +1803,9 @@ module Aws::CostExplorer
     #
     #  </note>
     #
-    # @note When making an API call, you may pass Expression
-    #   data as a hash:
-    #
-    #       {
-    #         or: [
-    #           {
-    #             or: {
-    #               # recursive Expressions
-    #             },
-    #             and: {
-    #               # recursive Expressions
-    #             },
-    #             not: {
-    #               # recursive Expression
-    #             },
-    #             dimensions: {
-    #               key: "AZ", # accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, LINKED_ACCOUNT_NAME, OPERATION, PURCHASE_TYPE, REGION, SERVICE, SERVICE_CODE, USAGE_TYPE, USAGE_TYPE_GROUP, RECORD_TYPE, OPERATING_SYSTEM, TENANCY, SCOPE, PLATFORM, SUBSCRIPTION_ID, LEGAL_ENTITY_NAME, DEPLOYMENT_OPTION, DATABASE_ENGINE, CACHE_ENGINE, INSTANCE_TYPE_FAMILY, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION, AGREEMENT_END_DATE_TIME_AFTER, AGREEMENT_END_DATE_TIME_BEFORE
-    #               values: ["Value"],
-    #               match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #             },
-    #             tags: {
-    #               key: "TagKey",
-    #               values: ["Value"],
-    #               match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #             },
-    #             cost_categories: {
-    #               key: "CostCategoryName",
-    #               values: ["Value"],
-    #               match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #             },
-    #           },
-    #         ],
-    #         and: [
-    #           {
-    #             or: {
-    #               # recursive Expressions
-    #             },
-    #             and: {
-    #               # recursive Expressions
-    #             },
-    #             not: {
-    #               # recursive Expression
-    #             },
-    #             dimensions: {
-    #               key: "AZ", # accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, LINKED_ACCOUNT_NAME, OPERATION, PURCHASE_TYPE, REGION, SERVICE, SERVICE_CODE, USAGE_TYPE, USAGE_TYPE_GROUP, RECORD_TYPE, OPERATING_SYSTEM, TENANCY, SCOPE, PLATFORM, SUBSCRIPTION_ID, LEGAL_ENTITY_NAME, DEPLOYMENT_OPTION, DATABASE_ENGINE, CACHE_ENGINE, INSTANCE_TYPE_FAMILY, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION, AGREEMENT_END_DATE_TIME_AFTER, AGREEMENT_END_DATE_TIME_BEFORE
-    #               values: ["Value"],
-    #               match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #             },
-    #             tags: {
-    #               key: "TagKey",
-    #               values: ["Value"],
-    #               match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #             },
-    #             cost_categories: {
-    #               key: "CostCategoryName",
-    #               values: ["Value"],
-    #               match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #             },
-    #           },
-    #         ],
-    #         not: {
-    #           or: [
-    #             {
-    #               # recursive Expression
-    #             },
-    #           ],
-    #           and: [
-    #             {
-    #               # recursive Expression
-    #             },
-    #           ],
-    #           not: {
-    #             # recursive Expression
-    #           },
-    #           dimensions: {
-    #             key: "AZ", # accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, LINKED_ACCOUNT_NAME, OPERATION, PURCHASE_TYPE, REGION, SERVICE, SERVICE_CODE, USAGE_TYPE, USAGE_TYPE_GROUP, RECORD_TYPE, OPERATING_SYSTEM, TENANCY, SCOPE, PLATFORM, SUBSCRIPTION_ID, LEGAL_ENTITY_NAME, DEPLOYMENT_OPTION, DATABASE_ENGINE, CACHE_ENGINE, INSTANCE_TYPE_FAMILY, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION, AGREEMENT_END_DATE_TIME_AFTER, AGREEMENT_END_DATE_TIME_BEFORE
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #           tags: {
-    #             key: "TagKey",
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #           cost_categories: {
-    #             key: "CostCategoryName",
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #         },
-    #         dimensions: {
-    #           key: "AZ", # accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, LINKED_ACCOUNT_NAME, OPERATION, PURCHASE_TYPE, REGION, SERVICE, SERVICE_CODE, USAGE_TYPE, USAGE_TYPE_GROUP, RECORD_TYPE, OPERATING_SYSTEM, TENANCY, SCOPE, PLATFORM, SUBSCRIPTION_ID, LEGAL_ENTITY_NAME, DEPLOYMENT_OPTION, DATABASE_ENGINE, CACHE_ENGINE, INSTANCE_TYPE_FAMILY, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION, AGREEMENT_END_DATE_TIME_AFTER, AGREEMENT_END_DATE_TIME_BEFORE
-    #           values: ["Value"],
-    #           match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #         },
-    #         tags: {
-    #           key: "TagKey",
-    #           values: ["Value"],
-    #           match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #         },
-    #         cost_categories: {
-    #           key: "CostCategoryName",
-    #           values: ["Value"],
-    #           match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #         },
-    #       }
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_DimensionValues.html
     #
     # @!attribute [rw] or
     #   Return results that match either `Dimension` object.
@@ -1964,25 +1873,55 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass GetAnomaliesRequest
-    #   data as a hash:
+    # A request to generate a recommendation is already in progress.
+    #
+    # @!attribute [rw] message
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GenerationExistsException AWS API Documentation
+    #
+    class GenerationExistsException < Struct.new(
+      :message)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # The summary of the Savings Plans recommendation generation.
+    #
+    # @!attribute [rw] recommendation_id
+    #   Indicates the ID for this specific recommendation.
+    #   @return [String]
+    #
+    # @!attribute [rw] generation_status
+    #   Indicates whether the recommendation generation succeeded, is
+    #   processing, or failed.
+    #   @return [String]
+    #
+    # @!attribute [rw] generation_started_time
+    #   Indicates the start time of the recommendation generation.
+    #   @return [String]
+    #
+    # @!attribute [rw] generation_completion_time
+    #   Indicates the completion time of the recommendation generation.
+    #   @return [String]
+    #
+    # @!attribute [rw] estimated_completion_time
+    #   Indicates the estimated time for when the recommendation generation
+    #   will complete.
+    #   @return [String]
     #
-    #       {
-    #         monitor_arn: "GenericString",
-    #         date_interval: { # required
-    #           start_date: "YearMonthDay", # required
-    #           end_date: "YearMonthDay",
-    #         },
-    #         feedback: "YES", # accepts YES, NO, PLANNED_ACTIVITY
-    #         total_impact: {
-    #           numeric_operator: "EQUAL", # required, accepts EQUAL, GREATER_THAN_OR_EQUAL, LESS_THAN_OR_EQUAL, GREATER_THAN, LESS_THAN, BETWEEN
-    #           start_value: 1.0, # required
-    #           end_value: 1.0,
-    #         },
-    #         next_page_token: "NextPageToken",
-    #         max_results: 1,
-    #       }
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GenerationSummary AWS API Documentation
     #
+    class GenerationSummary < Struct.new(
+      :recommendation_id,
+      :generation_status,
+      :generation_started_time,
+      :generation_completion_time,
+      :estimated_completion_time)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] monitor_arn
     #   Retrieves all of the cost anomalies detected for a specific cost
     #   anomaly monitor Amazon Resource Name (ARN).
@@ -2047,15 +1986,6 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass GetAnomalyMonitorsRequest
-    #   data as a hash:
-    #
-    #       {
-    #         monitor_arn_list: ["Value"],
-    #         next_page_token: "NextPageToken",
-    #         max_results: 1,
-    #       }
-    #
     # @!attribute [rw] monitor_arn_list
     #   A list of cost anomaly monitor ARNs.
     #   @return [Array<String>]
@@ -2100,16 +2030,6 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass GetAnomalySubscriptionsRequest
-    #   data as a hash:
-    #
-    #       {
-    #         subscription_arn_list: ["Value"],
-    #         monitor_arn: "GenericString",
-    #         next_page_token: "NextPageToken",
-    #         max_results: 1,
-    #       }
-    #
     # @!attribute [rw] subscription_arn_list
     #   A list of cost anomaly subscription ARNs.
     #   @return [Array<String>]
@@ -2159,55 +2079,6 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass GetCostAndUsageRequest
-    #   data as a hash:
-    #
-    #       {
-    #         time_period: { # required
-    #           start: "YearMonthDay", # required
-    #           end: "YearMonthDay", # required
-    #         },
-    #         granularity: "DAILY", # required, accepts DAILY, MONTHLY, HOURLY
-    #         filter: {
-    #           or: [
-    #             {
-    #               # recursive Expression
-    #             },
-    #           ],
-    #           and: [
-    #             {
-    #               # recursive Expression
-    #             },
-    #           ],
-    #           not: {
-    #             # recursive Expression
-    #           },
-    #           dimensions: {
-    #             key: "AZ", # accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, LINKED_ACCOUNT_NAME, OPERATION, PURCHASE_TYPE, REGION, SERVICE, SERVICE_CODE, USAGE_TYPE, USAGE_TYPE_GROUP, RECORD_TYPE, OPERATING_SYSTEM, TENANCY, SCOPE, PLATFORM, SUBSCRIPTION_ID, LEGAL_ENTITY_NAME, DEPLOYMENT_OPTION, DATABASE_ENGINE, CACHE_ENGINE, INSTANCE_TYPE_FAMILY, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION, AGREEMENT_END_DATE_TIME_AFTER, AGREEMENT_END_DATE_TIME_BEFORE
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #           tags: {
-    #             key: "TagKey",
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #           cost_categories: {
-    #             key: "CostCategoryName",
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #         },
-    #         metrics: ["MetricName"], # required
-    #         group_by: [
-    #           {
-    #             type: "DIMENSION", # accepts DIMENSION, TAG, COST_CATEGORY
-    #             key: "GroupDefinitionKey",
-    #           },
-    #         ],
-    #         next_page_token: "NextPageToken",
-    #       }
-    #
     # @!attribute [rw] time_period
     #   Sets the start date and end date for retrieving Amazon Web Services
     #   costs. The start date is inclusive, but the end date is exclusive.
@@ -2230,6 +2101,13 @@ module Aws::CostExplorer
     #   service. You can nest `Expression` objects to define any combination
     #   of dimension filters. For more information, see [Expression][1].
     #
+    #   Valid values for `MatchOptions` for `Dimensions` are `EQUALS` and
+    #   `CASE_SENSITIVE`.
+    #
+    #   Valid values for `MatchOptions` for `CostCategories` and `Tags` are
+    #   `EQUALS`, `ABSENT`, and `CASE_SENSITIVE`. Default values are
+    #   `EQUALS` and `CASE_SENSITIVE`.
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
@@ -2267,9 +2145,9 @@ module Aws::CostExplorer
     #   group by types.
     #
     #   Valid values for the `DIMENSION` type are `AZ`, `INSTANCE_TYPE`,
-    #   `LEGAL_ENTITY_NAME`, `LINKED_ACCOUNT`, `OPERATION`, `PLATFORM`,
-    #   `PURCHASE_TYPE`, `SERVICE`, `TENANCY`, `RECORD_TYPE`, and
-    #   `USAGE_TYPE`.
+    #   `LEGAL_ENTITY_NAME`, `INVOICING_ENTITY`, `LINKED_ACCOUNT`,
+    #   `OPERATION`, `PLATFORM`, `PURCHASE_TYPE`, `SERVICE`, `TENANCY`,
+    #   `RECORD_TYPE`, and `USAGE_TYPE`.
     #
     #   When you group by the `TAG` type and include a valid tag key, you
     #   get all tag values, including empty strings.
@@ -2326,55 +2204,6 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass GetCostAndUsageWithResourcesRequest
-    #   data as a hash:
-    #
-    #       {
-    #         time_period: { # required
-    #           start: "YearMonthDay", # required
-    #           end: "YearMonthDay", # required
-    #         },
-    #         granularity: "DAILY", # required, accepts DAILY, MONTHLY, HOURLY
-    #         filter: { # required
-    #           or: [
-    #             {
-    #               # recursive Expression
-    #             },
-    #           ],
-    #           and: [
-    #             {
-    #               # recursive Expression
-    #             },
-    #           ],
-    #           not: {
-    #             # recursive Expression
-    #           },
-    #           dimensions: {
-    #             key: "AZ", # accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, LINKED_ACCOUNT_NAME, OPERATION, PURCHASE_TYPE, REGION, SERVICE, SERVICE_CODE, USAGE_TYPE, USAGE_TYPE_GROUP, RECORD_TYPE, OPERATING_SYSTEM, TENANCY, SCOPE, PLATFORM, SUBSCRIPTION_ID, LEGAL_ENTITY_NAME, DEPLOYMENT_OPTION, DATABASE_ENGINE, CACHE_ENGINE, INSTANCE_TYPE_FAMILY, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION, AGREEMENT_END_DATE_TIME_AFTER, AGREEMENT_END_DATE_TIME_BEFORE
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #           tags: {
-    #             key: "TagKey",
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #           cost_categories: {
-    #             key: "CostCategoryName",
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #         },
-    #         metrics: ["MetricName"],
-    #         group_by: [
-    #           {
-    #             type: "DIMENSION", # accepts DIMENSION, TAG, COST_CATEGORY
-    #             key: "GroupDefinitionKey",
-    #           },
-    #         ],
-    #         next_page_token: "NextPageToken",
-    #       }
-    #
     # @!attribute [rw] time_period
     #   Sets the start and end dates for retrieving Amazon Web Services
     #   costs. The range must be within the last 14 days (the start date
@@ -2403,6 +2232,13 @@ module Aws::CostExplorer
     #   [Expression][1] `"SERVICE = Amazon Elastic Compute Cloud - Compute"`
     #   in the filter.
     #
+    #   Valid values for `MatchOptions` for `Dimensions` are `EQUALS` and
+    #   `CASE_SENSITIVE`.
+    #
+    #   Valid values for `MatchOptions` for `CostCategories` and `Tags` are
+    #   `EQUALS`, `ABSENT`, and `CASE_SENSITIVE`. Default values are
+    #   `EQUALS` and `CASE_SENSITIVE`.
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
@@ -2421,8 +2257,8 @@ module Aws::CostExplorer
     #   usage numbers without taking the units into account. For example, if
     #   you aggregate `usageQuantity` across all of Amazon EC2, the results
     #   aren't meaningful because Amazon EC2 compute hours and data
-    #   transfer are measured in different units (for example, hours vs.
-    #   GB). To get more meaningful `UsageQuantity` metrics, filter by
+    #   transfer are measured in different units (for example, hour or GB).
+    #   To get more meaningful `UsageQuantity` metrics, filter by
     #   `UsageType` or `UsageTypeGroups`.
     #
     #    </note>
@@ -2470,7 +2306,7 @@ module Aws::CostExplorer
     #   @return [Array<Types::GroupDefinition>]
     #
     # @!attribute [rw] results_by_time
-    #   The time period that is covered by the results in the response.
+    #   The time period that's covered by the results in the response.
     #   @return [Array<Types::ResultByTime>]
     #
     # @!attribute [rw] dimension_value_attributes
@@ -2490,64 +2326,13 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass GetCostCategoriesRequest
-    #   data as a hash:
-    #
-    #       {
-    #         search_string: "SearchString",
-    #         time_period: { # required
-    #           start: "YearMonthDay", # required
-    #           end: "YearMonthDay", # required
-    #         },
-    #         cost_category_name: "CostCategoryName",
-    #         filter: {
-    #           or: [
-    #             {
-    #               # recursive Expression
-    #             },
-    #           ],
-    #           and: [
-    #             {
-    #               # recursive Expression
-    #             },
-    #           ],
-    #           not: {
-    #             # recursive Expression
-    #           },
-    #           dimensions: {
-    #             key: "AZ", # accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, LINKED_ACCOUNT_NAME, OPERATION, PURCHASE_TYPE, REGION, SERVICE, SERVICE_CODE, USAGE_TYPE, USAGE_TYPE_GROUP, RECORD_TYPE, OPERATING_SYSTEM, TENANCY, SCOPE, PLATFORM, SUBSCRIPTION_ID, LEGAL_ENTITY_NAME, DEPLOYMENT_OPTION, DATABASE_ENGINE, CACHE_ENGINE, INSTANCE_TYPE_FAMILY, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION, AGREEMENT_END_DATE_TIME_AFTER, AGREEMENT_END_DATE_TIME_BEFORE
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #           tags: {
-    #             key: "TagKey",
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #           cost_categories: {
-    #             key: "CostCategoryName",
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #         },
-    #         sort_by: [
-    #           {
-    #             key: "SortDefinitionKey", # required
-    #             sort_order: "ASCENDING", # accepts ASCENDING, DESCENDING
-    #           },
-    #         ],
-    #         max_results: 1,
-    #         next_page_token: "NextPageToken",
-    #       }
-    #
     # @!attribute [rw] search_string
     #   The value that you want to search the filter values for.
     #
-    #   If you do not specify a `CostCategoryName`, `SearchString` will be
-    #   used to filter Cost Category names that match the `SearchString`
-    #   pattern. If you do specifiy a `CostCategoryName`, `SearchString`
-    #   will be used to filter Cost Category values that match the
-    #   `SearchString` pattern.
+    #   If you don't specify a `CostCategoryName`, `SearchString` is used
+    #   to filter Cost Category names that match the `SearchString` pattern.
+    #   If you specify a `CostCategoryName`, `SearchString` is used to
+    #   filter Cost Category values that match the `SearchString` pattern.
     #   @return [String]
     #
     # @!attribute [rw] time_period
@@ -2559,46 +2344,84 @@ module Aws::CostExplorer
     #   @return [String]
     #
     # @!attribute [rw] filter
-    #   Use `Expression` to filter by cost or by usage. There are two
-    #   patterns:
-    #
-    #   * Simple dimension values - You can set the dimension name and
-    #     values for the filters that you plan to use. For example, you can
-    #     filter for `REGION==us-east-1 OR REGION==us-west-1`. For
-    #     `GetRightsizingRecommendation`, the Region is a full name (for
-    #     example, `REGION==US East (N. Virginia)`. The `Expression` example
-    #     is as follows:
-    #
-    #     `\{ "Dimensions": \{ "Key": "REGION", "Values": [ "us-east-1",
-    #     “us-west-1” ] \} \}`
-    #
-    #     The list of dimension values are OR'd together to retrieve cost
-    #     or usage data. You can create `Expression` and `DimensionValues`
-    #     objects using either `with*` methods or `set*` methods in multiple
-    #     lines.
-    #
-    #   * Compound dimension values with logical operations - You can use
-    #     multiple `Expression` types and the logical operators `AND/OR/NOT`
-    #     to create a list of one or more `Expression` objects. By doing
-    #     this, you can filter on more advanced options. For example, you
-    #     can filter on `((REGION == us-east-1 OR REGION == us-west-1) OR
-    #     (TAG.Type == Type1)) AND (USAGE_TYPE != DataTransfer)`. The
-    #     `Expression` for that is as follows:
-    #
-    #     `\{ "And": [ \{"Or": [ \{"Dimensions": \{ "Key": "REGION",
-    #     "Values": [ "us-east-1", "us-west-1" ] \}\}, \{"Tags": \{ "Key":
-    #     "TagName", "Values": ["Value1"] \} \} ]\}, \{"Not":
-    #     \{"Dimensions": \{ "Key": "USAGE_TYPE", "Values": ["DataTransfer"]
-    #     \}\}\} ] \} `
+    #   Use `Expression` to filter in various Cost Explorer APIs.
+    #
+    #   Not all `Expression` types are supported in each API. Refer to the
+    #   documentation for each specific API to see what is supported.
+    #
+    #   There are two patterns:
+    #
+    #   * Simple dimension values.
+    #
+    #     * There are three types of simple dimension values:
+    #       `CostCategories`, `Tags`, and `Dimensions`.
+    #
+    #       * Specify the `CostCategories` field to define a filter that
+    #         acts on Cost Categories.
+    #
+    #       * Specify the `Tags` field to define a filter that acts on Cost
+    #         Allocation Tags.
+    #
+    #       * Specify the `Dimensions` field to define a filter that acts on
+    #         the [ `DimensionValues` ][1].
+    #
+    #     * For each filter type, you can set the dimension name and values
+    #       for the filters that you plan to use.
+    #
+    #       * For example, you can filter for `REGION==us-east-1 OR
+    #         REGION==us-west-1`. For `GetRightsizingRecommendation`, the
+    #         Region is a full name (for example, `REGION==US East (N.
+    #         Virginia)`.
+    #
+    #       * The corresponding `Expression` for this example is as follows:
+    #         `\{ "Dimensions": \{ "Key": "REGION", "Values": [ "us-east-1",
+    #         "us-west-1" ] \} \}`
+    #
+    #       * As shown in the previous example, lists of dimension values
+    #         are combined with `OR` when applying the filter.
+    #
+    #     * You can also set different match options to further control how
+    #       the filter behaves. Not all APIs support match options. Refer to
+    #       the documentation for each specific API to see what is
+    #       supported.
+    #
+    #       * For example, you can filter for linked account names that
+    #         start with "a".
+    #
+    #       * The corresponding `Expression` for this example is as follows:
+    #         `\{ "Dimensions": \{ "Key": "LINKED_ACCOUNT_NAME",
+    #         "MatchOptions": [ "STARTS_WITH" ], "Values": [ "a" ] \} \}`
+    #
+    #   * Compound `Expression` types with logical operations.
+    #
+    #     * You can use multiple `Expression` types and the logical
+    #       operators `AND/OR/NOT` to create a list of one or more
+    #       `Expression` objects. By doing this, you can filter by more
+    #       advanced options.
+    #
+    #     * For example, you can filter by `((REGION == us-east-1 OR REGION
+    #       == us-west-1) OR (TAG.Type == Type1)) AND (USAGE_TYPE !=
+    #       DataTransfer)`.
+    #
+    #     * The corresponding `Expression` for this example is as follows:
+    #       `\{ "And": [ \{"Or": [ \{"Dimensions": \{ "Key": "REGION",
+    #       "Values": [ "us-east-1", "us-west-1" ] \}\}, \{"Tags": \{ "Key":
+    #       "TagName", "Values": ["Value1"] \} \} ]\}, \{"Not":
+    #       \{"Dimensions": \{ "Key": "USAGE_TYPE", "Values":
+    #       ["DataTransfer"] \}\}\} ] \} `
     #
     #     <note markdown="1"> Because each `Expression` can have only one operator, the service
     #     returns an error if more than one is specified. The following
-    #     example shows an `Expression` object that creates an error.
+    #     example shows an `Expression` object that creates an error: ` \{
+    #     "And": [ ... ], "Dimensions": \{ "Key": "USAGE_TYPE", "Values": [
+    #     "DataTransfer" ] \} \} `
     #
-    #      </note>
+    #      The following is an example of the corresponding error message:
+    #     `"Expression has more than one roots. Only one root operator is
+    #     allowed for each expression: And, Or, Not, Dimensions, Tags,
+    #     CostCategories"`
     #
-    #     ` \{ "And": [ ... ], "DimensionValues": \{ "Dimension":
-    #     "USAGE_TYPE", "Values": [ "DataTransfer" ] \} \} `
+    #      </note>
     #
     #   <note markdown="1"> For the `GetRightsizingRecommendation` action, a combination of OR
     #   and NOT isn't supported. OR isn't supported between different
@@ -2611,13 +2434,17 @@ module Aws::CostExplorer
     #   `LINKED_ACCOUNT`.
     #
     #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_DimensionValues.html
     #   @return [Types::Expression]
     #
     # @!attribute [rw] sort_by
-    #   The value by which you want to sort the data.
+    #   The value that you sort the data by.
     #
-    #   The key represents cost and usage metrics. The following values are
-    #   supported:
+    #   The key represents the cost and usage metrics. The following values
+    #   are supported:
     #
     #   * `BlendedCost`
     #
@@ -2633,27 +2460,29 @@ module Aws::CostExplorer
     #
     #   * `NormalizedUsageAmount`
     #
-    #   Supported values for `SortOrder` are `ASCENDING` or `DESCENDING`.
+    #   The supported key values for the `SortOrder` value are `ASCENDING`
+    #   and `DESCENDING`.
     #
-    #   When using `SortBy`, `NextPageToken` and `SearchString` are not
-    #   supported.
+    #   When you use the `SortBy` value, the `NextPageToken` and
+    #   `SearchString` key values aren't supported.
     #   @return [Array<Types::SortDefinition>]
     #
     # @!attribute [rw] max_results
-    #   This field is only used when `SortBy` is provided in the request.
+    #   This field is only used when the `SortBy` value is provided in the
+    #   request.
     #
-    #   The maximum number of objects that to be returned for this request.
-    #   If `MaxResults` is not specified with `SortBy`, the request will
-    #   return 1000 results as the default value for this parameter.
+    #   The maximum number of objects that are returned for this request. If
+    #   `MaxResults` isn't specified with the `SortBy` value, the request
+    #   returns 1000 results as the default value for this parameter.
     #
-    #   For `GetCostCategories`, MaxResults has an upper limit of 1000.
+    #   For `GetCostCategories`, MaxResults has an upper quota of 1000.
     #   @return [Integer]
     #
     # @!attribute [rw] next_page_token
     #   If the number of objects that are still available for retrieval
-    #   exceeds the limit, Amazon Web Services returns a NextPageToken value
+    #   exceeds the quota, Amazon Web Services returns a NextPageToken value
     #   in the response. To retrieve the next batch of objects, provide the
-    #   NextPageToken from the prior call in your next request.
+    #   NextPageToken from the previous call in your next request.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetCostCategoriesRequest AWS API Documentation
@@ -2672,7 +2501,7 @@ module Aws::CostExplorer
 
     # @!attribute [rw] next_page_token
     #   If the number of objects that are still available for retrieval
-    #   exceeds the limit, Amazon Web Services returns a NextPageToken value
+    #   exceeds the quota, Amazon Web Services returns a NextPageToken value
     #   in the response. To retrieve the next batch of objects, provide the
     #   marker from the prior call in your next request.
     #   @return [String]
@@ -2684,12 +2513,12 @@ module Aws::CostExplorer
     # @!attribute [rw] cost_category_values
     #   The Cost Category values.
     #
-    #   `CostCategoryValues` are not returned if `CostCategoryName` is not
-    #   specified in the request.
+    #   If the `CostCategoryName` key isn't specified in the request, the
+    #   `CostCategoryValues` fields aren't returned.
     #   @return [Array<String>]
     #
     # @!attribute [rw] return_size
-    #   The number of objects returned.
+    #   The number of objects that are returned.
     #   @return [Integer]
     #
     # @!attribute [rw] total_size
@@ -2708,49 +2537,6 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass GetCostForecastRequest
-    #   data as a hash:
-    #
-    #       {
-    #         time_period: { # required
-    #           start: "YearMonthDay", # required
-    #           end: "YearMonthDay", # required
-    #         },
-    #         metric: "BLENDED_COST", # required, accepts BLENDED_COST, UNBLENDED_COST, AMORTIZED_COST, NET_UNBLENDED_COST, NET_AMORTIZED_COST, USAGE_QUANTITY, NORMALIZED_USAGE_AMOUNT
-    #         granularity: "DAILY", # required, accepts DAILY, MONTHLY, HOURLY
-    #         filter: {
-    #           or: [
-    #             {
-    #               # recursive Expression
-    #             },
-    #           ],
-    #           and: [
-    #             {
-    #               # recursive Expression
-    #             },
-    #           ],
-    #           not: {
-    #             # recursive Expression
-    #           },
-    #           dimensions: {
-    #             key: "AZ", # accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, LINKED_ACCOUNT_NAME, OPERATION, PURCHASE_TYPE, REGION, SERVICE, SERVICE_CODE, USAGE_TYPE, USAGE_TYPE_GROUP, RECORD_TYPE, OPERATING_SYSTEM, TENANCY, SCOPE, PLATFORM, SUBSCRIPTION_ID, LEGAL_ENTITY_NAME, DEPLOYMENT_OPTION, DATABASE_ENGINE, CACHE_ENGINE, INSTANCE_TYPE_FAMILY, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION, AGREEMENT_END_DATE_TIME_AFTER, AGREEMENT_END_DATE_TIME_BEFORE
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #           tags: {
-    #             key: "TagKey",
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #           cost_categories: {
-    #             key: "CostCategoryName",
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #         },
-    #         prediction_interval_level: 1,
-    #       }
-    #
     # @!attribute [rw] time_period
     #   The period of time that you want the forecast to cover. The start
     #   date must be equal to or no later than the current date to avoid a
@@ -2880,57 +2666,6 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass GetDimensionValuesRequest
-    #   data as a hash:
-    #
-    #       {
-    #         search_string: "SearchString",
-    #         time_period: { # required
-    #           start: "YearMonthDay", # required
-    #           end: "YearMonthDay", # required
-    #         },
-    #         dimension: "AZ", # required, accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, LINKED_ACCOUNT_NAME, OPERATION, PURCHASE_TYPE, REGION, SERVICE, SERVICE_CODE, USAGE_TYPE, USAGE_TYPE_GROUP, RECORD_TYPE, OPERATING_SYSTEM, TENANCY, SCOPE, PLATFORM, SUBSCRIPTION_ID, LEGAL_ENTITY_NAME, DEPLOYMENT_OPTION, DATABASE_ENGINE, CACHE_ENGINE, INSTANCE_TYPE_FAMILY, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION, AGREEMENT_END_DATE_TIME_AFTER, AGREEMENT_END_DATE_TIME_BEFORE
-    #         context: "COST_AND_USAGE", # accepts COST_AND_USAGE, RESERVATIONS, SAVINGS_PLANS
-    #         filter: {
-    #           or: [
-    #             {
-    #               # recursive Expression
-    #             },
-    #           ],
-    #           and: [
-    #             {
-    #               # recursive Expression
-    #             },
-    #           ],
-    #           not: {
-    #             # recursive Expression
-    #           },
-    #           dimensions: {
-    #             key: "AZ", # accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, LINKED_ACCOUNT_NAME, OPERATION, PURCHASE_TYPE, REGION, SERVICE, SERVICE_CODE, USAGE_TYPE, USAGE_TYPE_GROUP, RECORD_TYPE, OPERATING_SYSTEM, TENANCY, SCOPE, PLATFORM, SUBSCRIPTION_ID, LEGAL_ENTITY_NAME, DEPLOYMENT_OPTION, DATABASE_ENGINE, CACHE_ENGINE, INSTANCE_TYPE_FAMILY, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION, AGREEMENT_END_DATE_TIME_AFTER, AGREEMENT_END_DATE_TIME_BEFORE
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #           tags: {
-    #             key: "TagKey",
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #           cost_categories: {
-    #             key: "CostCategoryName",
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #         },
-    #         sort_by: [
-    #           {
-    #             key: "SortDefinitionKey", # required
-    #             sort_order: "ASCENDING", # accepts ASCENDING, DESCENDING
-    #           },
-    #         ],
-    #         max_results: 1,
-    #         next_page_token: "NextPageToken",
-    #       }
-    #
     # @!attribute [rw] search_string
     #   The value that you want to search the filter values for.
     #   @return [String]
@@ -2946,6 +2681,12 @@ module Aws::CostExplorer
     # @!attribute [rw] dimension
     #   The name of the dimension. Each `Dimension` is available for a
     #   different `Context`. For more information, see `Context`.
+    #   `LINK_ACCOUNT_NAME` and `SERVICE_CODE` can only be used in
+    #   [CostCategoryRule][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/AAPI_CostCategoryRule.html
     #   @return [String]
     #
     # @!attribute [rw] context
@@ -2962,12 +2703,40 @@ module Aws::CostExplorer
     #
     #   * AZ - The Availability Zone. An example is `us-east-1a`.
     #
+    #   * BILLING\_ENTITY - The Amazon Web Services seller that your account
+    #     is with. Possible values are the following:
+    #
+    #     \- Amazon Web Services(Amazon Web Services): The entity that sells
+    #     Amazon Web Services.
+    #
+    #     \- AISPL (Amazon Internet Services Pvt. Ltd.): The local Indian
+    #     entity that's an acting reseller for Amazon Web Services in
+    #     India.
+    #
+    #     \- Amazon Web Services Marketplace: The entity that supports the
+    #     sale of solutions that are built on Amazon Web Services by
+    #     third-party software providers.
+    #
+    #   * CACHE\_ENGINE - The Amazon ElastiCache operating system. Examples
+    #     are Windows or Linux.
+    #
+    #   * DEPLOYMENT\_OPTION - The scope of Amazon Relational Database
+    #     Service deployments. Valid values are `SingleAZ` and `MultiAZ`.
+    #
     #   * DATABASE\_ENGINE - The Amazon Relational Database Service
     #     database. Examples are Aurora or MySQL.
     #
     #   * INSTANCE\_TYPE - The type of Amazon EC2 instance. An example is
     #     `m4.xlarge`.
     #
+    #   * INSTANCE\_TYPE\_FAMILY - A family of instance types optimized to
+    #     fit different use cases. Examples are `Compute Optimized` (for
+    #     example, `C4`, `C5`, `C6g`, and `C7g`), `Memory Optimization` (for
+    #     example, `R4`, `R5n`, `R5b`, and `R6g`).
+    #
+    #   * INVOICING\_ENTITY - The name of the entity that issues the Amazon
+    #     Web Services invoice.
+    #
     #   * LEGAL\_ENTITY\_NAME - The name of the organization that sells you
     #     Amazon Web Services services, such as Amazon Web Services.
     #
@@ -2984,12 +2753,23 @@ module Aws::CostExplorer
     #   * PLATFORM - The Amazon EC2 operating system. Examples are Windows
     #     or Linux.
     #
-    #   * PURCHASE\_TYPE - The reservation type of the purchase to which
-    #     this usage is related. Examples include On-Demand Instances and
+    #   * PURCHASE\_TYPE - The reservation type of the purchase that this
+    #     usage is related to. Examples include On-Demand Instances and
     #     Standard Reserved Instances.
     #
+    #   * RESERVATION\_ID - The unique identifier for an Amazon Web Services
+    #     Reservation Instance.
+    #
+    #   * SAVINGS\_PLAN\_ARN - The unique identifier for your Savings Plans.
+    #
+    #   * SAVINGS\_PLANS\_TYPE - Type of Savings Plans (EC2 Instance or
+    #     Compute).
+    #
     #   * SERVICE - The Amazon Web Services service such as Amazon DynamoDB.
     #
+    #   * TENANCY - The tenancy of a resource. Examples are shared or
+    #     dedicated.
+    #
     #   * USAGE\_TYPE - The type of usage. An example is
     #     DataTransfer-In-Bytes. The response for the `GetDimensionValues`
     #     operation includes a unit attribute. Examples include GB and Hrs.
@@ -3000,8 +2780,8 @@ module Aws::CostExplorer
     #
     #   * REGION - The Amazon Web Services Region.
     #
-    #   * RECORD\_TYPE - The different types of charges such as RI fees,
-    #     usage costs, tax refunds, and credits.
+    #   * RECORD\_TYPE - The different types of charges such as Reserved
+    #     Instance (RI) fees, usage costs, tax refunds, and credits.
     #
     #   * RESOURCE\_ID - The unique identifier of the resource. ResourceId
     #     is an opt-in feature only available for last 14 days for
@@ -3045,8 +2825,8 @@ module Aws::CostExplorer
     #   * SAVINGS\_PLANS\_TYPE - Type of Savings Plans (EC2 Instance or
     #     Compute)
     #
-    #   * PAYMENT\_OPTION - Payment option for the given Savings Plans (for
-    #     example, All Upfront)
+    #   * PAYMENT\_OPTION - The payment option for the given Savings Plans
+    #     (for example, All Upfront)
     #
     #   * REGION - The Amazon Web Services Region.
     #
@@ -3057,50 +2837,88 @@ module Aws::CostExplorer
     #     includes the full name of the member account. The value field
     #     contains the Amazon Web Services ID of the member account.
     #
-    #   * SAVINGS\_PLAN\_ARN - The unique identifier for your Savings Plan
+    #   * SAVINGS\_PLAN\_ARN - The unique identifier for your Savings Plans.
     #   @return [String]
     #
     # @!attribute [rw] filter
-    #   Use `Expression` to filter by cost or by usage. There are two
-    #   patterns:
-    #
-    #   * Simple dimension values - You can set the dimension name and
-    #     values for the filters that you plan to use. For example, you can
-    #     filter for `REGION==us-east-1 OR REGION==us-west-1`. For
-    #     `GetRightsizingRecommendation`, the Region is a full name (for
-    #     example, `REGION==US East (N. Virginia)`. The `Expression` example
-    #     is as follows:
-    #
-    #     `\{ "Dimensions": \{ "Key": "REGION", "Values": [ "us-east-1",
-    #     “us-west-1” ] \} \}`
-    #
-    #     The list of dimension values are OR'd together to retrieve cost
-    #     or usage data. You can create `Expression` and `DimensionValues`
-    #     objects using either `with*` methods or `set*` methods in multiple
-    #     lines.
-    #
-    #   * Compound dimension values with logical operations - You can use
-    #     multiple `Expression` types and the logical operators `AND/OR/NOT`
-    #     to create a list of one or more `Expression` objects. By doing
-    #     this, you can filter on more advanced options. For example, you
-    #     can filter on `((REGION == us-east-1 OR REGION == us-west-1) OR
-    #     (TAG.Type == Type1)) AND (USAGE_TYPE != DataTransfer)`. The
-    #     `Expression` for that is as follows:
-    #
-    #     `\{ "And": [ \{"Or": [ \{"Dimensions": \{ "Key": "REGION",
-    #     "Values": [ "us-east-1", "us-west-1" ] \}\}, \{"Tags": \{ "Key":
-    #     "TagName", "Values": ["Value1"] \} \} ]\}, \{"Not":
-    #     \{"Dimensions": \{ "Key": "USAGE_TYPE", "Values": ["DataTransfer"]
-    #     \}\}\} ] \} `
+    #   Use `Expression` to filter in various Cost Explorer APIs.
+    #
+    #   Not all `Expression` types are supported in each API. Refer to the
+    #   documentation for each specific API to see what is supported.
+    #
+    #   There are two patterns:
+    #
+    #   * Simple dimension values.
+    #
+    #     * There are three types of simple dimension values:
+    #       `CostCategories`, `Tags`, and `Dimensions`.
+    #
+    #       * Specify the `CostCategories` field to define a filter that
+    #         acts on Cost Categories.
+    #
+    #       * Specify the `Tags` field to define a filter that acts on Cost
+    #         Allocation Tags.
+    #
+    #       * Specify the `Dimensions` field to define a filter that acts on
+    #         the [ `DimensionValues` ][1].
+    #
+    #     * For each filter type, you can set the dimension name and values
+    #       for the filters that you plan to use.
+    #
+    #       * For example, you can filter for `REGION==us-east-1 OR
+    #         REGION==us-west-1`. For `GetRightsizingRecommendation`, the
+    #         Region is a full name (for example, `REGION==US East (N.
+    #         Virginia)`.
+    #
+    #       * The corresponding `Expression` for this example is as follows:
+    #         `\{ "Dimensions": \{ "Key": "REGION", "Values": [ "us-east-1",
+    #         "us-west-1" ] \} \}`
+    #
+    #       * As shown in the previous example, lists of dimension values
+    #         are combined with `OR` when applying the filter.
+    #
+    #     * You can also set different match options to further control how
+    #       the filter behaves. Not all APIs support match options. Refer to
+    #       the documentation for each specific API to see what is
+    #       supported.
+    #
+    #       * For example, you can filter for linked account names that
+    #         start with "a".
+    #
+    #       * The corresponding `Expression` for this example is as follows:
+    #         `\{ "Dimensions": \{ "Key": "LINKED_ACCOUNT_NAME",
+    #         "MatchOptions": [ "STARTS_WITH" ], "Values": [ "a" ] \} \}`
+    #
+    #   * Compound `Expression` types with logical operations.
+    #
+    #     * You can use multiple `Expression` types and the logical
+    #       operators `AND/OR/NOT` to create a list of one or more
+    #       `Expression` objects. By doing this, you can filter by more
+    #       advanced options.
+    #
+    #     * For example, you can filter by `((REGION == us-east-1 OR REGION
+    #       == us-west-1) OR (TAG.Type == Type1)) AND (USAGE_TYPE !=
+    #       DataTransfer)`.
+    #
+    #     * The corresponding `Expression` for this example is as follows:
+    #       `\{ "And": [ \{"Or": [ \{"Dimensions": \{ "Key": "REGION",
+    #       "Values": [ "us-east-1", "us-west-1" ] \}\}, \{"Tags": \{ "Key":
+    #       "TagName", "Values": ["Value1"] \} \} ]\}, \{"Not":
+    #       \{"Dimensions": \{ "Key": "USAGE_TYPE", "Values":
+    #       ["DataTransfer"] \}\}\} ] \} `
     #
     #     <note markdown="1"> Because each `Expression` can have only one operator, the service
     #     returns an error if more than one is specified. The following
-    #     example shows an `Expression` object that creates an error.
+    #     example shows an `Expression` object that creates an error: ` \{
+    #     "And": [ ... ], "Dimensions": \{ "Key": "USAGE_TYPE", "Values": [
+    #     "DataTransfer" ] \} \} `
     #
-    #      </note>
+    #      The following is an example of the corresponding error message:
+    #     `"Expression has more than one roots. Only one root operator is
+    #     allowed for each expression: And, Or, Not, Dimensions, Tags,
+    #     CostCategories"`
     #
-    #     ` \{ "And": [ ... ], "DimensionValues": \{ "Dimension":
-    #     "USAGE_TYPE", "Values": [ "DataTransfer" ] \} \} `
+    #      </note>
     #
     #   <note markdown="1"> For the `GetRightsizingRecommendation` action, a combination of OR
     #   and NOT isn't supported. OR isn't supported between different
@@ -3113,10 +2931,14 @@ module Aws::CostExplorer
     #   `LINKED_ACCOUNT`.
     #
     #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_DimensionValues.html
     #   @return [Types::Expression]
     #
     # @!attribute [rw] sort_by
-    #   The value by which you want to sort the data.
+    #   The value that you want to sort the data by.
     #
     #   The key represents cost and usage metrics. The following values are
     #   supported:
@@ -3135,18 +2957,19 @@ module Aws::CostExplorer
     #
     #   * `NormalizedUsageAmount`
     #
-    #   Supported values for `SortOrder` are `ASCENDING` or `DESCENDING`.
+    #   The supported values for the `SortOrder` key are `ASCENDING` or
+    #   `DESCENDING`.
     #
     #   When you specify a `SortBy` paramater, the context must be
     #   `COST_AND_USAGE`. Further, when using `SortBy`, `NextPageToken` and
-    #   `SearchString` are not supported.
+    #   `SearchString` aren't supported.
     #   @return [Array<Types::SortDefinition>]
     #
     # @!attribute [rw] max_results
     #   This field is only used when SortBy is provided in the request. The
-    #   maximum number of objects that to be returned for this request. If
-    #   MaxResults is not specified with SortBy, the request will return
-    #   1000 results as the default value for this parameter.
+    #   maximum number of objects that are returned for this request. If
+    #   MaxResults isn't specified with SortBy, the request returns 1000
+    #   results as the default value for this parameter.
     #
     #   For `GetDimensionValues`, MaxResults has an upper limit of 1000.
     #   @return [Integer]
@@ -3222,7 +3045,8 @@ module Aws::CostExplorer
     #
     #   * RESOURCE\_ID - The unique identifier of the resource. ResourceId
     #     is an opt-in feature only available for last 14 days for
-    #     EC2-Compute Service.
+    #     EC2-Compute Service. You can opt-in by enabling `Hourly` and
+    #     `Resource Level Data` in Cost Management Console preferences.
     #
     #   If you set the context to `RESERVATIONS`, you can use the following
     #   dimensions for searching:
@@ -3305,60 +3129,6 @@ module Aws::CostExplorer
     # You can use the following request parameters to query for how much of
     # your instance usage a reservation covered.
     #
-    # @note When making an API call, you may pass GetReservationCoverageRequest
-    #   data as a hash:
-    #
-    #       {
-    #         time_period: { # required
-    #           start: "YearMonthDay", # required
-    #           end: "YearMonthDay", # required
-    #         },
-    #         group_by: [
-    #           {
-    #             type: "DIMENSION", # accepts DIMENSION, TAG, COST_CATEGORY
-    #             key: "GroupDefinitionKey",
-    #           },
-    #         ],
-    #         granularity: "DAILY", # accepts DAILY, MONTHLY, HOURLY
-    #         filter: {
-    #           or: [
-    #             {
-    #               # recursive Expression
-    #             },
-    #           ],
-    #           and: [
-    #             {
-    #               # recursive Expression
-    #             },
-    #           ],
-    #           not: {
-    #             # recursive Expression
-    #           },
-    #           dimensions: {
-    #             key: "AZ", # accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, LINKED_ACCOUNT_NAME, OPERATION, PURCHASE_TYPE, REGION, SERVICE, SERVICE_CODE, USAGE_TYPE, USAGE_TYPE_GROUP, RECORD_TYPE, OPERATING_SYSTEM, TENANCY, SCOPE, PLATFORM, SUBSCRIPTION_ID, LEGAL_ENTITY_NAME, DEPLOYMENT_OPTION, DATABASE_ENGINE, CACHE_ENGINE, INSTANCE_TYPE_FAMILY, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION, AGREEMENT_END_DATE_TIME_AFTER, AGREEMENT_END_DATE_TIME_BEFORE
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #           tags: {
-    #             key: "TagKey",
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #           cost_categories: {
-    #             key: "CostCategoryName",
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #         },
-    #         metrics: ["MetricName"],
-    #         next_page_token: "NextPageToken",
-    #         sort_by: {
-    #           key: "SortDefinitionKey", # required
-    #           sort_order: "ASCENDING", # accepts ASCENDING, DESCENDING
-    #         },
-    #         max_results: 1,
-    #       }
-    #
     # @!attribute [rw] time_period
     #   The start and end dates of the period that you want to retrieve data
     #   about reservation coverage for. You can retrieve data for a maximum
@@ -3382,6 +3152,8 @@ module Aws::CostExplorer
     #
     #   * INSTANCE\_TYPE
     #
+    #   * INVOICING\_ENTITY
+    #
     #   * LINKED\_ACCOUNT
     #
     #   * OPERATING\_SYSTEM
@@ -3464,7 +3236,7 @@ module Aws::CostExplorer
     # @!attribute [rw] sort_by
     #   The value by which you want to sort the data.
     #
-    #   The following values are supported for `Key`\:
+    #   The following values are supported for `Key`:
     #
     #   * `OnDemandCost`
     #
@@ -3535,57 +3307,8 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass GetReservationPurchaseRecommendationRequest
-    #   data as a hash:
-    #
-    #       {
-    #         account_id: "GenericString",
-    #         service: "GenericString", # required
-    #         filter: {
-    #           or: [
-    #             {
-    #               # recursive Expression
-    #             },
-    #           ],
-    #           and: [
-    #             {
-    #               # recursive Expression
-    #             },
-    #           ],
-    #           not: {
-    #             # recursive Expression
-    #           },
-    #           dimensions: {
-    #             key: "AZ", # accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, LINKED_ACCOUNT_NAME, OPERATION, PURCHASE_TYPE, REGION, SERVICE, SERVICE_CODE, USAGE_TYPE, USAGE_TYPE_GROUP, RECORD_TYPE, OPERATING_SYSTEM, TENANCY, SCOPE, PLATFORM, SUBSCRIPTION_ID, LEGAL_ENTITY_NAME, DEPLOYMENT_OPTION, DATABASE_ENGINE, CACHE_ENGINE, INSTANCE_TYPE_FAMILY, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION, AGREEMENT_END_DATE_TIME_AFTER, AGREEMENT_END_DATE_TIME_BEFORE
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #           tags: {
-    #             key: "TagKey",
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #           cost_categories: {
-    #             key: "CostCategoryName",
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #         },
-    #         account_scope: "PAYER", # accepts PAYER, LINKED
-    #         lookback_period_in_days: "SEVEN_DAYS", # accepts SEVEN_DAYS, THIRTY_DAYS, SIXTY_DAYS
-    #         term_in_years: "ONE_YEAR", # accepts ONE_YEAR, THREE_YEARS
-    #         payment_option: "NO_UPFRONT", # accepts NO_UPFRONT, PARTIAL_UPFRONT, ALL_UPFRONT, LIGHT_UTILIZATION, MEDIUM_UTILIZATION, HEAVY_UTILIZATION
-    #         service_specification: {
-    #           ec2_specification: {
-    #             offering_class: "STANDARD", # accepts STANDARD, CONVERTIBLE
-    #           },
-    #         },
-    #         page_size: 1,
-    #         next_page_token: "NextPageToken",
-    #       }
-    #
     # @!attribute [rw] account_id
-    #   The account ID that is associated with the recommendation.
+    #   The account ID that's associated with the recommendation.
     #   @return [String]
     #
     # @!attribute [rw] service
@@ -3593,46 +3316,84 @@ module Aws::CostExplorer
     #   @return [String]
     #
     # @!attribute [rw] filter
-    #   Use `Expression` to filter by cost or by usage. There are two
-    #   patterns:
-    #
-    #   * Simple dimension values - You can set the dimension name and
-    #     values for the filters that you plan to use. For example, you can
-    #     filter for `REGION==us-east-1 OR REGION==us-west-1`. For
-    #     `GetRightsizingRecommendation`, the Region is a full name (for
-    #     example, `REGION==US East (N. Virginia)`. The `Expression` example
-    #     is as follows:
-    #
-    #     `\{ "Dimensions": \{ "Key": "REGION", "Values": [ "us-east-1",
-    #     “us-west-1” ] \} \}`
-    #
-    #     The list of dimension values are OR'd together to retrieve cost
-    #     or usage data. You can create `Expression` and `DimensionValues`
-    #     objects using either `with*` methods or `set*` methods in multiple
-    #     lines.
-    #
-    #   * Compound dimension values with logical operations - You can use
-    #     multiple `Expression` types and the logical operators `AND/OR/NOT`
-    #     to create a list of one or more `Expression` objects. By doing
-    #     this, you can filter on more advanced options. For example, you
-    #     can filter on `((REGION == us-east-1 OR REGION == us-west-1) OR
-    #     (TAG.Type == Type1)) AND (USAGE_TYPE != DataTransfer)`. The
-    #     `Expression` for that is as follows:
-    #
-    #     `\{ "And": [ \{"Or": [ \{"Dimensions": \{ "Key": "REGION",
-    #     "Values": [ "us-east-1", "us-west-1" ] \}\}, \{"Tags": \{ "Key":
-    #     "TagName", "Values": ["Value1"] \} \} ]\}, \{"Not":
-    #     \{"Dimensions": \{ "Key": "USAGE_TYPE", "Values": ["DataTransfer"]
-    #     \}\}\} ] \} `
+    #   Use `Expression` to filter in various Cost Explorer APIs.
+    #
+    #   Not all `Expression` types are supported in each API. Refer to the
+    #   documentation for each specific API to see what is supported.
+    #
+    #   There are two patterns:
+    #
+    #   * Simple dimension values.
+    #
+    #     * There are three types of simple dimension values:
+    #       `CostCategories`, `Tags`, and `Dimensions`.
+    #
+    #       * Specify the `CostCategories` field to define a filter that
+    #         acts on Cost Categories.
+    #
+    #       * Specify the `Tags` field to define a filter that acts on Cost
+    #         Allocation Tags.
+    #
+    #       * Specify the `Dimensions` field to define a filter that acts on
+    #         the [ `DimensionValues` ][1].
+    #
+    #     * For each filter type, you can set the dimension name and values
+    #       for the filters that you plan to use.
+    #
+    #       * For example, you can filter for `REGION==us-east-1 OR
+    #         REGION==us-west-1`. For `GetRightsizingRecommendation`, the
+    #         Region is a full name (for example, `REGION==US East (N.
+    #         Virginia)`.
+    #
+    #       * The corresponding `Expression` for this example is as follows:
+    #         `\{ "Dimensions": \{ "Key": "REGION", "Values": [ "us-east-1",
+    #         "us-west-1" ] \} \}`
+    #
+    #       * As shown in the previous example, lists of dimension values
+    #         are combined with `OR` when applying the filter.
+    #
+    #     * You can also set different match options to further control how
+    #       the filter behaves. Not all APIs support match options. Refer to
+    #       the documentation for each specific API to see what is
+    #       supported.
+    #
+    #       * For example, you can filter for linked account names that
+    #         start with "a".
+    #
+    #       * The corresponding `Expression` for this example is as follows:
+    #         `\{ "Dimensions": \{ "Key": "LINKED_ACCOUNT_NAME",
+    #         "MatchOptions": [ "STARTS_WITH" ], "Values": [ "a" ] \} \}`
+    #
+    #   * Compound `Expression` types with logical operations.
+    #
+    #     * You can use multiple `Expression` types and the logical
+    #       operators `AND/OR/NOT` to create a list of one or more
+    #       `Expression` objects. By doing this, you can filter by more
+    #       advanced options.
+    #
+    #     * For example, you can filter by `((REGION == us-east-1 OR REGION
+    #       == us-west-1) OR (TAG.Type == Type1)) AND (USAGE_TYPE !=
+    #       DataTransfer)`.
+    #
+    #     * The corresponding `Expression` for this example is as follows:
+    #       `\{ "And": [ \{"Or": [ \{"Dimensions": \{ "Key": "REGION",
+    #       "Values": [ "us-east-1", "us-west-1" ] \}\}, \{"Tags": \{ "Key":
+    #       "TagName", "Values": ["Value1"] \} \} ]\}, \{"Not":
+    #       \{"Dimensions": \{ "Key": "USAGE_TYPE", "Values":
+    #       ["DataTransfer"] \}\}\} ] \} `
     #
     #     <note markdown="1"> Because each `Expression` can have only one operator, the service
     #     returns an error if more than one is specified. The following
-    #     example shows an `Expression` object that creates an error.
+    #     example shows an `Expression` object that creates an error: ` \{
+    #     "And": [ ... ], "Dimensions": \{ "Key": "USAGE_TYPE", "Values": [
+    #     "DataTransfer" ] \} \} `
     #
-    #      </note>
+    #      The following is an example of the corresponding error message:
+    #     `"Expression has more than one roots. Only one root operator is
+    #     allowed for each expression: And, Or, Not, Dimensions, Tags,
+    #     CostCategories"`
     #
-    #     ` \{ "And": [ ... ], "DimensionValues": \{ "Dimension":
-    #     "USAGE_TYPE", "Values": [ "DataTransfer" ] \} \} `
+    #      </note>
     #
     #   <note markdown="1"> For the `GetRightsizingRecommendation` action, a combination of OR
     #   and NOT isn't supported. OR isn't supported between different
@@ -3645,6 +3406,10 @@ module Aws::CostExplorer
     #   `LINKED_ACCOUNT`.
     #
     #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_DimensionValues.html
     #   @return [Types::Expression]
     #
     # @!attribute [rw] account_scope
@@ -3724,65 +3489,13 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass GetReservationUtilizationRequest
-    #   data as a hash:
-    #
-    #       {
-    #         time_period: { # required
-    #           start: "YearMonthDay", # required
-    #           end: "YearMonthDay", # required
-    #         },
-    #         group_by: [
-    #           {
-    #             type: "DIMENSION", # accepts DIMENSION, TAG, COST_CATEGORY
-    #             key: "GroupDefinitionKey",
-    #           },
-    #         ],
-    #         granularity: "DAILY", # accepts DAILY, MONTHLY, HOURLY
-    #         filter: {
-    #           or: [
-    #             {
-    #               # recursive Expression
-    #             },
-    #           ],
-    #           and: [
-    #             {
-    #               # recursive Expression
-    #             },
-    #           ],
-    #           not: {
-    #             # recursive Expression
-    #           },
-    #           dimensions: {
-    #             key: "AZ", # accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, LINKED_ACCOUNT_NAME, OPERATION, PURCHASE_TYPE, REGION, SERVICE, SERVICE_CODE, USAGE_TYPE, USAGE_TYPE_GROUP, RECORD_TYPE, OPERATING_SYSTEM, TENANCY, SCOPE, PLATFORM, SUBSCRIPTION_ID, LEGAL_ENTITY_NAME, DEPLOYMENT_OPTION, DATABASE_ENGINE, CACHE_ENGINE, INSTANCE_TYPE_FAMILY, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION, AGREEMENT_END_DATE_TIME_AFTER, AGREEMENT_END_DATE_TIME_BEFORE
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #           tags: {
-    #             key: "TagKey",
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #           cost_categories: {
-    #             key: "CostCategoryName",
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #         },
-    #         sort_by: {
-    #           key: "SortDefinitionKey", # required
-    #           sort_order: "ASCENDING", # accepts ASCENDING, DESCENDING
-    #         },
-    #         next_page_token: "NextPageToken",
-    #         max_results: 1,
-    #       }
-    #
     # @!attribute [rw] time_period
-    #   Sets the start and end dates for retrieving RI utilization. The
-    #   start date is inclusive, but the end date is exclusive. For example,
-    #   if `start` is `2017-01-01` and `end` is `2017-05-01`, then the cost
-    #   and usage data is retrieved from `2017-01-01` up to and including
-    #   `2017-04-30` but not including `2017-05-01`.
+    #   Sets the start and end dates for retrieving Reserved Instance (RI)
+    #   utilization. The start date is inclusive, but the end date is
+    #   exclusive. For example, if `start` is `2017-01-01` and `end` is
+    #   `2017-05-01`, then the cost and usage data is retrieved from
+    #   `2017-01-01` up to and including `2017-04-30` but not including
+    #   `2017-05-01`.
     #   @return [Types::DateInterval]
     #
     # @!attribute [rw] group_by
@@ -3836,9 +3549,9 @@ module Aws::CostExplorer
     #   @return [Types::Expression]
     #
     # @!attribute [rw] sort_by
-    #   The value by which you want to sort the data.
+    #   The value that you want to sort the data by.
     #
-    #   The following values are supported for `Key`\:
+    #   The following values are supported for `Key`:
     #
     #   * `UtilizationPercentage`
     #
@@ -3874,7 +3587,8 @@ module Aws::CostExplorer
     #
     #   * `UnrealizedSavings`
     #
-    #   Supported values for `SortOrder` are `ASCENDING` or `DESCENDING`.
+    #   The supported values for `SortOrder` are `ASCENDING` and
+    #   `DESCENDING`.
     #   @return [Types::SortDefinition]
     #
     # @!attribute [rw] next_page_token
@@ -3905,11 +3619,12 @@ module Aws::CostExplorer
     end
 
     # @!attribute [rw] utilizations_by_time
-    #   The amount of time that you used your RIs.
+    #   The amount of time that you used your Reserved Instances (RIs).
     #   @return [Array<Types::UtilizationByTime>]
     #
     # @!attribute [rw] total
-    #   The total amount of time that you used your RIs.
+    #   The total amount of time that you used your Reserved Instances
+    #   (RIs).
     #   @return [Types::ReservationAggregates]
     #
     # @!attribute [rw] next_page_token
@@ -3928,90 +3643,85 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass GetRightsizingRecommendationRequest
-    #   data as a hash:
-    #
-    #       {
-    #         filter: {
-    #           or: [
-    #             {
-    #               # recursive Expression
-    #             },
-    #           ],
-    #           and: [
-    #             {
-    #               # recursive Expression
-    #             },
-    #           ],
-    #           not: {
-    #             # recursive Expression
-    #           },
-    #           dimensions: {
-    #             key: "AZ", # accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, LINKED_ACCOUNT_NAME, OPERATION, PURCHASE_TYPE, REGION, SERVICE, SERVICE_CODE, USAGE_TYPE, USAGE_TYPE_GROUP, RECORD_TYPE, OPERATING_SYSTEM, TENANCY, SCOPE, PLATFORM, SUBSCRIPTION_ID, LEGAL_ENTITY_NAME, DEPLOYMENT_OPTION, DATABASE_ENGINE, CACHE_ENGINE, INSTANCE_TYPE_FAMILY, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION, AGREEMENT_END_DATE_TIME_AFTER, AGREEMENT_END_DATE_TIME_BEFORE
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #           tags: {
-    #             key: "TagKey",
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #           cost_categories: {
-    #             key: "CostCategoryName",
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #         },
-    #         configuration: {
-    #           recommendation_target: "SAME_INSTANCE_FAMILY", # required, accepts SAME_INSTANCE_FAMILY, CROSS_INSTANCE_FAMILY
-    #           benefits_considered: false, # required
-    #         },
-    #         service: "GenericString", # required
-    #         page_size: 1,
-    #         next_page_token: "NextPageToken",
-    #       }
-    #
     # @!attribute [rw] filter
-    #   Use `Expression` to filter by cost or by usage. There are two
-    #   patterns:
-    #
-    #   * Simple dimension values - You can set the dimension name and
-    #     values for the filters that you plan to use. For example, you can
-    #     filter for `REGION==us-east-1 OR REGION==us-west-1`. For
-    #     `GetRightsizingRecommendation`, the Region is a full name (for
-    #     example, `REGION==US East (N. Virginia)`. The `Expression` example
-    #     is as follows:
-    #
-    #     `\{ "Dimensions": \{ "Key": "REGION", "Values": [ "us-east-1",
-    #     “us-west-1” ] \} \}`
-    #
-    #     The list of dimension values are OR'd together to retrieve cost
-    #     or usage data. You can create `Expression` and `DimensionValues`
-    #     objects using either `with*` methods or `set*` methods in multiple
-    #     lines.
-    #
-    #   * Compound dimension values with logical operations - You can use
-    #     multiple `Expression` types and the logical operators `AND/OR/NOT`
-    #     to create a list of one or more `Expression` objects. By doing
-    #     this, you can filter on more advanced options. For example, you
-    #     can filter on `((REGION == us-east-1 OR REGION == us-west-1) OR
-    #     (TAG.Type == Type1)) AND (USAGE_TYPE != DataTransfer)`. The
-    #     `Expression` for that is as follows:
-    #
-    #     `\{ "And": [ \{"Or": [ \{"Dimensions": \{ "Key": "REGION",
-    #     "Values": [ "us-east-1", "us-west-1" ] \}\}, \{"Tags": \{ "Key":
-    #     "TagName", "Values": ["Value1"] \} \} ]\}, \{"Not":
-    #     \{"Dimensions": \{ "Key": "USAGE_TYPE", "Values": ["DataTransfer"]
-    #     \}\}\} ] \} `
+    #   Use `Expression` to filter in various Cost Explorer APIs.
+    #
+    #   Not all `Expression` types are supported in each API. Refer to the
+    #   documentation for each specific API to see what is supported.
+    #
+    #   There are two patterns:
+    #
+    #   * Simple dimension values.
+    #
+    #     * There are three types of simple dimension values:
+    #       `CostCategories`, `Tags`, and `Dimensions`.
+    #
+    #       * Specify the `CostCategories` field to define a filter that
+    #         acts on Cost Categories.
+    #
+    #       * Specify the `Tags` field to define a filter that acts on Cost
+    #         Allocation Tags.
+    #
+    #       * Specify the `Dimensions` field to define a filter that acts on
+    #         the [ `DimensionValues` ][1].
+    #
+    #     * For each filter type, you can set the dimension name and values
+    #       for the filters that you plan to use.
+    #
+    #       * For example, you can filter for `REGION==us-east-1 OR
+    #         REGION==us-west-1`. For `GetRightsizingRecommendation`, the
+    #         Region is a full name (for example, `REGION==US East (N.
+    #         Virginia)`.
+    #
+    #       * The corresponding `Expression` for this example is as follows:
+    #         `\{ "Dimensions": \{ "Key": "REGION", "Values": [ "us-east-1",
+    #         "us-west-1" ] \} \}`
+    #
+    #       * As shown in the previous example, lists of dimension values
+    #         are combined with `OR` when applying the filter.
+    #
+    #     * You can also set different match options to further control how
+    #       the filter behaves. Not all APIs support match options. Refer to
+    #       the documentation for each specific API to see what is
+    #       supported.
+    #
+    #       * For example, you can filter for linked account names that
+    #         start with "a".
+    #
+    #       * The corresponding `Expression` for this example is as follows:
+    #         `\{ "Dimensions": \{ "Key": "LINKED_ACCOUNT_NAME",
+    #         "MatchOptions": [ "STARTS_WITH" ], "Values": [ "a" ] \} \}`
+    #
+    #   * Compound `Expression` types with logical operations.
+    #
+    #     * You can use multiple `Expression` types and the logical
+    #       operators `AND/OR/NOT` to create a list of one or more
+    #       `Expression` objects. By doing this, you can filter by more
+    #       advanced options.
+    #
+    #     * For example, you can filter by `((REGION == us-east-1 OR REGION
+    #       == us-west-1) OR (TAG.Type == Type1)) AND (USAGE_TYPE !=
+    #       DataTransfer)`.
+    #
+    #     * The corresponding `Expression` for this example is as follows:
+    #       `\{ "And": [ \{"Or": [ \{"Dimensions": \{ "Key": "REGION",
+    #       "Values": [ "us-east-1", "us-west-1" ] \}\}, \{"Tags": \{ "Key":
+    #       "TagName", "Values": ["Value1"] \} \} ]\}, \{"Not":
+    #       \{"Dimensions": \{ "Key": "USAGE_TYPE", "Values":
+    #       ["DataTransfer"] \}\}\} ] \} `
     #
     #     <note markdown="1"> Because each `Expression` can have only one operator, the service
     #     returns an error if more than one is specified. The following
-    #     example shows an `Expression` object that creates an error.
+    #     example shows an `Expression` object that creates an error: ` \{
+    #     "And": [ ... ], "Dimensions": \{ "Key": "USAGE_TYPE", "Values": [
+    #     "DataTransfer" ] \} \} `
     #
-    #      </note>
+    #      The following is an example of the corresponding error message:
+    #     `"Expression has more than one roots. Only one root operator is
+    #     allowed for each expression: And, Or, Not, Dimensions, Tags,
+    #     CostCategories"`
     #
-    #     ` \{ "And": [ ... ], "DimensionValues": \{ "Dimension":
-    #     "USAGE_TYPE", "Values": [ "DataTransfer" ] \} \} `
+    #      </note>
     #
     #   <note markdown="1"> For the `GetRightsizingRecommendation` action, a combination of OR
     #   and NOT isn't supported. OR isn't supported between different
@@ -4024,15 +3734,19 @@ module Aws::CostExplorer
     #   `LINKED_ACCOUNT`.
     #
     #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_DimensionValues.html
     #   @return [Types::Expression]
     #
     # @!attribute [rw] configuration
-    #   Enables you to customize recommendations across two attributes. You
-    #   can choose to view recommendations for instances within the same
-    #   instance families or across different instance families. You can
-    #   also choose to view your estimated savings associated with
-    #   recommendations with consideration of existing Savings Plans or RI
-    #   benefits, or neither.
+    #   You can use Configuration to customize recommendations across two
+    #   attributes. You can choose to view recommendations for instances
+    #   within the same instance families or across different instance
+    #   families. You can also choose to view your estimated savings that
+    #   are associated with recommendations with consideration of existing
+    #   Savings Plans or RI benefits, or neither.
     #   @return [Types::RightsizingRecommendationConfiguration]
     #
     # @!attribute [rw] service
@@ -4079,12 +3793,12 @@ module Aws::CostExplorer
     #   @return [String]
     #
     # @!attribute [rw] configuration
-    #   Enables you to customize recommendations across two attributes. You
-    #   can choose to view recommendations for instances within the same
-    #   instance families or across different instance families. You can
-    #   also choose to view your estimated savings associated with
-    #   recommendations with consideration of existing Savings Plans or RI
-    #   benefits, or neither.
+    #   You can use Configuration to customize recommendations across two
+    #   attributes. You can choose to view recommendations for instances
+    #   within the same instance families or across different instance
+    #   families. You can also choose to view your estimated savings that
+    #   are associated with recommendations with consideration of existing
+    #   Savings Plans or RI benefits, or neither.
     #   @return [Types::RightsizingRecommendationConfiguration]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetRightsizingRecommendationResponse AWS API Documentation
@@ -4099,60 +3813,36 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass GetSavingsPlansCoverageRequest
-    #   data as a hash:
-    #
-    #       {
-    #         time_period: { # required
-    #           start: "YearMonthDay", # required
-    #           end: "YearMonthDay", # required
-    #         },
-    #         group_by: [
-    #           {
-    #             type: "DIMENSION", # accepts DIMENSION, TAG, COST_CATEGORY
-    #             key: "GroupDefinitionKey",
-    #           },
-    #         ],
-    #         granularity: "DAILY", # accepts DAILY, MONTHLY, HOURLY
-    #         filter: {
-    #           or: [
-    #             {
-    #               # recursive Expression
-    #             },
-    #           ],
-    #           and: [
-    #             {
-    #               # recursive Expression
-    #             },
-    #           ],
-    #           not: {
-    #             # recursive Expression
-    #           },
-    #           dimensions: {
-    #             key: "AZ", # accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, LINKED_ACCOUNT_NAME, OPERATION, PURCHASE_TYPE, REGION, SERVICE, SERVICE_CODE, USAGE_TYPE, USAGE_TYPE_GROUP, RECORD_TYPE, OPERATING_SYSTEM, TENANCY, SCOPE, PLATFORM, SUBSCRIPTION_ID, LEGAL_ENTITY_NAME, DEPLOYMENT_OPTION, DATABASE_ENGINE, CACHE_ENGINE, INSTANCE_TYPE_FAMILY, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION, AGREEMENT_END_DATE_TIME_AFTER, AGREEMENT_END_DATE_TIME_BEFORE
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #           tags: {
-    #             key: "TagKey",
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #           cost_categories: {
-    #             key: "CostCategoryName",
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #         },
-    #         metrics: ["MetricName"],
-    #         next_token: "NextPageToken",
-    #         max_results: 1,
-    #         sort_by: {
-    #           key: "SortDefinitionKey", # required
-    #           sort_order: "ASCENDING", # accepts ASCENDING, DESCENDING
-    #         },
-    #       }
+    # @!attribute [rw] recommendation_detail_id
+    #   The ID that is associated with the Savings Plan recommendation.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetSavingsPlanPurchaseRecommendationDetailsRequest AWS API Documentation
+    #
+    class GetSavingsPlanPurchaseRecommendationDetailsRequest < Struct.new(
+      :recommendation_detail_id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] recommendation_detail_id
+    #   The ID that is associated with the Savings Plan recommendation.
+    #   @return [String]
+    #
+    # @!attribute [rw] recommendation_detail_data
+    #   Contains detailed information about a specific Savings Plan
+    #   recommendation.
+    #   @return [Types::RecommendationDetailData]
     #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetSavingsPlanPurchaseRecommendationDetailsResponse AWS API Documentation
+    #
+    class GetSavingsPlanPurchaseRecommendationDetailsResponse < Struct.new(
+      :recommendation_detail_id,
+      :recommendation_detail_data)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] time_period
     #   The time period that you want the usage and costs for. The `Start`
     #   date must be within 13 months. The `End` date must be after the
@@ -4214,9 +3904,9 @@ module Aws::CostExplorer
     #   @return [Integer]
     #
     # @!attribute [rw] sort_by
-    #   The value by which you want to sort the data.
+    #   The value that you want to sort the data by.
     #
-    #   The following values are supported for `Key`\:
+    #   The following values are supported for `Key`:
     #
     #   * `SpendCoveredBySavingsPlan`
     #
@@ -4232,7 +3922,8 @@ module Aws::CostExplorer
     #
     #   * `Service`
     #
-    #   Supported values for `SortOrder` are `ASCENDING` or `DESCENDING`.
+    #   The supported values for `SortOrder` are `ASCENDING` and
+    #   `DESCENDING`.
     #   @return [Types::SortDefinition]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetSavingsPlansCoverageRequest AWS API Documentation
@@ -4269,60 +3960,17 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass GetSavingsPlansPurchaseRecommendationRequest
-    #   data as a hash:
-    #
-    #       {
-    #         savings_plans_type: "COMPUTE_SP", # required, accepts COMPUTE_SP, EC2_INSTANCE_SP, SAGEMAKER_SP
-    #         term_in_years: "ONE_YEAR", # required, accepts ONE_YEAR, THREE_YEARS
-    #         payment_option: "NO_UPFRONT", # required, accepts NO_UPFRONT, PARTIAL_UPFRONT, ALL_UPFRONT, LIGHT_UTILIZATION, MEDIUM_UTILIZATION, HEAVY_UTILIZATION
-    #         account_scope: "PAYER", # accepts PAYER, LINKED
-    #         next_page_token: "NextPageToken",
-    #         page_size: 1,
-    #         lookback_period_in_days: "SEVEN_DAYS", # required, accepts SEVEN_DAYS, THIRTY_DAYS, SIXTY_DAYS
-    #         filter: {
-    #           or: [
-    #             {
-    #               # recursive Expression
-    #             },
-    #           ],
-    #           and: [
-    #             {
-    #               # recursive Expression
-    #             },
-    #           ],
-    #           not: {
-    #             # recursive Expression
-    #           },
-    #           dimensions: {
-    #             key: "AZ", # accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, LINKED_ACCOUNT_NAME, OPERATION, PURCHASE_TYPE, REGION, SERVICE, SERVICE_CODE, USAGE_TYPE, USAGE_TYPE_GROUP, RECORD_TYPE, OPERATING_SYSTEM, TENANCY, SCOPE, PLATFORM, SUBSCRIPTION_ID, LEGAL_ENTITY_NAME, DEPLOYMENT_OPTION, DATABASE_ENGINE, CACHE_ENGINE, INSTANCE_TYPE_FAMILY, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION, AGREEMENT_END_DATE_TIME_AFTER, AGREEMENT_END_DATE_TIME_BEFORE
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #           tags: {
-    #             key: "TagKey",
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #           cost_categories: {
-    #             key: "CostCategoryName",
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #         },
-    #       }
-    #
     # @!attribute [rw] savings_plans_type
-    #   The Savings Plans recommendation type requested.
+    #   The Savings Plans recommendation type that's requested.
     #   @return [String]
     #
     # @!attribute [rw] term_in_years
-    #   The savings plan recommendation term used to generate these
+    #   The savings plan recommendation term that's used to generate these
     #   recommendations.
     #   @return [String]
     #
     # @!attribute [rw] payment_option
-    #   The payment option used to generate these recommendations.
+    #   The payment option that's used to generate these recommendations.
     #   @return [String]
     #
     # @!attribute [rw] account_scope
@@ -4345,22 +3993,22 @@ module Aws::CostExplorer
     #   @return [Integer]
     #
     # @!attribute [rw] lookback_period_in_days
-    #   The lookback period used to generate the recommendation.
+    #   The lookback period that's used to generate the recommendation.
     #   @return [String]
     #
     # @!attribute [rw] filter
     #   You can filter your recommendations by Account ID with the
     #   `LINKED_ACCOUNT` dimension. To filter your recommendations by
     #   Account ID, specify `Key` as `LINKED_ACCOUNT` and `Value` as the
-    #   comma-separated Acount ID(s) for which you want to see Savings Plans
-    #   purchase recommendations.
+    #   comma-separated Acount ID(s) that you want to see Savings Plans
+    #   purchase recommendations for.
     #
-    #   For GetSavingsPlansPurchaseRecommendation, the `Filter` does not
+    #   For GetSavingsPlansPurchaseRecommendation, the `Filter` doesn't
     #   include `CostCategories` or `Tags`. It only includes `Dimensions`.
     #   With `Dimensions`, `Key` must be `LINKED_ACCOUNT` and `Value` can be
-    #   a single Account ID or multiple comma-separated Account IDs for
-    #   which you want to see Savings Plans Purchase Recommendations. `AND`
-    #   and `OR` operators are not supported.
+    #   a single Account ID or multiple comma-separated Account IDs that you
+    #   want to see Savings Plans Purchase Recommendations for. `AND` and
+    #   `OR` operators are not supported.
     #   @return [Types::Expression]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetSavingsPlansPurchaseRecommendationRequest AWS API Documentation
@@ -4379,7 +4027,7 @@ module Aws::CostExplorer
     end
 
     # @!attribute [rw] metadata
-    #   Information regarding this specific recommendation set.
+    #   Information that regards this specific recommendation set.
     #   @return [Types::SavingsPlansPurchaseRecommendationMetadata]
     #
     # @!attribute [rw] savings_plans_purchase_recommendation
@@ -4403,53 +4051,6 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass GetSavingsPlansUtilizationDetailsRequest
-    #   data as a hash:
-    #
-    #       {
-    #         time_period: { # required
-    #           start: "YearMonthDay", # required
-    #           end: "YearMonthDay", # required
-    #         },
-    #         filter: {
-    #           or: [
-    #             {
-    #               # recursive Expression
-    #             },
-    #           ],
-    #           and: [
-    #             {
-    #               # recursive Expression
-    #             },
-    #           ],
-    #           not: {
-    #             # recursive Expression
-    #           },
-    #           dimensions: {
-    #             key: "AZ", # accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, LINKED_ACCOUNT_NAME, OPERATION, PURCHASE_TYPE, REGION, SERVICE, SERVICE_CODE, USAGE_TYPE, USAGE_TYPE_GROUP, RECORD_TYPE, OPERATING_SYSTEM, TENANCY, SCOPE, PLATFORM, SUBSCRIPTION_ID, LEGAL_ENTITY_NAME, DEPLOYMENT_OPTION, DATABASE_ENGINE, CACHE_ENGINE, INSTANCE_TYPE_FAMILY, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION, AGREEMENT_END_DATE_TIME_AFTER, AGREEMENT_END_DATE_TIME_BEFORE
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #           tags: {
-    #             key: "TagKey",
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #           cost_categories: {
-    #             key: "CostCategoryName",
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #         },
-    #         data_type: ["ATTRIBUTES"], # accepts ATTRIBUTES, UTILIZATION, AMORTIZED_COMMITMENT, SAVINGS
-    #         next_token: "NextPageToken",
-    #         max_results: 1,
-    #         sort_by: {
-    #           key: "SortDefinitionKey", # required
-    #           sort_order: "ASCENDING", # accepts ASCENDING, DESCENDING
-    #         },
-    #       }
-    #
     # @!attribute [rw] time_period
     #   The time period that you want the usage and costs for. The `Start`
     #   date must be within 13 months. The `End` date must be after the
@@ -4496,9 +4097,9 @@ module Aws::CostExplorer
     #   @return [Integer]
     #
     # @!attribute [rw] sort_by
-    #   The value by which you want to sort the data.
+    #   The value that you want to sort the data by.
     #
-    #   The following values are supported for `Key`\:
+    #   The following values are supported for `Key`:
     #
     #   * `UtilizationPercentage`
     #
@@ -4514,7 +4115,8 @@ module Aws::CostExplorer
     #
     #   * `AmortizedUpfrontCommitment`
     #
-    #   Supported values for `SortOrder` are `ASCENDING` or `DESCENDING`.
+    #   The supported values for `SortOrder` are `ASCENDING` and
+    #   `DESCENDING`.
     #   @return [Types::SortDefinition]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetSavingsPlansUtilizationDetailsRequest AWS API Documentation
@@ -4560,51 +4162,6 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass GetSavingsPlansUtilizationRequest
-    #   data as a hash:
-    #
-    #       {
-    #         time_period: { # required
-    #           start: "YearMonthDay", # required
-    #           end: "YearMonthDay", # required
-    #         },
-    #         granularity: "DAILY", # accepts DAILY, MONTHLY, HOURLY
-    #         filter: {
-    #           or: [
-    #             {
-    #               # recursive Expression
-    #             },
-    #           ],
-    #           and: [
-    #             {
-    #               # recursive Expression
-    #             },
-    #           ],
-    #           not: {
-    #             # recursive Expression
-    #           },
-    #           dimensions: {
-    #             key: "AZ", # accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, LINKED_ACCOUNT_NAME, OPERATION, PURCHASE_TYPE, REGION, SERVICE, SERVICE_CODE, USAGE_TYPE, USAGE_TYPE_GROUP, RECORD_TYPE, OPERATING_SYSTEM, TENANCY, SCOPE, PLATFORM, SUBSCRIPTION_ID, LEGAL_ENTITY_NAME, DEPLOYMENT_OPTION, DATABASE_ENGINE, CACHE_ENGINE, INSTANCE_TYPE_FAMILY, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION, AGREEMENT_END_DATE_TIME_AFTER, AGREEMENT_END_DATE_TIME_BEFORE
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #           tags: {
-    #             key: "TagKey",
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #           cost_categories: {
-    #             key: "CostCategoryName",
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #         },
-    #         sort_by: {
-    #           key: "SortDefinitionKey", # required
-    #           sort_order: "ASCENDING", # accepts ASCENDING, DESCENDING
-    #         },
-    #       }
-    #
     # @!attribute [rw] time_period
     #   The time period that you want the usage and costs for. The `Start`
     #   date must be within 13 months. The `End` date must be after the
@@ -4646,9 +4203,9 @@ module Aws::CostExplorer
     #   @return [Types::Expression]
     #
     # @!attribute [rw] sort_by
-    #   The value by which you want to sort the data.
+    #   The value that you want to sort the data by.
     #
-    #   The following values are supported for `Key`\:
+    #   The following values are supported for `Key`:
     #
     #   * `UtilizationPercentage`
     #
@@ -4660,7 +4217,8 @@ module Aws::CostExplorer
     #
     #   * `NetSavings`
     #
-    #   Supported values for `SortOrder` are `ASCENDING` or `DESCENDING`.
+    #   The supported values for `SortOrder` are `ASCENDING` and
+    #   `DESCENDING`.
     #   @return [Types::SortDefinition]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetSavingsPlansUtilizationRequest AWS API Documentation
@@ -4675,8 +4233,8 @@ module Aws::CostExplorer
     end
 
     # @!attribute [rw] savings_plans_utilizations_by_time
-    #   The amount of cost/commitment you used your Savings Plans. This
-    #   allows you to specify date ranges.
+    #   The amount of cost/commitment that you used your Savings Plans. You
+    #   can use it to specify date ranges.
     #   @return [Array<Types::SavingsPlansUtilizationByTime>]
     #
     # @!attribute [rw] total
@@ -4693,56 +4251,6 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass GetTagsRequest
-    #   data as a hash:
-    #
-    #       {
-    #         search_string: "SearchString",
-    #         time_period: { # required
-    #           start: "YearMonthDay", # required
-    #           end: "YearMonthDay", # required
-    #         },
-    #         tag_key: "TagKey",
-    #         filter: {
-    #           or: [
-    #             {
-    #               # recursive Expression
-    #             },
-    #           ],
-    #           and: [
-    #             {
-    #               # recursive Expression
-    #             },
-    #           ],
-    #           not: {
-    #             # recursive Expression
-    #           },
-    #           dimensions: {
-    #             key: "AZ", # accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, LINKED_ACCOUNT_NAME, OPERATION, PURCHASE_TYPE, REGION, SERVICE, SERVICE_CODE, USAGE_TYPE, USAGE_TYPE_GROUP, RECORD_TYPE, OPERATING_SYSTEM, TENANCY, SCOPE, PLATFORM, SUBSCRIPTION_ID, LEGAL_ENTITY_NAME, DEPLOYMENT_OPTION, DATABASE_ENGINE, CACHE_ENGINE, INSTANCE_TYPE_FAMILY, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION, AGREEMENT_END_DATE_TIME_AFTER, AGREEMENT_END_DATE_TIME_BEFORE
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #           tags: {
-    #             key: "TagKey",
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #           cost_categories: {
-    #             key: "CostCategoryName",
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #         },
-    #         sort_by: [
-    #           {
-    #             key: "SortDefinitionKey", # required
-    #             sort_order: "ASCENDING", # accepts ASCENDING, DESCENDING
-    #           },
-    #         ],
-    #         max_results: 1,
-    #         next_page_token: "NextPageToken",
-    #       }
-    #
     # @!attribute [rw] search_string
     #   The value that you want to search for.
     #   @return [String]
@@ -4760,46 +4268,84 @@ module Aws::CostExplorer
     #   @return [String]
     #
     # @!attribute [rw] filter
-    #   Use `Expression` to filter by cost or by usage. There are two
-    #   patterns:
-    #
-    #   * Simple dimension values - You can set the dimension name and
-    #     values for the filters that you plan to use. For example, you can
-    #     filter for `REGION==us-east-1 OR REGION==us-west-1`. For
-    #     `GetRightsizingRecommendation`, the Region is a full name (for
-    #     example, `REGION==US East (N. Virginia)`. The `Expression` example
-    #     is as follows:
-    #
-    #     `\{ "Dimensions": \{ "Key": "REGION", "Values": [ "us-east-1",
-    #     “us-west-1” ] \} \}`
-    #
-    #     The list of dimension values are OR'd together to retrieve cost
-    #     or usage data. You can create `Expression` and `DimensionValues`
-    #     objects using either `with*` methods or `set*` methods in multiple
-    #     lines.
-    #
-    #   * Compound dimension values with logical operations - You can use
-    #     multiple `Expression` types and the logical operators `AND/OR/NOT`
-    #     to create a list of one or more `Expression` objects. By doing
-    #     this, you can filter on more advanced options. For example, you
-    #     can filter on `((REGION == us-east-1 OR REGION == us-west-1) OR
-    #     (TAG.Type == Type1)) AND (USAGE_TYPE != DataTransfer)`. The
-    #     `Expression` for that is as follows:
-    #
-    #     `\{ "And": [ \{"Or": [ \{"Dimensions": \{ "Key": "REGION",
-    #     "Values": [ "us-east-1", "us-west-1" ] \}\}, \{"Tags": \{ "Key":
-    #     "TagName", "Values": ["Value1"] \} \} ]\}, \{"Not":
-    #     \{"Dimensions": \{ "Key": "USAGE_TYPE", "Values": ["DataTransfer"]
-    #     \}\}\} ] \} `
+    #   Use `Expression` to filter in various Cost Explorer APIs.
+    #
+    #   Not all `Expression` types are supported in each API. Refer to the
+    #   documentation for each specific API to see what is supported.
+    #
+    #   There are two patterns:
+    #
+    #   * Simple dimension values.
+    #
+    #     * There are three types of simple dimension values:
+    #       `CostCategories`, `Tags`, and `Dimensions`.
+    #
+    #       * Specify the `CostCategories` field to define a filter that
+    #         acts on Cost Categories.
+    #
+    #       * Specify the `Tags` field to define a filter that acts on Cost
+    #         Allocation Tags.
+    #
+    #       * Specify the `Dimensions` field to define a filter that acts on
+    #         the [ `DimensionValues` ][1].
+    #
+    #     * For each filter type, you can set the dimension name and values
+    #       for the filters that you plan to use.
+    #
+    #       * For example, you can filter for `REGION==us-east-1 OR
+    #         REGION==us-west-1`. For `GetRightsizingRecommendation`, the
+    #         Region is a full name (for example, `REGION==US East (N.
+    #         Virginia)`.
+    #
+    #       * The corresponding `Expression` for this example is as follows:
+    #         `\{ "Dimensions": \{ "Key": "REGION", "Values": [ "us-east-1",
+    #         "us-west-1" ] \} \}`
+    #
+    #       * As shown in the previous example, lists of dimension values
+    #         are combined with `OR` when applying the filter.
+    #
+    #     * You can also set different match options to further control how
+    #       the filter behaves. Not all APIs support match options. Refer to
+    #       the documentation for each specific API to see what is
+    #       supported.
+    #
+    #       * For example, you can filter for linked account names that
+    #         start with "a".
+    #
+    #       * The corresponding `Expression` for this example is as follows:
+    #         `\{ "Dimensions": \{ "Key": "LINKED_ACCOUNT_NAME",
+    #         "MatchOptions": [ "STARTS_WITH" ], "Values": [ "a" ] \} \}`
+    #
+    #   * Compound `Expression` types with logical operations.
+    #
+    #     * You can use multiple `Expression` types and the logical
+    #       operators `AND/OR/NOT` to create a list of one or more
+    #       `Expression` objects. By doing this, you can filter by more
+    #       advanced options.
+    #
+    #     * For example, you can filter by `((REGION == us-east-1 OR REGION
+    #       == us-west-1) OR (TAG.Type == Type1)) AND (USAGE_TYPE !=
+    #       DataTransfer)`.
+    #
+    #     * The corresponding `Expression` for this example is as follows:
+    #       `\{ "And": [ \{"Or": [ \{"Dimensions": \{ "Key": "REGION",
+    #       "Values": [ "us-east-1", "us-west-1" ] \}\}, \{"Tags": \{ "Key":
+    #       "TagName", "Values": ["Value1"] \} \} ]\}, \{"Not":
+    #       \{"Dimensions": \{ "Key": "USAGE_TYPE", "Values":
+    #       ["DataTransfer"] \}\}\} ] \} `
     #
     #     <note markdown="1"> Because each `Expression` can have only one operator, the service
     #     returns an error if more than one is specified. The following
-    #     example shows an `Expression` object that creates an error.
+    #     example shows an `Expression` object that creates an error: ` \{
+    #     "And": [ ... ], "Dimensions": \{ "Key": "USAGE_TYPE", "Values": [
+    #     "DataTransfer" ] \} \} `
     #
-    #      </note>
+    #      The following is an example of the corresponding error message:
+    #     `"Expression has more than one roots. Only one root operator is
+    #     allowed for each expression: And, Or, Not, Dimensions, Tags,
+    #     CostCategories"`
     #
-    #     ` \{ "And": [ ... ], "DimensionValues": \{ "Dimension":
-    #     "USAGE_TYPE", "Values": [ "DataTransfer" ] \} \} `
+    #      </note>
     #
     #   <note markdown="1"> For the `GetRightsizingRecommendation` action, a combination of OR
     #   and NOT isn't supported. OR isn't supported between different
@@ -4812,10 +4358,14 @@ module Aws::CostExplorer
     #   `LINKED_ACCOUNT`.
     #
     #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_DimensionValues.html
     #   @return [Types::Expression]
     #
     # @!attribute [rw] sort_by
-    #   The value by which you want to sort the data.
+    #   The value that you want to sort the data by.
     #
     #   The key represents cost and usage metrics. The following values are
     #   supported:
@@ -4834,19 +4384,20 @@ module Aws::CostExplorer
     #
     #   * `NormalizedUsageAmount`
     #
-    #   Supported values for `SortOrder` are `ASCENDING` or `DESCENDING`.
+    #   The supported values for `SortOrder` are `ASCENDING` and
+    #   `DESCENDING`.
     #
-    #   When using `SortBy`, `NextPageToken` and `SearchString` are not
+    #   When you use `SortBy`, `NextPageToken` and `SearchString` aren't
     #   supported.
     #   @return [Array<Types::SortDefinition>]
     #
     # @!attribute [rw] max_results
     #   This field is only used when SortBy is provided in the request. The
-    #   maximum number of objects that to be returned for this request. If
-    #   MaxResults is not specified with SortBy, the request will return
-    #   1000 results as the default value for this parameter.
+    #   maximum number of objects that are returned for this request. If
+    #   MaxResults isn't specified with SortBy, the request returns 1000
+    #   results as the default value for this parameter.
     #
-    #   For `GetTags`, MaxResults has an upper limit of 1000.
+    #   For `GetTags`, MaxResults has an upper quota of 1000.
     #   @return [Integer]
     #
     # @!attribute [rw] next_page_token
@@ -4899,57 +4450,14 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass GetUsageForecastRequest
-    #   data as a hash:
-    #
-    #       {
-    #         time_period: { # required
-    #           start: "YearMonthDay", # required
-    #           end: "YearMonthDay", # required
-    #         },
-    #         metric: "BLENDED_COST", # required, accepts BLENDED_COST, UNBLENDED_COST, AMORTIZED_COST, NET_UNBLENDED_COST, NET_AMORTIZED_COST, USAGE_QUANTITY, NORMALIZED_USAGE_AMOUNT
-    #         granularity: "DAILY", # required, accepts DAILY, MONTHLY, HOURLY
-    #         filter: {
-    #           or: [
-    #             {
-    #               # recursive Expression
-    #             },
-    #           ],
-    #           and: [
-    #             {
-    #               # recursive Expression
-    #             },
-    #           ],
-    #           not: {
-    #             # recursive Expression
-    #           },
-    #           dimensions: {
-    #             key: "AZ", # accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, LINKED_ACCOUNT_NAME, OPERATION, PURCHASE_TYPE, REGION, SERVICE, SERVICE_CODE, USAGE_TYPE, USAGE_TYPE_GROUP, RECORD_TYPE, OPERATING_SYSTEM, TENANCY, SCOPE, PLATFORM, SUBSCRIPTION_ID, LEGAL_ENTITY_NAME, DEPLOYMENT_OPTION, DATABASE_ENGINE, CACHE_ENGINE, INSTANCE_TYPE_FAMILY, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION, AGREEMENT_END_DATE_TIME_AFTER, AGREEMENT_END_DATE_TIME_BEFORE
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #           tags: {
-    #             key: "TagKey",
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #           cost_categories: {
-    #             key: "CostCategoryName",
-    #             values: ["Value"],
-    #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #           },
-    #         },
-    #         prediction_interval_level: 1,
-    #       }
-    #
     # @!attribute [rw] time_period
     #   The start and end dates of the period that you want to retrieve
-    #   usage forecast for. The start date is inclusive, but the end date is
-    #   exclusive. For example, if `start` is `2017-01-01` and `end` is
-    #   `2017-05-01`, then the cost and usage data is retrieved from
-    #   `2017-01-01` up to and including `2017-04-30` but not including
-    #   `2017-05-01`. The start date must be equal to or later than the
-    #   current date to avoid a validation error.
+    #   usage forecast for. The start date is included in the period, but
+    #   the end date isn't included in the period. For example, if `start`
+    #   is `2017-01-01` and `end` is `2017-05-01`, then the cost and usage
+    #   data is retrieved from `2017-01-01` up to and including `2017-04-30`
+    #   but not including `2017-05-01`. The start date must be equal to or
+    #   later than the current date to avoid a validation error.
     #   @return [Types::DateInterval]
     #
     # @!attribute [rw] metric
@@ -5023,12 +4531,12 @@ module Aws::CostExplorer
     #   @return [Types::Expression]
     #
     # @!attribute [rw] prediction_interval_level
-    #   Cost Explorer always returns the mean forecast as a single point.
-    #   You can request a prediction interval around the mean by specifying
-    #   a confidence level. The higher the confidence level, the more
-    #   confident Cost Explorer is about the actual value falling in the
-    #   prediction interval. Higher confidence levels result in wider
-    #   prediction intervals.
+    #   Amazon Web Services Cost Explorer always returns the mean forecast
+    #   as a single point. You can request a prediction interval around the
+    #   mean by specifying a confidence level. The higher the confidence
+    #   level, the more confident Cost Explorer is about the actual value
+    #   falling in the prediction interval. Higher confidence levels result
+    #   in wider prediction intervals.
     #   @return [Integer]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetUsageForecastRequest AWS API Documentation
@@ -5084,14 +4592,6 @@ module Aws::CostExplorer
     # Represents a group when you specify a group by criteria or in the
     # response to a query with a specific grouping.
     #
-    # @note When making an API call, you may pass GroupDefinition
-    #   data as a hash:
-    #
-    #       {
-    #         type: "DIMENSION", # accepts DIMENSION, TAG, COST_CATEGORY
-    #         key: "GroupDefinitionKey",
-    #       }
-    #
     # @!attribute [rw] type
     #   The string that represents the type of group.
     #   @return [String]
@@ -5116,46 +4616,76 @@ module Aws::CostExplorer
     #   @return [Float]
     #
     # @!attribute [rw] total_impact
-    #   The cumulative dollar value that's observed for an anomaly.
+    #   The cumulative dollar difference between the total actual spend and
+    #   total expected spend. It is calculated as `TotalActualSpend -
+    #   TotalExpectedSpend`.
+    #   @return [Float]
+    #
+    # @!attribute [rw] total_actual_spend
+    #   The cumulative dollar amount that was actually spent during the
+    #   anomaly.
+    #   @return [Float]
+    #
+    # @!attribute [rw] total_expected_spend
+    #   The cumulative dollar amount that was expected to be spent during
+    #   the anomaly. It is calculated using advanced machine learning models
+    #   to determine the typical spending pattern based on historical data
+    #   for a customer.
+    #   @return [Float]
+    #
+    # @!attribute [rw] total_impact_percentage
+    #   The cumulative percentage difference between the total actual spend
+    #   and total expected spend. It is calculated as `(TotalImpact /
+    #   TotalExpectedSpend) * 100`. When `TotalExpectedSpend` is zero, this
+    #   field is omitted. Expected spend can be zero in situations such as
+    #   when you start to use a service for the first time.
     #   @return [Float]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/Impact AWS API Documentation
     #
     class Impact < Struct.new(
       :max_impact,
-      :total_impact)
+      :total_impact,
+      :total_actual_spend,
+      :total_expected_spend,
+      :total_impact_percentage)
       SENSITIVE = []
       include Aws::Structure
     end
 
-    # Details about the instances that Amazon Web Services recommends that
-    # you purchase.
+    # Details about the reservations that Amazon Web Services recommends
+    # that you purchase.
     #
     # @!attribute [rw] ec2_instance_details
-    #   The Amazon EC2 instances that Amazon Web Services recommends that
+    #   The Amazon EC2 reservations that Amazon Web Services recommends that
     #   you purchase.
     #   @return [Types::EC2InstanceDetails]
     #
     # @!attribute [rw] rds_instance_details
-    #   The Amazon RDS instances that Amazon Web Services recommends that
+    #   The Amazon RDS reservations that Amazon Web Services recommends that
     #   you purchase.
     #   @return [Types::RDSInstanceDetails]
     #
     # @!attribute [rw] redshift_instance_details
-    #   The Amazon Redshift instances that Amazon Web Services recommends
+    #   The Amazon Redshift reservations that Amazon Web Services recommends
     #   that you purchase.
     #   @return [Types::RedshiftInstanceDetails]
     #
     # @!attribute [rw] elasticache_instance_details
-    #   The ElastiCache instances that Amazon Web Services recommends that
-    #   you purchase.
+    #   The ElastiCache reservations that Amazon Web Services recommends
+    #   that you purchase.
     #   @return [Types::ElastiCacheInstanceDetails]
     #
     # @!attribute [rw] es_instance_details
-    #   The Amazon ES instances that Amazon Web Services recommends that you
-    #   purchase.
+    #   The Amazon OpenSearch Service reservations that Amazon Web Services
+    #   recommends that you purchase.
     #   @return [Types::ESInstanceDetails]
     #
+    # @!attribute [rw] memory_db_instance_details
+    #   The MemoryDB reservations that Amazon Web Services recommends that
+    #   you purchase.
+    #   @return [Types::MemoryDBInstanceDetails]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/InstanceDetails AWS API Documentation
     #
     class InstanceDetails < Struct.new(
@@ -5163,7 +4693,8 @@ module Aws::CostExplorer
       :rds_instance_details,
       :redshift_instance_details,
       :elasticache_instance_details,
-      :es_instance_details)
+      :es_instance_details,
+      :memory_db_instance_details)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -5194,15 +4725,67 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass ListCostCategoryDefinitionsRequest
-    #   data as a hash:
+    # @!attribute [rw] status
+    #   The status of cost allocation tag keys that are returned for this
+    #   request.
+    #   @return [String]
+    #
+    # @!attribute [rw] tag_keys
+    #   The list of cost allocation tag keys that are returned for this
+    #   request.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] type
+    #   The type of `CostAllocationTag` object that are returned for this
+    #   request. The `AWSGenerated` type tags are tags that Amazon Web
+    #   Services defines and applies to support Amazon Web Services
+    #   resources for cost allocation purposes. The `UserDefined` type tags
+    #   are tags that you define, create, and apply to resources.
+    #   @return [String]
+    #
+    # @!attribute [rw] next_token
+    #   The token to retrieve the next set of results. Amazon Web Services
+    #   provides the token when the response from a previous call has more
+    #   results than the maximum page size.
+    #   @return [String]
+    #
+    # @!attribute [rw] max_results
+    #   The maximum number of objects that are returned for this request. By
+    #   default, the request returns 100 results.
+    #   @return [Integer]
     #
-    #       {
-    #         effective_on: "ZonedDateTime",
-    #         next_token: "NextPageToken",
-    #         max_results: 1,
-    #       }
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/ListCostAllocationTagsRequest AWS API Documentation
     #
+    class ListCostAllocationTagsRequest < Struct.new(
+      :status,
+      :tag_keys,
+      :type,
+      :next_token,
+      :max_results)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] cost_allocation_tags
+    #   A list of cost allocation tags that includes the detailed metadata
+    #   for each one.
+    #   @return [Array<Types::CostAllocationTag>]
+    #
+    # @!attribute [rw] next_token
+    #   The token to retrieve the next set of results. Amazon Web Services
+    #   provides the token when the response from a previous call has more
+    #   results than the maximum page size.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/ListCostAllocationTagsResponse AWS API Documentation
+    #
+    class ListCostAllocationTagsResponse < Struct.new(
+      :cost_allocation_tags,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] effective_on
     #   The date when the Cost Category was effective.
     #   @return [String]
@@ -5228,7 +4811,7 @@ module Aws::CostExplorer
     end
 
     # @!attribute [rw] cost_category_references
-    #   A reference to a Cost Category containing enough information to
+    #   A reference to a Cost Category that contains enough information to
     #   identify the Cost Category.
     #   @return [Array<Types::CostCategoryReference>]
     #
@@ -5247,31 +4830,141 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # The aggregated value for a metric.
-    #
-    # @!attribute [rw] amount
-    #   The actual number that represents the metric.
+    # @!attribute [rw] generation_status
+    #   The status of the recommendation generation.
     #   @return [String]
     #
-    # @!attribute [rw] unit
-    #   The unit that the metric is given in.
+    # @!attribute [rw] recommendation_ids
+    #   The IDs for each specific recommendation.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] page_size
+    #   The number of recommendations that you want returned in a single
+    #   response object.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] next_page_token
+    #   The token to retrieve the next set of results.
     #   @return [String]
     #
-    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/MetricValue AWS API Documentation
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/ListSavingsPlansPurchaseRecommendationGenerationRequest AWS API Documentation
     #
-    class MetricValue < Struct.new(
-      :amount,
-      :unit)
+    class ListSavingsPlansPurchaseRecommendationGenerationRequest < Struct.new(
+      :generation_status,
+      :recommendation_ids,
+      :page_size,
+      :next_page_token)
       SENSITIVE = []
       include Aws::Structure
     end
 
-    # Details on the modification recommendation.
+    # @!attribute [rw] generation_summary_list
+    #   The list of historical recommendation generations.
+    #   @return [Array<Types::GenerationSummary>]
     #
-    # @!attribute [rw] target_instances
-    #   Determines whether this instance type is the Amazon Web Services
-    #   default recommendation.
-    #   @return [Array<Types::TargetInstance>]
+    # @!attribute [rw] next_page_token
+    #   The token to retrieve the next set of results.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/ListSavingsPlansPurchaseRecommendationGenerationResponse AWS API Documentation
+    #
+    class ListSavingsPlansPurchaseRecommendationGenerationResponse < Struct.new(
+      :generation_summary_list,
+      :next_page_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] resource_arn
+    #   The Amazon Resource Name (ARN) of the resource. For a list of
+    #   supported resources, see [ResourceTag][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_ResourceTag.html
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/ListTagsForResourceRequest AWS API Documentation
+    #
+    class ListTagsForResourceRequest < Struct.new(
+      :resource_arn)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] resource_tags
+    #   A list of tag key value pairs that are associated with the resource.
+    #   @return [Array<Types::ResourceTag>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/ListTagsForResourceResponse AWS API Documentation
+    #
+    class ListTagsForResourceResponse < Struct.new(
+      :resource_tags)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Details about the MemoryDB reservations that Amazon Web Services
+    # recommends that you purchase.
+    #
+    # @!attribute [rw] family
+    #   The instance family of the recommended reservation.
+    #   @return [String]
+    #
+    # @!attribute [rw] node_type
+    #   The node type of the recommended reservation.
+    #   @return [String]
+    #
+    # @!attribute [rw] region
+    #   The Amazon Web Services Region of the recommended reservation.
+    #   @return [String]
+    #
+    # @!attribute [rw] current_generation
+    #   Determines whether the recommendation is for a current generation
+    #   instance.
+    #   @return [Boolean]
+    #
+    # @!attribute [rw] size_flex_eligible
+    #   Determines whether the recommended reservation is size flexible.
+    #   @return [Boolean]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/MemoryDBInstanceDetails AWS API Documentation
+    #
+    class MemoryDBInstanceDetails < Struct.new(
+      :family,
+      :node_type,
+      :region,
+      :current_generation,
+      :size_flex_eligible)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # The aggregated value for a metric.
+    #
+    # @!attribute [rw] amount
+    #   The actual number that represents the metric.
+    #   @return [String]
+    #
+    # @!attribute [rw] unit
+    #   The unit that the metric is given in.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/MetricValue AWS API Documentation
+    #
+    class MetricValue < Struct.new(
+      :amount,
+      :unit)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Details for the modification recommendation.
+    #
+    # @!attribute [rw] target_instances
+    #   Determines whether this instance type is the Amazon Web Services
+    #   default recommendation.
+    #   @return [Array<Types::TargetInstance>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/ModifyRecommendationDetail AWS API Documentation
     #
@@ -5286,20 +4979,20 @@ module Aws::CostExplorer
     #
     # @!attribute [rw] network_in_bytes_per_second
     #   The network inbound throughput utilization measured in Bytes per
-    #   second.
+    #   second (Bps).
     #   @return [String]
     #
     # @!attribute [rw] network_out_bytes_per_second
     #   The network outbound throughput utilization measured in Bytes per
-    #   second.
+    #   second (Bps).
     #   @return [String]
     #
     # @!attribute [rw] network_packets_in_per_second
-    #   The network ingress packets that are measured in packets per second.
+    #   The network inbound packets that are measured in packets per second.
     #   @return [String]
     #
     # @!attribute [rw] network_packets_out_per_second
-    #   The network outgress packets that are measured in packets per
+    #   The network outbound packets that are measured in packets per
     #   second.
     #   @return [String]
     #
@@ -5314,14 +5007,6 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass ProvideAnomalyFeedbackRequest
-    #   data as a hash:
-    #
-    #       {
-    #         anomaly_id: "GenericString", # required
-    #         feedback: "YES", # required, accepts YES, NO, PLANNED_ACTIVITY
-    #       }
-    #
     # @!attribute [rw] anomaly_id
     #   A cost anomaly ID.
     #   @return [String]
@@ -5352,7 +5037,7 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # Details about the Amazon RDS instances that Amazon Web Services
+    # Details about the Amazon RDS reservations that Amazon Web Services
     # recommends that you purchase.
     #
     # @!attribute [rw] family
@@ -5410,8 +5095,223 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # Details about the Amazon Redshift instances that Amazon Web Services
-    # recommends that you purchase.
+    # The details and metrics for the given recommendation.
+    #
+    # @!attribute [rw] account_scope
+    #   The account scope that you want your recommendations for. Amazon Web
+    #   Services calculates recommendations including the management account
+    #   and member accounts if the value is set to PAYER. If the value is
+    #   LINKED, recommendations are calculated for individual member
+    #   accounts only.
+    #   @return [String]
+    #
+    # @!attribute [rw] lookback_period_in_days
+    #   How many days of previous usage that Amazon Web Services considers
+    #   when making this recommendation.
+    #   @return [String]
+    #
+    # @!attribute [rw] savings_plans_type
+    #   The requested Savings Plan recommendation type.
+    #   @return [String]
+    #
+    # @!attribute [rw] term_in_years
+    #   The term of the commitment in years.
+    #   @return [String]
+    #
+    # @!attribute [rw] payment_option
+    #   The payment option for the commitment (for example, All Upfront or
+    #   No Upfront).
+    #   @return [String]
+    #
+    # @!attribute [rw] account_id
+    #   The AccountID that the recommendation is generated for.
+    #   @return [String]
+    #
+    # @!attribute [rw] currency_code
+    #   The currency code that Amazon Web Services used to generate the
+    #   recommendation and present potential savings.
+    #   @return [String]
+    #
+    # @!attribute [rw] instance_family
+    #   The instance family of the recommended Savings Plan.
+    #   @return [String]
+    #
+    # @!attribute [rw] region
+    #   The region the recommendation is generated for.
+    #   @return [String]
+    #
+    # @!attribute [rw] offering_id
+    #   The unique ID that's used to distinguish Savings Plans from one
+    #   another.
+    #   @return [String]
+    #
+    # @!attribute [rw] generation_timestamp
+    #   The period of time that you want the usage and costs for.
+    #   @return [String]
+    #
+    # @!attribute [rw] latest_usage_timestamp
+    #   The period of time that you want the usage and costs for.
+    #   @return [String]
+    #
+    # @!attribute [rw] current_average_hourly_on_demand_spend
+    #   The average value of hourly On-Demand spend over the lookback period
+    #   of the applicable usage type.
+    #   @return [String]
+    #
+    # @!attribute [rw] current_maximum_hourly_on_demand_spend
+    #   The highest value of hourly On-Demand spend over the lookback period
+    #   of the applicable usage type.
+    #   @return [String]
+    #
+    # @!attribute [rw] current_minimum_hourly_on_demand_spend
+    #   The lowest value of hourly On-Demand spend over the lookback period
+    #   of the applicable usage type.
+    #   @return [String]
+    #
+    # @!attribute [rw] estimated_average_utilization
+    #   The estimated utilization of the recommended Savings Plan.
+    #   @return [String]
+    #
+    # @!attribute [rw] estimated_monthly_savings_amount
+    #   The estimated monthly savings amount based on the recommended
+    #   Savings Plan.
+    #   @return [String]
+    #
+    # @!attribute [rw] estimated_on_demand_cost
+    #   The remaining On-Demand cost estimated to not be covered by the
+    #   recommended Savings Plan, over the length of the lookback period.
+    #   @return [String]
+    #
+    # @!attribute [rw] estimated_on_demand_cost_with_current_commitment
+    #   The estimated On-Demand costs you expect with no additional
+    #   commitment, based on your usage of the selected time period and the
+    #   Savings Plan you own.
+    #   @return [String]
+    #
+    # @!attribute [rw] estimated_roi
+    #   The estimated return on investment that's based on the recommended
+    #   Savings Plan that you purchased. This is calculated as
+    #   estimatedSavingsAmount/estimatedSPCost*100.
+    #   @return [String]
+    #
+    # @!attribute [rw] estimated_sp_cost
+    #   The cost of the recommended Savings Plan over the length of the
+    #   lookback period.
+    #   @return [String]
+    #
+    # @!attribute [rw] estimated_savings_amount
+    #   The estimated savings amount that's based on the recommended
+    #   Savings Plan over the length of the lookback period.
+    #   @return [String]
+    #
+    # @!attribute [rw] estimated_savings_percentage
+    #   The estimated savings percentage relative to the total cost of
+    #   applicable On-Demand usage over the lookback period.
+    #   @return [String]
+    #
+    # @!attribute [rw] existing_hourly_commitment
+    #   The existing hourly commitment for the Savings Plan type.
+    #   @return [String]
+    #
+    # @!attribute [rw] hourly_commitment_to_purchase
+    #   The recommended hourly commitment level for the Savings Plan type
+    #   and the configuration that's based on the usage during the lookback
+    #   period.
+    #   @return [String]
+    #
+    # @!attribute [rw] upfront_cost
+    #   The upfront cost of the recommended Savings Plan, based on the
+    #   selected payment option.
+    #   @return [String]
+    #
+    # @!attribute [rw] current_average_coverage
+    #   The average value of hourly coverage over the lookback period.
+    #   @return [String]
+    #
+    # @!attribute [rw] estimated_average_coverage
+    #   The estimated coverage of the recommended Savings Plan.
+    #   @return [String]
+    #
+    # @!attribute [rw] metrics_over_lookback_period
+    #   The related hourly cost, coverage, and utilization metrics over the
+    #   lookback period.
+    #   @return [Array<Types::RecommendationDetailHourlyMetrics>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/RecommendationDetailData AWS API Documentation
+    #
+    class RecommendationDetailData < Struct.new(
+      :account_scope,
+      :lookback_period_in_days,
+      :savings_plans_type,
+      :term_in_years,
+      :payment_option,
+      :account_id,
+      :currency_code,
+      :instance_family,
+      :region,
+      :offering_id,
+      :generation_timestamp,
+      :latest_usage_timestamp,
+      :current_average_hourly_on_demand_spend,
+      :current_maximum_hourly_on_demand_spend,
+      :current_minimum_hourly_on_demand_spend,
+      :estimated_average_utilization,
+      :estimated_monthly_savings_amount,
+      :estimated_on_demand_cost,
+      :estimated_on_demand_cost_with_current_commitment,
+      :estimated_roi,
+      :estimated_sp_cost,
+      :estimated_savings_amount,
+      :estimated_savings_percentage,
+      :existing_hourly_commitment,
+      :hourly_commitment_to_purchase,
+      :upfront_cost,
+      :current_average_coverage,
+      :estimated_average_coverage,
+      :metrics_over_lookback_period)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Contains the hourly metrics for the given recommendation over the
+    # lookback period.
+    #
+    # @!attribute [rw] start_time
+    #   The period of time that you want the usage and costs for.
+    #   @return [String]
+    #
+    # @!attribute [rw] estimated_on_demand_cost
+    #   The remaining On-Demand cost estimated to not be covered by the
+    #   recommended Savings Plan, over the length of the lookback period.
+    #   @return [String]
+    #
+    # @!attribute [rw] current_coverage
+    #   The current amount of Savings Plans eligible usage that the Savings
+    #   Plan covered.
+    #   @return [String]
+    #
+    # @!attribute [rw] estimated_coverage
+    #   The estimated coverage amount based on the recommended Savings Plan.
+    #   @return [String]
+    #
+    # @!attribute [rw] estimated_new_commitment_utilization
+    #   The estimated utilization for the recommended Savings Plan.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/RecommendationDetailHourlyMetrics AWS API Documentation
+    #
+    class RecommendationDetailHourlyMetrics < Struct.new(
+      :start_time,
+      :estimated_on_demand_cost,
+      :current_coverage,
+      :estimated_coverage,
+      :estimated_new_commitment_utilization)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Details about the Amazon Redshift reservations that Amazon Web
+    # Services recommends that you purchase.
     #
     # @!attribute [rw] family
     #   The instance family of the recommended reservation.
@@ -5642,12 +5542,12 @@ module Aws::CostExplorer
     # Details about your recommended reservation purchase.
     #
     # @!attribute [rw] account_id
-    #   The account that this RI recommendation is for.
+    #   The account that this Reserved Instance (RI) recommendation is for.
     #   @return [String]
     #
     # @!attribute [rw] instance_details
-    #   Details about the instances that Amazon Web Services recommends that
-    #   you purchase.
+    #   Details about the reservations that Amazon Web Services recommends
+    #   that you purchase.
     #   @return [Types::InstanceDetails]
     #
     # @!attribute [rw] recommended_number_of_instances_to_purchase
@@ -5713,12 +5613,12 @@ module Aws::CostExplorer
     #
     # @!attribute [rw] estimated_monthly_savings_amount
     #   How much Amazon Web Services estimates that this specific
-    #   recommendation could save you in a month.
+    #   recommendation might save you in a month.
     #   @return [String]
     #
     # @!attribute [rw] estimated_monthly_savings_percentage
     #   How much Amazon Web Services estimates that this specific
-    #   recommendation could save you in a month, as a percentage of your
+    #   recommendation might save you in a month, as a percentage of your
     #   overall costs.
     #   @return [String]
     #
@@ -5728,8 +5628,8 @@ module Aws::CostExplorer
     #   @return [String]
     #
     # @!attribute [rw] estimated_reservation_cost_for_lookback_period
-    #   How much Amazon Web Services estimates that you would have spent for
-    #   all usage during the specified historical period if you had a
+    #   How much Amazon Web Services estimates that you might spend for all
+    #   usage during the specified historical period if you had a
     #   reservation.
     #   @return [String]
     #
@@ -5845,10 +5745,10 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # Details on the resource.
+    # Details for the resource.
     #
     # @!attribute [rw] ec2_resource_details
-    #   Details on the Amazon EC2 resource.
+    #   Details for the Amazon EC2 resource.
     #   @return [Types::EC2ResourceDetails]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/ResourceDetails AWS API Documentation
@@ -5864,10 +5764,45 @@ module Aws::CostExplorer
     # @!attribute [rw] message
     #   @return [String]
     #
+    # @!attribute [rw] resource_name
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/ResourceNotFoundException AWS API Documentation
     #
     class ResourceNotFoundException < Struct.new(
-      :message)
+      :message,
+      :resource_name)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # The tag structure that contains a tag key and value.
+    #
+    # <note markdown="1"> Tagging is supported only for the following Cost Explorer resource
+    # types: [ `AnomalyMonitor` ][1], [ `AnomalySubscription` ][2], [
+    # `CostCategory` ][3].
+    #
+    #  </note>
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_AnomalyMonitor.html
+    # [2]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_AnomalySubscription.html
+    # [3]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_CostCategory.html
+    #
+    # @!attribute [rw] key
+    #   The key that's associated with the tag.
+    #   @return [String]
+    #
+    # @!attribute [rw] value
+    #   The value that's associated with the tag.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/ResourceTag AWS API Documentation
+    #
+    class ResourceTag < Struct.new(
+      :key,
+      :value)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -5938,8 +5873,8 @@ module Aws::CostExplorer
     #   @return [Types::TerminateRecommendationDetail]
     #
     # @!attribute [rw] finding_reason_codes
-    #   The list of possible reasons why the recommendation is generated
-    #   such as under or over utilization of specific metrics (for example,
+    #   The list of possible reasons why the recommendation is generated,
+    #   such as under- or over-utilization of specific metrics (for example,
     #   CPU, Memory, Network).
     #   @return [Array<String>]
     #
@@ -5961,15 +5896,8 @@ module Aws::CostExplorer
     # recommendations for instances within the same instance families or
     # across different instance families. You can also choose to view your
     # estimated savings that are associated with recommendations with
-    # consideration of existing Savings Plans or RI benefits, or neither.
-    #
-    # @note When making an API call, you may pass RightsizingRecommendationConfiguration
-    #   data as a hash:
-    #
-    #       {
-    #         recommendation_target: "SAME_INSTANCE_FAMILY", # required, accepts SAME_INSTANCE_FAMILY, CROSS_INSTANCE_FAMILY
-    #         benefits_considered: false, # required
-    #       }
+    # consideration of existing Savings Plans or Reserved Instance (RI)
+    # benefits, or neither.
     #
     # @!attribute [rw] recommendation_target
     #   The option to see recommendations within the same instance family or
@@ -6054,12 +5982,14 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # The combination of Amazon Web Services service, linked account,
-    # Region, and usage type where a cost anomaly is observed.
+    # The combination of Amazon Web Service, linked account, linked account
+    # name, Region, and usage type where a cost anomaly is observed. The
+    # linked account name will only be available when the account name can
+    # be identified.
     #
     # @!attribute [rw] service
-    #   The Amazon Web Services service name that's associated with the
-    #   cost anomaly.
+    #   The Amazon Web Service name that's associated with the cost
+    #   anomaly.
     #   @return [String]
     #
     # @!attribute [rw] region
@@ -6075,13 +6005,19 @@ module Aws::CostExplorer
     #   The `UsageType` value that's associated with the cost anomaly.
     #   @return [String]
     #
+    # @!attribute [rw] linked_account_name
+    #   The member account name value that's associated with the cost
+    #   anomaly.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/RootCause AWS API Documentation
     #
     class RootCause < Struct.new(
       :service,
       :region,
       :linked_account,
-      :usage_type)
+      :usage_type,
+      :linked_account_name)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -6114,7 +6050,7 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # The amount of Savings Plans eligible usage that is covered by Savings
+    # The amount of Savings Plans eligible usage that's covered by Savings
     # Plans. All calculations consider the On-Demand equivalent of your
     # Savings Plans usage.
     #
@@ -6145,7 +6081,7 @@ module Aws::CostExplorer
     # Savings Plans, and total Savings Plans costs for an account.
     #
     # @!attribute [rw] spend_covered_by_savings_plans
-    #   The amount of your Amazon Web Services usage that is covered by a
+    #   The amount of your Amazon Web Services usage that's covered by a
     #   Savings Plans.
     #   @return [String]
     #
@@ -6224,15 +6160,16 @@ module Aws::CostExplorer
     #   @return [String]
     #
     # @!attribute [rw] payment_option
-    #   The payment option used to generate the recommendation.
+    #   The payment option that's used to generate the recommendation.
     #   @return [String]
     #
     # @!attribute [rw] lookback_period_in_days
-    #   The lookback period in days, used to generate the recommendation.
+    #   The lookback period in days that's used to generate the
+    #   recommendation.
     #   @return [String]
     #
     # @!attribute [rw] savings_plans_purchase_recommendation_details
-    #   Details for the Savings Plans we recommend that you purchase to
+    #   Details for the Savings Plans that we recommend that you purchase to
     #   cover existing Savings Plans eligible workloads.
     #   @return [Array<Types::SavingsPlansPurchaseRecommendationDetail>]
     #
@@ -6291,7 +6228,7 @@ module Aws::CostExplorer
     #   @return [String]
     #
     # @!attribute [rw] estimated_on_demand_cost_with_current_commitment
-    #   The estimated On-Demand costs you would expect with no additional
+    #   The estimated On-Demand costs you expect with no additional
     #   commitment, based on your usage of the selected time period and the
     #   Savings Plans you own.
     #   @return [String]
@@ -6336,6 +6273,11 @@ module Aws::CostExplorer
     #   of the applicable usage type.
     #   @return [String]
     #
+    # @!attribute [rw] recommendation_detail_id
+    #   Contains detailed information about a specific Savings Plan
+    #   recommendation.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/SavingsPlansPurchaseRecommendationDetail AWS API Documentation
     #
     class SavingsPlansPurchaseRecommendationDetail < Struct.new(
@@ -6354,7 +6296,8 @@ module Aws::CostExplorer
       :estimated_monthly_savings_amount,
       :current_minimum_hourly_on_demand_spend,
       :current_maximum_hourly_on_demand_spend,
-      :current_average_hourly_on_demand_spend)
+      :current_average_hourly_on_demand_spend,
+      :recommendation_detail_id)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -6366,7 +6309,7 @@ module Aws::CostExplorer
     #   @return [String]
     #
     # @!attribute [rw] generation_timestamp
-    #   The timestamp showing when the recommendations were generated.
+    #   The timestamp that shows when the recommendations were generated.
     #   @return [String]
     #
     # @!attribute [rw] additional_metadata
@@ -6437,7 +6380,7 @@ module Aws::CostExplorer
     #   @return [String]
     #
     # @!attribute [rw] estimated_on_demand_cost_with_current_commitment
-    #   The estimated On-Demand costs you would expect with no additional
+    #   The estimated On-Demand costs you expect with no additional
     #   commitment. It's based on your usage of the selected time period
     #   and the Savings Plans you own.
     #   @return [String]
@@ -6524,8 +6467,8 @@ module Aws::CostExplorer
     #   @return [Types::SavingsPlansUtilization]
     #
     # @!attribute [rw] savings
-    #   The amount saved by using existing Savings Plans. Savings returns
-    #   both net savings from Savings Plans, as well as the
+    #   The amount that's saved by using existing Savings Plans. Savings
+    #   returns both net savings from Savings Plans and also the
     #   `onDemandCostEquivalent` of the Savings Plans when considering the
     #   utilization rate.
     #   @return [Types::SavingsPlansSavings]
@@ -6545,7 +6488,7 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # The amount of Savings Plans utilization, in hours.
+    # The amount of Savings Plans utilization (in hours).
     #
     # @!attribute [rw] time_period
     #   The time period of the request.
@@ -6557,8 +6500,8 @@ module Aws::CostExplorer
     #   @return [Types::SavingsPlansUtilization]
     #
     # @!attribute [rw] savings
-    #   The amount saved by using existing Savings Plans. Savings returns
-    #   both net savings from Savings Plans as well as the
+    #   The amount that's saved by using existing Savings Plans. Savings
+    #   returns both net savings from Savings Plans and also the
     #   `onDemandCostEquivalent` of the Savings Plans when considering the
     #   utilization rate.
     #   @return [Types::SavingsPlansSavings]
@@ -6579,7 +6522,7 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # A single daily or monthly Savings Plans utilization rate, and details
+    # A single daily or monthly Savings Plans utilization rate and details
     # for your account. A management account in an organization have access
     # to member accounts. You can use `GetDimensionValues` to determine the
     # possible dimension values.
@@ -6599,7 +6542,7 @@ module Aws::CostExplorer
     #
     # @!attribute [rw] savings
     #   The amount saved by using existing Savings Plans. Savings returns
-    #   both net savings from savings plans as well as the
+    #   both net savings from savings plans and also the
     #   `onDemandCostEquivalent` of the Savings Plans when considering the
     #   utilization rate.
     #   @return [Types::SavingsPlansSavings]
@@ -6638,15 +6581,6 @@ module Aws::CostExplorer
     # Hardware specifications for the service that you want recommendations
     # for.
     #
-    # @note When making an API call, you may pass ServiceSpecification
-    #   data as a hash:
-    #
-    #       {
-    #         ec2_specification: {
-    #           offering_class: "STANDARD", # accepts STANDARD, CONVERTIBLE
-    #         },
-    #       }
-    #
     # @!attribute [rw] ec2_specification
     #   The Amazon EC2 hardware specifications that you want Amazon Web
     #   Services to provide recommendations for.
@@ -6660,15 +6594,7 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # The details of how to sort the data.
-    #
-    # @note When making an API call, you may pass SortDefinition
-    #   data as a hash:
-    #
-    #       {
-    #         key: "SortDefinitionKey", # required
-    #         sort_order: "ASCENDING", # accepts ASCENDING, DESCENDING
-    #       }
+    # The details for how to sort the data.
     #
     # @!attribute [rw] key
     #   The key that's used to sort the data.
@@ -6687,16 +6613,36 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # The recipient of `AnomalySubscription` notifications.
+    # @api private
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/StartSavingsPlansPurchaseRecommendationGenerationRequest AWS API Documentation
+    #
+    class StartSavingsPlansPurchaseRecommendationGenerationRequest < Aws::EmptyStructure; end
+
+    # @!attribute [rw] recommendation_id
+    #   The ID for this specific recommendation.
+    #   @return [String]
+    #
+    # @!attribute [rw] generation_started_time
+    #   The start time of the recommendation generation.
+    #   @return [String]
     #
-    # @note When making an API call, you may pass Subscriber
-    #   data as a hash:
+    # @!attribute [rw] estimated_completion_time
+    #   The estimated time for when the recommendation generation will
+    #   complete.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/StartSavingsPlansPurchaseRecommendationGenerationResponse AWS API Documentation
     #
-    #       {
-    #         address: "SubscriberAddress",
-    #         type: "EMAIL", # accepts EMAIL, SNS
-    #         status: "CONFIRMED", # accepts CONFIRMED, DECLINED
-    #       }
+    class StartSavingsPlansPurchaseRecommendationGenerationResponse < Struct.new(
+      :recommendation_id,
+      :generation_started_time,
+      :estimated_completion_time)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # The recipient of `AnomalySubscription` notifications.
     #
     # @!attribute [rw] address
     #   The email address or SNS Amazon Resource Name (ARN). This depends on
@@ -6721,25 +6667,64 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
+    # @!attribute [rw] resource_arn
+    #   The Amazon Resource Name (ARN) of the resource. For a list of
+    #   supported resources, see [ResourceTag][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_ResourceTag.html
+    #   @return [String]
+    #
+    # @!attribute [rw] resource_tags
+    #   A list of tag key-value pairs to be added to the resource.
+    #
+    #   Each tag consists of a key and a value, and each key must be unique
+    #   for the resource. The following restrictions apply to resource tags:
+    #
+    #   * Although the maximum number of array members is 200, you can
+    #     assign a maximum of 50 user-tags to one resource. The remaining
+    #     are reserved for Amazon Web Services use
+    #
+    #   * The maximum length of a key is 128 characters
+    #
+    #   * The maximum length of a value is 256 characters
+    #
+    #   * Keys and values can only contain alphanumeric characters, spaces,
+    #     and any of the following: `_.:/=+@-`
+    #
+    #   * Keys and values are case sensitive
+    #
+    #   * Keys and values are trimmed for any leading or trailing
+    #     whitespaces
+    #
+    #   * Don’t use `aws:` as a prefix for your keys. This prefix is
+    #     reserved for Amazon Web Services use
+    #   @return [Array<Types::ResourceTag>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/TagResourceRequest AWS API Documentation
+    #
+    class TagResourceRequest < Struct.new(
+      :resource_arn,
+      :resource_tags)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/TagResourceResponse AWS API Documentation
+    #
+    class TagResourceResponse < Aws::EmptyStructure; end
+
     # The values that are available for a tag.
     #
     # If `Values` and `Key` aren't specified, the `ABSENT` `MatchOption` is
     # applied to all tags. That is, it's filtered on resources with no
     # tags.
     #
-    # If `Values` is provided and `Key` isn't specified, the `ABSENT`
+    # If `Key` is provided and `Values` isn't specified, the `ABSENT`
     # `MatchOption` is applied to the tag `Key` only. That is, it's
     # filtered on resources without the given tag key.
     #
-    # @note When making an API call, you may pass TagValues
-    #   data as a hash:
-    #
-    #       {
-    #         key: "TagKey",
-    #         values: ["Value"],
-    #         match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #       }
-    #
     # @!attribute [rw] key
     #   The key for the tag.
     #   @return [String]
@@ -6795,7 +6780,7 @@ module Aws::CostExplorer
     #   @return [Types::ResourceUtilization]
     #
     # @!attribute [rw] platform_differences
-    #   Explains the actions you might need to take in order to successfully
+    #   Explains the actions that you might need to take to successfully
     #   migrate your workloads from the current instance type to the
     #   recommended instance type.
     #   @return [Array<String>]
@@ -6835,16 +6820,25 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # Filters cost anomalies based on the total impact.
+    # Can occur if you specify a number of tags for a resource greater than
+    # the maximum 50 user tags per resource.
+    #
+    # @!attribute [rw] message
+    #   @return [String]
+    #
+    # @!attribute [rw] resource_name
+    #   @return [String]
     #
-    # @note When making an API call, you may pass TotalImpactFilter
-    #   data as a hash:
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/TooManyTagsException AWS API Documentation
     #
-    #       {
-    #         numeric_operator: "EQUAL", # required, accepts EQUAL, GREATER_THAN_OR_EQUAL, LESS_THAN_OR_EQUAL, GREATER_THAN, LESS_THAN, BETWEEN
-    #         start_value: 1.0, # required
-    #         end_value: 1.0,
-    #       }
+    class TooManyTagsException < Struct.new(
+      :message,
+      :resource_name)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Filters cost anomalies based on the total impact.
     #
     # @!attribute [rw] numeric_operator
     #   The comparing value that's used in the filter.
@@ -6909,14 +6903,36 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass UpdateAnomalyMonitorRequest
-    #   data as a hash:
+    # @!attribute [rw] resource_arn
+    #   The Amazon Resource Name (ARN) of the resource. For a list of
+    #   supported resources, see [ResourceTag][1].
     #
-    #       {
-    #         monitor_arn: "GenericString", # required
-    #         monitor_name: "GenericString",
-    #       }
     #
+    #
+    #   [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_ResourceTag.html
+    #   @return [String]
+    #
+    # @!attribute [rw] resource_tag_keys
+    #   A list of tag keys associated with tags that need to be removed from
+    #   the resource. If you specify a tag key that doesn't exist, it's
+    #   ignored. Although the maximum number of array members is 200,
+    #   user-tag maximum is 50. The remaining are reserved for Amazon Web
+    #   Services use.
+    #   @return [Array<String>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/UntagResourceRequest AWS API Documentation
+    #
+    class UntagResourceRequest < Struct.new(
+      :resource_arn,
+      :resource_tag_keys)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/UntagResourceResponse AWS API Documentation
+    #
+    class UntagResourceResponse < Aws::EmptyStructure; end
+
     # @!attribute [rw] monitor_arn
     #   Cost anomaly monitor Amazon Resource Names (ARNs).
     #   @return [String]
@@ -6946,30 +6962,21 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass UpdateAnomalySubscriptionRequest
-    #   data as a hash:
-    #
-    #       {
-    #         subscription_arn: "GenericString", # required
-    #         threshold: 1.0,
-    #         frequency: "DAILY", # accepts DAILY, IMMEDIATE, WEEKLY
-    #         monitor_arn_list: ["Arn"],
-    #         subscribers: [
-    #           {
-    #             address: "SubscriberAddress",
-    #             type: "EMAIL", # accepts EMAIL, SNS
-    #             status: "CONFIRMED", # accepts CONFIRMED, DECLINED
-    #           },
-    #         ],
-    #         subscription_name: "GenericString",
-    #       }
-    #
     # @!attribute [rw] subscription_arn
     #   A cost anomaly subscription Amazon Resource Name (ARN).
     #   @return [String]
     #
     # @!attribute [rw] threshold
+    #   (deprecated)
+    #
     #   The update to the threshold value for receiving notifications.
+    #
+    #   This field has been deprecated. To update a threshold, use
+    #   ThresholdExpression. Continued use of Threshold will be treated as
+    #   shorthand syntax for a ThresholdExpression.
+    #
+    #   You can specify either Threshold or ThresholdExpression, but not
+    #   both.
     #   @return [Float]
     #
     # @!attribute [rw] frequency
@@ -6989,6 +6996,51 @@ module Aws::CostExplorer
     #   The new name of the subscription.
     #   @return [String]
     #
+    # @!attribute [rw] threshold_expression
+    #   The update to the [Expression][1] object used to specify the
+    #   anomalies that you want to generate alerts for. This supports
+    #   dimensions and nested expressions. The supported dimensions are
+    #   `ANOMALY_TOTAL_IMPACT_ABSOLUTE` and
+    #   `ANOMALY_TOTAL_IMPACT_PERCENTAGE`, corresponding to an anomaly’s
+    #   TotalImpact and TotalImpactPercentage, respectively (see [Impact][2]
+    #   for more details). The supported nested expression types are `AND`
+    #   and `OR`. The match option `GREATER_THAN_OR_EQUAL` is required.
+    #   Values must be numbers between 0 and 10,000,000,000 in string
+    #   format.
+    #
+    #   You can specify either Threshold or ThresholdExpression, but not
+    #   both.
+    #
+    #   The following are examples of valid ThresholdExpressions:
+    #
+    #   * Absolute threshold: `\{ "Dimensions": \{ "Key":
+    #     "ANOMALY_TOTAL_IMPACT_ABSOLUTE", "MatchOptions": [
+    #     "GREATER_THAN_OR_EQUAL" ], "Values": [ "100" ] \} \}`
+    #
+    #   * Percentage threshold: `\{ "Dimensions": \{ "Key":
+    #     "ANOMALY_TOTAL_IMPACT_PERCENTAGE", "MatchOptions": [
+    #     "GREATER_THAN_OR_EQUAL" ], "Values": [ "100" ] \} \}`
+    #
+    #   * `AND` two thresholds together: `\{ "And": [ \{ "Dimensions": \{
+    #     "Key": "ANOMALY_TOTAL_IMPACT_ABSOLUTE", "MatchOptions": [
+    #     "GREATER_THAN_OR_EQUAL" ], "Values": [ "100" ] \} \}, \{
+    #     "Dimensions": \{ "Key": "ANOMALY_TOTAL_IMPACT_PERCENTAGE",
+    #     "MatchOptions": [ "GREATER_THAN_OR_EQUAL" ], "Values": [ "100" ]
+    #     \} \} ] \}`
+    #
+    #   * `OR` two thresholds together: `\{ "Or": [ \{ "Dimensions": \{
+    #     "Key": "ANOMALY_TOTAL_IMPACT_ABSOLUTE", "MatchOptions": [
+    #     "GREATER_THAN_OR_EQUAL" ], "Values": [ "100" ] \} \}, \{
+    #     "Dimensions": \{ "Key": "ANOMALY_TOTAL_IMPACT_PERCENTAGE",
+    #     "MatchOptions": [ "GREATER_THAN_OR_EQUAL" ], "Values": [ "100" ]
+    #     \} \} ] \}`
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
+    #   [2]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Impact.html
+    #   @return [Types::Expression]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/UpdateAnomalySubscriptionRequest AWS API Documentation
     #
     class UpdateAnomalySubscriptionRequest < Struct.new(
@@ -6997,7 +7049,8 @@ module Aws::CostExplorer
       :frequency,
       :monitor_arn_list,
       :subscribers,
-      :subscription_name)
+      :subscription_name,
+      :threshold_expression)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -7014,72 +7067,69 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass UpdateCostCategoryDefinitionRequest
-    #   data as a hash:
-    #
-    #       {
-    #         cost_category_arn: "Arn", # required
-    #         rule_version: "CostCategoryExpression.v1", # required, accepts CostCategoryExpression.v1
-    #         rules: [ # required
-    #           {
-    #             value: "CostCategoryValue",
-    #             rule: {
-    #               or: [
-    #                 {
-    #                   # recursive Expression
-    #                 },
-    #               ],
-    #               and: [
-    #                 {
-    #                   # recursive Expression
-    #                 },
-    #               ],
-    #               not: {
-    #                 # recursive Expression
-    #               },
-    #               dimensions: {
-    #                 key: "AZ", # accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, LINKED_ACCOUNT_NAME, OPERATION, PURCHASE_TYPE, REGION, SERVICE, SERVICE_CODE, USAGE_TYPE, USAGE_TYPE_GROUP, RECORD_TYPE, OPERATING_SYSTEM, TENANCY, SCOPE, PLATFORM, SUBSCRIPTION_ID, LEGAL_ENTITY_NAME, DEPLOYMENT_OPTION, DATABASE_ENGINE, CACHE_ENGINE, INSTANCE_TYPE_FAMILY, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION, AGREEMENT_END_DATE_TIME_AFTER, AGREEMENT_END_DATE_TIME_BEFORE
-    #                 values: ["Value"],
-    #                 match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #               },
-    #               tags: {
-    #                 key: "TagKey",
-    #                 values: ["Value"],
-    #                 match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #               },
-    #               cost_categories: {
-    #                 key: "CostCategoryName",
-    #                 values: ["Value"],
-    #                 match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
-    #               },
-    #             },
-    #             inherited_value: {
-    #               dimension_name: "LINKED_ACCOUNT_NAME", # accepts LINKED_ACCOUNT_NAME, TAG
-    #               dimension_key: "GenericString",
-    #             },
-    #             type: "REGULAR", # accepts REGULAR, INHERITED_VALUE
-    #           },
-    #         ],
-    #         default_value: "CostCategoryValue",
-    #         split_charge_rules: [
-    #           {
-    #             source: "GenericString", # required
-    #             targets: ["GenericString"], # required
-    #             method: "FIXED", # required, accepts FIXED, PROPORTIONAL, EVEN
-    #             parameters: [
-    #               {
-    #                 type: "ALLOCATION_PERCENTAGES", # required, accepts ALLOCATION_PERCENTAGES
-    #                 values: ["GenericString"], # required
-    #               },
-    #             ],
-    #           },
-    #         ],
-    #       }
+    # Gives a detailed description of the result of an action. It's on each
+    # cost allocation tag entry in the request.
+    #
+    # @!attribute [rw] tag_key
+    #   The key for the cost allocation tag.
+    #   @return [String]
+    #
+    # @!attribute [rw] code
+    #   An error code representing why the action failed on this entry.
+    #   @return [String]
+    #
+    # @!attribute [rw] message
+    #   A message explaining why the action failed on this entry.
+    #   @return [String]
     #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/UpdateCostAllocationTagsStatusError AWS API Documentation
+    #
+    class UpdateCostAllocationTagsStatusError < Struct.new(
+      :tag_key,
+      :code,
+      :message)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] cost_allocation_tags_status
+    #   The list of `CostAllocationTagStatusEntry` objects that are used to
+    #   update cost allocation tags status for this request.
+    #   @return [Array<Types::CostAllocationTagStatusEntry>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/UpdateCostAllocationTagsStatusRequest AWS API Documentation
+    #
+    class UpdateCostAllocationTagsStatusRequest < Struct.new(
+      :cost_allocation_tags_status)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] errors
+    #   A list of `UpdateCostAllocationTagsStatusError` objects with error
+    #   details about each cost allocation tag that can't be updated. If
+    #   there's no failure, an empty array returns.
+    #   @return [Array<Types::UpdateCostAllocationTagsStatusError>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/UpdateCostAllocationTagsStatusResponse AWS API Documentation
+    #
+    class UpdateCostAllocationTagsStatusResponse < Struct.new(
+      :errors)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] cost_category_arn
     #   The unique identifier for your Cost Category.
     #   @return [String]
     #
+    # @!attribute [rw] effective_start
+    #   The Cost Category's effective start date. It can only be a billing
+    #   start date (first day of the month). If the date isn't provided,
+    #   it's the first day of the current month. Dates can't be before the
+    #   previous twelve months, or in the future.
+    #   @return [String]
+    #
     # @!attribute [rw] rule_version
     #   The rule schema version in this particular Cost Category.
     #   @return [String]
@@ -7106,6 +7156,7 @@ module Aws::CostExplorer
     #
     class UpdateCostCategoryDefinitionRequest < Struct.new(
       :cost_category_arn,
+      :effective_start,
       :rule_version,
       :rules,
       :default_value,
@@ -7119,7 +7170,8 @@ module Aws::CostExplorer
     #   @return [String]
     #
     # @!attribute [rw] effective_start
-    #   The Cost Category's effective start date.
+    #   The Cost Category's effective start date. It can only be a billing
+    #   start date (first day of the month).
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/UpdateCostCategoryDefinitionResponse AWS API Documentation