Vps

Networking

Manage network settings, IP addresses, and DNS configurations for your virtual machines.

Networking

Manage network settings, IP addresses, and DNS configurations for your virtual machines.

PTR Records

GET /projects/{project}/products/{product}/vps/ptr

Retrieve PTR (reverse DNS) records for VM IP addresses.

Path Parameters

NameTypeDescription
projectstringUnique project identifier
productstringUnique product/VM identifier

Headers

NameTypeDescription
AuthorizationstringBearer token for authentication
PermissionstringREAD_NETWORK

Response

200 - Success

{
  "ipv4": {
    "address": "192.121.119.100",
    "ptr": "web.example.com"
  },
  "ipv6": {
    "address": "2001:67c:bec:b::100/64",
    "ptr": "web.example.com"
  }
}

Update PTR Records

PUT /projects/{project}/products/{product}/vps/ptr

Set custom PTR records for your VM's IP addresses.

ℹ️ PTR Records: PTR records provide reverse DNS lookup functionality, allowing IP addresses to resolve to domain names. This is particularly important for mail servers and other services that require reverse DNS validation.

Path Parameters

NameTypeDescription
projectstringUnique project identifier
productstringUnique product/VM identifier

Headers

NameTypeDescription
AuthorizationstringBearer token for authentication
PermissionstringWRITE_NETWORK

Request Body

NameTypeDescription
ipv4objectOptional. IPv4 PTR configuration
ipv4.ptrstringOptional. PTR record for IPv4 (null to remove)
ipv6objectOptional. IPv6 PTR configuration
ipv6.ptrstringOptional. PTR record for IPv6 (null to remove)

Example Request:

{
  "ipv4": {
    "ptr": "web.example.com"
  },
  "ipv6": {
    "ptr": "web.example.com" 
  }
}

Remove PTR Records:

{
  "ipv4": {
    "ptr": null
  },
  "ipv6": {
    "ptr": null
  }
}

Response

200 - Success

{
  "success": true
}