CostExplorer / Client / get_reservation_purchase_recommendation

get_reservation_purchase_recommendation#

CostExplorer.Client.get_reservation_purchase_recommendation(**kwargs)#

Gets recommendations for reservation purchases. These recommendations might help you to reduce your costs. Reservations provide a discounted hourly rate (up to 75%) compared to On-Demand pricing.

Amazon Web Services 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 Amazon Web Services has these categories, it simulates every combination of reservations in each category of usage to identify the best number of each type of Reserved Instance (RI) to purchase to maximize your estimated savings.

For example, Amazon Web Services automatically aggregates your Amazon 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. Amazon Web Services recommends the smallest size instance in an instance family. This makes it easier to purchase a size-flexible Reserved Instance (RI). Amazon Web Services also shows the equal number of normalized units. This way, you can purchase any instance size that you want. For this example, your RI recommendation is for c4.large because that is the smallest size instance in the c4 instance family.

Request Syntax

response = client.get_reservation_purchase_recommendation(
    AccountId='string',
    Service='string',
    Filter={
        'Or': [
            {'... recursive ...'},
        ],
        'And': [
            {'... recursive ...'},
        ],
        'Not': {'... recursive ...'},
        'Dimensions': {
            'Key': 'AZ'|'INSTANCE_TYPE'|'LINKED_ACCOUNT'|'LINKED_ACCOUNT_NAME'|'OPERATION'|'PURCHASE_TYPE'|'REGION'|'SERVICE'|'SERVICE_CODE'|'USAGE_TYPE'|'USAGE_TYPE_GROUP'|'RECORD_TYPE'|'OPERATING_SYSTEM'|'TENANCY'|'SCOPE'|'PLATFORM'|'SUBSCRIPTION_ID'|'LEGAL_ENTITY_NAME'|'DEPLOYMENT_OPTION'|'DATABASE_ENGINE'|'CACHE_ENGINE'|'INSTANCE_TYPE_FAMILY'|'BILLING_ENTITY'|'RESERVATION_ID'|'RESOURCE_ID'|'RIGHTSIZING_TYPE'|'SAVINGS_PLANS_TYPE'|'SAVINGS_PLAN_ARN'|'PAYMENT_OPTION'|'AGREEMENT_END_DATE_TIME_AFTER'|'AGREEMENT_END_DATE_TIME_BEFORE'|'INVOICING_ENTITY'|'ANOMALY_TOTAL_IMPACT_ABSOLUTE'|'ANOMALY_TOTAL_IMPACT_PERCENTAGE',
            'Values': [
                'string',
            ],
            'MatchOptions': [
                'EQUALS'|'ABSENT'|'STARTS_WITH'|'ENDS_WITH'|'CONTAINS'|'CASE_SENSITIVE'|'CASE_INSENSITIVE'|'GREATER_THAN_OR_EQUAL',
            ]
        },
        'Tags': {
            'Key': 'string',
            'Values': [
                'string',
            ],
            'MatchOptions': [
                'EQUALS'|'ABSENT'|'STARTS_WITH'|'ENDS_WITH'|'CONTAINS'|'CASE_SENSITIVE'|'CASE_INSENSITIVE'|'GREATER_THAN_OR_EQUAL',
            ]
        },
        'CostCategories': {
            'Key': 'string',
            'Values': [
                'string',
            ],
            'MatchOptions': [
                'EQUALS'|'ABSENT'|'STARTS_WITH'|'ENDS_WITH'|'CONTAINS'|'CASE_SENSITIVE'|'CASE_INSENSITIVE'|'GREATER_THAN_OR_EQUAL',
            ]
        }
    },
    AccountScope='PAYER'|'LINKED',
    LookbackPeriodInDays='SEVEN_DAYS'|'THIRTY_DAYS'|'SIXTY_DAYS',
    TermInYears='ONE_YEAR'|'THREE_YEARS',
    PaymentOption='NO_UPFRONT'|'PARTIAL_UPFRONT'|'ALL_UPFRONT'|'LIGHT_UTILIZATION'|'MEDIUM_UTILIZATION'|'HEAVY_UTILIZATION',
    ServiceSpecification={
        'EC2Specification': {
            'OfferingClass': 'STANDARD'|'CONVERTIBLE'
        }
    },
    PageSize=123,
    NextPageToken='string'
)

Parameters:

AccountId (string) – The account ID that’s associated with the recommendation.
Service (string) –
[REQUIRED]

The specific service that you want recommendations for.
Filter (dict) –
Use Expression to filter in various Cost Explorer APIs.

Not all Expression types are supported in each API. Refer to the documentation for each specific API to see what is supported.

There are two patterns:
- Simple dimension values.
  - There are three types of simple dimension values: CostCategories, Tags, and Dimensions.
    - Specify the CostCategories field to define a filter that acts on Cost Categories.
    - Specify the Tags field to define a filter that acts on Cost Allocation Tags.
    - Specify the Dimensions field to define a filter that acts on the DimensionValues.
  - For each filter type, you can set the dimension name and values for the filters that you plan to use.
    - For example, you can filter for REGION==us-east-1 OR REGION==us-west-1. For GetRightsizingRecommendation, the Region is a full name (for example, REGION==US East (N. Virginia).
    - The corresponding Expression for this example is as follows: { "Dimensions": { "Key": "REGION", "Values": [ "us-east-1", “us-west-1” ] } }
    - As shown in the previous example, lists of dimension values are combined with OR when applying the filter.
  - You can also set different match options to further control how the filter behaves. Not all APIs support match options. Refer to the documentation for each specific API to see what is supported.
    - For example, you can filter for linked account names that start with “a”.
    - The corresponding Expression for this example is as follows: { "Dimensions": { "Key": "LINKED_ACCOUNT_NAME", "MatchOptions": [ "STARTS_WITH" ], "Values": [ "a" ] } }
- Compound Expression types with logical operations.
  - You can use multiple Expression types and the logical operators AND/OR/NOT to create a list of one or more Expression objects. By doing this, you can filter by more advanced options.
  - For example, you can filter by ((REGION == us-east-1 OR REGION == us-west-1) OR (TAG.Type == Type1)) AND (USAGE_TYPE != DataTransfer).
  - The corresponding Expression for this example is as follows: { "And": [ {"Or": [ {"Dimensions": { "Key": "REGION", "Values": [ "us-east-1", "us-west-1" ] }}, {"Tags": { "Key": "TagName", "Values": ["Value1"] } } ]}, {"Not": {"Dimensions": { "Key": "USAGE_TYPE", "Values": ["DataTransfer"] }}} ] }
Note
Because each Expression can have only one operator, the service returns an error if more than one is specified. The following example shows an Expression object that creates an error: { "And": [ ... ], "Dimensions": { "Key": "USAGE_TYPE", "Values": [ "DataTransfer" ] } }

The following is an example of the corresponding error message: "Expression has more than one roots. Only one root operator is allowed for each expression: And, Or, Not, Dimensions, Tags, CostCategories"

Note
For the GetRightsizingRecommendation action, a combination of OR and NOT isn’t supported. OR isn’t supported between different dimensions, or dimensions and tags. NOT operators aren’t supported. Dimensions are also limited to LINKED_ACCOUNT, REGION, or RIGHTSIZING_TYPE.

For the GetReservationPurchaseRecommendation action, only NOT is supported. AND and OR aren’t supported. Dimensions are limited to LINKED_ACCOUNT.
- Or (list) –
  
  Return results that match either Dimension object.
  - (dict) –
    
    Use Expression to filter in various Cost Explorer APIs.
    
    Not all Expression types are supported in each API. Refer to the documentation for each specific API to see what is supported.
    
    There are two patterns:
    - Simple dimension values.
      - There are three types of simple dimension values: CostCategories, Tags, and Dimensions.
        
        Specify the CostCategories field to define a filter that acts on Cost Categories.
        
        Specify the Tags field to define a filter that acts on Cost Allocation Tags.
        
        Specify the Dimensions field to define a filter that acts on the DimensionValues.
      - For each filter type, you can set the dimension name and values for the filters that you plan to use.
        
        For example, you can filter for REGION==us-east-1 OR REGION==us-west-1. For GetRightsizingRecommendation, the Region is a full name (for example, REGION==US East (N. Virginia).
        
        The corresponding Expression for this example is as follows: { "Dimensions": { "Key": "REGION", "Values": [ "us-east-1", “us-west-1” ] } }
        
        As shown in the previous example, lists of dimension values are combined with OR when applying the filter.
      - You can also set different match options to further control how the filter behaves. Not all APIs support match options. Refer to the documentation for each specific API to see what is supported.
        
        For example, you can filter for linked account names that start with “a”.
        
        The corresponding Expression for this example is as follows: { "Dimensions": { "Key": "LINKED_ACCOUNT_NAME", "MatchOptions": [ "STARTS_WITH" ], "Values": [ "a" ] } }
    - Compound Expression types with logical operations.
      - You can use multiple Expression types and the logical operators AND/OR/NOT to create a list of one or more Expression objects. By doing this, you can filter by more advanced options.
      - For example, you can filter by ((REGION == us-east-1 OR REGION == us-west-1) OR (TAG.Type == Type1)) AND (USAGE_TYPE != DataTransfer).
      - The corresponding Expression for this example is as follows: { "And": [ {"Or": [ {"Dimensions": { "Key": "REGION", "Values": [ "us-east-1", "us-west-1" ] }}, {"Tags": { "Key": "TagName", "Values": ["Value1"] } } ]}, {"Not": {"Dimensions": { "Key": "USAGE_TYPE", "Values": ["DataTransfer"] }}} ] }
    Note
    Because each Expression can have only one operator, the service returns an error if more than one is specified. The following example shows an Expression object that creates an error: { "And": [ ... ], "Dimensions": { "Key": "USAGE_TYPE", "Values": [ "DataTransfer" ] } }
    
    The following is an example of the corresponding error message: "Expression has more than one roots. Only one root operator is allowed for each expression: And, Or, Not, Dimensions, Tags, CostCategories"
    
    Note
    For the GetRightsizingRecommendation action, a combination of OR and NOT isn’t supported. OR isn’t supported between different dimensions, or dimensions and tags. NOT operators aren’t supported. Dimensions are also limited to LINKED_ACCOUNT, REGION, or RIGHTSIZING_TYPE.
    
    For the GetReservationPurchaseRecommendation action, only NOT is supported. AND and OR aren’t supported. Dimensions are limited to LINKED_ACCOUNT.
- And (list) –
  
  Return results that match both Dimension objects.
  - (dict) –
    
    Use Expression to filter in various Cost Explorer APIs.
    
    Not all Expression types are supported in each API. Refer to the documentation for each specific API to see what is supported.
    
    There are two patterns:
    - Simple dimension values.
      - There are three types of simple dimension values: CostCategories, Tags, and Dimensions.
        
        Specify the CostCategories field to define a filter that acts on Cost Categories.
        
        Specify the Tags field to define a filter that acts on Cost Allocation Tags.
        
        Specify the Dimensions field to define a filter that acts on the DimensionValues.
      - For each filter type, you can set the dimension name and values for the filters that you plan to use.
        
        For example, you can filter for REGION==us-east-1 OR REGION==us-west-1. For GetRightsizingRecommendation, the Region is a full name (for example, REGION==US East (N. Virginia).
        
        The corresponding Expression for this example is as follows: { "Dimensions": { "Key": "REGION", "Values": [ "us-east-1", “us-west-1” ] } }
        
        As shown in the previous example, lists of dimension values are combined with OR when applying the filter.
      - You can also set different match options to further control how the filter behaves. Not all APIs support match options. Refer to the documentation for each specific API to see what is supported.
        
        For example, you can filter for linked account names that start with “a”.
        
        The corresponding Expression for this example is as follows: { "Dimensions": { "Key": "LINKED_ACCOUNT_NAME", "MatchOptions": [ "STARTS_WITH" ], "Values": [ "a" ] } }
    - Compound Expression types with logical operations.
      - You can use multiple Expression types and the logical operators AND/OR/NOT to create a list of one or more Expression objects. By doing this, you can filter by more advanced options.
      - For example, you can filter by ((REGION == us-east-1 OR REGION == us-west-1) OR (TAG.Type == Type1)) AND (USAGE_TYPE != DataTransfer).
      - The corresponding Expression for this example is as follows: { "And": [ {"Or": [ {"Dimensions": { "Key": "REGION", "Values": [ "us-east-1", "us-west-1" ] }}, {"Tags": { "Key": "TagName", "Values": ["Value1"] } } ]}, {"Not": {"Dimensions": { "Key": "USAGE_TYPE", "Values": ["DataTransfer"] }}} ] }
    Note
    Because each Expression can have only one operator, the service returns an error if more than one is specified. The following example shows an Expression object that creates an error: { "And": [ ... ], "Dimensions": { "Key": "USAGE_TYPE", "Values": [ "DataTransfer" ] } }
    
    The following is an example of the corresponding error message: "Expression has more than one roots. Only one root operator is allowed for each expression: And, Or, Not, Dimensions, Tags, CostCategories"
    
    Note
    For the GetRightsizingRecommendation action, a combination of OR and NOT isn’t supported. OR isn’t supported between different dimensions, or dimensions and tags. NOT operators aren’t supported. Dimensions are also limited to LINKED_ACCOUNT, REGION, or RIGHTSIZING_TYPE.
    
    For the GetReservationPurchaseRecommendation action, only NOT is supported. AND and OR aren’t supported. Dimensions are limited to LINKED_ACCOUNT.
- Not (dict) –
  
  Return results that don’t match a Dimension object.
- Dimensions (dict) –
  
  The specific Dimension to use for Expression.
  - Key (string) –
    
    The names of the metadata types that you can use to filter and group your results. For example, AZ returns a list of Availability Zones.
    
    Not all dimensions are supported in each API. Refer to the documentation for each specific API to see what is supported.
    
    LINK_ACCOUNT_NAME and SERVICE_CODE can only be used in CostCategoryRule.
    
    ANOMALY_TOTAL_IMPACT_ABSOLUTE and ANOMALY_TOTAL_IMPACT_PERCENTAGE can only be used in AnomalySubscriptions.
  - Values (list) –
    
    The metadata values that you can use to filter and group your results. You can use GetDimensionValues to find specific values.
    - (string) –
  - MatchOptions (list) –
    
    The match options that you can use to filter your results.
    
    MatchOptions is only applicable for actions related to Cost Category and Anomaly Subscriptions. Refer to the documentation for each specific API to see what is supported.
    
    The default values for MatchOptions are EQUALS and CASE_SENSITIVE.
    - (string) –
- Tags (dict) –
  
  The specific Tag to use for Expression.
  - Key (string) –
    
    The key for the tag.
  - Values (list) –
    
    The specific value of the tag.
    - (string) –
  - MatchOptions (list) –
    
    The match options that you can use to filter your results. MatchOptions is only applicable for actions related to Cost Category. The default values for MatchOptions are EQUALS and CASE_SENSITIVE.
    - (string) –
- CostCategories (dict) –
  
  The filter that’s based on CostCategory values.
  - Key (string) –
    
    The unique name of the Cost Category.
  - Values (list) –
    
    The specific value of the Cost Category.
    - (string) –
  - MatchOptions (list) –
    
    The match options that you can use to filter your results. MatchOptions is only applicable for actions related to cost category. The default values for MatchOptions is EQUALS and CASE_SENSITIVE.
    - (string) –
AccountScope (string) – 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.
LookbackPeriodInDays (string) – The number of previous days that you want Amazon Web Services to consider when it calculates your recommendations.
TermInYears (string) – The reservation term that you want recommendations for.
PaymentOption (string) – The reservation purchase option that you want recommendations for.
ServiceSpecification (dict) –
The hardware specifications for the service instances that you want recommendations for, such as standard or convertible Amazon EC2 instances.
- EC2Specification (dict) –
  
  The Amazon EC2 hardware specifications that you want Amazon Web Services to provide recommendations for.
  - OfferingClass (string) –
    
    Indicates whether you want a recommendation for standard or convertible reservations.
PageSize (integer) – The number of recommendations that you want returned in a single response object.
NextPageToken (string) – The pagination token that indicates the next set of results that you want to retrieve.

Return type:

dict

Returns:

Response Syntax

{
    'Metadata': {
        'RecommendationId': 'string',
        'GenerationTimestamp': 'string'
    },
    'Recommendations': [
        {
            'AccountScope': 'PAYER'|'LINKED',
            'LookbackPeriodInDays': 'SEVEN_DAYS'|'THIRTY_DAYS'|'SIXTY_DAYS',
            'TermInYears': 'ONE_YEAR'|'THREE_YEARS',
            'PaymentOption': 'NO_UPFRONT'|'PARTIAL_UPFRONT'|'ALL_UPFRONT'|'LIGHT_UTILIZATION'|'MEDIUM_UTILIZATION'|'HEAVY_UTILIZATION',
            'ServiceSpecification': {
                'EC2Specification': {
                    'OfferingClass': 'STANDARD'|'CONVERTIBLE'
                }
            },
            'RecommendationDetails': [
                {
                    'AccountId': 'string',
                    'InstanceDetails': {
                        'EC2InstanceDetails': {
                            'Family': 'string',
                            'InstanceType': 'string',
                            'Region': 'string',
                            'AvailabilityZone': 'string',
                            'Platform': 'string',
                            'Tenancy': 'string',
                            'CurrentGeneration': True|False,
                            'SizeFlexEligible': True|False
                        },
                        'RDSInstanceDetails': {
                            'Family': 'string',
                            'InstanceType': 'string',
                            'Region': 'string',
                            'DatabaseEngine': 'string',
                            'DatabaseEdition': 'string',
                            'DeploymentOption': 'string',
                            'LicenseModel': 'string',
                            'CurrentGeneration': True|False,
                            'SizeFlexEligible': True|False
                        },
                        'RedshiftInstanceDetails': {
                            'Family': 'string',
                            'NodeType': 'string',
                            'Region': 'string',
                            'CurrentGeneration': True|False,
                            'SizeFlexEligible': True|False
                        },
                        'ElastiCacheInstanceDetails': {
                            'Family': 'string',
                            'NodeType': 'string',
                            'Region': 'string',
                            'ProductDescription': 'string',
                            'CurrentGeneration': True|False,
                            'SizeFlexEligible': True|False
                        },
                        'ESInstanceDetails': {
                            'InstanceClass': 'string',
                            'InstanceSize': 'string',
                            'Region': 'string',
                            'CurrentGeneration': True|False,
                            'SizeFlexEligible': True|False
                        }
                    },
                    'RecommendedNumberOfInstancesToPurchase': 'string',
                    'RecommendedNormalizedUnitsToPurchase': 'string',
                    'MinimumNumberOfInstancesUsedPerHour': 'string',
                    'MinimumNormalizedUnitsUsedPerHour': 'string',
                    'MaximumNumberOfInstancesUsedPerHour': 'string',
                    'MaximumNormalizedUnitsUsedPerHour': 'string',
                    'AverageNumberOfInstancesUsedPerHour': 'string',
                    'AverageNormalizedUnitsUsedPerHour': 'string',
                    'AverageUtilization': 'string',
                    'EstimatedBreakEvenInMonths': 'string',
                    'CurrencyCode': 'string',
                    'EstimatedMonthlySavingsAmount': 'string',
                    'EstimatedMonthlySavingsPercentage': 'string',
                    'EstimatedMonthlyOnDemandCost': 'string',
                    'EstimatedReservationCostForLookbackPeriod': 'string',
                    'UpfrontCost': 'string',
                    'RecurringStandardMonthlyCost': 'string'
                },
            ],
            'RecommendationSummary': {
                'TotalEstimatedMonthlySavingsAmount': 'string',
                'TotalEstimatedMonthlySavingsPercentage': 'string',
                'CurrencyCode': 'string'
            }
        },
    ],
    'NextPageToken': 'string'
}

Response Structure

(dict) –
- Metadata (dict) –
  
  Information about this specific recommendation call, such as the time stamp for when Cost Explorer generated this recommendation.
  - RecommendationId (string) –
    
    The ID for this specific recommendation.
  - GenerationTimestamp (string) –
    
    The timestamp for when Amazon Web Services made this recommendation.
- Recommendations (list) –
  
  Recommendations for reservations to purchase.
  - (dict) –
    
    A specific reservation that Amazon Web Services recommends for purchase.
    - AccountScope (string) –
      
      The account scope that Amazon Web Services recommends that you purchase this instance for. For example, you can purchase this reservation for an entire organization in Amazon Web Services Organizations.
    - LookbackPeriodInDays (string) –
      
      How many days of previous usage that Amazon Web Services considers when making this recommendation.
    - TermInYears (string) –
      
      The term of the reservation that you want recommendations for, in years.
    - PaymentOption (string) –
      
      The payment option for the reservation (for example, AllUpfront or NoUpfront).
    - ServiceSpecification (dict) –
      
      Hardware specifications for the service that you want recommendations for.
      - EC2Specification (dict) –
        
        The Amazon EC2 hardware specifications that you want Amazon Web Services to provide recommendations for.
        
        OfferingClass (string) –
        
        Indicates whether you want a recommendation for standard or convertible reservations.
    - RecommendationDetails (list) –
      
      Details about the recommended purchases.
      - (dict) –
        
        Details about your recommended reservation purchase.
        
        AccountId (string) –
        
        The account that this Reserved Instance (RI) recommendation is for.
        
        InstanceDetails (dict) –
        
        Details about the instances that Amazon Web Services recommends that you purchase.
        
        EC2InstanceDetails (dict) –
        
        The Amazon EC2 instances that Amazon Web Services recommends that you purchase.
        
        Family (string) –
        
        The instance family of the recommended reservation.
        
        InstanceType (string) –
        
        The type of instance that Amazon Web Services recommends.
        
        Region (string) –
        
        The Amazon Web Services Region of the recommended reservation.
        
        AvailabilityZone (string) –
        
        The Availability Zone of the recommended reservation.
        
        Platform (string) –
        
        The platform of the recommended reservation. The platform is the specific combination of operating system, license model, and software on an instance.
        
        Tenancy (string) –
        
        Determines whether the recommended reservation is dedicated or shared.
        
        CurrentGeneration (boolean) –
        
        Determines whether the recommendation is for a current-generation instance.
        
        SizeFlexEligible (boolean) –
        
        Determines whether the recommended reservation is size flexible.
        
        RDSInstanceDetails (dict) –
        
        The Amazon RDS instances that Amazon Web Services recommends that you purchase.
        
        Family (string) –
        
        The instance family of the recommended reservation.
        
        InstanceType (string) –
        
        The type of instance that Amazon Web Services recommends.
        
        Region (string) –
        
        The Amazon Web Services Region of the recommended reservation.
        
        DatabaseEngine (string) –
        
        The database engine that the recommended reservation supports.
        
        DatabaseEdition (string) –
        
        The database edition that the recommended reservation supports.
        
        DeploymentOption (string) –
        
        Determines whether the recommendation is for a reservation in a single Availability Zone or a reservation with a backup in a second Availability Zone.
        
        LicenseModel (string) –
        
        The license model that the recommended reservation supports.
        
        CurrentGeneration (boolean) –
        
        Determines whether the recommendation is for a current-generation instance.
        
        SizeFlexEligible (boolean) –
        
        Determines whether the recommended reservation is size flexible.
        
        RedshiftInstanceDetails (dict) –
        
        The Amazon Redshift instances that Amazon Web Services recommends that you purchase.
        
        Family (string) –
        
        The instance family of the recommended reservation.
        
        NodeType (string) –
        
        The type of node that Amazon Web Services recommends.
        
        Region (string) –
        
        The Amazon Web Services Region of the recommended reservation.
        
        CurrentGeneration (boolean) –
        
        Determines whether the recommendation is for a current-generation instance.
        
        SizeFlexEligible (boolean) –
        
        Determines whether the recommended reservation is size flexible.
        
        ElastiCacheInstanceDetails (dict) –
        
        The ElastiCache instances that Amazon Web Services recommends that you purchase.
        
        Family (string) –
        
        The instance family of the recommended reservation.
        
        NodeType (string) –
        
        The type of node that Amazon Web Services recommends.
        
        Region (string) –
        
        The Amazon Web Services Region of the recommended reservation.
        
        ProductDescription (string) –
        
        The description of the recommended reservation.
        
        CurrentGeneration (boolean) –
        
        Determines whether the recommendation is for a current generation instance.
        
        SizeFlexEligible (boolean) –
        
        Determines whether the recommended reservation is size flexible.
        
        ESInstanceDetails (dict) –
        
        The Amazon OpenSearch Service instances that Amazon Web Services recommends that you purchase.
        
        InstanceClass (string) –
        
        The class of instance that Amazon Web Services recommends.
        
        InstanceSize (string) –
        
        The size of instance that Amazon Web Services recommends.
        
        Region (string) –
        
        The Amazon Web Services Region of the recommended reservation.
        
        CurrentGeneration (boolean) –
        
        Determines whether the recommendation is for a current-generation instance.
        
        SizeFlexEligible (boolean) –
        
        Determines whether the recommended reservation is size flexible.
        
        RecommendedNumberOfInstancesToPurchase (string) –
        
        The number of instances that Amazon Web Services recommends that you purchase.
        
        RecommendedNormalizedUnitsToPurchase (string) –
        
        The number of normalized units that Amazon Web Services recommends that you purchase.
        
        MinimumNumberOfInstancesUsedPerHour (string) –
        
        The minimum number of instances that you used in an hour during the historical period. Amazon Web Services uses this to calculate your recommended reservation purchases.
        
        MinimumNormalizedUnitsUsedPerHour (string) –
        
        The minimum number of normalized units that you used in an hour during the historical period. Amazon Web Services uses this to calculate your recommended reservation purchases.
        
        MaximumNumberOfInstancesUsedPerHour (string) –
        
        The maximum number of instances that you used in an hour during the historical period. Amazon Web Services uses this to calculate your recommended reservation purchases.
        
        MaximumNormalizedUnitsUsedPerHour (string) –
        
        The maximum number of normalized units that you used in an hour during the historical period. Amazon Web Services uses this to calculate your recommended reservation purchases.
        
        AverageNumberOfInstancesUsedPerHour (string) –
        
        The average number of instances that you used in an hour during the historical period. Amazon Web Services uses this to calculate your recommended reservation purchases.
        
        AverageNormalizedUnitsUsedPerHour (string) –
        
        The average number of normalized units that you used in an hour during the historical period. Amazon Web Services uses this to calculate your recommended reservation purchases.
        
        AverageUtilization (string) –
        
        The average utilization of your instances. Amazon Web Services uses this to calculate your recommended reservation purchases.
        
        EstimatedBreakEvenInMonths (string) –
        
        How long Amazon Web Services estimates that it takes for this instance to start saving you money, in months.
        
        CurrencyCode (string) –
        
        The currency code that Amazon Web Services used to calculate the costs for this instance.
        
        EstimatedMonthlySavingsAmount (string) –
        
        How much Amazon Web Services estimates that this specific recommendation might save you in a month.
        
        EstimatedMonthlySavingsPercentage (string) –
        
        How much Amazon Web Services estimates that this specific recommendation might save you in a month, as a percentage of your overall costs.
        
        EstimatedMonthlyOnDemandCost (string) –
        
        How much Amazon Web Services estimates that you spend on On-Demand Instances in a month.
        
        EstimatedReservationCostForLookbackPeriod (string) –
        
        How much Amazon Web Services estimates that you might spend for all usage during the specified historical period if you had a reservation.
        
        UpfrontCost (string) –
        
        How much purchasing this instance costs you upfront.
        
        RecurringStandardMonthlyCost (string) –
        
        How much purchasing this instance costs you on a monthly basis.
    - RecommendationSummary (dict) –
      
      A summary about the recommended purchase.
      - TotalEstimatedMonthlySavingsAmount (string) –
        
        The total amount that Amazon Web Services estimates that this recommendation could save you in a month.
      - TotalEstimatedMonthlySavingsPercentage (string) –
        
        The total amount that Amazon Web Services estimates that this recommendation could save you in a month, as a percentage of your costs.
      - CurrencyCode (string) –
        
        The currency code used for this recommendation.
- NextPageToken (string) –
  
  The pagination token for the next set of retrievable results.

Exceptions

CostExplorer.Client.exceptions.LimitExceededException
CostExplorer.Client.exceptions.DataUnavailableException
CostExplorer.Client.exceptions.InvalidNextTokenException