Get databases

This endpoint retrieves databases belonging to the account of the calling user.

Method	Path	Operation*
GET	account/services/databases	get_databases

*

In order for a user to perform the "get_databases" operation, the "get_databases" permission must be included in the list of allowed actions in the statement of the user's role.

Request

No parameters.

Response

Attribute	Type	Description
default	string	Database UUID of the default database of the account.
databases	dictionary	Dictionary containing databases with their attributes: - key: Database UUID. - value: Database attributes

Database attributes

Attribute	Type	Description
status	string, value is "running", "pending", or "service"	Status of the database: - "running": The Timeseries database is running. - "pending": The Timeseries database is in the process of initialising. - "service": Unexpected behaviour occurred and the Timeseries database is not available.
note	string	User-defined note. The maximum length of a note is 256 characters.
created_ts	timestamp	Time at which the database was created. Measured in seconds (to three decimal places) that have elapsed since the Unix epoch(opens new window).
updated_ts	timestamp	Time at which the database was last updated. Measured in seconds (to three decimal places) that have elapsed since the Unix epoch(opens new window).