BedrockAgentCoreControl / Paginator / ListPolicyGenerations

ListPolicyGenerations

class BedrockAgentCoreControl.Paginator.ListPolicyGenerations

paginator = client.get_paginator('list_policy_generations')

paginate(**kwargs)

Creates an iterator that will paginate through responses from BedrockAgentCoreControl.Client.list_policy_generations().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    policyEngineId='string',
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)

Parameters:

• policyEngineId (string) –

  [REQUIRED]

  The identifier of the policy engine whose policy generations to retrieve.

• 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

{
    'policyGenerations': [
        {
            'policyEngineId': 'string',
            'policyGenerationId': 'string',
            'name': 'string',
            'policyGenerationArn': 'string',
            'resource': {
                'arn': 'string'
            },
            'createdAt': datetime(2015, 1, 1),
            'updatedAt': datetime(2015, 1, 1),
            'status': 'GENERATING'|'GENERATED'|'GENERATE_FAILED'|'DELETE_FAILED',
            'statusReasons': [
                'string',
            ],
            'findings': 'string'
        },
    ],
    'NextToken': 'string'
}

Response Structure

• (dict) –

  • policyGenerations (list) –

    An array of policy generation objects that match the specified criteria.

    • (dict) –

      Represents a policy generation request within the AgentCore Policy system. Tracks the AI-powered conversion of natural language descriptions into Cedar policy statements, enabling users to author policies by describing authorization requirements in plain English. The generation process analyzes the natural language input along with the Gateway’s tool context and Cedar schema to produce one or more validated policy options. Each generation request tracks the status of the conversion process and maintains findings about the generated policies, including validation results and potential issues. Generated policy assets remain available for one week after successful generation, allowing time to review and create policies from the generated options.

      • policyEngineId (string) –

        The identifier of the policy engine associated with this generation request.

      • policyGenerationId (string) –

        The unique identifier for this policy generation request.

      • name (string) –

        The customer-assigned name for this policy generation request.

      • policyGenerationArn (string) –

        The ARN of this policy generation request.

      • resource (dict) –

        The resource information associated with this policy generation.

        Note

        This is a Tagged Union structure. Only one of the following top level keys will be set: arn. If a client receives an unknown member it will set SDK_UNKNOWN_MEMBER as the top level key, which maps to the name or tag of the unknown member. The structure of SDK_UNKNOWN_MEMBER is as follows:

        'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
        

        • arn (string) –

          The Amazon Resource Name (ARN) of the resource. This globally unique identifier specifies the exact resource that policies will be evaluated against for access control decisions.

      • createdAt (datetime) –

        The timestamp when this policy generation request was created.

      • updatedAt (datetime) –

        The timestamp when this policy generation was last updated.

      • status (string) –

        The current status of this policy generation request.

      • statusReasons (list) –

        Additional information about the generation status.

        • (string) –

      • findings (string) –

        Findings and insights from this policy generation process.

  • NextToken (string) –

    A token to resume pagination.