:doc:`TrustedAdvisorPublicAPI <../../trustedadvisor>` / Client / list_recommendations

********************
list_recommendations
********************



.. py:method:: TrustedAdvisorPublicAPI.Client.list_recommendations(**kwargs)

  

  List a filterable set of Recommendations

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/trustedadvisor-2022-09-15/ListRecommendations>`_  


  **Request Syntax**
  ::

    response = client.list_recommendations(
        afterLastUpdatedAt=datetime(2015, 1, 1),
        awsService='string',
        beforeLastUpdatedAt=datetime(2015, 1, 1),
        checkIdentifier='string',
        maxResults=123,
        nextToken='string',
        pillar='cost_optimizing'|'performance'|'security'|'service_limits'|'fault_tolerance'|'operational_excellence',
        source='aws_config'|'compute_optimizer'|'cost_explorer'|'lse'|'manual'|'pse'|'rds'|'resilience'|'resilience_hub'|'security_hub'|'stir'|'ta_check'|'well_architected',
        status='ok'|'warning'|'error',
        type='standard'|'priority'
    )
    
  :type afterLastUpdatedAt: datetime
  :param afterLastUpdatedAt: 

    After the last update of the Recommendation

    

  
  :type awsService: string
  :param awsService: 

    The aws service associated with the Recommendation

    

  
  :type beforeLastUpdatedAt: datetime
  :param beforeLastUpdatedAt: 

    Before the last update of the Recommendation

    

  
  :type checkIdentifier: string
  :param checkIdentifier: 

    The check identifier of the Recommendation

    

  
  :type maxResults: integer
  :param maxResults: 

    The maximum number of results to return per page.

    

  
  :type nextToken: string
  :param nextToken: 

    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.

    

  
  :type pillar: string
  :param pillar: 

    The pillar of the Recommendation

    

  
  :type source: string
  :param source: 

    The source of the Recommendation

    

  
  :type status: string
  :param status: 

    The status of the Recommendation

    

  
  :type type: string
  :param type: 

    The type of the Recommendation

    

  
  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {
          'nextToken': 'string',
          'recommendationSummaries': [
              {
                  'arn': 'string',
                  'awsServices': [
                      'string',
                  ],
                  'checkArn': 'string',
                  'createdAt': datetime(2015, 1, 1),
                  'id': 'string',
                  'lastUpdatedAt': datetime(2015, 1, 1),
                  'lifecycleStage': 'in_progress'|'pending_response'|'dismissed'|'resolved',
                  'name': 'string',
                  'pillarSpecificAggregates': {
                      'costOptimizing': {
                          'estimatedMonthlySavings': 123.0,
                          'estimatedPercentMonthlySavings': 123.0
                      }
                  },
                  'pillars': [
                      'cost_optimizing'|'performance'|'security'|'service_limits'|'fault_tolerance'|'operational_excellence',
                  ],
                  'resourcesAggregates': {
                      'errorCount': 123,
                      'okCount': 123,
                      'warningCount': 123
                  },
                  'source': 'aws_config'|'compute_optimizer'|'cost_explorer'|'lse'|'manual'|'pse'|'rds'|'resilience'|'resilience_hub'|'security_hub'|'stir'|'ta_check'|'well_architected',
                  'status': 'ok'|'warning'|'error',
                  'type': 'standard'|'priority'
              },
          ]
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **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.

        
      

      - **recommendationSummaries** *(list) --* 

        The list of Recommendations

        
        

        - *(dict) --* 

          Summary of Recommendation for an Account

          
          

          - **arn** *(string) --* 

            The ARN of the Recommendation

            
          

          - **awsServices** *(list) --* 

            The AWS Services that the Recommendation applies to

            
            

            - *(string) --* 
        
          

          - **checkArn** *(string) --* 

            The AWS Trusted Advisor Check ARN that relates to the Recommendation

            
          

          - **createdAt** *(datetime) --* 

            When the Recommendation was created, if created by AWS Trusted Advisor Priority

            
          

          - **id** *(string) --* 

            The ID which identifies where the Recommendation was produced

            
          

          - **lastUpdatedAt** *(datetime) --* 

            When the Recommendation was last updated

            
          

          - **lifecycleStage** *(string) --* 

            The lifecycle stage from AWS Trusted Advisor Priority

            
          

          - **name** *(string) --* 

            The name of the AWS Trusted Advisor Recommendation

            
          

          - **pillarSpecificAggregates** *(dict) --* 

            The pillar aggregations for cost savings

            
            

            - **costOptimizing** *(dict) --* 

              Cost optimizing aggregates

              
              

              - **estimatedMonthlySavings** *(float) --* 

                The estimated monthly savings

                
              

              - **estimatedPercentMonthlySavings** *(float) --* 

                The estimated percently monthly savings

                
          
        
          

          - **pillars** *(list) --* 

            The Pillars that the Recommendation is optimizing

            
            

            - *(string) --* 
        
          

          - **resourcesAggregates** *(dict) --* 

            An aggregation of all resources

            
            

            - **errorCount** *(integer) --* 

              The number of AWS resources that were flagged to have errors according to the Trusted Advisor check

              
            

            - **okCount** *(integer) --* 

              The number of AWS resources that were flagged to be OK according to the Trusted Advisor check

              
            

            - **warningCount** *(integer) --* 

              The number of AWS resources that were flagged to have warning according to the Trusted Advisor check

              
        
          

          - **source** *(string) --* 

            The source of the Recommendation

            
          

          - **status** *(string) --* 

            The status of the Recommendation

            
          

          - **type** *(string) --* 

            Whether the Recommendation was automated or generated by AWS Trusted Advisor Priority

            
      
    
  
  **Exceptions**
  
  *   :py:class:`TrustedAdvisorPublicAPI.Client.exceptions.AccessDeniedException`

  
  *   :py:class:`TrustedAdvisorPublicAPI.Client.exceptions.InternalServerException`

  
  *   :py:class:`TrustedAdvisorPublicAPI.Client.exceptions.ValidationException`

  
  *   :py:class:`TrustedAdvisorPublicAPI.Client.exceptions.ThrottlingException`

  