Network

IP addresses and their reverse DNS.

GET/network/subnets/{service_id}/ip-addressesAddresses of a subnet
GET/network/ip-addressesOther addresses
PUT/network/ip-addresses/{ip_id}/dns-nameSet the reverse DNS

Addresses of a subnet

GET/network/subnets/{service_id}/ip-addresses

Needs the permission network:read

Path

service_idrequired string (uuid)

Response 200

`items`required	object[]
`id`required	string
`address`required	string
`dns_name`required	string
`status`required	string
`description`required	string
`can_edit`required	boolean

curl "https://portal.nimag.net/api/v1/network/subnets/{service_id}/ip-addresses" \
  -H "Authorization: Bearer nck_…"

{
  "items": [
    {
      "id": "string",
      "address": "string",
      "dns_name": "string",
      "status": "string",
      "description": "string"
    }
  ],
  "can_edit": true
}

Other addresses

GET/network/ip-addresses

Needs the permission network:read

The customer's addresses that are not part of one of its subnets.

Response 200

`items`required	object[]
`id`required	string
`address`required	string
`dns_name`required	string
`status`required	string
`description`required	string
`can_edit`required	boolean

curl "https://portal.nimag.net/api/v1/network/ip-addresses" \
  -H "Authorization: Bearer nck_…"

{
  "items": [
    {
      "id": "string",
      "address": "string",
      "dns_name": "string",
      "status": "string",
      "description": "string"
    }
  ],
  "can_edit": true
}

Set the reverse DNS

PUT/network/ip-addresses/{ip_id}/dns-name

Needs the permission network:reverse_dns:manage

The name an address answers to (PTR). An empty name removes it.

Path

ip_idrequired string

Body (JSON)

dns_name string up to 255 characters, default ""

Response 200

`id`required	string
`address`required	string
`dns_name`required	string
`status`required	string
`description`required	string

curl -X PUT "https://portal.nimag.net/api/v1/network/ip-addresses/{ip_id}/dns-name" \
  -H "Authorization: Bearer nck_…" \
  -H "Content-Type: application/json" \
  -d '{
    "dns_name": ""
  }'

{
  "id": "string",
  "address": "string",
  "dns_name": "string",
  "status": "string",
  "description": "string"
}