BedrockAgentCoreControl / Paginator / ListGatewayRateLimits

ListGatewayRateLimits

class BedrockAgentCoreControl.Paginator.ListGatewayRateLimits
paginator = client.get_paginator('list_gateway_rate_limits')
paginate(**kwargs)

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

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 unique identifier of the gateway.

  • 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

{
    'rateLimits': [
        {
            'rateLimitId': 'string',
            'gatewayIdentifier': 'string',
            'description': 'string',
            'dimensionKeys': [
                'string',
            ],
            'entries': [
                {
                    'dimensions': {
                        'string': 'string'
                    },
                    'requests': [
                        {
                            'rate': 123.0,
                            'period': 'second'|'minute'
                        },
                    ],
                    'tokens': [
                        {
                            'rate': 123.0,
                            'period': 'second'|'minute'
                        },
                    ],
                    'connections': [
                        {
                            'rate': 123.0,
                            'period': 'second'|'minute'
                        },
                    ]
                },
            ],
            'status': 'CREATING'|'ACTIVE'|'UPDATING'|'DELETING',
            'createdAt': datetime(2015, 1, 1),
            'updatedAt': datetime(2015, 1, 1)
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) –

    • rateLimits (list) –

      The list of rate limits for the gateway.

      • (dict) –

        Contains detailed information about a gateway rate limit, including its configuration and current status.

        • rateLimitId (string) –

          The unique identifier of the rate limit.

        • gatewayIdentifier (string) –

          The unique identifier of the gateway.

        • description (string) –

          The human-readable description of the rate limit.

        • dimensionKeys (list) –

          The ordered list of dimension key names that define the scope of this rate limit.

          • (string) –

            A dimension key specifying the scope dimension for rate limiting.

            Allowed values: targetName, toolName, qualifiedModelId, or context-path expressions: $.context.iam.principal, $.context.iam.sourceIdentity, $.context.jwt.<claim> where <claim> is a JWT claim name (for example, $.context.jwt.sub). Validated server-side to enforce allowed prefixes and patterns.

        • entries (list) –

          The list of rule entries that map dimension values to rate configurations.

          • (dict) –

            A single rule entry within a rate limit that maps dimension values to rate configurations. Each entry defines the rate limits for a specific combination of dimension values.

            • dimensions (dict) –

              A map of dimension names to dimension values for this rule entry. Keys must match the parent rate limit’s dimension keys. Values may use * as a wildcard, but only in trailing positions based on the dimension keys ordering.

              • (string) –

                A dimension key specifying the scope dimension for rate limiting.

                Allowed values: targetName, toolName, qualifiedModelId, or context-path expressions: $.context.iam.principal, $.context.iam.sourceIdentity, $.context.jwt.<claim> where <claim> is a JWT claim name (for example, $.context.jwt.sub). Validated server-side to enforce allowed prefixes and patterns.

                • (string) –

                  A dimension value in a rule entry (exact value or * wildcard).

            • requests (list) –

              The request rate limit configuration. Specifies the maximum number of requests allowed per time period.

              • (dict) –

                Contains the rate configuration for a rate limit metric, specifying the allowed rate and time period.

                • rate (float) –

                  The rate value for the limit. For request limits, this is the number of requests allowed per period. For token limits, this is the number of tokens allowed per period. For connection limits, this is the number of concurrent connections allowed.

                • period (string) –

                  The time period for the rate limit. Valid values:

                  • second—Measures the rate limit over a one-second window.

                  • minute—Measures the rate limit over a one-minute window.

            • tokens (list) –

              The token rate limit configuration. Specifies the maximum number of tokens allowed per time period.

              • (dict) –

                Contains the rate configuration for a rate limit metric, specifying the allowed rate and time period.

                • rate (float) –

                  The rate value for the limit. For request limits, this is the number of requests allowed per period. For token limits, this is the number of tokens allowed per period. For connection limits, this is the number of concurrent connections allowed.

                • period (string) –

                  The time period for the rate limit. Valid values:

                  • second—Measures the rate limit over a one-second window.

                  • minute—Measures the rate limit over a one-minute window.

            • connections (list) –

              The connection rate limit configuration. Specifies the maximum number of concurrent connections allowed.

              • (dict) –

                Contains the rate configuration for a rate limit metric, specifying the allowed rate and time period.

                • rate (float) –

                  The rate value for the limit. For request limits, this is the number of requests allowed per period. For token limits, this is the number of tokens allowed per period. For connection limits, this is the number of concurrent connections allowed.

                • period (string) –

                  The time period for the rate limit. Valid values:

                  • second—Measures the rate limit over a one-second window.

                  • minute—Measures the rate limit over a one-minute window.

        • status (string) –

          The current status of the rate limit.

        • createdAt (datetime) –

          The timestamp when the rate limit was created.

        • updatedAt (datetime) –

          The timestamp when the rate limit was last updated.

    • NextToken (string) –

      A token to resume pagination.