The IPs endpoint allows management of the Reverse DNS entries for the IP addresses allocated to any virtual machines, and deletion of additional IPs.
Once deleted, an additional IP may be reused to satisfy new allocation requests. If you’d like to move an additional IP between VMs you control, please contact support.
Endpoints
These are relative to https://uk0.bigv.io
GET /ips/<ipaddress>
PUT /ips/<ipaddress>
DELETE /ips/<ipaddress>
Attributes
address
– The IP address.rdns
– The server name for reverse DNS.
Examples
IP Information
Request
GET /ips/<ipaddress>
Curl
curl -H "Content-type: application/json" \
-H "Authorization: Bearer {session-id}" \
https://uk0.bigv.io/ips/213.123.123.123
Response
{
"address": "213.123.123.123",
"rdns": "myhost.mydomain.com"
}
Update Reverse DNS
Request
PUT /ips/<ipaddress>
Curl
curl -H "Content-type: application/json" \
-H "Authorization: Bearer {session-id}" \
-X PUT -d '{"rdns":"mynewhost.mydomain.com"}' \
https://uk0.bigv.io/ips/213.123.123.123
Response
{
"address": "213.123.123.123",
"rdns": "mynewhost.mydomain.com"
}
Delete an additional IP
Request
DELETE /ips/<ipaddress>
Curl
curl -H "Content-type: application/json" \
-H "Authorization: Bearer {session-id}" \
-X DELETE \
https://uk0.bigv.io/ips/213.123.123.123
Response
204 No Content