aws-sdk-costexplorer 1.47.0 → 1.52.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a3d765e46655e71bb61a2626ac36bf7764ec141368cc5900ddc303c006a787c0
-  data.tar.gz: 9189ea599344647f963a9e60d12870ea4580d7f73692cc993d39f7aa16c6affa
+  metadata.gz: '04803150baa34e220ad9f1d8aba16ec9e785ce813789155ccebe8e339dafe006'
+  data.tar.gz: a33f0130626afe470c9fe78b4f20c4a82b9bddadfd622d6ca51ab0b98fb7d102
 SHA512:
-  metadata.gz: cf99755242101b726e2ef78f04fd705e90ca1dfea857dfcf1cd48d9de36b28364860d0b7ff889ae8857409f02970f0d5f1bf0e7d82d3c3b04b653760fae52f5e
-  data.tar.gz: 4ae6ff2989b4e0a28c1914f702a5eb303065eb265e70f6373809485f9a883e05f08fa6fdb691983820a02a08ef7b1254fd9fbd3bad88d598188e705ce8ce08da
+  metadata.gz: 0b04966b37fc6cfd8cf503ecce1d9dcc87343c5b5cfd9114fc21c704c8737960cd81f2e1d58787426b14d73cb2e762e473a79e074c437be889ebf1ce5e367521
+  data.tar.gz: 426c346572001de07b9f97ec7518c0bdd5439da4c70a0cd791d800abae2dd6f1603ec23d82642585d68a3326ad97536b665286de9bc225d654e971b896697f50

data/lib/aws-sdk-costexplorer.rb

@@ -28,7 +28,7 @@ require_relative 'aws-sdk-costexplorer/customizations'
 # structure.
 #
 #     cost_explorer = Aws::CostExplorer::Client.new
-#     resp = cost_explorer.create_cost_category_definition(params)
+#     resp = cost_explorer.create_anomaly_monitor(params)
 #
 # See {Client} for more information.
 #
@@ -48,6 +48,6 @@ require_relative 'aws-sdk-costexplorer/customizations'
 # @!group service
 module Aws::CostExplorer
 
-  GEM_VERSION = '1.47.0'
+  GEM_VERSION = '1.52.0'
 
 end

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

@@ -337,6 +337,119 @@ module Aws::CostExplorer
 
     # @!group API Operations
 
+    # Creates a new cost anomaly detection monitor with the requested type
+    # and monitor specification.
+    #
+    # @option params [required, Types::AnomalyMonitor] :anomaly_monitor
+    #   The cost anomaly detection monitor object that you want to create.
+    #
+    # @return [Types::CreateAnomalyMonitorResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::CreateAnomalyMonitorResponse#monitor_arn #monitor_arn} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.create_anomaly_monitor({
+    #     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
+    #           values: ["Value"],
+    #           match_options: ["EQUALS"], # accepts EQUALS, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
+    #         },
+    #         tags: {
+    #           key: "TagKey",
+    #           values: ["Value"],
+    #           match_options: ["EQUALS"], # accepts EQUALS, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
+    #         },
+    #         cost_categories: {
+    #           key: "CostCategoryName",
+    #           values: ["Value"],
+    #           match_options: ["EQUALS"], # accepts EQUALS, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
+    #         },
+    #       },
+    #       dimensional_value_count: 1,
+    #     },
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.monitor_arn #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/CreateAnomalyMonitor AWS API Documentation
+    #
+    # @overload create_anomaly_monitor(params = {})
+    # @param [Hash] params ({})
+    def create_anomaly_monitor(params = {}, options = {})
+      req = build_request(:create_anomaly_monitor, params)
+      req.send_request(options)
+    end
+
+    # Adds a subscription to a cost anomaly detection monitor. You can use
+    # each subscription to define subscribers with email or SNS
+    # notifications. Email subscribers can set a dollar threshold and a time
+    # frequency for receiving notifications.
+    #
+    # @option params [required, Types::AnomalySubscription] :anomaly_subscription
+    #   The cost anomaly subscription object that you want to create.
+    #
+    # @return [Types::CreateAnomalySubscriptionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::CreateAnomalySubscriptionResponse#subscription_arn #subscription_arn} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.create_anomaly_subscription({
+    #     anomaly_subscription: { # required
+    #       subscription_arn: "GenericString",
+    #       account_id: "GenericString",
+    #       monitor_arn_list: ["Value"], # 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
+    #     },
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.subscription_arn #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/CreateAnomalySubscription AWS API Documentation
+    #
+    # @overload create_anomaly_subscription(params = {})
+    # @param [Hash] params ({})
+    def create_anomaly_subscription(params = {}, options = {})
+      req = build_request(:create_anomaly_subscription, params)
+      req.send_request(options)
+    end
+
     # Creates a new Cost Category with the requested name and rules.
     #
     # @option params [required, String] :name
@@ -393,6 +506,7 @@ module Aws::CostExplorer
     #           cost_categories: {
     #             key: "CostCategoryName",
     #             values: ["Value"],
+    #             match_options: ["EQUALS"], # accepts EQUALS, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
     #           },
     #         },
     #       },
@@ -413,6 +527,52 @@ module Aws::CostExplorer
       req.send_request(options)
     end
 
+    # Deletes a cost anomaly monitor.
+    #
+    # @option params [required, String] :monitor_arn
+    #   The unique identifier of the cost anomaly monitor that you want to
+    #   delete.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.delete_anomaly_monitor({
+    #     monitor_arn: "GenericString", # required
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/DeleteAnomalyMonitor AWS API Documentation
+    #
+    # @overload delete_anomaly_monitor(params = {})
+    # @param [Hash] params ({})
+    def delete_anomaly_monitor(params = {}, options = {})
+      req = build_request(:delete_anomaly_monitor, params)
+      req.send_request(options)
+    end
+
+    # Deletes a cost anomaly subscription.
+    #
+    # @option params [required, String] :subscription_arn
+    #   The unique identifier of the cost anomaly subscription that you want
+    #   to delete.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.delete_anomaly_subscription({
+    #     subscription_arn: "GenericString", # required
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/DeleteAnomalySubscription AWS API Documentation
+    #
+    # @overload delete_anomaly_subscription(params = {})
+    # @param [Hash] params ({})
+    def delete_anomaly_subscription(params = {}, options = {})
+      req = build_request(:delete_anomaly_subscription, params)
+      req.send_request(options)
+    end
+
     # Deletes a Cost Category. Expenses from this month going forward will
     # no longer be categorized with this Cost Category.
     #
@@ -497,6 +657,11 @@ module Aws::CostExplorer
     #   resp.cost_category.rules[0].rule.cost_categories.key #=> String
     #   resp.cost_category.rules[0].rule.cost_categories.values #=> Array
     #   resp.cost_category.rules[0].rule.cost_categories.values[0] #=> String
+    #   resp.cost_category.rules[0].rule.cost_categories.match_options #=> Array
+    #   resp.cost_category.rules[0].rule.cost_categories.match_options[0] #=> String, one of "EQUALS", "STARTS_WITH", "ENDS_WITH", "CONTAINS", "CASE_SENSITIVE", "CASE_INSENSITIVE"
+    #   resp.cost_category.processing_status #=> Array
+    #   resp.cost_category.processing_status[0].component #=> String, one of "COST_EXPLORER"
+    #   resp.cost_category.processing_status[0].status #=> String, one of "PROCESSING", "APPLIED"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/DescribeCostCategoryDefinition AWS API Documentation
     #
@@ -507,12 +672,219 @@ module Aws::CostExplorer
       req.send_request(options)
     end
 
+    # Retrieves all of the cost anomalies detected on your account, during
+    # the time period specified by the `DateInterval` object.
+    #
+    # @option params [String] :monitor_arn
+    #   Retrieves all of the cost anomalies detected for a specific cost
+    #   anomaly monitor Amazon Resource Name (ARN).
+    #
+    # @option params [required, Types::AnomalyDateInterval] :date_interval
+    #   Assigns the start and end dates for retrieving cost anomalies. The
+    #   returned anomaly object will have an `AnomalyEndDate` in the specified
+    #   time range.
+    #
+    # @option params [String] :feedback
+    #   Filters anomaly results by the feedback field on the anomaly object.
+    #
+    # @option params [Types::TotalImpactFilter] :total_impact
+    #   Filters anomaly results by the total impact field on the anomaly
+    #   object. For example, you can filter anomalies `GREATER_THAN 200.00` to
+    #   retrieve anomalies, with an estimated dollar impact greater than 200.
+    #
+    # @option params [String] :next_page_token
+    #   The token to retrieve the next set of results. AWS provides the token
+    #   when the response from a previous call has more results than the
+    #   maximum page size.
+    #
+    # @option params [Integer] :max_results
+    #   The number of entries a paginated response contains.
+    #
+    # @return [Types::GetAnomaliesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetAnomaliesResponse#anomalies #anomalies} => Array<Types::Anomaly>
+    #   * {Types::GetAnomaliesResponse#next_page_token #next_page_token} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_anomalies({
+    #     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,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.anomalies #=> Array
+    #   resp.anomalies[0].anomaly_id #=> String
+    #   resp.anomalies[0].anomaly_start_date #=> String
+    #   resp.anomalies[0].anomaly_end_date #=> String
+    #   resp.anomalies[0].dimension_value #=> String
+    #   resp.anomalies[0].root_causes #=> Array
+    #   resp.anomalies[0].root_causes[0].service #=> String
+    #   resp.anomalies[0].root_causes[0].region #=> String
+    #   resp.anomalies[0].root_causes[0].linked_account #=> String
+    #   resp.anomalies[0].root_causes[0].usage_type #=> String
+    #   resp.anomalies[0].anomaly_score.max_score #=> Float
+    #   resp.anomalies[0].anomaly_score.current_score #=> Float
+    #   resp.anomalies[0].impact.max_impact #=> Float
+    #   resp.anomalies[0].impact.total_impact #=> Float
+    #   resp.anomalies[0].monitor_arn #=> String
+    #   resp.anomalies[0].feedback #=> String, one of "YES", "NO", "PLANNED_ACTIVITY"
+    #   resp.next_page_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetAnomalies AWS API Documentation
+    #
+    # @overload get_anomalies(params = {})
+    # @param [Hash] params ({})
+    def get_anomalies(params = {}, options = {})
+      req = build_request(:get_anomalies, params)
+      req.send_request(options)
+    end
+
+    # Retrieves the cost anomaly monitor definitions for your account. You
+    # can filter using a list of cost anomaly monitor Amazon Resource Names
+    # (ARNs).
+    #
+    # @option params [Array<String>] :monitor_arn_list
+    #   A list of cost anomaly monitor ARNs.
+    #
+    # @option params [String] :next_page_token
+    #   The token to retrieve the next set of results. AWS provides the token
+    #   when the response from a previous call has more results than the
+    #   maximum page size.
+    #
+    # @option params [Integer] :max_results
+    #   The number of entries a paginated response contains.
+    #
+    # @return [Types::GetAnomalyMonitorsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetAnomalyMonitorsResponse#anomaly_monitors #anomaly_monitors} => Array&lt;Types::AnomalyMonitor&gt;
+    #   * {Types::GetAnomalyMonitorsResponse#next_page_token #next_page_token} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_anomaly_monitors({
+    #     monitor_arn_list: ["Value"],
+    #     next_page_token: "NextPageToken",
+    #     max_results: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.anomaly_monitors #=> Array
+    #   resp.anomaly_monitors[0].monitor_arn #=> String
+    #   resp.anomaly_monitors[0].monitor_name #=> String
+    #   resp.anomaly_monitors[0].creation_date #=> String
+    #   resp.anomaly_monitors[0].last_updated_date #=> String
+    #   resp.anomaly_monitors[0].last_evaluated_date #=> String
+    #   resp.anomaly_monitors[0].monitor_type #=> String, one of "DIMENSIONAL", "CUSTOM"
+    #   resp.anomaly_monitors[0].monitor_dimension #=> String, one of "SERVICE"
+    #   resp.anomaly_monitors[0].monitor_specification.or #=> Array
+    #   resp.anomaly_monitors[0].monitor_specification.or[0] #=> Types::Expression
+    #   resp.anomaly_monitors[0].monitor_specification.and #=> Array
+    #   resp.anomaly_monitors[0].monitor_specification.and[0] #=> Types::Expression
+    #   resp.anomaly_monitors[0].monitor_specification.not #=> Types::Expression
+    #   resp.anomaly_monitors[0].monitor_specification.dimensions.key #=> String, one of "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"
+    #   resp.anomaly_monitors[0].monitor_specification.dimensions.values #=> Array
+    #   resp.anomaly_monitors[0].monitor_specification.dimensions.values[0] #=> String
+    #   resp.anomaly_monitors[0].monitor_specification.dimensions.match_options #=> Array
+    #   resp.anomaly_monitors[0].monitor_specification.dimensions.match_options[0] #=> String, one of "EQUALS", "STARTS_WITH", "ENDS_WITH", "CONTAINS", "CASE_SENSITIVE", "CASE_INSENSITIVE"
+    #   resp.anomaly_monitors[0].monitor_specification.tags.key #=> String
+    #   resp.anomaly_monitors[0].monitor_specification.tags.values #=> Array
+    #   resp.anomaly_monitors[0].monitor_specification.tags.values[0] #=> String
+    #   resp.anomaly_monitors[0].monitor_specification.tags.match_options #=> Array
+    #   resp.anomaly_monitors[0].monitor_specification.tags.match_options[0] #=> String, one of "EQUALS", "STARTS_WITH", "ENDS_WITH", "CONTAINS", "CASE_SENSITIVE", "CASE_INSENSITIVE"
+    #   resp.anomaly_monitors[0].monitor_specification.cost_categories.key #=> String
+    #   resp.anomaly_monitors[0].monitor_specification.cost_categories.values #=> Array
+    #   resp.anomaly_monitors[0].monitor_specification.cost_categories.values[0] #=> String
+    #   resp.anomaly_monitors[0].monitor_specification.cost_categories.match_options #=> Array
+    #   resp.anomaly_monitors[0].monitor_specification.cost_categories.match_options[0] #=> String, one of "EQUALS", "STARTS_WITH", "ENDS_WITH", "CONTAINS", "CASE_SENSITIVE", "CASE_INSENSITIVE"
+    #   resp.anomaly_monitors[0].dimensional_value_count #=> Integer
+    #   resp.next_page_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetAnomalyMonitors AWS API Documentation
+    #
+    # @overload get_anomaly_monitors(params = {})
+    # @param [Hash] params ({})
+    def get_anomaly_monitors(params = {}, options = {})
+      req = build_request(:get_anomaly_monitors, params)
+      req.send_request(options)
+    end
+
+    # Retrieves the cost anomaly subscription objects for your account. You
+    # can filter using a list of cost anomaly monitor Amazon Resource Names
+    # (ARNs).
+    #
+    # @option params [Array<String>] :subscription_arn_list
+    #   A list of cost anomaly subscription ARNs.
+    #
+    # @option params [String] :monitor_arn
+    #   Cost anomaly monitor ARNs.
+    #
+    # @option params [String] :next_page_token
+    #   The token to retrieve the next set of results. AWS provides the token
+    #   when the response from a previous call has more results than the
+    #   maximum page size.
+    #
+    # @option params [Integer] :max_results
+    #   The number of entries a paginated response contains.
+    #
+    # @return [Types::GetAnomalySubscriptionsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetAnomalySubscriptionsResponse#anomaly_subscriptions #anomaly_subscriptions} => Array&lt;Types::AnomalySubscription&gt;
+    #   * {Types::GetAnomalySubscriptionsResponse#next_page_token #next_page_token} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_anomaly_subscriptions({
+    #     subscription_arn_list: ["Value"],
+    #     monitor_arn: "GenericString",
+    #     next_page_token: "NextPageToken",
+    #     max_results: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.anomaly_subscriptions #=> Array
+    #   resp.anomaly_subscriptions[0].subscription_arn #=> String
+    #   resp.anomaly_subscriptions[0].account_id #=> String
+    #   resp.anomaly_subscriptions[0].monitor_arn_list #=> Array
+    #   resp.anomaly_subscriptions[0].monitor_arn_list[0] #=> String
+    #   resp.anomaly_subscriptions[0].subscribers #=> Array
+    #   resp.anomaly_subscriptions[0].subscribers[0].address #=> String
+    #   resp.anomaly_subscriptions[0].subscribers[0].type #=> String, one of "EMAIL", "SNS"
+    #   resp.anomaly_subscriptions[0].subscribers[0].status #=> String, one of "CONFIRMED", "DECLINED"
+    #   resp.anomaly_subscriptions[0].threshold #=> Float
+    #   resp.anomaly_subscriptions[0].frequency #=> String, one of "DAILY", "IMMEDIATE", "WEEKLY"
+    #   resp.anomaly_subscriptions[0].subscription_name #=> String
+    #   resp.next_page_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetAnomalySubscriptions AWS API Documentation
+    #
+    # @overload get_anomaly_subscriptions(params = {})
+    # @param [Hash] params ({})
+    def get_anomaly_subscriptions(params = {}, options = {})
+      req = build_request(:get_anomaly_subscriptions, params)
+      req.send_request(options)
+    end
+
     # Retrieves cost and usage metrics for your account. You can specify
     # which cost and usage-related metric, such as `BlendedCosts` or
     # `UsageQuantity`, that you want the request to return. You can also
     # filter and group your data by various dimensions, such as `SERVICE` or
     # `AZ`, in a specific time range. For a complete list of valid
-    # dimensions, see the [GetDimensionValues][1] operation. Master accounts
+    # dimensions, see the [GetDimensionValues][1] operation. Master account
     # in an organization in AWS Organizations have access to all member
     # accounts.
     #
@@ -543,7 +915,7 @@ module Aws::CostExplorer
     #
     #   [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
     #
-    # @option params [Array<String>] :metrics
+    # @option params [required, Array<String>] :metrics
     #   Which metrics are returned in the query. For more information about
     #   blended and unblended rates, see [Why does the "blended" annotation
     #   appear on some line items in my bill?][1].
@@ -570,7 +942,7 @@ module Aws::CostExplorer
     #
     # @option params [Array<Types::GroupDefinition>] :group_by
     #   You can group AWS costs using up to two different groups, either
-    #   dimensions, tag keys, or both.
+    #   dimensions, tag keys, cost categories, or any two group by types.
     #
     #   When you group by tag key, you get all tag values, including empty
     #   strings.
@@ -625,9 +997,10 @@ module Aws::CostExplorer
     #       cost_categories: {
     #         key: "CostCategoryName",
     #         values: ["Value"],
+    #         match_options: ["EQUALS"], # accepts EQUALS, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
     #       },
     #     },
-    #     metrics: ["MetricName"],
+    #     metrics: ["MetricName"], # required
     #     group_by: [
     #       {
     #         type: "DIMENSION", # accepts DIMENSION, TAG, COST_CATEGORY
@@ -672,7 +1045,7 @@ module Aws::CostExplorer
     # return. You can also filter and group your data by various dimensions,
     # such as `SERVICE` or `AZ`, in a specific time range. For a complete
     # list of valid dimensions, see the [GetDimensionValues][1] operation.
-    # Master accounts in an organization in AWS Organizations have access to
+    # Master account in an organization in AWS Organizations have access to
     # all member accounts. This API is currently available for the Amazon
     # Elastic Compute Cloud – Compute service only.
     #
@@ -702,7 +1075,7 @@ module Aws::CostExplorer
     #   `Granularity` isn't set, the response object doesn't include the
     #   `Granularity`, `MONTHLY`, `DAILY`, or `HOURLY`.
     #
-    # @option params [Types::Expression] :filter
+    # @option params [required, Types::Expression] :filter
     #   Filters Amazon Web Services costs by different dimensions. For
     #   example, you can specify `SERVICE` and `LINKED_ACCOUNT` and get the
     #   costs that are associated with that account's usage of that service.
@@ -710,7 +1083,8 @@ module Aws::CostExplorer
     #   dimension filters. For more information, see [Expression][1].
     #
     #   The `GetCostAndUsageWithResources` operation requires that you either
-    #   group by or filter by a `ResourceId`.
+    #   group by or filter by a `ResourceId`. It requires the [Expression][1]
+    #   `"SERVICE = Amazon Elastic Compute Cloud - Compute"` in the filter.
     #
     #
     #
@@ -743,7 +1117,7 @@ module Aws::CostExplorer
     #
     # @option params [Array<Types::GroupDefinition>] :group_by
     #   You can group Amazon Web Services costs using up to two different
-    #   groups: either dimensions, tag keys, or both.
+    #   groups: `DIMENSION`, `TAG`, `COST_CATEGORY`.
     #
     # @option params [String] :next_page_token
     #   The token to retrieve the next set of results. AWS provides the token
@@ -764,7 +1138,7 @@ module Aws::CostExplorer
     #       end: "YearMonthDay", # required
     #     },
     #     granularity: "DAILY", # accepts DAILY, MONTHLY, HOURLY
-    #     filter: {
+    #     filter: { # required
     #       or: [
     #         {
     #           # recursive Expression
@@ -791,6 +1165,7 @@ module Aws::CostExplorer
     #       cost_categories: {
     #         key: "CostCategoryName",
     #         values: ["Value"],
+    #         match_options: ["EQUALS"], # accepts EQUALS, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
     #       },
     #     },
     #     metrics: ["MetricName"],
@@ -837,7 +1212,9 @@ module Aws::CostExplorer
     # your past costs.
     #
     # @option params [required, Types::DateInterval] :time_period
-    #   The period of time that you want the forecast to cover.
+    #   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
+    #   validation error.
     #
     # @option params [required, String] :metric
     #   Which metric Cost Explorer uses to create your forecast. For more
@@ -920,6 +1297,7 @@ module Aws::CostExplorer
     #       cost_categories: {
     #         key: "CostCategoryName",
     #         values: ["Value"],
+    #         match_options: ["EQUALS"], # accepts EQUALS, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
     #       },
     #     },
     #     prediction_interval_level: 1,
@@ -1013,6 +1391,8 @@ module Aws::CostExplorer
     #     is Amazon EC2: CloudWatch – Alarms. The response for this operation
     #     includes a unit attribute.
     #
+    #   * REGION - The AWS Region.
+    #
     #   * RECORD\_TYPE - The different types of charges such as RI fees, usage
     #     costs, tax refunds, and credits.
     #
@@ -1294,6 +1674,7 @@ module Aws::CostExplorer
     #       cost_categories: {
     #         key: "CostCategoryName",
     #         values: ["Value"],
+    #         match_options: ["EQUALS"], # accepts EQUALS, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
     #       },
     #     },
     #     metrics: ["MetricName"],
@@ -1375,9 +1756,9 @@ module Aws::CostExplorer
     #
     # @option params [String] :account_scope
     #   The account scope that you want your recommendations for. Amazon Web
-    #   Services calculates recommendations including the payer account and
-    #   linked accounts if the value is set to `PAYER`. If the value is
-    #   `LINKED`, recommendations are calculated for individual linked
+    #   Services calculates recommendations including the master account and
+    #   member accounts if the value is set to `PAYER`. If the value is
+    #   `LINKED`, recommendations are calculated for individual member
     #   accounts only.
     #
     # @option params [String] :lookback_period_in_days
@@ -1503,11 +1884,11 @@ module Aws::CostExplorer
       req.send_request(options)
     end
 
-    # Retrieves the reservation utilization for your account. Master
-    # accounts in an organization have access to member accounts. You can
-    # filter data by dimensions in a time period. You can use
-    # `GetDimensionValues` to determine the possible dimension values.
-    # Currently, you can group only by `SUBSCRIPTION_ID`.
+    # Retrieves the reservation utilization for your account. Master account
+    # in an organization have access to member accounts. You can filter data
+    # by dimensions in a time period. You can use `GetDimensionValues` to
+    # determine the possible dimension values. Currently, you can group only
+    # by `SUBSCRIPTION_ID`.
     #
     # @option params [required, Types::DateInterval] :time_period
     #   Sets the start and end dates for retrieving RI utilization. The start
@@ -1615,6 +1996,7 @@ module Aws::CostExplorer
     #       cost_categories: {
     #         key: "CostCategoryName",
     #         values: ["Value"],
+    #         match_options: ["EQUALS"], # accepts EQUALS, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
     #       },
     #     },
     #     next_page_token: "NextPageToken",
@@ -1702,8 +2084,10 @@ module Aws::CostExplorer
     #
     #   * 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`. The `Expression` for
-    #     that looks like this:
+    #     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
+    #     looks like:
     #
     #     `\{ "Dimensions": \{ "Key": "REGION", "Values": [ "us-east-1",
     #     “us-west-1” ] \} \}`
@@ -1800,6 +2184,7 @@ module Aws::CostExplorer
     #       cost_categories: {
     #         key: "CostCategoryName",
     #         values: ["Value"],
+    #         match_options: ["EQUALS"], # accepts EQUALS, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
     #       },
     #     },
     #     configuration: {
@@ -1842,6 +2227,10 @@ module Aws::CostExplorer
     #   resp.rightsizing_recommendations[0].current_instance.resource_utilization.ec2_resource_utilization.max_cpu_utilization_percentage #=> String
     #   resp.rightsizing_recommendations[0].current_instance.resource_utilization.ec2_resource_utilization.max_memory_utilization_percentage #=> String
     #   resp.rightsizing_recommendations[0].current_instance.resource_utilization.ec2_resource_utilization.max_storage_utilization_percentage #=> String
+    #   resp.rightsizing_recommendations[0].current_instance.resource_utilization.ec2_resource_utilization.ebs_resource_utilization.ebs_read_ops_per_second #=> String
+    #   resp.rightsizing_recommendations[0].current_instance.resource_utilization.ec2_resource_utilization.ebs_resource_utilization.ebs_write_ops_per_second #=> String
+    #   resp.rightsizing_recommendations[0].current_instance.resource_utilization.ec2_resource_utilization.ebs_resource_utilization.ebs_read_bytes_per_second #=> String
+    #   resp.rightsizing_recommendations[0].current_instance.resource_utilization.ec2_resource_utilization.ebs_resource_utilization.ebs_write_bytes_per_second #=> String
     #   resp.rightsizing_recommendations[0].current_instance.reservation_covered_hours_in_lookback_period #=> String
     #   resp.rightsizing_recommendations[0].current_instance.savings_plans_covered_hours_in_lookback_period #=> String
     #   resp.rightsizing_recommendations[0].current_instance.on_demand_hours_in_lookback_period #=> String
@@ -1866,6 +2255,10 @@ module Aws::CostExplorer
     #   resp.rightsizing_recommendations[0].modify_recommendation_detail.target_instances[0].expected_resource_utilization.ec2_resource_utilization.max_cpu_utilization_percentage #=> String
     #   resp.rightsizing_recommendations[0].modify_recommendation_detail.target_instances[0].expected_resource_utilization.ec2_resource_utilization.max_memory_utilization_percentage #=> String
     #   resp.rightsizing_recommendations[0].modify_recommendation_detail.target_instances[0].expected_resource_utilization.ec2_resource_utilization.max_storage_utilization_percentage #=> String
+    #   resp.rightsizing_recommendations[0].modify_recommendation_detail.target_instances[0].expected_resource_utilization.ec2_resource_utilization.ebs_resource_utilization.ebs_read_ops_per_second #=> String
+    #   resp.rightsizing_recommendations[0].modify_recommendation_detail.target_instances[0].expected_resource_utilization.ec2_resource_utilization.ebs_resource_utilization.ebs_write_ops_per_second #=> String
+    #   resp.rightsizing_recommendations[0].modify_recommendation_detail.target_instances[0].expected_resource_utilization.ec2_resource_utilization.ebs_resource_utilization.ebs_read_bytes_per_second #=> String
+    #   resp.rightsizing_recommendations[0].modify_recommendation_detail.target_instances[0].expected_resource_utilization.ec2_resource_utilization.ebs_resource_utilization.ebs_write_bytes_per_second #=> String
     #   resp.rightsizing_recommendations[0].terminate_recommendation_detail.estimated_monthly_savings #=> String
     #   resp.rightsizing_recommendations[0].terminate_recommendation_detail.currency_code #=> String
     #   resp.next_page_token #=> String
@@ -1999,6 +2392,7 @@ module Aws::CostExplorer
     #       cost_categories: {
     #         key: "CostCategoryName",
     #         values: ["Value"],
+    #         match_options: ["EQUALS"], # accepts EQUALS, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
     #       },
     #     },
     #     metrics: ["MetricName"],
@@ -2043,9 +2437,9 @@ module Aws::CostExplorer
     #
     # @option params [String] :account_scope
     #   The account scope that you want your recommendations for. Amazon Web
-    #   Services calculates recommendations including the payer account and
-    #   linked accounts if the value is set to `PAYER`. If the value is
-    #   `LINKED`, recommendations are calculated for individual linked
+    #   Services calculates recommendations including the master account and
+    #   member accounts if the value is set to `PAYER`. If the value is
+    #   `LINKED`, recommendations are calculated for individual member
     #   accounts only.
     #
     # @option params [String] :next_page_token
@@ -2117,6 +2511,7 @@ module Aws::CostExplorer
     #       cost_categories: {
     #         key: "CostCategoryName",
     #         values: ["Value"],
+    #         match_options: ["EQUALS"], # accepts EQUALS, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
     #       },
     #     },
     #   })
@@ -2172,7 +2567,7 @@ module Aws::CostExplorer
     end
 
     # Retrieves the Savings Plans utilization for your account across date
-    # ranges with daily or monthly granularity. Master accounts in an
+    # ranges with daily or monthly granularity. Master account in an
     # organization have access to member accounts. You can use
     # `GetDimensionValues` in `SAVINGS_PLANS` to determine the possible
     # dimension values.
@@ -2259,6 +2654,7 @@ module Aws::CostExplorer
     #       cost_categories: {
     #         key: "CostCategoryName",
     #         values: ["Value"],
+    #         match_options: ["EQUALS"], # accepts EQUALS, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
     #       },
     #     },
     #   })
@@ -2390,6 +2786,7 @@ module Aws::CostExplorer
     #       cost_categories: {
     #         key: "CostCategoryName",
     #         values: ["Value"],
+    #         match_options: ["EQUALS"], # accepts EQUALS, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
     #       },
     #     },
     #     next_token: "NextPageToken",
@@ -2500,7 +2897,8 @@ module Aws::CostExplorer
     #   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`.
+    #   `2017-05-01`. The start date must be equal to or later than the
+    #   current date to avoid a validation error.
     #
     # @option params [required, String] :metric
     #   Which metric Cost Explorer uses to create your forecast.
@@ -2571,6 +2969,7 @@ module Aws::CostExplorer
     #       cost_categories: {
     #         key: "CostCategoryName",
     #         values: ["Value"],
+    #         match_options: ["EQUALS"], # accepts EQUALS, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
     #       },
     #     },
     #     prediction_interval_level: 1,
@@ -2639,6 +3038,11 @@ module Aws::CostExplorer
     #   resp.cost_category_references[0].effective_start #=> String
     #   resp.cost_category_references[0].effective_end #=> String
     #   resp.cost_category_references[0].number_of_rules #=> Integer
+    #   resp.cost_category_references[0].processing_status #=> Array
+    #   resp.cost_category_references[0].processing_status[0].component #=> String, one of "COST_EXPLORER"
+    #   resp.cost_category_references[0].processing_status[0].status #=> String, one of "PROCESSING", "APPLIED"
+    #   resp.cost_category_references[0].values #=> Array
+    #   resp.cost_category_references[0].values[0] #=> String
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/ListCostCategoryDefinitions AWS API Documentation
@@ -2650,6 +3054,127 @@ module Aws::CostExplorer
       req.send_request(options)
     end
 
+    # Modifies the feedback property of a given cost anomaly.
+    #
+    # @option params [required, String] :anomaly_id
+    #   A cost anomaly ID.
+    #
+    # @option params [required, String] :feedback
+    #   Describes whether the cost anomaly was a planned activity or you
+    #   considered it an anomaly.
+    #
+    # @return [Types::ProvideAnomalyFeedbackResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ProvideAnomalyFeedbackResponse#anomaly_id #anomaly_id} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.provide_anomaly_feedback({
+    #     anomaly_id: "GenericString", # required
+    #     feedback: "YES", # required, accepts YES, NO, PLANNED_ACTIVITY
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.anomaly_id #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/ProvideAnomalyFeedback AWS API Documentation
+    #
+    # @overload provide_anomaly_feedback(params = {})
+    # @param [Hash] params ({})
+    def provide_anomaly_feedback(params = {}, options = {})
+      req = build_request(:provide_anomaly_feedback, params)
+      req.send_request(options)
+    end
+
+    # Updates an existing cost anomaly monitor. The changes made are applied
+    # going forward, and does not change anomalies detected in the past.
+    #
+    # @option params [required, String] :monitor_arn
+    #   Cost anomaly monitor Amazon Resource Names (ARNs).
+    #
+    # @option params [String] :monitor_name
+    #   The new name for the cost anomaly monitor.
+    #
+    # @return [Types::UpdateAnomalyMonitorResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::UpdateAnomalyMonitorResponse#monitor_arn #monitor_arn} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.update_anomaly_monitor({
+    #     monitor_arn: "GenericString", # required
+    #     monitor_name: "GenericString",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.monitor_arn #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/UpdateAnomalyMonitor AWS API Documentation
+    #
+    # @overload update_anomaly_monitor(params = {})
+    # @param [Hash] params ({})
+    def update_anomaly_monitor(params = {}, options = {})
+      req = build_request(:update_anomaly_monitor, params)
+      req.send_request(options)
+    end
+
+    # Updates an existing cost anomaly monitor subscription.
+    #
+    # @option params [required, String] :subscription_arn
+    #   A cost anomaly subscription Amazon Resource Name (ARN).
+    #
+    # @option params [Float] :threshold
+    #   The update to the threshold value for receiving notifications.
+    #
+    # @option params [String] :frequency
+    #   The update to the frequency value at which subscribers will receive
+    #   notifications.
+    #
+    # @option params [Array<String>] :monitor_arn_list
+    #   A list of cost anomaly subscription ARNs.
+    #
+    # @option params [Array<Types::Subscriber>] :subscribers
+    #   The update to the subscriber list.
+    #
+    # @option params [String] :subscription_name
+    #   The subscription's new name.
+    #
+    # @return [Types::UpdateAnomalySubscriptionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::UpdateAnomalySubscriptionResponse#subscription_arn #subscription_arn} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.update_anomaly_subscription({
+    #     subscription_arn: "GenericString", # required
+    #     threshold: 1.0,
+    #     frequency: "DAILY", # accepts DAILY, IMMEDIATE, WEEKLY
+    #     monitor_arn_list: ["Value"],
+    #     subscribers: [
+    #       {
+    #         address: "SubscriberAddress",
+    #         type: "EMAIL", # accepts EMAIL, SNS
+    #         status: "CONFIRMED", # accepts CONFIRMED, DECLINED
+    #       },
+    #     ],
+    #     subscription_name: "GenericString",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.subscription_arn #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/UpdateAnomalySubscription AWS API Documentation
+    #
+    # @overload update_anomaly_subscription(params = {})
+    # @param [Hash] params ({})
+    def update_anomaly_subscription(params = {}, options = {})
+      req = build_request(:update_anomaly_subscription, params)
+      req.send_request(options)
+    end
+
     # Updates an existing Cost Category. Changes made to the Cost Category
     # rules will be used to categorize the current month’s expenses and
     # future expenses. This won’t change categorization for the previous
@@ -2709,6 +3234,7 @@ module Aws::CostExplorer
     #           cost_categories: {
     #             key: "CostCategoryName",
     #             values: ["Value"],
+    #             match_options: ["EQUALS"], # accepts EQUALS, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
     #           },
     #         },
     #       },
@@ -2742,7 +3268,7 @@ module Aws::CostExplorer
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-costexplorer'
-      context[:gem_version] = '1.47.0'
+      context[:gem_version] = '1.52.0'
       Seahorse::Client::Request.new(handlers, context)
     end