Create a Network

POST

/networks

Creates a network with the specified ip_range.

You may specify one or more subnets. You can also add more Subnets later by using the add subnet action. If you do not specify an ip_range in the subnet we will automatically pick the first available /24 range for you.

You may specify one or more routes in routes. You can also add more routes later by using the add route action.

Request

Body Params application/json

Examples

Responses

🟢201The `network` key contains the network that was just created

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.hetzner.cloud/v1/networks' \
--header 'Content-Type: application/json' \
--data-raw '{
    "ip_range": "10.0.0.0/16",
    "labels": {
        "labelkey": "value"
    },
    "name": "mynet",
    "routes": [
        {
            "destination": "10.100.1.0/24",
            "gateway": "10.0.1.1"
        }
    ],
    "subnets": [
        {
            "ip_range": "10.0.1.0/24",
            "network_zone": "eu-central",
            "type": "cloud"
        }
    ]
}'

Response Example

{
    "network": {
        "created": "2016-01-30T23:50:00.000Z",
        "id": 4711,
        "ip_range": "10.0.0.0/16",
        "labels": {},
        "load_balancers": [
            42
        ],
        "name": "mynet",
        "protection": {
            "delete": false
        },
        "routes": [
            {
                "destination": "10.100.1.0/24",
                "gateway": "10.0.1.1"
            }
        ],
        "servers": [
            42
        ],
        "subnets": [
            {
                "gateway": "10.0.0.1",
                "ip_range": "10.0.1.0/24",
                "network_zone": "eu-central",
                "type": "cloud"
            }
        ]
    }
}

Modified at 2023-08-16 03:09:21

Get all Networks

Delete a Network