Attach a Server to a Network

POST

/servers/{id}/actions/attach_to_network

Attaches a Server to a network. This will complement the fixed public Server interface by adding an additional ethernet interface to the Server which is connected to the specified network.

The Server will get an IP auto assigned from a subnet of type server in the same network_zone.

Using the alias_ips attribute you can also define one or more additional IPs to the Servers. Please note that you will have to configure these IPs by hand on your Server since only the primary IP will be given out by DHCP.

Call specific error codes

Code	Description
`server_already_attached`	The server is already attached to the network
`ip_not_available`	The provided Network IP is not available
`no_subnet_available`	No Subnet or IP is available for the Server within the network
`networks_overlap`	The network IP range overlaps with one of the server networks

Request

Path Params

Body Params application/json

Examples

Responses

🟢201The `action` key in the reply contains an Action object with this structure

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.hetzner.cloud/v1/servers//actions/attach_to_network' \
--header 'Content-Type: application/json' \
--data-raw '{
    "alias_ips": [
        "10.0.1.2"
    ],
    "ip": "10.0.1.1",
    "network": 4711
}'

Response Example

{
    "action": {
        "command": "attach_to_network",
        "error": {
            "code": "action_failed",
            "message": "Action failed"
        },
        "finished": null,
        "id": 13,
        "progress": 0,
        "resources": [
            {
                "id": 42,
                "type": "server"
            },
            {
                "id": 4711,
                "type": "network"
            }
        ],
        "started": "2016-01-30T23:50:00.000Z",
        "status": "running"
    }
}

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

Attach an ISO to a Server

Change alias IPs of a Network