LocationService / Paginator / ListKeys

ListKeys

class LocationService.Paginator.ListKeys

paginator = client.get_paginator('list_keys')

paginate(**kwargs)

Creates an iterator that will paginate through responses from LocationService.Client.list_keys().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    Filter={
        'KeyStatus': 'Active'|'Expired'
    },
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)

Parameters:

• Filter (dict) –

  Optionally filter the list to only Active or Expired API keys.

  • KeyStatus (string) –

    Filter on Active or Expired API keys.

• 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

{
    'Entries': [
        {
            'CreateTime': datetime(2015, 1, 1),
            'Description': 'string',
            'ExpireTime': datetime(2015, 1, 1),
            'KeyName': 'string',
            'Restrictions': {
                'AllowActions': [
                    'string',
                ],
                'AllowReferers': [
                    'string',
                ],
                'AllowResources': [
                    'string',
                ]
            },
            'UpdateTime': datetime(2015, 1, 1)
        },
    ],

}

Response Structure

• (dict) –

  • Entries (list) –

    Contains API key resources in your Amazon Web Services account. Details include API key name, allowed referers and timestamp for when the API key will expire.

    • (dict) –

      An API key resource listed in your Amazon Web Services account.

      • CreateTime (datetime) –

        The timestamp of when the API key was created, in ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ.

      • Description (string) –

        The optional description for the API key resource.

      • ExpireTime (datetime) –

        The timestamp for when the API key resource will expire, in ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ.

      • KeyName (string) –

        The name of the API key resource.

      • Restrictions (dict) –

        API Restrictions on the allowed actions, resources, and referers for an API key resource.

        • AllowActions (list) –

          A list of allowed actions that an API key resource grants permissions to perform

          Note

          Currently, the only valid action is geo:GetMap* as an input to the list. For example, ["geo:GetMap*"] is valid but ["geo:GetMapTile"] is not.

          • (string) –

        • AllowReferers (list) –

          An optional list of allowed HTTP referers for which requests must originate from. Requests using this API key from other domains will not be allowed.

          Requirements:

          • Contain only alphanumeric characters (A–Z, a–z, 0–9) or any symbols in this list $\-._+!*`(),;/?:@=&

          • May contain a percent (%) if followed by 2 hexadecimal digits (A-F, a-f, 0-9); this is used for URL encoding purposes.

          • May contain wildcard characters question mark (?) and asterisk (*). Question mark (?) will replace any single character (including hexadecimal digits). Asterisk (*) will replace any multiple characters (including multiple hexadecimal digits).

          • No spaces allowed. For example, https://example.com.

          • (string) –

        • AllowResources (list) –

          A list of allowed resource ARNs that a API key bearer can perform actions on

          For more information about ARN format, see Amazon Resource Names (ARNs).

          Note

          In this preview, you can allow only map resources.

          Requirements:

          • Must be prefixed with arn.

          • partition and service must not be empty and should begin with only alphanumeric characters (A–Z, a–z, 0–9) and contain only alphanumeric numbers, hyphens (-) and periods (.).

          • region and account-id can be empty or should begin with only alphanumeric characters (A–Z, a–z, 0–9) and contain only alphanumeric numbers, hyphens (-) and periods (.).

          • resource-id can begin with any character except for forward slash (/) and contain any characters after, including forward slashes to form a path. resource-id can also include wildcard characters, denoted by an asterisk (*).

          • arn, partition, service, region, account-id and resource-id must be delimited by a colon (:).

          • No spaces allowed. For example, arn:aws:geo:region:account-id:map/ExampleMap*.

          • (string) –

      • UpdateTime (datetime) –

        The timestamp of when the API key was last updated, in ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ.