get_usage_plan_keys

APIGateway.Client.get_usage_plan_keys(**kwargs)

Gets all the usage plan keys representing the API keys added to a specified usage plan.

See also: AWS API Documentation

Request Syntax

response = client.get_usage_plan_keys(
    usagePlanId='string',
    position='string',
    limit=123,
    nameQuery='string'
)
Parameters
  • usagePlanId (string) --

    [REQUIRED]

    The Id of the UsagePlan resource representing the usage plan containing the to-be-retrieved UsagePlanKey resource representing a plan customer.

  • position (string) -- The current pagination position in the paged result set.
  • limit (integer) -- The maximum number of returned results per page. The default value is 25 and the maximum value is 500.
  • nameQuery (string) -- A query parameter specifying the name of the to-be-returned usage plan keys.
Return type

dict

Returns

Response Syntax

{
    'position': 'string',
    'items': [
        {
            'id': 'string',
            'type': 'string',
            'value': 'string',
            'name': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    Represents the collection of usage plan keys added to usage plans for the associated API keys and, possibly, other types of keys.

    • position (string) --

    • items (list) --

      The current page of elements from this collection.

      • (dict) --

        Represents a usage plan key to identify a plan customer.

        • id (string) --

          The Id of a usage plan key.

        • type (string) --

          The type of a usage plan key. Currently, the valid key type is API_KEY .

        • value (string) --

          The value of a usage plan key.

        • name (string) --

          The name of a usage plan key.

Exceptions

  • APIGateway.Client.exceptions.BadRequestException
  • APIGateway.Client.exceptions.NotFoundException
  • APIGateway.Client.exceptions.UnauthorizedException
  • APIGateway.Client.exceptions.TooManyRequestsException