Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-14813890.8 KB

Returns both the current and recommended resource configuration and the estimated cost impact for a recommendation.

The recommendationId is only valid for up to a maximum of 24 hours as recommendations are refreshed daily. To retrieve the recommendationId, use the ListRecommendations API.

post/#X-Amz-Target=CostOptimizationHubService.GetRecommendation

Headers

X-Amz-Target'CostOptimizationHubService.GetRecommendation' required

Request body

recommendationIdstring required

The ID for the recommendation.

Response

Success

recommendationIdstring

The ID for the recommendation.

resourceIdstring

The unique identifier for the resource. This is the same as the Amazon Resource Name (ARN), if available.

resourceArnstring

The Amazon Resource Name (ARN) of the resource.

accountIdstring

The account to which the recommendation applies.

currencyCodestring

The currency code used for the recommendation.

recommendationLookbackPeriodInDaysinteger

The lookback period that's used to generate the recommendation.

costCalculationLookbackPeriodInDaysinteger

The lookback period used to calculate cost impact for a recommendation.

estimatedSavingsPercentagenumber double

The estimated savings percentage relative to the total cost over the cost calculation lookback period.

estimatedSavingsOverCostCalculationLookbackPeriodnumber double

The estimated savings amount over the lookback period used to calculate cost impact for a recommendation.

currentResourceType'Ec2Instance' | 'LambdaFunction' | 'EbsVolume' | 'EcsService' | 'Ec2AutoScalingGroup' | 'Ec2InstanceSavingsPlans' | 'ComputeSavingsPlans' | 'SageMakerSavingsPlans' | 'Ec2ReservedInstances' | 'RdsReservedInstances' | 'OpenSearchReservedInstances' | 'RedshiftReservedInstances' | 'ElastiCacheReservedInstances' | 'RdsDbInstanceStorage' | 'RdsDbInstance' | 'AuroraDbClusterStorage' | 'DynamoDbReservedCapacity' | 'MemoryDbReservedInstances' | 'NatGateway' | 'DynamoDBTable' | 'ElastiCacheCluster' | 'MemoryDBCluster' | 'DocumentDBCluster' | 'WorkSpaces' | 'SageMakerEndpoint'

The type of resource.

recommendedResourceType'Ec2Instance' | 'LambdaFunction' | 'EbsVolume' | 'EcsService' | 'Ec2AutoScalingGroup' | 'Ec2InstanceSavingsPlans' | 'ComputeSavingsPlans' | 'SageMakerSavingsPlans' | 'Ec2ReservedInstances' | 'RdsReservedInstances' | 'OpenSearchReservedInstances' | 'RedshiftReservedInstances' | 'ElastiCacheReservedInstances' | 'RdsDbInstanceStorage' | 'RdsDbInstance' | 'AuroraDbClusterStorage' | 'DynamoDbReservedCapacity' | 'MemoryDbReservedInstances' | 'NatGateway' | 'DynamoDBTable' | 'ElastiCacheCluster' | 'MemoryDBCluster' | 'DocumentDBCluster' | 'WorkSpaces' | 'SageMakerEndpoint'

The resource type of the recommendation.

regionstring

The Amazon Web Services Region of the resource.

source'ComputeOptimizer' | 'CostExplorer'

The source of the recommendation.

lastRefreshTimestampstring date-time

The time when the recommendation was last generated.

estimatedMonthlySavingsnumber double

The estimated monthly savings amount for the recommendation.

estimatedMonthlyCostnumber double

The estimated monthly cost of the current resource. For Reserved Instances and Savings Plans, it refers to the cost for eligible usage.

implementationEffort'VeryLow' | 'Low' | 'Medium' | 'High' | 'VeryHigh'

The effort required to implement the recommendation.

restartNeededboolean

Whether or not implementing the recommendation requires a restart.

actionType'Rightsize' | 'Stop' | 'Upgrade' | 'PurchaseSavingsPlans' | 'PurchaseReservedInstances' | 'MigrateToGraviton' | 'Delete' | 'ScaleIn'

The type of action you can take by adopting the recommendation.

rollbackPossibleboolean

Whether or not implementing the recommendation can be rolled back.