BedrockAgentCoreControl / Paginator / ListGatewayTargets

ListGatewayTargets

class BedrockAgentCoreControl.Paginator.ListGatewayTargets

paginator = client.get_paginator('list_gateway_targets')

paginate(**kwargs)

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

See also: AWS API Documentation

Request Syntax

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

Parameters:

• gatewayIdentifier (string) –

  [REQUIRED]

  The identifier of the gateway to list targets for.

• 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

{
    'items': [
        {
            'targetId': 'string',
            'name': 'string',
            'status': 'CREATING'|'UPDATING'|'UPDATE_UNSUCCESSFUL'|'DELETING'|'READY'|'FAILED'|'SYNCHRONIZING'|'SYNCHRONIZE_UNSUCCESSFUL'|'CREATE_PENDING_AUTH'|'UPDATE_PENDING_AUTH'|'SYNCHRONIZE_PENDING_AUTH',
            'description': 'string',
            'createdAt': datetime(2015, 1, 1),
            'updatedAt': datetime(2015, 1, 1),
            'resourcePriority': 123,
            'lastSynchronizedAt': datetime(2015, 1, 1),
            'authorizationData': {
                'oauth2': {
                    'authorizationUrl': 'string',
                    'userId': 'string'
                }
            },
            'targetType': 'OPEN_API_SCHEMA'|'SMITHY_MODEL'|'MCP_SERVER'|'LAMBDA'|'API_GATEWAY'|'CONNECTOR'|'AGENTCORE_RUNTIME'|'PASSTHROUGH'|'PROVIDER',
            'listingMode': 'DEFAULT'|'DYNAMIC'
        },
    ],
    'NextToken': 'string'
}

Response Structure

• (dict) –

  • items (list) –

    The list of gateway target summaries.

    • (dict) –

      Contains summary information about a gateway target. A target represents an endpoint that the gateway can connect to.

      • targetId (string) –

        The unique identifier of the target.

      • name (string) –

        The name of the target.

      • status (string) –

        The current status of the target.

      • description (string) –

        The description of the target.

      • createdAt (datetime) –

        The timestamp when the target was created.

      • updatedAt (datetime) –

        The timestamp when the target was last updated.

      • resourcePriority (integer) –

        Priority for resolving resource URI conflicts across targets. Lower values take precedence. Defaults to 1000 when not set.

      • lastSynchronizedAt (datetime) –

        The timestamp when the target was last synchronized.

      • authorizationData (dict) –

        Contains the authorization data that is returned when a gateway target is configured with a credential provider with authorization code grant type and requires user federation.

        Note

        This is a Tagged Union structure. Only one of the following top level keys will be set: oauth2. 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'}
        

        • oauth2 (dict) –

          OAuth2 authorization data for the gateway target.

          • authorizationUrl (string) –

            The URL to initiate the authorization process. This URL is provided when the OAuth2 access token requires user authorization.

          • userId (string) –

            The user identifier associated with the OAuth2 authorization session that is defined by AgentCore Gateway.

      • targetType (string) –

        The type of the target.

      • listingMode (string) –

        The listing mode for the target. MCP resources for DEFAULT targets are cached at the control plane for faster access. MCP resources for DYNAMIC targets are retrieved dynamically when listing tools.

  • NextToken (string) –

    A token to resume pagination.