Create PostgreSQL cluster

Create a new PostgreSQL cluster with the specified configuration.

POST /cloud/v1/dbaas/postgres/clusters/{project_id}/{region_id}

Python

Python

import os
from gcore import Gcore

client = Gcore(
    api_key=os.environ.get("GCORE_API_KEY"),  # This is the default and can be omitted
)
task_id_list = client.cloud.databases.postgres.clusters.create(
    project_id=0,
    region_id=0,
    cluster_name="3",
    flavor={
        "cpu": 1,
        "memory_gib": 1,
    },
    high_availability={
        "replication_mode": "sync"
    },
    network={
        "acl": ["92.33.34.127"],
        "network_type": "public",
    },
    pg_server_configuration={
        "pg_conf": "\nlisten_addresses = 'localhost'\nport = 5432\nmax_connections = 100\nshared_buffers = 128MB\nlogging_collector = on",
        "version": "version",
    },
    storage={
        "size_gib": 100,
        "type": "ssd-hiiops",
    },
)
print(task_id_list.tasks)

200

{
  "tasks": [
    "d478ae29-dedc-4869-82f0-96104425f565"
  ]
}

Authorizations

Authorization · string · header · required

API key for authentication. Make sure to include the word apikey, followed by a single space and then your token. Example: apikey 1234$abcdef

Path Parameters

project_id · integer · required

Project ID

region_id · integer · required

Region ID

Body

application/json

cluster_name · string · required

PostgreSQL cluster name

Required string length: 1 - 50

Pattern: ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$

flavor · Flavor · object · required

Instance RAM and CPU

Show child attributes

high_availability · HighAvailabilityOptions · object · required

High Availability settings

Show child attributes

network · Network · object · required

Show child attributes

pg_server_configuration · PostgreSQLServerConfig · object · required

PosgtreSQL cluster configuration

Show child attributes

storage · Storage · object · required

Cluster's storage configuration

Show child attributes

databases · Database · object[]

Show child attributes

users · PgUser · object[]

Show child attributes

Response

200 - application/json

OK

tasks · string[] · required

List of task IDs representing asynchronous operations. Use these IDs to monitor operation progress:

• GET /v1/tasks/{task_id} - Check individual task status and details Poll task status until completion (FINISHED/ERROR) before proceeding with dependent operations.

Example:

["d478ae29-dedc-4869-82f0-96104425f565"]