Перейти до вмісту
NimbusNexus

Reverse DNS (PTR records)

Reverse DNS is the hostname someone gets when they ask "what's the name behind this IP?" — the inverse of normal DNS resolution. The records live in a separate tree (in-addr.arpa. for IPv4, ip6.arpa. for IPv6) and are authoritative for the IP block they cover.

For most VMs, the default reverse DNS (unused.nimbusnexus.net or similar) is fine. Set a custom PTR when:

  • You run a mail server. Most major email providers reject mail from IPs whose PTR doesn't match the sending hostname's forward DNS. Without a matching PTR, your delivery rate drops to zero.
  • You're allowlisted by a partner using PTR-based identification. Some firewalls do reverse-lookup-then-forward-lookup verification for inbound TCP.

PTR records are scoped to NimbusNexus-allocated floating IPs — you can't set PTRs on an IP that isn't ours.

What's next

Reference

GET/api/v1/ptr/records/

List Ptr Records

Lists reverse-DNS PTR records mapped to the project's floating IPs.

Responses

  • 200Successful Response
  • 401Unauthorized
  • 403Forbidden
  • 422Validation error
  • 429Too Many Requests
  • 500Internal Server Error

https://api.nimbusnexus.net/api/v1/ptr/records/

PUT/api/v1/ptr/records/set/{floatingip_id}

Set Ptr Record

Sets or replaces the reverse-DNS PTR record for the given floating IP.

Parameters

NameInRequiredDescription
floatingip_idpathyesCompound floating IP identifier in the form `<region>:<uuid>`

Request body

JSON body required.

Responses

  • 200Successful Response
  • 400Bad Request
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 422Validation error
  • 429Too Many Requests
  • 500Internal Server Error

https://api.nimbusnexus.net/api/v1/ptr/records/set/{floatingip_id}

PUT/api/v1/ptr/records/unset/{floatingip_id}

Unset Ptr Record

Clears the reverse-DNS PTR record bound to the given floating IP.

Parameters

NameInRequiredDescription
floatingip_idpathyesCompound floating IP identifier in the form `<region>:<uuid>`

Responses

  • 204Successful Response
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 422Validation Error
  • 429Too Many Requests
  • 500Internal Server Error

https://api.nimbusnexus.net/api/v1/ptr/records/unset/{floatingip_id}

GET/api/v1/ptr/records/{floatingip_id}

Get Ptr Record

Retrieves the reverse-DNS PTR record bound to the given floating IP.

Parameters

NameInRequiredDescription
floatingip_idpathyesCompound floating IP identifier in the form `<region>:<uuid>`

Responses

  • 200Successful Response
  • 400Bad Request
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 422Validation error
  • 429Too Many Requests
  • 500Internal Server Error

https://api.nimbusnexus.net/api/v1/ptr/records/{floatingip_id}

GET/api/v1/zones/{zone_id}/ptr/

List Ptrs

Lists PTR records in the specified zone owned by the calling project.

Parameters

NameInRequiredDescription
zone_idpathyesParent zone ID
admin_domainqueryno—
admin_projectqueryno—
limitqueryno—
markerqueryno—
sort_dirqueryno—
sort_keyqueryno—
namequeryno—
typequeryno—
ttlqueryno—
statusqueryno—
descriptionqueryno—

Responses

  • 200Successful Response
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 422Validation error
  • 429Too Many Requests
  • 500Internal Server Error

https://api.nimbusnexus.net/api/v1/zones/{zone_id}/ptr/

POST/api/v1/zones/{zone_id}/ptr/

Create Ptr

Creates a PTR record within the specified DNS zone.

Parameters

NameInRequiredDescription
zone_idpathyesParent zone ID

Request body

JSON body required.

Responses

  • 201Successful Response
  • 400Bad Request
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 409Conflict
  • 422Validation error
  • 429Too Many Requests
  • 500Internal Server Error

https://api.nimbusnexus.net/api/v1/zones/{zone_id}/ptr/

GET/api/v1/zones/{zone_id}/ptr/{recordset_id}

Get Ptr

Retrieves a single PTR record by zone and recordset identifiers.

Parameters

NameInRequiredDescription
zone_idpathyesParent zone ID
recordset_idpathyesPTR record ID

Responses

  • 200Successful Response
  • 400Bad Request
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 422Validation error
  • 429Too Many Requests
  • 500Internal Server Error

https://api.nimbusnexus.net/api/v1/zones/{zone_id}/ptr/{recordset_id}

PUT/api/v1/zones/{zone_id}/ptr/{recordset_id}

Update Ptr

Updates an existing PTR record in the specified zone.

Parameters

NameInRequiredDescription
recordset_idpathyesRecordset ID
zone_idpathyesParent zone ID

Request body

JSON body required.

Responses

  • 202Successful Response
  • 400Bad Request
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 409Conflict
  • 422Validation error
  • 429Too Many Requests
  • 500Internal Server Error

https://api.nimbusnexus.net/api/v1/zones/{zone_id}/ptr/{recordset_id}

DELETE/api/v1/zones/{zone_id}/ptr/{recordset_id}

Delete Ptr

Deletes a PTR record from the specified DNS zone.

Parameters

NameInRequiredDescription
recordset_idpathyesRecordset ID
zone_idpathyesParent zone ID

Responses

  • 202Successful Response
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 422Validation Error
  • 429Too Many Requests
  • 500Internal Server Error

https://api.nimbusnexus.net/api/v1/zones/{zone_id}/ptr/{recordset_id}

Need to make a real call? Try these endpoints in the live Swagger UI →