organization_recommendation_accounts
Creates, updates, deletes, gets or lists an organization_recommendation_accounts resource.
Overview
| Name | organization_recommendation_accounts |
| Type | Resource |
| Id | aws.trustedadvisor.organization_recommendation_accounts |
Fields
The following fields are returned by SELECT queries:
- list_organization_recommendation_accounts
| Name | Datatype | Description |
|---|---|---|
account_id | string | The AWS account ID (pattern: <code>\d+</code>) |
account_recommendation_arn | string | The Recommendation ARN (pattern: <code>arn:[\w-]+:trustedadvisor::\d{12}:recommendation/[\w-]+</code>) |
last_updated_at | string (date-time) | When the Recommendation was last updated |
lifecycle_stage | string | The lifecycle stage from AWS Trusted Advisor Priority (in_progress, pending_response, dismissed, resolved) |
update_reason | string | Reason for the lifecycle stage change (pattern: <code>[\s\S]*</code>) |
update_reason_code | string | Reason code for the lifecycle state change (non_critical_account, temporary_account, valid_business_case, other_methods_available, low_priority, not_applicable, other) |
updated_on_behalf_of | string | The person on whose behalf a Technical Account Manager (TAM) updated the recommendation. This information is only available when a Technical Account Manager takes an action on a recommendation managed by AWS Trusted Advisor Priority |
updated_on_behalf_of_job_title | string | The job title of the person on whose behalf a Technical Account Manager (TAM) updated the recommendation. This information is only available when a Technical Account Manager takes an action on a recommendation managed by AWS Trusted Advisor Priority |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
list_organization_recommendation_accounts | select | organization_recommendation_identifier, region | nextToken, maxResults, affectedAccountId | Lists the accounts that own the resources for an organization aggregate recommendation. This API only supports prioritized recommendations and provides global priority recommendations, eliminating the need to call the API in each AWS Region. |
Parameters
Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.
| Name | Datatype | Description |
|---|---|---|
organization_recommendation_identifier | string | The Recommendation identifier |
region | string | AWS region (default: us-east-1) |
affectedAccountId | string | An account affected by this organization recommendation |
maxResults | integer | The maximum number of results to return per page. |
nextToken | string | The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results. |
SELECT examples
- list_organization_recommendation_accounts
Lists the accounts that own the resources for an organization aggregate recommendation. This API only supports prioritized recommendations and provides global priority recommendations, eliminating the need to call the API in each AWS Region.
SELECT
account_id,
account_recommendation_arn,
last_updated_at,
lifecycle_stage,
update_reason,
update_reason_code,
updated_on_behalf_of,
updated_on_behalf_of_job_title
FROM aws.trustedadvisor.organization_recommendation_accounts
WHERE organization_recommendation_identifier = '{{ organization_recommendation_identifier }}' -- required
AND region = '{{ region }}' -- required
AND nextToken = '{{ nextToken }}'
AND maxResults = '{{ maxResults }}'
AND affectedAccountId = '{{ affectedAccountId }}'
;