GetOrganizationRecommendation - AWS Trusted Advisor


Get a specific recommendation within an AWS Organizations organization. This API supports only prioritized recommendations and provides global priority recommendations, eliminating the need to call the API in each AWS Region.

Request Syntax

GET /v1/organization-recommendations/organizationRecommendationIdentifier HTTP/1.1

URI Request Parameters

The request uses the following URI parameters.


The Recommendation identifier

Length Constraints: Minimum length of 20. Maximum length of 200.

Pattern: ^arn:[\w-]+:trustedadvisor:::organization-recommendation\/[\w-]+$

Required: Yes

Request Body

The request does not have a request body.

Response Syntax

HTTP/1.1 200 Content-type: application/json { "organizationRecommendation": { "arn": "string", "awsServices": [ "string" ], "checkArn": "string", "createdAt": "string", "createdBy": "string", "description": "string", "id": "string", "lastUpdatedAt": "string", "lifecycleStage": "string", "name": "string", "pillars": [ "string" ], "pillarSpecificAggregates": { "costOptimizing": { "estimatedMonthlySavings": number, "estimatedPercentMonthlySavings": number } }, "resolvedAt": "string", "resourcesAggregates": { "errorCount": number, "okCount": number, "warningCount": number }, "source": "string", "status": "string", "type": "string", "updatedOnBehalfOf": "string", "updatedOnBehalfOfJobTitle": "string", "updateReason": "string", "updateReasonCode": "string" } }

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.


The Recommendation

Type: OrganizationRecommendation object


For information about the errors that are common to all actions, see Common Errors.


Exception that access has been denied due to insufficient access

HTTP Status Code: 403


Exception to notify that an unexpected internal error occurred during processing of the request

HTTP Status Code: 500


Exception that the requested resource has not been found

HTTP Status Code: 404


Exception to notify that requests are being throttled

HTTP Status Code: 429


Exception that the request failed to satisfy service constraints

HTTP Status Code: 400


Get Organization Recommendation

Get an organization recommendation by identifier.

Sample Request

{ "organizationRecommendationIdentifier": "arn:aws:trustedadvisor:::organization-recommendation/9534ec9b-bf3a-44e8-8213-2ed68b39d9d5" }

Sample Response

{ "organizationRecommendation": { "arn": "arn:aws:trustedadvisor:::organization-recommendation/9534ec9b-bf3a-44e8-8213-2ed68b39d9d5", "name": "Lambda Runtime Deprecation Warning", "description": "One or more lambdas are using a deprecated runtime", "awsServices": [ "lambda" ], "checkArn": "arn:aws:trustedadvisor:::check/L4dfs2Q4C5", "id": "9534ec9b-bf3a-44e8-8213-2ed68b39d9d5", "lifecycleStage": "resolved", "pillars": [ "security" ], "resourcesAggregates": { "errorCount": 0, "okCount": 0, "warningCount": 0 }, "source": "ta_check", "status": "warning", "type": "priority" } }

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: