list_databases

list_databases(**kwargs)

Returns a list of your Timestream databases. Service quotas apply. See code sample for details.

See also: AWS API Documentation

Request Syntax

response = client.list_databases(
    NextToken='string',
    MaxResults=123
)
Parameters
  • NextToken (string) -- The pagination token. To resume pagination, provide the NextToken value as argument of a subsequent API invocation.
  • MaxResults (integer) -- The total number of items to return in the output. If the total number of items available is more than the value specified, a NextToken is provided in the output. To resume pagination, provide the NextToken value as argument of a subsequent API invocation.
Return type

dict

Returns

Response Syntax

{
    'Databases': [
        {
            'Arn': 'string',
            'DatabaseName': 'string',
            'TableCount': 123,
            'KmsKeyId': 'string',
            'CreationTime': datetime(2015, 1, 1),
            'LastUpdatedTime': datetime(2015, 1, 1)
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • Databases (list) --

      A list of database names.

      • (dict) --

        A top-level container for a table. Databases and tables are the fundamental management concepts in Amazon Timestream. All tables in a database are encrypted with the same KMS key.

        • Arn (string) --

          The Amazon Resource Name that uniquely identifies this database.

        • DatabaseName (string) --

          The name of the Timestream database.

        • TableCount (integer) --

          The total number of tables found within a Timestream database.

        • KmsKeyId (string) --

          The identifier of the KMS key used to encrypt the data stored in the database.

        • CreationTime (datetime) --

          The time when the database was created, calculated from the Unix epoch time.

        • LastUpdatedTime (datetime) --

          The last time that this database was updated.

    • NextToken (string) --

      The pagination token. This parameter is returned when the response is truncated.

Exceptions

  • TimestreamWrite.Client.exceptions.InternalServerException
  • TimestreamWrite.Client.exceptions.ThrottlingException
  • TimestreamWrite.Client.exceptions.ValidationException
  • TimestreamWrite.Client.exceptions.AccessDeniedException
  • TimestreamWrite.Client.exceptions.InvalidEndpointException