Get a PostgreSQL Managed Database

Display information for a single, accessible PostgreSQL Managed Database.

linode-cli databases postgresql-view 123
Learn more...
databases:read_only
Learn more...
Path Params
string
required

Enum Call either the v4 URL, or v4beta for operations still in Beta.

integer
required

The ID of the Managed PostgreSQL Database.

Responses

Response body
object
allow_list
array of strings

Controls access to the Managed Database.

  • Individually included IP addresses or CIDR ranges can access the Managed Database while all other sources are blocked.

  • A standalone value of 0.0.0.0/0 allows all IP addresses access to the Managed Database.

  • An empty array ([]) blocks all public and private connections to the Managed Database.

allow_list
integer
Defaults to 1

The number of Linode instance nodes deployed to the Managed Database.

  • Choose 3 nodes to create a high availability cluster that consists of one primary node and two replica nodes.

  • A 2 node cluster is only available with a dedicated plan. It consists of one primary node and one replica node.

1 2 3

date-time

Read-only When this Managed Database was created.

boolean
Defaults to true

Read-only Whether the Managed Databases is encrypted. Currently required to be true.

string

Filterable, Read-only The Managed Database engine type.

engine_config
object

Advanced parameters you can apply to a PostgreSQL Managed Database, via our partner Aiven's specification. Only include the objects for parameters you want to set in your database. Omit objects for parameters you don't want to define or change.

📘

Aiven may offer additional parameters in their specification. Currently, only those listed here are supported for use in a PostgreSQL Managed Database. You can also run the List PostgreSQL Managed Database advanced parameters operation to see an up-to-date list.

pg
object

PostgreSQL-specific advanced configuration parameters.

boolean

Enable the pg_stat_monitor extension. When this extension is enabled, PostgreSQL restarts the cluster it's in. Additionally, pg_stat_statements results for utility commands are unreliable.

pglookout
object

Parameter used to apply PGLookout settings.

number
20 to 60

Percentage of total RAM that the database server uses for shared memory buffers. Valid range is 20-60 (float), which corresponds to 20% - 60%. This setting adjusts the shared_buffers configuration value.

integer
1 to 4

Sets the maximum amount of memory in MB to be used by a query operation, such as a sort or hash table, before writing to temporary disk files. Default is 1MB + 0.075% of total RAM, up to 32 MB.

fork
object

Details on the database that was the target of the fork. This only exists if the database was restored by creating a fork from another MySQL or PostgreSQL database.

date-time

The database timestamp from which it was restored. This is not when the fork was created.

integer

The instance id of the database that was forked from.

hosts
object

Read-only The primary and secondary hosts for the Managed Database. These are assigned after provisioning is complete.

string | null

The primary host for the Managed Database.

string | null

The secondary/private network host for the Managed Database. A private network host and a private IP can only be used to access a database cluster from Linodes in the same data center and will not incur transfer costs.

📘

The secondary hostname is publicly visible and accessible.

integer

Read-only A unique ID that can be used to identify and reference the Managed Database.

string
length between 3 and 32

Filterable A unique, user-defined string referring to the Managed Database. This string needs to be unique per Managed Database engine type.

members
object

Read-only A mapping between IP addresses and strings designating them as primary or failover.

Has additional fields
date-time

Read-only The oldest time to which a database can be restored.

string

Filterable, Read-only The back-end platform for relational databases used by the service.

rdbms-legacy rdbms-default

integer

Read-only The access port for this Managed Database.

string

Filterable The Region ID for the Managed Database.

boolean
Defaults to true

Currently required to be true. Whether to require SSL credentials to establish a connection to the Managed Database. Run the Get managed PostgreSQL database credentials operation for access information.

string

Filterable, Read-only The operating status of the Managed Database.

provisioning active suspending suspended resuming failed degraded updating resizing

integer

Read-only The total disk size of the database, in GB.

string

Filterable The Linode Instance type used by the Managed Database for its nodes.

date-time

Read-only When this Managed Database was last updated.

updates
object

Configuration settings for automated patch update maintenance for the Managed Database.

integer
1 to 7

The numeric reference for the day of the week to perform maintenance. 1 is Monday, 2 is Tuesday, through to 7 which is Sunday.

integer
1 to 3

The maximum maintenance window time in hours.

string
Defaults to weekly

How frequently maintenance occurs. Currently can only be weekly.

weekly

integer
0 to 23

The hour to begin maintenance based in UTC time.

pending
array of objects

Read-only An array of pending updates.

pending
object
date-time | null

The time when a mandatory update needs to be applied.

string

A description of the update.

date-time | null

The date and time a maintenance update will be applied.

integer

Read-only The amount of space currently in use in the database, in GB.

string

Filterable The Managed Database engine version.

Language
Credentials