Sign in
Network Actions

Delete a route from a Network

Delete a route entry from a Network.

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

post/networks/{id}/actions/delete_route

Request

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

Path parameters

idinteger required

ID of the Network.

Example:42

ID of the Network.

Request body

destinationstring required

Destination network or host of the route.

Packages addressed for IPs matching the destination IP prefix will be send to the specified gateway.

Must be one of

  • private IPv4 ranges of RFC1918
  • or 0.0.0.0/0.

Must not overlap with

  • an existing ip_range in any subnets
  • or with any destinations in other routes
  • or with 172.31.1.1.

172.31.1.1 is being used as a gateway for the public network interface of Servers.

gatewaystring required

Gateway of the route.

Packages addressed for the specified destination will be send to this IP address.

Cannot be

  • the first IP of the networks ip_range,
  • an IP behind a vSwitch or
  • 172.31.1.1.

172.31.1.1 is being used as a gateway for the public network interface of Servers.

Example request

{
  "destination": "10.100.1.0/24",
  "gateway": "10.0.1.1"
}

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.