aws-sdk-costexplorer 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 4dbabc76e800c52c051795be31b2cef1306b5b24
-  data.tar.gz: b7baa6c43895ea437fff06172181ecfea24d4653
+  metadata.gz: 87fd4ca3923fa05af050f055cd46350ecaee4e56
+  data.tar.gz: 922c2e493f0550c59285e6f6a19317bcc1d36942
 SHA512:
-  metadata.gz: 0c95854f198f07aa297e95bf3f4da9f6242b30f4240ee1e972dc25b0bcf136c4cb894541bbb1f75f578e8b2b680ae8ec8b376945b7dc20e502a1fa5a954dd2b1
-  data.tar.gz: 1256232d391c2c2c41f73cc1514fbf41b696ed39bae364146b06143d13f0122332d094bbfe8b248022be16f4e0493fb9a135b9c244e11e2daaac42ba3d4d80fb
+  metadata.gz: 9488f467344b8eb01fb3ce1bae4b8324ee6725313b0e7a14dfdad98e6a7df633908b131a95f4f31d0491b0b7a311a1b74144ed304ef3d9794bac5d8851412255
+  data.tar.gz: 2d9b78663c7e2b68eea6c2ce794662ce3bc51b5438f35c9fc4c85d61f92072192a421ae05d51a6848ae51d2c1fa9c69e9c1016a7251588404113b57986c6d3c3

data/lib/aws-sdk-costexplorer.rb

@@ -42,6 +42,6 @@ require_relative 'aws-sdk-costexplorer/customizations'
 # @service
 module Aws::CostExplorer
 
-  GEM_VERSION = '1.1.0'
+  GEM_VERSION = '1.2.0'
 
 end

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

@@ -155,13 +155,14 @@ module Aws::CostExplorer
 
     # @!group API Operations
 
-    # Retrieve cost and usage metrics for your account. You can specify
+    # 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. See the `GetDimensionValues` action
-    # for a complete list of the valid dimensions. Master accounts in an
-    # organization have access to all member accounts.
+    # `AZ`, in a specific time range. For a complete list of valid
+    # dimensions, see the ` GetDimensionValues ` operation. Master accounts
+    # in an organization in AWS Organizations have access to all member
+    # accounts.
     #
     # @option params [Types::DateInterval] :time_period
     #   Sets the start and end dates for retrieving AWS costs. The start date
@@ -177,10 +178,10 @@ module Aws::CostExplorer
     #
     # @option params [Types::Expression] :filter
     #   Filters AWS costs by different dimensions. For example, you can
-    #   specify `SERVICE` and `LINKED_ACCOUNT` and get the costs associated
-    #   with that account's usage of that service. You can nest `Expression`
-    #   objects to define any combination of dimension filters. For more
-    #   information, see [Expression][1].
+    #   specify `SERVICE` and `LINKED_ACCOUNT` and get the costs that are
+    #   associated with that account's usage of that service. You can nest
+    #   `Expression` objects to define any combination of dimension filters.
+    #   For more information, see [Expression][1].
     #
     #
     #
@@ -202,6 +203,8 @@ module Aws::CostExplorer
     #
     #    </note>
     #
+    #   `Metrics` is required for `GetCostAndUsage` requests.
+    #
     #
     #
     #   [1]: https://aws.amazon.com/premiumsupport/knowledge-center/blended-rates-intro/
@@ -213,9 +216,9 @@ module Aws::CostExplorer
     #   When you group by tag key, you get all tag values, including empty
     #   strings.
     #
-    #   Valid values are `AZ`, `INSTANCE_TYPE`, `LINKED_ACCOUNT`, `OPERATION`,
-    #   `PLATFORM`, `PURCHASE_TYPE`, `SERVICE`, `TAGS`, `TENANCY`, and
-    #   `USAGE_TYPE`.
+    #   Valid values are `AZ`, `INSTANCE_TYPE`, `LEGAL_ENTITY_NAME`,
+    #   `LINKED_ACCOUNT`, `OPERATION`, `PLATFORM`, `PURCHASE_TYPE`, `SERVICE`,
+    #   `TAGS`, `TENANCY`, and `USAGE_TYPE`.
     #
     # @option params [String] :next_page_token
     #   The token to retrieve the next set of results. AWS provides the token
@@ -298,9 +301,9 @@ module Aws::CostExplorer
       req.send_request(options)
     end
 
-    # You can use `GetDimensionValues` to retrieve all available filter
-    # values for a specific filter over a period of time. You can search the
-    # dimension values for an arbitrary string.
+    # Retrieves all available filter values for a specific filter over a
+    # period of time. You can search the dimension values for an arbitrary
+    # string.
     #
     # @option params [String] :search_string
     #   The value that you want to search the filter values for.
@@ -313,7 +316,7 @@ module Aws::CostExplorer
     #   `2017-04-30` but not including `2017-05-01`.
     #
     # @option params [required, String] :dimension
-    #   The name of the dimension. Each `Dimensions`is available for different
+    #   The name of the dimension. Each `Dimension` is available for different
     #   a `Context`. For more information, see `Context`.
     #
     # @option params [String] :context
@@ -321,38 +324,39 @@ module Aws::CostExplorer
     #   `RESERVATIONS` or `COST_AND_USAGE`. The default value is
     #   `COST_AND_USAGE`. If the context is set to `RESERVATIONS`, the
     #   resulting dimension values can be used in the
-    #   `GetReservationUtilization` action. If the context is set to
-    #   `COST_AND_USAGE`, the resulting dimension values can be used in the
+    #   `GetReservationUtilization` operation. If the context is set to
+    #   `COST_AND_USAGE` the resulting dimension values can be used in the
     #   `GetCostAndUsage` operation.
     #
     #   If you set the context to `CostAndUsage`, you can use the following
     #   dimensions for searching:
     #
-    #   * AZ - The Availability Zone. An example is us-east-1a.
+    #   * AZ - The Availability Zone. An example is `us-east-1a`.
     #
-    #   * INSTANCE\_TYPE - The type of EC2 instance. An example is m4.xlarge.
+    #   * INSTANCE\_TYPE - The type of instance. An example is an EC2
+    #     `m4.xlarge`.
     #
     #   * LINKED\_ACCOUNT - The description in the attribute map that includes
     #     the full name of the member account. The value field contains the
-    #     AWS ID of the member account
+    #     AWS ID of the member account.
     #
-    #   * OPERATION - The action performed. Examples include RunInstance and
-    #     CreateBucket.
+    #   * OPERATION - The action performed. Examples include `RunInstance` and
+    #     `CreateBucket`.
     #
     #   * PURCHASE\_TYPE - The reservation type of the purchase to which this
-    #     usage is related. Examples include: On Demand Instances and Standard
-    #     Reserved Instances
+    #     usage is related. Examples include On-Demand Instances and Standard
+    #     Reserved Instances.
     #
     #   * SERVICE - The AWS service such as DynamoDB.
     #
     #   * USAGE\_TYPE - The type of usage. An example is
-    #     DataTransfer-In-Bytes. The response for the GetDimensionValues
-    #     action includes a unit attribute, examples of which include GB and
-    #     Hrs.
+    #     `DataTransfer-In-Bytes`. The response for the `GetDimensionValues`
+    #     operation includes a unit attribute, examples of which include GB
+    #     and Hrs.
     #
     #   * USAGE\_TYPE\_GROUP - The grouping of common usage types. An example
-    #     is EC2: CloudWatch – Alarms. The response for this action includes a
-    #     unit attribute.
+    #     is EC2: CloudWatch – Alarms. The response for this operation
+    #     includes a unit attribute.
     #
     #   * RECORD\_TYPE - The different types of charges such as RI fees, usage
     #     costs, tax refunds, and credits.
@@ -360,20 +364,24 @@ module Aws::CostExplorer
     #   If you set the context to `RESERVATIONS`, you can use the following
     #   dimensions for searching:
     #
-    #   * AZ - The Availability Zone. An example is us-east-1a.
+    #   * AZ - The Availability Zone. An example is `us-east-1a`.
     #
-    #   * INSTANCE\_TYPE - The type of EC2 instance. An example is m4.xlarge.
+    #   * INSTANCE\_TYPE - The type of instance. An example is an EC2
+    #     `m4.xlarge`.
     #
     #   * LINKED\_ACCOUNT - The description in the attribute map that includes
     #     the full name of the member account. The value field contains the
-    #     AWS ID of the member account
+    #     AWS ID of the member account.
     #
-    #   * PLATFORM - The operating system. Examples are Windows or Linux.
+    #   * PLATFORM - The specific combination of operating system, license
+    #     model, and software on an instance. For example, a Windows instance
+    #     with SQL Server Web and no license, or a Red Hat Enterprise Linux
+    #     instance.
     #
-    #   * REGION - The AWS region.
+    #   * REGION - The AWS Region.
     #
-    #   * SCOPE - The scope of a reserved instance (RI). Values are regional
-    #     or a single availability zone.
+    #   * SCOPE - The scope of a Reserved Instance (RI). Values are regional
+    #     or a single Availability Zone.
     #
     #   * TENANCY - The tenancy of a resource. Examples are shared or
     #     dedicated.
@@ -422,10 +430,13 @@ module Aws::CostExplorer
       req.send_request(options)
     end
 
-    # Retrieve the reservation coverage for your account. An organization's
-    # master account has access to the associated member accounts. For any
-    # time period, you can filter data about reservation usage by the
-    # following dimensions.
+    # Retrieves the reservation coverage for your account. This allows you
+    # to see how much of your Amazon Elastic Compute Cloud, Amazon
+    # ElastiCache, Amazon Relational Database Service, or Amazon Redshift
+    # usage is covered by a reservation. An organization's master account
+    # can see the coverage of the associated member accounts. For any time
+    # period, you can filter data about reservation usage by the following
+    # dimensions:
     #
     # * AZ
     #
@@ -445,14 +456,14 @@ module Aws::CostExplorer
     # @option params [required, Types::DateInterval] :time_period
     #   The start and end dates of the period for which you want to retrieve
     #   data about reservation coverage. You can retrieve data for a maximum
-    #   of 13 months-the last 12 months and the current month. The start date
+    #   of 13 months: the last 12 months and the current month. The start date
     #   is inclusive, but the end date is exclusive. For example, if `start`
     #   is `2017-01-01` and `end` is `2017-05-01`, then the cost and usage
     #   data is retrieved from `2017-01-01` up to and including `2017-04-30`
     #   but not including `2017-05-01`.
     #
     # @option params [Array<Types::GroupDefinition>] :group_by
-    #   You can group the data by the following attributes.
+    #   You can group the data by the following attributes:
     #
     #   * AZ
     #
@@ -476,7 +487,7 @@ module Aws::CostExplorer
     #
     # @option params [Types::Expression] :filter
     #   Filters utilization data by dimensions. You can filter by the
-    #   following dimensions.
+    #   following dimensions:
     #
     #   * AZ
     #
@@ -490,7 +501,7 @@ module Aws::CostExplorer
     #
     #   * TENANCY
     #
-    #   `GetReservationCoverage` uses the same `Expression` object as the
+    #   `GetReservationCoverage` uses the same ` Expression ` object as the
     #   other operations, but only `AND` is supported among each dimension.
     #   You can nest only one level deep. If there are multiple values for a
     #   dimension, they are OR'd together.
@@ -577,11 +588,139 @@ module Aws::CostExplorer
       req.send_request(options)
     end
 
-    # You can retrieve the Reservation utilization for your account. Master
-    # accounts in an organization have access to their associated 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`.
+    # Gets recommendations for which reservations to purchase. These
+    # recommendations could help you reduce your costs. Reservations provide
+    # a discounted hourly rate (up to 75%) compared to On-Demand pricing.
+    #
+    # AWS generates your recommendations by identifying your On-Demand usage
+    # during a specific time period and collecting your usage into
+    # categories that are eligible for a reservation. After AWS has these
+    # categories, it simulates every combination of reservations in each
+    # category of usage to identify the best number of each type of RI to
+    # purchase to maximize your estimated savings.
+    #
+    # For example, AWS automatically aggregates your EC2 Linux, shared
+    # tenancy, and c4 family usage in the US West (Oregon) Region and
+    # recommends that you buy size-flexible regional reservations to apply
+    # to the c4 family usage. AWS recommends the smallest size instance in
+    # an instance family. This makes it easier to purchase a size-flexible
+    # RI. AWS also shows the equal number of normalized units so that you
+    # can purchase any instance size that you want. For this example, your
+    # RI recommendation would be for `c4.large`, because that is the
+    # smallest size instance in the c4 instance family.
+    #
+    # @option params [String] :account_id
+    #   The account ID that is associated with the recommendation.
+    #
+    # @option params [required, String] :service
+    #   The specific service that you want recommendations for.
+    #
+    # @option params [String] :account_scope
+    #   The account scope that you want recommendations for. The only valid
+    #   value is `Payer`. This means that AWS includes the master account and
+    #   any member accounts when it calculates its recommendations.
+    #
+    # @option params [String] :lookback_period_in_days
+    #   The number of previous days that you want AWS to consider when it
+    #   calculates your recommendations.
+    #
+    # @option params [String] :term_in_years
+    #   The reservation term that you want recommendations for.
+    #
+    # @option params [String] :payment_option
+    #   The reservation purchase option that you want recommendations for.
+    #
+    # @option params [Types::ServiceSpecification] :service_specification
+    #   The specific service, such as EC2, that you want recommendations for.
+    #
+    # @option params [Integer] :page_size
+    #   The number of recommendations that you want returned in a single
+    #   response object.
+    #
+    # @option params [String] :next_page_token
+    #   The pagination token that indicates the next set of results that you
+    #   want to retrieve.
+    #
+    # @return [Types::GetReservationPurchaseRecommendationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetReservationPurchaseRecommendationResponse#metadata #metadata} => Types::ReservationPurchaseRecommendationMetadata
+    #   * {Types::GetReservationPurchaseRecommendationResponse#recommendations #recommendations} => Array&lt;Types::ReservationPurchaseRecommendation&gt;
+    #   * {Types::GetReservationPurchaseRecommendationResponse#next_page_token #next_page_token} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_reservation_purchase_recommendation({
+    #     account_id: "GenericString",
+    #     service: "GenericString", # required
+    #     account_scope: "PAYER", # accepts PAYER
+    #     lookback_period_in_days: "SEVEN_DAYS", # accepts SEVEN_DAYS, THIRTY_DAYS, SIXTY_DAYS
+    #     term_in_years: "ONE_YEAR", # accepts ONE_YEAR, THREE_YEARS
+    #     payment_option: "NO_UPFRONT", # accepts NO_UPFRONT, PARTIAL_UPFRONT, ALL_UPFRONT
+    #     service_specification: {
+    #       ec2_specification: {
+    #         offering_class: "STANDARD", # accepts STANDARD, CONVERTIBLE
+    #       },
+    #     },
+    #     page_size: 1,
+    #     next_page_token: "NextPageToken",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.metadata.recommendation_id #=> String
+    #   resp.metadata.generation_timestamp #=> String
+    #   resp.recommendations #=> Array
+    #   resp.recommendations[0].account_scope #=> String, one of "PAYER"
+    #   resp.recommendations[0].lookback_period_in_days #=> String, one of "SEVEN_DAYS", "THIRTY_DAYS", "SIXTY_DAYS"
+    #   resp.recommendations[0].term_in_years #=> String, one of "ONE_YEAR", "THREE_YEARS"
+    #   resp.recommendations[0].payment_option #=> String, one of "NO_UPFRONT", "PARTIAL_UPFRONT", "ALL_UPFRONT"
+    #   resp.recommendations[0].service_specification.ec2_specification.offering_class #=> String, one of "STANDARD", "CONVERTIBLE"
+    #   resp.recommendations[0].recommendation_details #=> Array
+    #   resp.recommendations[0].recommendation_details[0].instance_details.ec2_instance_details.family #=> String
+    #   resp.recommendations[0].recommendation_details[0].instance_details.ec2_instance_details.instance_type #=> String
+    #   resp.recommendations[0].recommendation_details[0].instance_details.ec2_instance_details.region #=> String
+    #   resp.recommendations[0].recommendation_details[0].instance_details.ec2_instance_details.availability_zone #=> String
+    #   resp.recommendations[0].recommendation_details[0].instance_details.ec2_instance_details.platform #=> String
+    #   resp.recommendations[0].recommendation_details[0].instance_details.ec2_instance_details.tenancy #=> String
+    #   resp.recommendations[0].recommendation_details[0].instance_details.ec2_instance_details.current_generation #=> Boolean
+    #   resp.recommendations[0].recommendation_details[0].instance_details.ec2_instance_details.size_flex_eligible #=> Boolean
+    #   resp.recommendations[0].recommendation_details[0].recommended_number_of_instances_to_purchase #=> String
+    #   resp.recommendations[0].recommendation_details[0].recommended_normalized_units_to_purchase #=> String
+    #   resp.recommendations[0].recommendation_details[0].minimum_number_of_instances_used_per_hour #=> String
+    #   resp.recommendations[0].recommendation_details[0].minimum_normalized_units_used_per_hour #=> String
+    #   resp.recommendations[0].recommendation_details[0].maximum_number_of_instances_used_per_hour #=> String
+    #   resp.recommendations[0].recommendation_details[0].maximum_normalized_units_used_per_hour #=> String
+    #   resp.recommendations[0].recommendation_details[0].average_number_of_instances_used_per_hour #=> String
+    #   resp.recommendations[0].recommendation_details[0].average_normalized_units_used_per_hour #=> String
+    #   resp.recommendations[0].recommendation_details[0].average_utilization #=> String
+    #   resp.recommendations[0].recommendation_details[0].estimated_break_even_in_months #=> String
+    #   resp.recommendations[0].recommendation_details[0].currency_code #=> String
+    #   resp.recommendations[0].recommendation_details[0].estimated_monthly_savings_amount #=> String
+    #   resp.recommendations[0].recommendation_details[0].estimated_monthly_savings_percentage #=> String
+    #   resp.recommendations[0].recommendation_details[0].estimated_monthly_on_demand_cost #=> String
+    #   resp.recommendations[0].recommendation_details[0].estimated_reservation_cost_for_lookback_period #=> String
+    #   resp.recommendations[0].recommendation_details[0].upfront_cost #=> String
+    #   resp.recommendations[0].recommendation_details[0].recurring_standard_monthly_cost #=> String
+    #   resp.recommendations[0].recommendation_summary.total_estimated_monthly_savings_amount #=> String
+    #   resp.recommendations[0].recommendation_summary.total_estimated_monthly_savings_percentage #=> String
+    #   resp.recommendations[0].recommendation_summary.currency_code #=> String
+    #   resp.next_page_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetReservationPurchaseRecommendation AWS API Documentation
+    #
+    # @overload get_reservation_purchase_recommendation(params = {})
+    # @param [Hash] params ({})
+    def get_reservation_purchase_recommendation(params = {}, options = {})
+      req = build_request(:get_reservation_purchase_recommendation, params)
+      req.send_request(options)
+    end
+
+    # You can retrieve the reservation utilization for your account. Master
+    # accounts in an organization in AWS Organizations have access to their
+    # associated 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 reserve instance (RI)
@@ -602,10 +741,10 @@ module Aws::CostExplorer
     #
     # @option params [Types::Expression] :filter
     #   Filters utilization data by using different dimensions.
-    #   `GetReservationUtilization` uses the same `Expression` object as the
+    #   `GetReservationUtilization` uses the same ` Expression ` object as the
     #   other operations, but only `AND` is supported among each dimension,
-    #   and nesting is supported up to only one level deep. If there are
-    #   multiple values for a dimension, they are OR'd together.
+    #   and nesting is supported to only one level deep. If there are multiple
+    #   values for a dimension, they are OR'd together.
     #
     # @option params [String] :next_page_token
     #   The token to retrieve the next set of results. AWS provides the token
@@ -761,7 +900,7 @@ module Aws::CostExplorer
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-costexplorer'
-      context[:gem_version] = '1.1.0'
+      context[:gem_version] = '1.2.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -11,6 +11,7 @@ module Aws::CostExplorer
 
     include Seahorse::Model
 
+    AccountScope = Shapes::StringShape.new(name: 'AccountScope')
     AttributeType = Shapes::StringShape.new(name: 'AttributeType')
     AttributeValue = Shapes::StringShape.new(name: 'AttributeValue')
     Attributes = Shapes::MapShape.new(name: 'Attributes')
@@ -27,17 +28,23 @@ module Aws::CostExplorer
     DimensionValues = Shapes::StructureShape.new(name: 'DimensionValues')
     DimensionValuesWithAttributes = Shapes::StructureShape.new(name: 'DimensionValuesWithAttributes')
     DimensionValuesWithAttributesList = Shapes::ListShape.new(name: 'DimensionValuesWithAttributesList')
+    EC2InstanceDetails = Shapes::StructureShape.new(name: 'EC2InstanceDetails')
+    EC2Specification = Shapes::StructureShape.new(name: 'EC2Specification')
     Entity = Shapes::StringShape.new(name: 'Entity')
     ErrorMessage = Shapes::StringShape.new(name: 'ErrorMessage')
     Estimated = Shapes::BooleanShape.new(name: 'Estimated')
     Expression = Shapes::StructureShape.new(name: 'Expression')
     Expressions = Shapes::ListShape.new(name: 'Expressions')
+    GenericBoolean = Shapes::BooleanShape.new(name: 'GenericBoolean')
+    GenericString = Shapes::StringShape.new(name: 'GenericString')
     GetCostAndUsageRequest = Shapes::StructureShape.new(name: 'GetCostAndUsageRequest')
     GetCostAndUsageResponse = Shapes::StructureShape.new(name: 'GetCostAndUsageResponse')
     GetDimensionValuesRequest = Shapes::StructureShape.new(name: 'GetDimensionValuesRequest')
     GetDimensionValuesResponse = Shapes::StructureShape.new(name: 'GetDimensionValuesResponse')
     GetReservationCoverageRequest = Shapes::StructureShape.new(name: 'GetReservationCoverageRequest')
     GetReservationCoverageResponse = Shapes::StructureShape.new(name: 'GetReservationCoverageResponse')
+    GetReservationPurchaseRecommendationRequest = Shapes::StructureShape.new(name: 'GetReservationPurchaseRecommendationRequest')
+    GetReservationPurchaseRecommendationResponse = Shapes::StructureShape.new(name: 'GetReservationPurchaseRecommendationResponse')
     GetReservationUtilizationRequest = Shapes::StructureShape.new(name: 'GetReservationUtilizationRequest')
     GetReservationUtilizationResponse = Shapes::StructureShape.new(name: 'GetReservationUtilizationResponse')
     GetTagsRequest = Shapes::StructureShape.new(name: 'GetTagsRequest')
@@ -49,10 +56,12 @@ module Aws::CostExplorer
     GroupDefinitionType = Shapes::StringShape.new(name: 'GroupDefinitionType')
     GroupDefinitions = Shapes::ListShape.new(name: 'GroupDefinitions')
     Groups = Shapes::ListShape.new(name: 'Groups')
+    InstanceDetails = Shapes::StructureShape.new(name: 'InstanceDetails')
     InvalidNextTokenException = Shapes::StructureShape.new(name: 'InvalidNextTokenException')
     Key = Shapes::StringShape.new(name: 'Key')
     Keys = Shapes::ListShape.new(name: 'Keys')
     LimitExceededException = Shapes::StructureShape.new(name: 'LimitExceededException')
+    LookbackPeriodInDays = Shapes::StringShape.new(name: 'LookbackPeriodInDays')
     MetricAmount = Shapes::StringShape.new(name: 'MetricAmount')
     MetricName = Shapes::StringShape.new(name: 'MetricName')
     MetricNames = Shapes::ListShape.new(name: 'MetricNames')
@@ -60,23 +69,34 @@ module Aws::CostExplorer
     MetricValue = Shapes::StructureShape.new(name: 'MetricValue')
     Metrics = Shapes::MapShape.new(name: 'Metrics')
     NextPageToken = Shapes::StringShape.new(name: 'NextPageToken')
+    NonNegativeInteger = Shapes::IntegerShape.new(name: 'NonNegativeInteger')
+    OfferingClass = Shapes::StringShape.new(name: 'OfferingClass')
     OnDemandHours = Shapes::StringShape.new(name: 'OnDemandHours')
     PageSize = Shapes::IntegerShape.new(name: 'PageSize')
+    PaymentOption = Shapes::StringShape.new(name: 'PaymentOption')
     PurchasedHours = Shapes::StringShape.new(name: 'PurchasedHours')
     ReservationAggregates = Shapes::StructureShape.new(name: 'ReservationAggregates')
     ReservationCoverageGroup = Shapes::StructureShape.new(name: 'ReservationCoverageGroup')
     ReservationCoverageGroups = Shapes::ListShape.new(name: 'ReservationCoverageGroups')
     ReservationGroupKey = Shapes::StringShape.new(name: 'ReservationGroupKey')
     ReservationGroupValue = Shapes::StringShape.new(name: 'ReservationGroupValue')
+    ReservationPurchaseRecommendation = Shapes::StructureShape.new(name: 'ReservationPurchaseRecommendation')
+    ReservationPurchaseRecommendationDetail = Shapes::StructureShape.new(name: 'ReservationPurchaseRecommendationDetail')
+    ReservationPurchaseRecommendationDetails = Shapes::ListShape.new(name: 'ReservationPurchaseRecommendationDetails')
+    ReservationPurchaseRecommendationMetadata = Shapes::StructureShape.new(name: 'ReservationPurchaseRecommendationMetadata')
+    ReservationPurchaseRecommendationSummary = Shapes::StructureShape.new(name: 'ReservationPurchaseRecommendationSummary')
+    ReservationPurchaseRecommendations = Shapes::ListShape.new(name: 'ReservationPurchaseRecommendations')
     ReservationUtilizationGroup = Shapes::StructureShape.new(name: 'ReservationUtilizationGroup')
     ReservationUtilizationGroups = Shapes::ListShape.new(name: 'ReservationUtilizationGroups')
     ReservedHours = Shapes::StringShape.new(name: 'ReservedHours')
     ResultByTime = Shapes::StructureShape.new(name: 'ResultByTime')
     ResultsByTime = Shapes::ListShape.new(name: 'ResultsByTime')
     SearchString = Shapes::StringShape.new(name: 'SearchString')
+    ServiceSpecification = Shapes::StructureShape.new(name: 'ServiceSpecification')
     TagKey = Shapes::StringShape.new(name: 'TagKey')
     TagList = Shapes::ListShape.new(name: 'TagList')
     TagValues = Shapes::StructureShape.new(name: 'TagValues')
+    TermInYears = Shapes::StringShape.new(name: 'TermInYears')
     TotalActualHours = Shapes::StringShape.new(name: 'TotalActualHours')
     TotalRunningHours = Shapes::StringShape.new(name: 'TotalRunningHours')
     UnusedHours = Shapes::StringShape.new(name: 'UnusedHours')
@@ -120,6 +140,19 @@ module Aws::CostExplorer
 
     DimensionValuesWithAttributesList.member = Shapes::ShapeRef.new(shape: DimensionValuesWithAttributes)
 
+    EC2InstanceDetails.add_member(:family, Shapes::ShapeRef.new(shape: GenericString, location_name: "Family"))
+    EC2InstanceDetails.add_member(:instance_type, Shapes::ShapeRef.new(shape: GenericString, location_name: "InstanceType"))
+    EC2InstanceDetails.add_member(:region, Shapes::ShapeRef.new(shape: GenericString, location_name: "Region"))
+    EC2InstanceDetails.add_member(:availability_zone, Shapes::ShapeRef.new(shape: GenericString, location_name: "AvailabilityZone"))
+    EC2InstanceDetails.add_member(:platform, Shapes::ShapeRef.new(shape: GenericString, location_name: "Platform"))
+    EC2InstanceDetails.add_member(:tenancy, Shapes::ShapeRef.new(shape: GenericString, location_name: "Tenancy"))
+    EC2InstanceDetails.add_member(:current_generation, Shapes::ShapeRef.new(shape: GenericBoolean, location_name: "CurrentGeneration"))
+    EC2InstanceDetails.add_member(:size_flex_eligible, Shapes::ShapeRef.new(shape: GenericBoolean, location_name: "SizeFlexEligible"))
+    EC2InstanceDetails.struct_class = Types::EC2InstanceDetails
+
+    EC2Specification.add_member(:offering_class, Shapes::ShapeRef.new(shape: OfferingClass, location_name: "OfferingClass"))
+    EC2Specification.struct_class = Types::EC2Specification
+
     Expression.add_member(:or, Shapes::ShapeRef.new(shape: Expressions, location_name: "Or"))
     Expression.add_member(:and, Shapes::ShapeRef.new(shape: Expressions, location_name: "And"))
     Expression.add_member(:not, Shapes::ShapeRef.new(shape: Expression, location_name: "Not"))
@@ -167,6 +200,22 @@ module Aws::CostExplorer
     GetReservationCoverageResponse.add_member(:next_page_token, Shapes::ShapeRef.new(shape: NextPageToken, location_name: "NextPageToken"))
     GetReservationCoverageResponse.struct_class = Types::GetReservationCoverageResponse
 
+    GetReservationPurchaseRecommendationRequest.add_member(:account_id, Shapes::ShapeRef.new(shape: GenericString, location_name: "AccountId"))
+    GetReservationPurchaseRecommendationRequest.add_member(:service, Shapes::ShapeRef.new(shape: GenericString, required: true, location_name: "Service"))
+    GetReservationPurchaseRecommendationRequest.add_member(:account_scope, Shapes::ShapeRef.new(shape: AccountScope, location_name: "AccountScope"))
+    GetReservationPurchaseRecommendationRequest.add_member(:lookback_period_in_days, Shapes::ShapeRef.new(shape: LookbackPeriodInDays, location_name: "LookbackPeriodInDays"))
+    GetReservationPurchaseRecommendationRequest.add_member(:term_in_years, Shapes::ShapeRef.new(shape: TermInYears, location_name: "TermInYears"))
+    GetReservationPurchaseRecommendationRequest.add_member(:payment_option, Shapes::ShapeRef.new(shape: PaymentOption, location_name: "PaymentOption"))
+    GetReservationPurchaseRecommendationRequest.add_member(:service_specification, Shapes::ShapeRef.new(shape: ServiceSpecification, location_name: "ServiceSpecification"))
+    GetReservationPurchaseRecommendationRequest.add_member(:page_size, Shapes::ShapeRef.new(shape: NonNegativeInteger, location_name: "PageSize"))
+    GetReservationPurchaseRecommendationRequest.add_member(:next_page_token, Shapes::ShapeRef.new(shape: NextPageToken, location_name: "NextPageToken"))
+    GetReservationPurchaseRecommendationRequest.struct_class = Types::GetReservationPurchaseRecommendationRequest
+
+    GetReservationPurchaseRecommendationResponse.add_member(:metadata, Shapes::ShapeRef.new(shape: ReservationPurchaseRecommendationMetadata, location_name: "Metadata"))
+    GetReservationPurchaseRecommendationResponse.add_member(:recommendations, Shapes::ShapeRef.new(shape: ReservationPurchaseRecommendations, location_name: "Recommendations"))
+    GetReservationPurchaseRecommendationResponse.add_member(:next_page_token, Shapes::ShapeRef.new(shape: NextPageToken, location_name: "NextPageToken"))
+    GetReservationPurchaseRecommendationResponse.struct_class = Types::GetReservationPurchaseRecommendationResponse
+
     GetReservationUtilizationRequest.add_member(:time_period, Shapes::ShapeRef.new(shape: DateInterval, required: true, location_name: "TimePeriod"))
     GetReservationUtilizationRequest.add_member(:group_by, Shapes::ShapeRef.new(shape: GroupDefinitions, location_name: "GroupBy"))
     GetReservationUtilizationRequest.add_member(:granularity, Shapes::ShapeRef.new(shape: Granularity, location_name: "Granularity"))
@@ -203,6 +252,9 @@ module Aws::CostExplorer
 
     Groups.member = Shapes::ShapeRef.new(shape: Group)
 
+    InstanceDetails.add_member(:ec2_instance_details, Shapes::ShapeRef.new(shape: EC2InstanceDetails, location_name: "EC2InstanceDetails"))
+    InstanceDetails.struct_class = Types::InstanceDetails
+
     Keys.member = Shapes::ShapeRef.new(shape: Key)
 
     MetricNames.member = Shapes::ShapeRef.new(shape: MetricName)
@@ -226,6 +278,48 @@ module Aws::CostExplorer
 
     ReservationCoverageGroups.member = Shapes::ShapeRef.new(shape: ReservationCoverageGroup)
 
+    ReservationPurchaseRecommendation.add_member(:account_scope, Shapes::ShapeRef.new(shape: AccountScope, location_name: "AccountScope"))
+    ReservationPurchaseRecommendation.add_member(:lookback_period_in_days, Shapes::ShapeRef.new(shape: LookbackPeriodInDays, location_name: "LookbackPeriodInDays"))
+    ReservationPurchaseRecommendation.add_member(:term_in_years, Shapes::ShapeRef.new(shape: TermInYears, location_name: "TermInYears"))
+    ReservationPurchaseRecommendation.add_member(:payment_option, Shapes::ShapeRef.new(shape: PaymentOption, location_name: "PaymentOption"))
+    ReservationPurchaseRecommendation.add_member(:service_specification, Shapes::ShapeRef.new(shape: ServiceSpecification, location_name: "ServiceSpecification"))
+    ReservationPurchaseRecommendation.add_member(:recommendation_details, Shapes::ShapeRef.new(shape: ReservationPurchaseRecommendationDetails, location_name: "RecommendationDetails"))
+    ReservationPurchaseRecommendation.add_member(:recommendation_summary, Shapes::ShapeRef.new(shape: ReservationPurchaseRecommendationSummary, location_name: "RecommendationSummary"))
+    ReservationPurchaseRecommendation.struct_class = Types::ReservationPurchaseRecommendation
+
+    ReservationPurchaseRecommendationDetail.add_member(:instance_details, Shapes::ShapeRef.new(shape: InstanceDetails, location_name: "InstanceDetails"))
+    ReservationPurchaseRecommendationDetail.add_member(:recommended_number_of_instances_to_purchase, Shapes::ShapeRef.new(shape: GenericString, location_name: "RecommendedNumberOfInstancesToPurchase"))
+    ReservationPurchaseRecommendationDetail.add_member(:recommended_normalized_units_to_purchase, Shapes::ShapeRef.new(shape: GenericString, location_name: "RecommendedNormalizedUnitsToPurchase"))
+    ReservationPurchaseRecommendationDetail.add_member(:minimum_number_of_instances_used_per_hour, Shapes::ShapeRef.new(shape: GenericString, location_name: "MinimumNumberOfInstancesUsedPerHour"))
+    ReservationPurchaseRecommendationDetail.add_member(:minimum_normalized_units_used_per_hour, Shapes::ShapeRef.new(shape: GenericString, location_name: "MinimumNormalizedUnitsUsedPerHour"))
+    ReservationPurchaseRecommendationDetail.add_member(:maximum_number_of_instances_used_per_hour, Shapes::ShapeRef.new(shape: GenericString, location_name: "MaximumNumberOfInstancesUsedPerHour"))
+    ReservationPurchaseRecommendationDetail.add_member(:maximum_normalized_units_used_per_hour, Shapes::ShapeRef.new(shape: GenericString, location_name: "MaximumNormalizedUnitsUsedPerHour"))
+    ReservationPurchaseRecommendationDetail.add_member(:average_number_of_instances_used_per_hour, Shapes::ShapeRef.new(shape: GenericString, location_name: "AverageNumberOfInstancesUsedPerHour"))
+    ReservationPurchaseRecommendationDetail.add_member(:average_normalized_units_used_per_hour, Shapes::ShapeRef.new(shape: GenericString, location_name: "AverageNormalizedUnitsUsedPerHour"))
+    ReservationPurchaseRecommendationDetail.add_member(:average_utilization, Shapes::ShapeRef.new(shape: GenericString, location_name: "AverageUtilization"))
+    ReservationPurchaseRecommendationDetail.add_member(:estimated_break_even_in_months, Shapes::ShapeRef.new(shape: GenericString, location_name: "EstimatedBreakEvenInMonths"))
+    ReservationPurchaseRecommendationDetail.add_member(:currency_code, Shapes::ShapeRef.new(shape: GenericString, location_name: "CurrencyCode"))
+    ReservationPurchaseRecommendationDetail.add_member(:estimated_monthly_savings_amount, Shapes::ShapeRef.new(shape: GenericString, location_name: "EstimatedMonthlySavingsAmount"))
+    ReservationPurchaseRecommendationDetail.add_member(:estimated_monthly_savings_percentage, Shapes::ShapeRef.new(shape: GenericString, location_name: "EstimatedMonthlySavingsPercentage"))
+    ReservationPurchaseRecommendationDetail.add_member(:estimated_monthly_on_demand_cost, Shapes::ShapeRef.new(shape: GenericString, location_name: "EstimatedMonthlyOnDemandCost"))
+    ReservationPurchaseRecommendationDetail.add_member(:estimated_reservation_cost_for_lookback_period, Shapes::ShapeRef.new(shape: GenericString, location_name: "EstimatedReservationCostForLookbackPeriod"))
+    ReservationPurchaseRecommendationDetail.add_member(:upfront_cost, Shapes::ShapeRef.new(shape: GenericString, location_name: "UpfrontCost"))
+    ReservationPurchaseRecommendationDetail.add_member(:recurring_standard_monthly_cost, Shapes::ShapeRef.new(shape: GenericString, location_name: "RecurringStandardMonthlyCost"))
+    ReservationPurchaseRecommendationDetail.struct_class = Types::ReservationPurchaseRecommendationDetail
+
+    ReservationPurchaseRecommendationDetails.member = Shapes::ShapeRef.new(shape: ReservationPurchaseRecommendationDetail)
+
+    ReservationPurchaseRecommendationMetadata.add_member(:recommendation_id, Shapes::ShapeRef.new(shape: GenericString, location_name: "RecommendationId"))
+    ReservationPurchaseRecommendationMetadata.add_member(:generation_timestamp, Shapes::ShapeRef.new(shape: GenericString, location_name: "GenerationTimestamp"))
+    ReservationPurchaseRecommendationMetadata.struct_class = Types::ReservationPurchaseRecommendationMetadata
+
+    ReservationPurchaseRecommendationSummary.add_member(:total_estimated_monthly_savings_amount, Shapes::ShapeRef.new(shape: GenericString, location_name: "TotalEstimatedMonthlySavingsAmount"))
+    ReservationPurchaseRecommendationSummary.add_member(:total_estimated_monthly_savings_percentage, Shapes::ShapeRef.new(shape: GenericString, location_name: "TotalEstimatedMonthlySavingsPercentage"))
+    ReservationPurchaseRecommendationSummary.add_member(:currency_code, Shapes::ShapeRef.new(shape: GenericString, location_name: "CurrencyCode"))
+    ReservationPurchaseRecommendationSummary.struct_class = Types::ReservationPurchaseRecommendationSummary
+
+    ReservationPurchaseRecommendations.member = Shapes::ShapeRef.new(shape: ReservationPurchaseRecommendation)
+
     ReservationUtilizationGroup.add_member(:key, Shapes::ShapeRef.new(shape: ReservationGroupKey, location_name: "Key"))
     ReservationUtilizationGroup.add_member(:value, Shapes::ShapeRef.new(shape: ReservationGroupValue, location_name: "Value"))
     ReservationUtilizationGroup.add_member(:attributes, Shapes::ShapeRef.new(shape: Attributes, location_name: "Attributes"))
@@ -242,6 +336,9 @@ module Aws::CostExplorer
 
     ResultsByTime.member = Shapes::ShapeRef.new(shape: ResultByTime)
 
+    ServiceSpecification.add_member(:ec2_specification, Shapes::ShapeRef.new(shape: EC2Specification, location_name: "EC2Specification"))
+    ServiceSpecification.struct_class = Types::ServiceSpecification
+
     TagList.member = Shapes::ShapeRef.new(shape: Entity)
 
     TagValues.add_member(:key, Shapes::ShapeRef.new(shape: TagKey, location_name: "Key"))
@@ -307,6 +404,17 @@ module Aws::CostExplorer
         o.errors << Shapes::ShapeRef.new(shape: InvalidNextTokenException)
       end)
 
+      api.add_operation(:get_reservation_purchase_recommendation, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "GetReservationPurchaseRecommendation"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: GetReservationPurchaseRecommendationRequest)
+        o.output = Shapes::ShapeRef.new(shape: GetReservationPurchaseRecommendationResponse)
+        o.errors << Shapes::ShapeRef.new(shape: LimitExceededException)
+        o.errors << Shapes::ShapeRef.new(shape: DataUnavailableException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidNextTokenException)
+      end)
+
       api.add_operation(:get_reservation_utilization, Seahorse::Model::Operation.new.tap do |o|
         o.name = "GetReservationUtilization"
         o.http_method = "POST"