aws-sdk-costexplorer 1.88.0 → 1.89.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 92b6d734c8c89730cf7be3631ed06041c2d809eb3b442a7a451f737a91d21f8f
-  data.tar.gz: 84fcbc0a00a6f2e08e6a72e635328cfef7bc9753d4b44d0909125645b1ad890a
+  metadata.gz: '094f8b338f6e5883fb40f498dbdb21fa505f2ff4e908556cebeb6538abc39f87'
+  data.tar.gz: c0e3205a80ccb3760d64cdd601b378912318144e4d79974f4ca795f5b5806de6
 SHA512:
-  metadata.gz: 24378c6c155f08118c2a6025a4f507ff8e23f733a3ce4820bf0730fda2323164a56a4cab3393d8b1d997ccd0353438c45f74ec7ac72f8eb41c7ee0a4df658df4
-  data.tar.gz: 6f079853a626ea781975ed340175781b467c6288c7e8df6444b42fc7eb358877a981c8a954ea7c63ea6bfb635496a597d3f9482ecb8b6878141bac167fb0f4b6
+  metadata.gz: 7db8c6acbf859d831e9a68425bfa1a14d90c3052cd0ba515ef5529fa4b68b9e4f05bec913990509cad9713cf62f70a85f4a11aab2bce9be5d0dc03f89db1ac2a
+  data.tar.gz: 9f395cc78bb1a510202dce526d1be1d5a159a2c59e0d8b87bc617b29efbeb40f138f3d77ca0479c57c029a832dcc7b2991e99ea1110937bcb677f1a62c59d29a

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.89.0 (2023-07-24)
+------------------
+
+* Feature - This release introduces the new API 'GetSavingsPlanPurchaseRecommendationDetails', which retrieves the details for a Savings Plan recommendation. It also updates the existing API 'GetSavingsPlansPurchaseRecommendation' to include the recommendation detail ID.
+
 1.88.0 (2023-07-11)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.88.0
+1.89.0

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

@@ -1560,7 +1560,7 @@ module Aws::CostExplorer
     #
     #       * The corresponding `Expression` for this example is as follows:
     #         `\{ "Dimensions": \{ "Key": "REGION", "Values": [ "us-east-1",
-    #         “us-west-1” ] \} \}`
+    #         "us-west-1" ] \} \}`
     #
     #       * As shown in the previous example, lists of dimension values are
     #         combined with `OR` when applying the filter.
@@ -1570,7 +1570,7 @@ module Aws::CostExplorer
     #       the documentation for each specific API to see what is supported.
     #
     #       * For example, you can filter for linked account names that start
-    #         with “a”.
+    #         with "a".
     #
     #       * The corresponding `Expression` for this example is as follows:
     #         `\{ "Dimensions": \{ "Key": "LINKED_ACCOUNT_NAME",
@@ -2105,7 +2105,7 @@ module Aws::CostExplorer
     #
     #       * The corresponding `Expression` for this example is as follows:
     #         `\{ "Dimensions": \{ "Key": "REGION", "Values": [ "us-east-1",
-    #         “us-west-1” ] \} \}`
+    #         "us-west-1" ] \} \}`
     #
     #       * As shown in the previous example, lists of dimension values are
     #         combined with `OR` when applying the filter.
@@ -2115,7 +2115,7 @@ module Aws::CostExplorer
     #       the documentation for each specific API to see what is supported.
     #
     #       * For example, you can filter for linked account names that start
-    #         with “a”.
+    #         with "a".
     #
     #       * The corresponding `Expression` for this example is as follows:
     #         `\{ "Dimensions": \{ "Key": "LINKED_ACCOUNT_NAME",
@@ -2615,7 +2615,7 @@ module Aws::CostExplorer
     #
     #       * The corresponding `Expression` for this example is as follows:
     #         `\{ "Dimensions": \{ "Key": "REGION", "Values": [ "us-east-1",
-    #         “us-west-1” ] \} \}`
+    #         "us-west-1" ] \} \}`
     #
     #       * As shown in the previous example, lists of dimension values are
     #         combined with `OR` when applying the filter.
@@ -2625,7 +2625,7 @@ module Aws::CostExplorer
     #       the documentation for each specific API to see what is supported.
     #
     #       * For example, you can filter for linked account names that start
-    #         with “a”.
+    #         with "a".
     #
     #       * The corresponding `Expression` for this example is as follows:
     #         `\{ "Dimensions": \{ "Key": "LINKED_ACCOUNT_NAME",
@@ -3124,7 +3124,7 @@ module Aws::CostExplorer
     #
     #       * The corresponding `Expression` for this example is as follows:
     #         `\{ "Dimensions": \{ "Key": "REGION", "Values": [ "us-east-1",
-    #         “us-west-1” ] \} \}`
+    #         "us-west-1" ] \} \}`
     #
     #       * As shown in the previous example, lists of dimension values are
     #         combined with `OR` when applying the filter.
@@ -3134,7 +3134,7 @@ module Aws::CostExplorer
     #       the documentation for each specific API to see what is supported.
     #
     #       * For example, you can filter for linked account names that start
-    #         with “a”.
+    #         with "a".
     #
     #       * The corresponding `Expression` for this example is as follows:
     #         `\{ "Dimensions": \{ "Key": "LINKED_ACCOUNT_NAME",
@@ -3354,6 +3354,71 @@ module Aws::CostExplorer
       req.send_request(options)
     end
 
+    # Retrieves the details for a Savings Plan recommendation. These details
+    # include the hourly data-points that construct the new cost, coverage,
+    # and utilization charts.
+    #
+    # @option params [required, String] :recommendation_detail_id
+    #   The ID that is associated with the Savings Plan recommendation.
+    #
+    # @return [Types::GetSavingsPlanPurchaseRecommendationDetailsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetSavingsPlanPurchaseRecommendationDetailsResponse#recommendation_detail_id #recommendation_detail_id} => String
+    #   * {Types::GetSavingsPlanPurchaseRecommendationDetailsResponse#recommendation_detail_data #recommendation_detail_data} => Types::RecommendationDetailData
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_savings_plan_purchase_recommendation_details({
+    #     recommendation_detail_id: "RecommendationDetailId", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.recommendation_detail_id #=> String
+    #   resp.recommendation_detail_data.account_scope #=> String, one of "PAYER", "LINKED"
+    #   resp.recommendation_detail_data.lookback_period_in_days #=> String, one of "SEVEN_DAYS", "THIRTY_DAYS", "SIXTY_DAYS"
+    #   resp.recommendation_detail_data.savings_plans_type #=> String, one of "COMPUTE_SP", "EC2_INSTANCE_SP", "SAGEMAKER_SP"
+    #   resp.recommendation_detail_data.term_in_years #=> String, one of "ONE_YEAR", "THREE_YEARS"
+    #   resp.recommendation_detail_data.payment_option #=> String, one of "NO_UPFRONT", "PARTIAL_UPFRONT", "ALL_UPFRONT", "LIGHT_UTILIZATION", "MEDIUM_UTILIZATION", "HEAVY_UTILIZATION"
+    #   resp.recommendation_detail_data.account_id #=> String
+    #   resp.recommendation_detail_data.currency_code #=> String
+    #   resp.recommendation_detail_data.instance_family #=> String
+    #   resp.recommendation_detail_data.region #=> String
+    #   resp.recommendation_detail_data.offering_id #=> String
+    #   resp.recommendation_detail_data.generation_timestamp #=> String
+    #   resp.recommendation_detail_data.latest_usage_timestamp #=> String
+    #   resp.recommendation_detail_data.current_average_hourly_on_demand_spend #=> String
+    #   resp.recommendation_detail_data.current_maximum_hourly_on_demand_spend #=> String
+    #   resp.recommendation_detail_data.current_minimum_hourly_on_demand_spend #=> String
+    #   resp.recommendation_detail_data.estimated_average_utilization #=> String
+    #   resp.recommendation_detail_data.estimated_monthly_savings_amount #=> String
+    #   resp.recommendation_detail_data.estimated_on_demand_cost #=> String
+    #   resp.recommendation_detail_data.estimated_on_demand_cost_with_current_commitment #=> String
+    #   resp.recommendation_detail_data.estimated_roi #=> String
+    #   resp.recommendation_detail_data.estimated_sp_cost #=> String
+    #   resp.recommendation_detail_data.estimated_savings_amount #=> String
+    #   resp.recommendation_detail_data.estimated_savings_percentage #=> String
+    #   resp.recommendation_detail_data.existing_hourly_commitment #=> String
+    #   resp.recommendation_detail_data.hourly_commitment_to_purchase #=> String
+    #   resp.recommendation_detail_data.upfront_cost #=> String
+    #   resp.recommendation_detail_data.current_average_coverage #=> String
+    #   resp.recommendation_detail_data.estimated_average_coverage #=> String
+    #   resp.recommendation_detail_data.metrics_over_lookback_period #=> Array
+    #   resp.recommendation_detail_data.metrics_over_lookback_period[0].start_time #=> String
+    #   resp.recommendation_detail_data.metrics_over_lookback_period[0].estimated_on_demand_cost #=> String
+    #   resp.recommendation_detail_data.metrics_over_lookback_period[0].current_coverage #=> String
+    #   resp.recommendation_detail_data.metrics_over_lookback_period[0].estimated_coverage #=> String
+    #   resp.recommendation_detail_data.metrics_over_lookback_period[0].estimated_new_commitment_utilization #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetSavingsPlanPurchaseRecommendationDetails AWS API Documentation
+    #
+    # @overload get_savings_plan_purchase_recommendation_details(params = {})
+    # @param [Hash] params ({})
+    def get_savings_plan_purchase_recommendation_details(params = {}, options = {})
+      req = build_request(:get_savings_plan_purchase_recommendation_details, params)
+      req.send_request(options)
+    end
+
     # Retrieves the Savings Plans covered for your account. This enables you
     # to see how much of your cost is covered by a Savings Plan. An
     # organization’s management account can see the coverage of the
@@ -3652,6 +3717,7 @@ module Aws::CostExplorer
     #   resp.savings_plans_purchase_recommendation.savings_plans_purchase_recommendation_details[0].current_minimum_hourly_on_demand_spend #=> String
     #   resp.savings_plans_purchase_recommendation.savings_plans_purchase_recommendation_details[0].current_maximum_hourly_on_demand_spend #=> String
     #   resp.savings_plans_purchase_recommendation.savings_plans_purchase_recommendation_details[0].current_average_hourly_on_demand_spend #=> String
+    #   resp.savings_plans_purchase_recommendation.savings_plans_purchase_recommendation_details[0].recommendation_detail_id #=> String
     #   resp.savings_plans_purchase_recommendation.savings_plans_purchase_recommendation_summary.estimated_roi #=> String
     #   resp.savings_plans_purchase_recommendation.savings_plans_purchase_recommendation_summary.currency_code #=> String
     #   resp.savings_plans_purchase_recommendation.savings_plans_purchase_recommendation_summary.estimated_total_cost #=> String
@@ -4036,7 +4102,7 @@ module Aws::CostExplorer
     #
     #       * The corresponding `Expression` for this example is as follows:
     #         `\{ "Dimensions": \{ "Key": "REGION", "Values": [ "us-east-1",
-    #         “us-west-1” ] \} \}`
+    #         "us-west-1" ] \} \}`
     #
     #       * As shown in the previous example, lists of dimension values are
     #         combined with `OR` when applying the filter.
@@ -4046,7 +4112,7 @@ module Aws::CostExplorer
     #       the documentation for each specific API to see what is supported.
     #
     #       * For example, you can filter for linked account names that start
-    #         with “a”.
+    #         with "a".
     #
     #       * The corresponding `Expression` for this example is as follows:
     #         `\{ "Dimensions": \{ "Key": "LINKED_ACCOUNT_NAME",
@@ -4771,7 +4837,18 @@ module Aws::CostExplorer
       req.send_request(options)
     end
 
-    # Updates an existing cost anomaly monitor subscription.
+    # Updates an existing cost anomaly subscription. Specify the fields that
+    # you want to update. Omitted fields are unchanged.
+    #
+    # <note markdown="1"> The JSON below describes the generic construct for each type. See
+    # [Request Parameters][1] for possible values as they apply to
+    # `AnomalySubscription`.
+    #
+    #  </note>
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_UpdateAnomalySubscription.html#API_UpdateAnomalySubscription_RequestParameters
     #
     # @option params [required, String] :subscription_arn
     #   A cost anomaly subscription Amazon Resource Name (ARN).
@@ -4785,6 +4862,8 @@ module Aws::CostExplorer
     #   ThresholdExpression. Continued use of Threshold will be treated as
     #   shorthand syntax for a ThresholdExpression.
     #
+    #   You can specify either Threshold or ThresholdExpression, but not both.
+    #
     # @option params [String] :frequency
     #   The update to the frequency value that subscribers receive
     #   notifications.
@@ -4802,10 +4881,14 @@ module Aws::CostExplorer
     #   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`.
-    #   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.
+    #   `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:
     #
@@ -4834,6 +4917,7 @@ module Aws::CostExplorer
     #
     #
     #   [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::UpdateAnomalySubscriptionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -5066,7 +5150,7 @@ module Aws::CostExplorer
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-costexplorer'
-      context[:gem_version] = '1.88.0'
+      context[:gem_version] = '1.89.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -144,6 +144,8 @@ module Aws::CostExplorer
     GetReservationUtilizationResponse = Shapes::StructureShape.new(name: 'GetReservationUtilizationResponse')
     GetRightsizingRecommendationRequest = Shapes::StructureShape.new(name: 'GetRightsizingRecommendationRequest')
     GetRightsizingRecommendationResponse = Shapes::StructureShape.new(name: 'GetRightsizingRecommendationResponse')
+    GetSavingsPlanPurchaseRecommendationDetailsRequest = Shapes::StructureShape.new(name: 'GetSavingsPlanPurchaseRecommendationDetailsRequest')
+    GetSavingsPlanPurchaseRecommendationDetailsResponse = Shapes::StructureShape.new(name: 'GetSavingsPlanPurchaseRecommendationDetailsResponse')
     GetSavingsPlansCoverageRequest = Shapes::StructureShape.new(name: 'GetSavingsPlansCoverageRequest')
     GetSavingsPlansCoverageResponse = Shapes::StructureShape.new(name: 'GetSavingsPlansCoverageResponse')
     GetSavingsPlansPurchaseRecommendationRequest = Shapes::StructureShape.new(name: 'GetSavingsPlansPurchaseRecommendationRequest')
@@ -188,6 +190,7 @@ module Aws::CostExplorer
     MetricUnit = Shapes::StringShape.new(name: 'MetricUnit')
     MetricValue = Shapes::StructureShape.new(name: 'MetricValue')
     Metrics = Shapes::MapShape.new(name: 'Metrics')
+    MetricsOverLookbackPeriod = Shapes::ListShape.new(name: 'MetricsOverLookbackPeriod')
     ModifyRecommendationDetail = Shapes::StructureShape.new(name: 'ModifyRecommendationDetail')
     MonitorArnList = Shapes::ListShape.new(name: 'MonitorArnList')
     MonitorDimension = Shapes::StringShape.new(name: 'MonitorDimension')
@@ -215,6 +218,9 @@ module Aws::CostExplorer
     RDSInstanceDetails = Shapes::StructureShape.new(name: 'RDSInstanceDetails')
     RICostForUnusedHours = Shapes::StringShape.new(name: 'RICostForUnusedHours')
     RealizedSavings = Shapes::StringShape.new(name: 'RealizedSavings')
+    RecommendationDetailData = Shapes::StructureShape.new(name: 'RecommendationDetailData')
+    RecommendationDetailHourlyMetrics = Shapes::StructureShape.new(name: 'RecommendationDetailHourlyMetrics')
+    RecommendationDetailId = Shapes::StringShape.new(name: 'RecommendationDetailId')
     RecommendationId = Shapes::StringShape.new(name: 'RecommendationId')
     RecommendationIdList = Shapes::ListShape.new(name: 'RecommendationIdList')
     RecommendationTarget = Shapes::StringShape.new(name: 'RecommendationTarget')
@@ -830,6 +836,13 @@ module Aws::CostExplorer
     GetRightsizingRecommendationResponse.add_member(:configuration, Shapes::ShapeRef.new(shape: RightsizingRecommendationConfiguration, location_name: "Configuration"))
     GetRightsizingRecommendationResponse.struct_class = Types::GetRightsizingRecommendationResponse
 
+    GetSavingsPlanPurchaseRecommendationDetailsRequest.add_member(:recommendation_detail_id, Shapes::ShapeRef.new(shape: RecommendationDetailId, required: true, location_name: "RecommendationDetailId"))
+    GetSavingsPlanPurchaseRecommendationDetailsRequest.struct_class = Types::GetSavingsPlanPurchaseRecommendationDetailsRequest
+
+    GetSavingsPlanPurchaseRecommendationDetailsResponse.add_member(:recommendation_detail_id, Shapes::ShapeRef.new(shape: RecommendationDetailId, location_name: "RecommendationDetailId"))
+    GetSavingsPlanPurchaseRecommendationDetailsResponse.add_member(:recommendation_detail_data, Shapes::ShapeRef.new(shape: RecommendationDetailData, location_name: "RecommendationDetailData"))
+    GetSavingsPlanPurchaseRecommendationDetailsResponse.struct_class = Types::GetSavingsPlanPurchaseRecommendationDetailsResponse
+
     GetSavingsPlansCoverageRequest.add_member(:time_period, Shapes::ShapeRef.new(shape: DateInterval, required: true, location_name: "TimePeriod"))
     GetSavingsPlansCoverageRequest.add_member(:group_by, Shapes::ShapeRef.new(shape: GroupDefinitions, location_name: "GroupBy"))
     GetSavingsPlansCoverageRequest.add_member(:granularity, Shapes::ShapeRef.new(shape: Granularity, location_name: "Granularity"))
@@ -990,6 +1003,8 @@ module Aws::CostExplorer
     Metrics.key = Shapes::ShapeRef.new(shape: MetricName)
     Metrics.value = Shapes::ShapeRef.new(shape: MetricValue)
 
+    MetricsOverLookbackPeriod.member = Shapes::ShapeRef.new(shape: RecommendationDetailHourlyMetrics)
+
     ModifyRecommendationDetail.add_member(:target_instances, Shapes::ShapeRef.new(shape: TargetInstancesList, location_name: "TargetInstances"))
     ModifyRecommendationDetail.struct_class = Types::ModifyRecommendationDetail
 
@@ -1021,6 +1036,44 @@ module Aws::CostExplorer
     RDSInstanceDetails.add_member(:size_flex_eligible, Shapes::ShapeRef.new(shape: GenericBoolean, location_name: "SizeFlexEligible"))
     RDSInstanceDetails.struct_class = Types::RDSInstanceDetails
 
+    RecommendationDetailData.add_member(:account_scope, Shapes::ShapeRef.new(shape: AccountScope, location_name: "AccountScope"))
+    RecommendationDetailData.add_member(:lookback_period_in_days, Shapes::ShapeRef.new(shape: LookbackPeriodInDays, location_name: "LookbackPeriodInDays"))
+    RecommendationDetailData.add_member(:savings_plans_type, Shapes::ShapeRef.new(shape: SupportedSavingsPlansType, location_name: "SavingsPlansType"))
+    RecommendationDetailData.add_member(:term_in_years, Shapes::ShapeRef.new(shape: TermInYears, location_name: "TermInYears"))
+    RecommendationDetailData.add_member(:payment_option, Shapes::ShapeRef.new(shape: PaymentOption, location_name: "PaymentOption"))
+    RecommendationDetailData.add_member(:account_id, Shapes::ShapeRef.new(shape: GenericString, location_name: "AccountId"))
+    RecommendationDetailData.add_member(:currency_code, Shapes::ShapeRef.new(shape: GenericString, location_name: "CurrencyCode"))
+    RecommendationDetailData.add_member(:instance_family, Shapes::ShapeRef.new(shape: GenericString, location_name: "InstanceFamily"))
+    RecommendationDetailData.add_member(:region, Shapes::ShapeRef.new(shape: GenericString, location_name: "Region"))
+    RecommendationDetailData.add_member(:offering_id, Shapes::ShapeRef.new(shape: GenericString, location_name: "OfferingId"))
+    RecommendationDetailData.add_member(:generation_timestamp, Shapes::ShapeRef.new(shape: ZonedDateTime, location_name: "GenerationTimestamp"))
+    RecommendationDetailData.add_member(:latest_usage_timestamp, Shapes::ShapeRef.new(shape: ZonedDateTime, location_name: "LatestUsageTimestamp"))
+    RecommendationDetailData.add_member(:current_average_hourly_on_demand_spend, Shapes::ShapeRef.new(shape: GenericString, location_name: "CurrentAverageHourlyOnDemandSpend"))
+    RecommendationDetailData.add_member(:current_maximum_hourly_on_demand_spend, Shapes::ShapeRef.new(shape: GenericString, location_name: "CurrentMaximumHourlyOnDemandSpend"))
+    RecommendationDetailData.add_member(:current_minimum_hourly_on_demand_spend, Shapes::ShapeRef.new(shape: GenericString, location_name: "CurrentMinimumHourlyOnDemandSpend"))
+    RecommendationDetailData.add_member(:estimated_average_utilization, Shapes::ShapeRef.new(shape: GenericString, location_name: "EstimatedAverageUtilization"))
+    RecommendationDetailData.add_member(:estimated_monthly_savings_amount, Shapes::ShapeRef.new(shape: GenericString, location_name: "EstimatedMonthlySavingsAmount"))
+    RecommendationDetailData.add_member(:estimated_on_demand_cost, Shapes::ShapeRef.new(shape: GenericString, location_name: "EstimatedOnDemandCost"))
+    RecommendationDetailData.add_member(:estimated_on_demand_cost_with_current_commitment, Shapes::ShapeRef.new(shape: GenericString, location_name: "EstimatedOnDemandCostWithCurrentCommitment"))
+    RecommendationDetailData.add_member(:estimated_roi, Shapes::ShapeRef.new(shape: GenericString, location_name: "EstimatedROI"))
+    RecommendationDetailData.add_member(:estimated_sp_cost, Shapes::ShapeRef.new(shape: GenericString, location_name: "EstimatedSPCost"))
+    RecommendationDetailData.add_member(:estimated_savings_amount, Shapes::ShapeRef.new(shape: GenericString, location_name: "EstimatedSavingsAmount"))
+    RecommendationDetailData.add_member(:estimated_savings_percentage, Shapes::ShapeRef.new(shape: GenericString, location_name: "EstimatedSavingsPercentage"))
+    RecommendationDetailData.add_member(:existing_hourly_commitment, Shapes::ShapeRef.new(shape: GenericString, location_name: "ExistingHourlyCommitment"))
+    RecommendationDetailData.add_member(:hourly_commitment_to_purchase, Shapes::ShapeRef.new(shape: GenericString, location_name: "HourlyCommitmentToPurchase"))
+    RecommendationDetailData.add_member(:upfront_cost, Shapes::ShapeRef.new(shape: GenericString, location_name: "UpfrontCost"))
+    RecommendationDetailData.add_member(:current_average_coverage, Shapes::ShapeRef.new(shape: GenericString, location_name: "CurrentAverageCoverage"))
+    RecommendationDetailData.add_member(:estimated_average_coverage, Shapes::ShapeRef.new(shape: GenericString, location_name: "EstimatedAverageCoverage"))
+    RecommendationDetailData.add_member(:metrics_over_lookback_period, Shapes::ShapeRef.new(shape: MetricsOverLookbackPeriod, location_name: "MetricsOverLookbackPeriod"))
+    RecommendationDetailData.struct_class = Types::RecommendationDetailData
+
+    RecommendationDetailHourlyMetrics.add_member(:start_time, Shapes::ShapeRef.new(shape: ZonedDateTime, location_name: "StartTime"))
+    RecommendationDetailHourlyMetrics.add_member(:estimated_on_demand_cost, Shapes::ShapeRef.new(shape: GenericString, location_name: "EstimatedOnDemandCost"))
+    RecommendationDetailHourlyMetrics.add_member(:current_coverage, Shapes::ShapeRef.new(shape: GenericString, location_name: "CurrentCoverage"))
+    RecommendationDetailHourlyMetrics.add_member(:estimated_coverage, Shapes::ShapeRef.new(shape: GenericString, location_name: "EstimatedCoverage"))
+    RecommendationDetailHourlyMetrics.add_member(:estimated_new_commitment_utilization, Shapes::ShapeRef.new(shape: GenericString, location_name: "EstimatedNewCommitmentUtilization"))
+    RecommendationDetailHourlyMetrics.struct_class = Types::RecommendationDetailHourlyMetrics
+
     RecommendationIdList.member = Shapes::ShapeRef.new(shape: RecommendationId)
 
     RedshiftInstanceDetails.add_member(:family, Shapes::ShapeRef.new(shape: GenericString, location_name: "Family"))
@@ -1220,6 +1273,7 @@ module Aws::CostExplorer
     SavingsPlansPurchaseRecommendationDetail.add_member(:current_minimum_hourly_on_demand_spend, Shapes::ShapeRef.new(shape: GenericString, location_name: "CurrentMinimumHourlyOnDemandSpend"))
     SavingsPlansPurchaseRecommendationDetail.add_member(:current_maximum_hourly_on_demand_spend, Shapes::ShapeRef.new(shape: GenericString, location_name: "CurrentMaximumHourlyOnDemandSpend"))
     SavingsPlansPurchaseRecommendationDetail.add_member(:current_average_hourly_on_demand_spend, Shapes::ShapeRef.new(shape: GenericString, location_name: "CurrentAverageHourlyOnDemandSpend"))
+    SavingsPlansPurchaseRecommendationDetail.add_member(:recommendation_detail_id, Shapes::ShapeRef.new(shape: RecommendationDetailId, location_name: "RecommendationDetailId"))
     SavingsPlansPurchaseRecommendationDetail.struct_class = Types::SavingsPlansPurchaseRecommendationDetail
 
     SavingsPlansPurchaseRecommendationDetailList.member = Shapes::ShapeRef.new(shape: SavingsPlansPurchaseRecommendationDetail)
@@ -1633,6 +1687,16 @@ module Aws::CostExplorer
         o.errors << Shapes::ShapeRef.new(shape: InvalidNextTokenException)
       end)
 
+      api.add_operation(:get_savings_plan_purchase_recommendation_details, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "GetSavingsPlanPurchaseRecommendationDetails"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: GetSavingsPlanPurchaseRecommendationDetailsRequest)
+        o.output = Shapes::ShapeRef.new(shape: GetSavingsPlanPurchaseRecommendationDetailsResponse)
+        o.errors << Shapes::ShapeRef.new(shape: LimitExceededException)
+        o.errors << Shapes::ShapeRef.new(shape: DataUnavailableException)
+      end)
+
       api.add_operation(:get_savings_plans_coverage, Seahorse::Model::Operation.new.tap do |o|
         o.name = "GetSavingsPlansCoverage"
         o.http_method = "POST"
@@ -1750,6 +1814,7 @@ module Aws::CostExplorer
         o.output = Shapes::ShapeRef.new(shape: ListSavingsPlansPurchaseRecommendationGenerationResponse)
         o.errors << Shapes::ShapeRef.new(shape: LimitExceededException)
         o.errors << Shapes::ShapeRef.new(shape: InvalidNextTokenException)
+        o.errors << Shapes::ShapeRef.new(shape: DataUnavailableException)
       end)
 
       api.add_operation(:list_tags_for_resource, Seahorse::Model::Operation.new.tap do |o|
@@ -1780,6 +1845,7 @@ module Aws::CostExplorer
         o.errors << Shapes::ShapeRef.new(shape: LimitExceededException)
         o.errors << Shapes::ShapeRef.new(shape: ServiceQuotaExceededException)
         o.errors << Shapes::ShapeRef.new(shape: GenerationExistsException)
+        o.errors << Shapes::ShapeRef.new(shape: DataUnavailableException)
       end)
 
       api.add_operation(:tag_resource, Seahorse::Model::Operation.new.tap do |o|

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

@@ -50,9 +50,6 @@ module Aws::CostExplorer
 
     def initialize(options = {})
       self[:region] = options[:region]
-      if self[:region].nil?
-        raise ArgumentError, "Missing required EndpointParameter: :region"
-      end
       self[:use_dual_stack] = options[:use_dual_stack]
       self[:use_dual_stack] = false if self[:use_dual_stack].nil?
       if self[:use_dual_stack].nil?

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

@@ -14,84 +14,45 @@ module Aws::CostExplorer
       use_dual_stack = parameters.use_dual_stack
       use_fips = parameters.use_fips
       endpoint = parameters.endpoint
-      if (partition_result = Aws::Endpoints::Matchers.aws_partition(region))
-        if Aws::Endpoints::Matchers.set?(endpoint)
-          if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
-            raise ArgumentError, "Invalid Configuration: FIPS and custom endpoint are not supported"
-          end
-          if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
-            raise ArgumentError, "Invalid Configuration: Dualstack and custom endpoint are not supported"
-          end
-          return Aws::Endpoints::Endpoint.new(url: endpoint, headers: {}, properties: {})
+      if Aws::Endpoints::Matchers.set?(endpoint)
+        if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
+          raise ArgumentError, "Invalid Configuration: FIPS and custom endpoint are not supported"
         end
-        if Aws::Endpoints::Matchers.string_equals?(Aws::Endpoints::Matchers.attr(partition_result, "name"), "aws")
-          if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true) && Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
-            if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS")) && Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
-              return Aws::Endpoints::Endpoint.new(url: "https://cost-explorer-fips.#{region}.api.aws", headers: {}, properties: {"authSchemes"=>[{"name"=>"sigv4", "signingRegion"=>"us-east-1", "signingName"=>"ce"}]})
-            end
-            raise ArgumentError, "FIPS and DualStack are enabled, but this partition does not support one or both"
-          end
-          if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
-            if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"))
-              return Aws::Endpoints::Endpoint.new(url: "https://cost-explorer-fips.#{region}.amazonaws.com", headers: {}, properties: {"authSchemes"=>[{"name"=>"sigv4", "signingRegion"=>"us-east-1", "signingName"=>"ce"}]})
-            end
-            raise ArgumentError, "FIPS is enabled but this partition does not support FIPS"
+        if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
+          raise ArgumentError, "Invalid Configuration: Dualstack and custom endpoint are not supported"
+        end
+        return Aws::Endpoints::Endpoint.new(url: endpoint, headers: {}, properties: {})
+      end
+      if Aws::Endpoints::Matchers.set?(region)
+        if (partition_result = Aws::Endpoints::Matchers.aws_partition(region))
+          if Aws::Endpoints::Matchers.string_equals?(Aws::Endpoints::Matchers.attr(partition_result, "name"), "aws") && Aws::Endpoints::Matchers.boolean_equals?(use_fips, false) && Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, false)
+            return Aws::Endpoints::Endpoint.new(url: "https://ce.us-east-1.amazonaws.com", headers: {}, properties: {"authSchemes"=>[{"name"=>"sigv4", "signingName"=>"ce", "signingRegion"=>"us-east-1"}]})
           end
-          if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
-            if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
-              return Aws::Endpoints::Endpoint.new(url: "https://cost-explorer.#{region}.api.aws", headers: {}, properties: {"authSchemes"=>[{"name"=>"sigv4", "signingRegion"=>"us-east-1", "signingName"=>"ce"}]})
-            end
-            raise ArgumentError, "DualStack is enabled but this partition does not support DualStack"
+          if Aws::Endpoints::Matchers.string_equals?(Aws::Endpoints::Matchers.attr(partition_result, "name"), "aws-cn") && Aws::Endpoints::Matchers.boolean_equals?(use_fips, false) && Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, false)
+            return Aws::Endpoints::Endpoint.new(url: "https://ce.cn-northwest-1.amazonaws.com.cn", headers: {}, properties: {"authSchemes"=>[{"name"=>"sigv4", "signingName"=>"ce", "signingRegion"=>"cn-northwest-1"}]})
           end
-          return Aws::Endpoints::Endpoint.new(url: "https://ce.us-east-1.amazonaws.com", headers: {}, properties: {"authSchemes"=>[{"name"=>"sigv4", "signingRegion"=>"us-east-1", "signingName"=>"ce"}]})
-        end
-        if Aws::Endpoints::Matchers.string_equals?(Aws::Endpoints::Matchers.attr(partition_result, "name"), "aws-cn")
           if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true) && Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
             if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS")) && Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
-              return Aws::Endpoints::Endpoint.new(url: "https://cost-explorer-fips.#{region}.api.amazonwebservices.com.cn", headers: {}, properties: {"authSchemes"=>[{"name"=>"sigv4", "signingRegion"=>"cn-northwest-1", "signingName"=>"ce"}]})
+              return Aws::Endpoints::Endpoint.new(url: "https://ce-fips.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
             end
             raise ArgumentError, "FIPS and DualStack are enabled, but this partition does not support one or both"
           end
           if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
             if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"))
-              return Aws::Endpoints::Endpoint.new(url: "https://cost-explorer-fips.#{region}.amazonaws.com.cn", headers: {}, properties: {"authSchemes"=>[{"name"=>"sigv4", "signingRegion"=>"cn-northwest-1", "signingName"=>"ce"}]})
+              return Aws::Endpoints::Endpoint.new(url: "https://ce-fips.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
             end
             raise ArgumentError, "FIPS is enabled but this partition does not support FIPS"
           end
           if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
             if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
-              return Aws::Endpoints::Endpoint.new(url: "https://cost-explorer.#{region}.api.amazonwebservices.com.cn", headers: {}, properties: {"authSchemes"=>[{"name"=>"sigv4", "signingRegion"=>"cn-northwest-1", "signingName"=>"ce"}]})
+              return Aws::Endpoints::Endpoint.new(url: "https://ce.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
             end
             raise ArgumentError, "DualStack is enabled but this partition does not support DualStack"
           end
-          return Aws::Endpoints::Endpoint.new(url: "https://ce.cn-northwest-1.amazonaws.com.cn", headers: {}, properties: {"authSchemes"=>[{"name"=>"sigv4", "signingRegion"=>"cn-northwest-1", "signingName"=>"ce"}]})
-        end
-        if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true) && Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
-          if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS")) && Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
-            return Aws::Endpoints::Endpoint.new(url: "https://ce-fips.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
-          end
-          raise ArgumentError, "FIPS and DualStack are enabled, but this partition does not support one or both"
-        end
-        if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
-          if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"))
-            return Aws::Endpoints::Endpoint.new(url: "https://ce-fips.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
-          end
-          raise ArgumentError, "FIPS is enabled but this partition does not support FIPS"
-        end
-        if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
-          if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
-            return Aws::Endpoints::Endpoint.new(url: "https://ce.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
-          end
-          raise ArgumentError, "DualStack is enabled but this partition does not support DualStack"
-        end
-        if Aws::Endpoints::Matchers.string_equals?(region, "aws-global")
-          return Aws::Endpoints::Endpoint.new(url: "https://ce.us-east-1.amazonaws.com", headers: {}, properties: {"authSchemes"=>[{"name"=>"sigv4", "signingRegion"=>"us-east-1", "signingName"=>"ce"}]})
-        end
-        if Aws::Endpoints::Matchers.string_equals?(region, "aws-cn-global")
-          return Aws::Endpoints::Endpoint.new(url: "https://ce.cn-northwest-1.amazonaws.com.cn", headers: {}, properties: {"authSchemes"=>[{"name"=>"sigv4", "signingRegion"=>"cn-northwest-1", "signingName"=>"ce"}]})
+          return Aws::Endpoints::Endpoint.new(url: "https://ce.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
         end
-        return Aws::Endpoints::Endpoint.new(url: "https://ce.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
       end
+      raise ArgumentError, "Invalid Configuration: Missing Region"
       raise ArgumentError, 'No endpoint could be resolved'
 
     end

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

@@ -278,6 +278,20 @@ module Aws::CostExplorer
       end
     end
 
+    class GetSavingsPlanPurchaseRecommendationDetails
+      def self.build(context)
+        unless context.config.regional_endpoint
+          endpoint = context.config.endpoint.to_s
+        end
+        Aws::CostExplorer::EndpointParameters.new(
+          region: context.config.region,
+          use_dual_stack: context.config.use_dualstack_endpoint,
+          use_fips: context.config.use_fips_endpoint,
+          endpoint: endpoint,
+        )
+      end
+    end
+
     class GetSavingsPlansCoverage
       def self.build(context)
         unless context.config.regional_endpoint

data/lib/aws-sdk-costexplorer/plugins/endpoints.rb

@@ -94,6 +94,8 @@ module Aws::CostExplorer
             Aws::CostExplorer::Endpoints::GetReservationUtilization.build(context)
           when :get_rightsizing_recommendation
             Aws::CostExplorer::Endpoints::GetRightsizingRecommendation.build(context)
+          when :get_savings_plan_purchase_recommendation_details
+            Aws::CostExplorer::Endpoints::GetSavingsPlanPurchaseRecommendationDetails.build(context)
           when :get_savings_plans_coverage
             Aws::CostExplorer::Endpoints::GetSavingsPlansCoverage.build(context)
           when :get_savings_plans_purchase_recommendation

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

@@ -151,7 +151,7 @@ module Aws::CostExplorer
     #
     #       * The corresponding `Expression` for this example is as follows:
     #         `\{ "Dimensions": \{ "Key": "REGION", "Values": [ "us-east-1",
-    #         “us-west-1” ] \} \}`
+    #         "us-west-1" ] \} \}`
     #
     #       * As shown in the previous example, lists of dimension values
     #         are combined with `OR` when applying the filter.
@@ -162,7 +162,7 @@ module Aws::CostExplorer
     #       supported.
     #
     #       * For example, you can filter for linked account names that
-    #         start with “a”.
+    #         start with "a".
     #
     #       * The corresponding `Expression` for this example is as follows:
     #         `\{ "Dimensions": \{ "Key": "LINKED_ACCOUNT_NAME",
@@ -256,10 +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.
+    #
+    # 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.
+    #
+    #
+    #
+    # [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).
@@ -280,19 +297,31 @@ module Aws::CostExplorer
     # @!attribute [rw] threshold
     #   (deprecated)
     #
-    #   The dollar value that triggers a notification if the threshold is
-    #   exceeded.
+    #   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.
+    #   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
@@ -304,12 +333,15 @@ module Aws::CostExplorer
     #   want to generate alerts for. This supports dimensions and nested
     #   expressions. The supported dimensions are
     #   `ANOMALY_TOTAL_IMPACT_ABSOLUTE` and
-    #   `ANOMALY_TOTAL_IMPACT_PERCENTAGE`. 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.
+    #   `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.
+    #   resource. You cannot specify both.
     #
     #   The following are examples of valid ThresholdExpressions:
     #
@@ -338,6 +370,7 @@ module Aws::CostExplorer
     #
     #
     #   [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
@@ -593,10 +626,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
@@ -1705,7 +1735,7 @@ module Aws::CostExplorer
     #
     #     * The corresponding `Expression` for this example is as follows:
     #       `\{ "Dimensions": \{ "Key": "REGION", "Values": [ "us-east-1",
-    #       “us-west-1” ] \} \}`
+    #       "us-west-1" ] \} \}`
     #
     #     * As shown in the previous example, lists of dimension values are
     #       combined with `OR` when applying the filter.
@@ -1715,7 +1745,7 @@ module Aws::CostExplorer
     #     the documentation for each specific API to see what is supported.
     #
     #     * For example, you can filter for linked account names that start
-    #       with “a”.
+    #       with "a".
     #
     #     * The corresponding `Expression` for this example is as follows:
     #       `\{ "Dimensions": \{ "Key": "LINKED_ACCOUNT_NAME",
@@ -2334,7 +2364,7 @@ module Aws::CostExplorer
     #
     #       * The corresponding `Expression` for this example is as follows:
     #         `\{ "Dimensions": \{ "Key": "REGION", "Values": [ "us-east-1",
-    #         “us-west-1” ] \} \}`
+    #         "us-west-1" ] \} \}`
     #
     #       * As shown in the previous example, lists of dimension values
     #         are combined with `OR` when applying the filter.
@@ -2345,7 +2375,7 @@ module Aws::CostExplorer
     #       supported.
     #
     #       * For example, you can filter for linked account names that
-    #         start with “a”.
+    #         start with "a".
     #
     #       * The corresponding `Expression` for this example is as follows:
     #         `\{ "Dimensions": \{ "Key": "LINKED_ACCOUNT_NAME",
@@ -2831,7 +2861,7 @@ module Aws::CostExplorer
     #
     #       * The corresponding `Expression` for this example is as follows:
     #         `\{ "Dimensions": \{ "Key": "REGION", "Values": [ "us-east-1",
-    #         “us-west-1” ] \} \}`
+    #         "us-west-1" ] \} \}`
     #
     #       * As shown in the previous example, lists of dimension values
     #         are combined with `OR` when applying the filter.
@@ -2842,7 +2872,7 @@ module Aws::CostExplorer
     #       supported.
     #
     #       * For example, you can filter for linked account names that
-    #         start with “a”.
+    #         start with "a".
     #
     #       * The corresponding `Expression` for this example is as follows:
     #         `\{ "Dimensions": \{ "Key": "LINKED_ACCOUNT_NAME",
@@ -3306,7 +3336,7 @@ module Aws::CostExplorer
     #
     #       * The corresponding `Expression` for this example is as follows:
     #         `\{ "Dimensions": \{ "Key": "REGION", "Values": [ "us-east-1",
-    #         “us-west-1” ] \} \}`
+    #         "us-west-1" ] \} \}`
     #
     #       * As shown in the previous example, lists of dimension values
     #         are combined with `OR` when applying the filter.
@@ -3317,7 +3347,7 @@ module Aws::CostExplorer
     #       supported.
     #
     #       * For example, you can filter for linked account names that
-    #         start with “a”.
+    #         start with "a".
     #
     #       * The corresponding `Expression` for this example is as follows:
     #         `\{ "Dimensions": \{ "Key": "LINKED_ACCOUNT_NAME",
@@ -3634,7 +3664,7 @@ module Aws::CostExplorer
     #
     #       * The corresponding `Expression` for this example is as follows:
     #         `\{ "Dimensions": \{ "Key": "REGION", "Values": [ "us-east-1",
-    #         “us-west-1” ] \} \}`
+    #         "us-west-1" ] \} \}`
     #
     #       * As shown in the previous example, lists of dimension values
     #         are combined with `OR` when applying the filter.
@@ -3645,7 +3675,7 @@ module Aws::CostExplorer
     #       supported.
     #
     #       * For example, you can filter for linked account names that
-    #         start with “a”.
+    #         start with "a".
     #
     #       * The corresponding `Expression` for this example is as follows:
     #         `\{ "Dimensions": \{ "Key": "LINKED_ACCOUNT_NAME",
@@ -3772,6 +3802,36 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
+    # @!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
@@ -4228,7 +4288,7 @@ module Aws::CostExplorer
     #
     #       * The corresponding `Expression` for this example is as follows:
     #         `\{ "Dimensions": \{ "Key": "REGION", "Values": [ "us-east-1",
-    #         “us-west-1” ] \} \}`
+    #         "us-west-1" ] \} \}`
     #
     #       * As shown in the previous example, lists of dimension values
     #         are combined with `OR` when applying the filter.
@@ -4239,7 +4299,7 @@ module Aws::CostExplorer
     #       supported.
     #
     #       * For example, you can filter for linked account names that
-    #         start with “a”.
+    #         start with "a".
     #
     #       * The corresponding `Expression` for this example is as follows:
     #         `\{ "Dimensions": \{ "Key": "LINKED_ACCOUNT_NAME",
@@ -4982,6 +5042,221 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
+    # 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 instances that Amazon Web Services
     # recommends that you purchase.
     #
@@ -5945,6 +6220,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(
@@ -5963,7 +6243,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
@@ -6640,6 +6921,9 @@ module Aws::CostExplorer
     #   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
@@ -6664,9 +6948,15 @@ module Aws::CostExplorer
     #   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`. 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.
+    #   `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:
     #
@@ -6695,6 +6985,7 @@ module Aws::CostExplorer
     #
     #
     #   [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

data/lib/aws-sdk-costexplorer.rb

@@ -52,6 +52,6 @@ require_relative 'aws-sdk-costexplorer/customizations'
 # @!group service
 module Aws::CostExplorer
 
-  GEM_VERSION = '1.88.0'
+  GEM_VERSION = '1.89.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-costexplorer
 version: !ruby/object:Gem::Version
-  version: 1.88.0
+  version: 1.89.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-07-11 00:00:00.000000000 Z
+date: 2023-07-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core