list_ledgers

list_ledgers(**kwargs)

Returns an array of ledger summaries that are associated with the current Amazon Web Services account and Region.

This action returns a maximum of 100 items and is paginated so that you can retrieve all the items by calling ListLedgers multiple times.

See also: AWS API Documentation

Request Syntax

response = client.list_ledgers(
    MaxResults=123,
    NextToken='string'
)

Parameters

• MaxResults (integer) -- The maximum number of results to return in a single ListLedgers request. (The actual number of results returned might be fewer.)
• NextToken (string) -- A pagination token, indicating that you want to retrieve the next page of results. If you received a value for NextToken in the response from a previous ListLedgers call, then you should use that value as input here.

Return type

dict

Returns

Response Syntax

{
    'Ledgers': [
        {
            'Name': 'string',
            'State': 'CREATING'|'ACTIVE'|'DELETING'|'DELETED',
            'CreationDateTime': datetime(2015, 1, 1)
        },
    ],
    'NextToken': 'string'
}

Response Structure

• (dict) --

  • Ledgers (list) --

    The array of ledger summaries that are associated with the current Amazon Web Services account and Region.

    • (dict) --

      Information about a ledger, including its name, state, and when it was created.

      • Name (string) --

        The name of the ledger.

      • State (string) --

        The current status of the ledger.

      • CreationDateTime (datetime) --

        The date and time, in epoch time format, when the ledger was created. (Epoch time format is the number of seconds elapsed since 12:00:00 AM January 1, 1970 UTC.)

  • NextToken (string) --

    A pagination token, indicating whether there are more results available:

    • If NextToken is empty, then the last page of results has been processed and there are no more results to be retrieved.
    • If NextToken is not empty, then there are more results available. To retrieve the next page of results, use the value of NextToken in a subsequent ListLedgers call.