Primary IP Actions

Unassign a Primary IP from a resource

Unassign a Primary IP from a resource.

A Server must be powered off (status off) in order for this operation to succeed.

A Server requires at least one network interface (public or private) to be powered on.

Operation specific errors

StatusCodeDescription
422server_not_stoppedThe Server is running, but needs to be powered off
422server_is_load_balancer_targetThe Server IPv4 address is a loadbalancer target
post/primary_ips/{id}/actions/unassign

Request

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

Path parameters

idinteger required

ID of the Primary IP.

Example:42

ID of the Primary IP.

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.