Redshift / Paginator / ListRecommendations

ListRecommendations#

class Redshift.Paginator.ListRecommendations#
paginator = client.get_paginator('list_recommendations')
paginate(**kwargs)#

Creates an iterator that will paginate through responses from Redshift.Client.list_recommendations().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    ClusterIdentifier='string',
    NamespaceArn='string',
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)
Parameters:
  • ClusterIdentifier (string) – The unique identifier of the Amazon Redshift cluster for which the list of Advisor recommendations is returned. If the neither the cluster identifier and the cluster namespace ARN parameters are specified, then recommendations for all clusters in the account are returned.

  • NamespaceArn (string) – The Amazon Redshift cluster namespace Amazon Resource Name (ARN) for which the list of Advisor recommendations is returned. If the neither the cluster identifier and the cluster namespace ARN parameters are specified, then recommendations for all clusters in the account are returned.

  • PaginationConfig (dict) –

    A dictionary that provides parameters to control pagination.

    • MaxItems (integer) –

      The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.

    • PageSize (integer) –

      The size of each page.

    • StartingToken (string) –

      A token to specify where to start paginating. This is the NextToken from a previous response.

Return type:

dict

Returns:

Response Syntax

{
    'Recommendations': [
        {
            'Id': 'string',
            'ClusterIdentifier': 'string',
            'NamespaceArn': 'string',
            'CreatedAt': datetime(2015, 1, 1),
            'RecommendationType': 'string',
            'Title': 'string',
            'Description': 'string',
            'Observation': 'string',
            'ImpactRanking': 'HIGH'|'MEDIUM'|'LOW',
            'RecommendationText': 'string',
            'RecommendedActions': [
                {
                    'Text': 'string',
                    'Database': 'string',
                    'Command': 'string',
                    'Type': 'SQL'|'CLI'
                },
            ],
            'ReferenceLinks': [
                {
                    'Text': 'string',
                    'Link': 'string'
                },
            ]
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) –

    • Recommendations (list) –

      The Advisor recommendations for action on the Amazon Redshift cluster.

      • (dict) –

        An Amazon Redshift Advisor recommended action on the Amazon Redshift cluster.

        • Id (string) –

          A unique identifier of the Advisor recommendation.

        • ClusterIdentifier (string) –

          The unique identifier of the cluster for which the recommendation is returned.

        • NamespaceArn (string) –

          The Amazon Redshift cluster namespace ARN for which the recommendations is returned.

        • CreatedAt (datetime) –

          The date and time (UTC) that the recommendation was created.

        • RecommendationType (string) –

          The type of Advisor recommendation.

        • Title (string) –

          The title of the recommendation.

        • Description (string) –

          The description of the recommendation.

        • Observation (string) –

          The description of what was observed about your cluster.

        • ImpactRanking (string) –

          The scale of the impact that the Advisor recommendation has to the performance and cost of the cluster.

        • RecommendationText (string) –

          The description of the recommendation.

        • RecommendedActions (list) –

          List of Amazon Redshift recommended actions.

          • (dict) –

            The recommended action from the Amazon Redshift Advisor recommendation.

            • Text (string) –

              The specific instruction about the command.

            • Database (string) –

              The database name to perform the action on. Only applicable if the type of command is SQL.

            • Command (string) –

              The command to run.

            • Type (string) –

              The type of command.

        • ReferenceLinks (list) –

          List of helpful links for more information about the Advisor recommendation.

          • (dict) –

            A link to an Amazon Redshift Advisor reference for more information about a recommendation.

            • Text (string) –

              The hyperlink text that describes the link to more information.

            • Link (string) –

              The URL address to find more information.

    • NextToken (string) –

      A token to resume pagination.