Sign in
Network Actions

Change IP range of a Network

Changes the IP range of a Network.

The following restrictions apply to changing the IP range:

  • IP ranges can only be extended and never shrunk.
  • IPs can only be added to the end of the existing range, therefore only the netmask is allowed to be changed.

To update the routes on the connected Servers, they need to be rebooted or the routes to be updated manually.

For example if the Network has a range of 10.0.0.0/16 to extend it the new range has to start with the IP 10.0.0.0 as well. The netmask /16 can be changed to a smaller one then 16 therefore increasing the IP range. A valid entry would be 10.0.0.0/15, 10.0.0.0/14 or 10.0.0.0/13 and so on.

If a change is currently being performed on this Network, a error response with code conflict will be returned.

post/networks/{id}/actions/change_ip_range

Request

  • Base URL: https://api.hetzner.cloud/v1
  • URL: https://api.hetzner.cloud/v1/networks/{id}/actions/change_ip_range
  • Auth: HTTP bearer

Path parameters

idinteger required

ID of the Network.

Example:42

ID of the Network.

Request body

ip_rangestring required

IP range of the Network.

Uses CIDR notation.

Must span all included subnets. Must be one of the private IPv4 ranges of RFC1918.

Minimum network size is /24. We highly recommend that you pick a larger Network with a /16 netmask.

Example request

{
  "ip_range": "10.0.0.0/16"
}

Response

Request succeeded.

Example response

{
  "action": {
    "id": 42,
    "command": "start_resource",
    "started": "2016-01-30T23:55:00Z",
    "finished": "2016-01-30T23:55:00Z",
    "progress": 100,
    "resources": [
      {
        "id": 42,
        "type": "server"
      }
    ],
    "error": {
      "code": "action_failed",
      "message": "Action failed"
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.