UpCloud

Database SDN Networks

Managed Databases can be connected to SDN private networks for secure, private connectivity. This enables servers in private networks to connect to your database without traversing the public internet.


POST/1.3/database/{uuid}/networks

Attach SDN network

Attaches an SDN private network to a Managed Database service.

Attributes

  • Name
    name
    Type
    string
    Description

    Network name, unique within the service (1-64 chars). Required.

  • Name
    uuid
    Type
    string
    Description

    Private network UUID. Required.

  • Name
    type
    Type
    string
    Description

    Network type: "private". Required.

  • Name
    family
    Type
    string
    Description

    Address family: "IPv4". Required.

Request

POST
/1.3/database/{uuid}/networks
curl -X POST https://api.upcloud.com/1.3/database/09a4b9d5-c1f8-4c9f-9e7a-1234567890ab/networks \
  -u your_username:your_password \
  -H "Content-Type: application/json" \
  -d '{
    "name": "example-private-network",
    "uuid": "03bec0ad-85c3-459e-824d-710f8f24f740",
    "type": "private",
    "family": "IPv4"
  }'

GET/1.3/database/{uuid}/networks

List SDN networks

Returns a list of attached SDN networks for a Managed Database service.

Request

GET
/1.3/database/{uuid}/networks
curl -X GET https://api.upcloud.com/1.3/database/09a4b9d5-c1f8-4c9f-9e7a-1234567890ab/networks \
  -u your_username:your_password

GET/1.3/database/{uuid}/networks/{network_name}

Get SDN network details

Returns details of a specific attached SDN network.

Request

GET
/1.3/database/{uuid}/networks/{network_name}
curl -X GET https://api.upcloud.com/1.3/database/09a4b9d5-c1f8-4c9f-9e7a-1234567890ab/networks/example-private-network \
  -u your_username:your_password

DELETE/1.3/database/{uuid}/networks/{network_name}

Detach SDN network

Detaches an SDN network from a Managed Database service.

Request

DELETE
/1.3/database/{uuid}/networks/{network_name}
curl -X DELETE https://api.upcloud.com/1.3/database/09a4b9d5-c1f8-4c9f-9e7a-1234567890ab/networks/example-private-network \
  -u your_username:your_password

GET/1.3/database/{uuid}/peering-status

Get peering status

Returns the network peering status for a Managed Database service. Only available for services using SDN private networks.

Request

GET
/1.3/database/{uuid}/peering-status
curl -X GET https://api.upcloud.com/1.3/database/09a4b9d5-c1f8-4c9f-9e7a-1234567890ab/peering-status \
  -u your_username:your_password