WellArchitected / Client / list_agent_recommendation_items

list_agent_recommendation_items¶

WellArchitected.Client.list_agent_recommendation_items(**kwargs)¶

Lists recommendation items for a specific recommendation. Recommendation items provide detailed information about individual optimization opportunities.

Request Syntax

response = client.list_agent_recommendation_items(
    recommendationArn='string',
    type='AWS_RESOURCE'|'RECOMMENDATION',
    maxResults=123,
    nextToken='string'
)

Parameters:

recommendationArn (string) –
[REQUIRED]

The Amazon Resource Name (ARN) of the recommendation to list items for.
type (string) – Optional filter to return only recommendation items of the specified type.
maxResults (integer) – The maximum number of recommendation items to return in a single response.
nextToken (string) – A pagination token returned from a previous call to continue retrieving results.

Return type:

dict

Returns:

Response Syntax

{
    'items': [
        {
            'id': 'string',
            'recommendationArn': 'string',
            'type': 'AWS_RESOURCE'|'RECOMMENDATION',
            'metadata': {...}|[...]|123|123.4|'string'|True|None,
            'createdBy': 'string',
            'createdAt': datetime(2015, 1, 1),
            'lastModifiedBy': 'string',
            'lastModifiedAt': datetime(2015, 1, 1)
        },
    ],
    'nextToken': 'string'
}

Response Structure

(dict) –
- items (list) –
  
  A list of recommendation items with their detailed metadata and configuration information.
  - (dict) –
    
    Summary of an agent recommendation item, representing an Amazon Web Services resource or recommendation affected by the optimization recommendation.
    - id (string) –
      
      The unique identifier of the recommendation item.
    - recommendationArn (string) –
      
      The Amazon Resource Name (ARN) of the associated recommendation.
    - type (string) –
      
      The type of the recommendation item.
    - metadata (document) –
      
      Metadata containing a snapshot of the resource or recommendation at the time of generation.
    - createdBy (string) –
      
      The identifier of the user or system that created this recommendation item.
    - createdAt (datetime) –
      
      The timestamp when the recommendation item was created.
    - lastModifiedBy (string) –
      
      The identifier of the user or system that last modified this recommendation item.
    - lastModifiedAt (datetime) –
      
      The timestamp when the recommendation item was last modified.
- nextToken (string) –
  
  A pagination token to retrieve the next set of results, if available.

Exceptions

WellArchitected.Client.exceptions.AccessDeniedException
WellArchitected.Client.exceptions.ValidationException
WellArchitected.Client.exceptions.InternalServerException
WellArchitected.Client.exceptions.ResourceNotFoundException
WellArchitected.Client.exceptions.ThrottlingException