Repository navigation
Releases
v2.27.0
Load Balancers can now be created with existing Primary IPs
Primary IPs, which were previously available exclusively for Servers, are now also available for Load Balancers. When creating a Load Balancer, you can assign an existing Primary IP instead of having an IP address allocated automatically. Currently, you cannot change the Primary IP once the Load Balancer has been created.
To support this change, we added the new public_net property to the request body of the endpoint POST /load_balancers, with the following child properties:
public_net.ipv4: ID of an IPv4 Primary IP to assign to the Load Balancer.public_net.ipv6: ID of an IPv6 Primary IP to assign to the Load Balancer.
If you omit a property, a new Primary IP of that version is allocated for the Load Balancer, as before.
A Primary IP can currently only be assigned when the Load Balancer is created. It stays assigned for the entire lifetime of the Load Balancer.
Related to https://docs.hetzner.cloud/changelog#2026-10-05-load-balancers-can-use-existing-primary-ips.
Deleting a Load Balancer now returns an Action
Important
Please update all code that uses the LoadBalancersClient.delete method to wait on the newly returned action.
As part of our work on supporting existing Primary IPs for Load Balancers, deleting a Load Balancer is now tracked with an Action.
The endpoint DELETE /load_balancers/{id} now returns a 201 status code with an Action in the response body, instead of a 204 status code with an empty response body.
You can use the returned Action to track the progress of the deletion.
Related to https://docs.hetzner.cloud/changelog#2026-10-05-delete-load-balancer-returns-action.
Features
v2.26.0
v2.25.1
v2.25.0
v2.24.0
v2.23.0
Removed deprecated Datacenter property from Server and PrimaryIP
Removed the deprecated Datacenter property from the Server and PrimaryIP resources. Since the property was already removed from the Hetzner Cloud API, we do not consider this a breaking change (see changelog entry).
Important
Action required: Please update all code that accesses server.datacenter or primary_ip.datacenter to use the location property instead, as shown below.
Before:
server = client.server.get_by_id(5)
print(server.datacenter)
primary_ip = client.primary_ip.get_by_id(5)
print(primary_ip.datacenter)After:
server = client.server.get_by_id(5)
print(server.location)
primary_ip = client.primary_ip.get_by_id(5)
print(primary_ip.location)Features
v2.22.0
Datacenters resource is now deprecated
The endpoints GET /v1/datacenters and GET /v1/datacenters/{id} are now deprecated and will be removed after 1 Oct. 2026. After this date, requests to these endpoints will return HTTP 410 Gone.
The DatacentersClient, Datacenter and related classes are now deprecated.
See the changelog for more details.
Features
- deprecate datacenters (#656)
v2.21.0
Features
- retry requests on api bad_gateway error (#658)
v2.20.0
Load Balancer HTTP Services now support timeout_idle
HTTP Services now support the field timeout_idle, which controls the time a HTTP connection is allowed to idle before it is being dropped.
See the changelog for more information.
Features
- load-balancer: support
timeout_idlehttp service field (#649)
v2.19.0
Primary IPs assignee_type behavior change
In the create Primary IP call, the assignee_type argument is now only send when the assignee_id argument is set. The assignee_type argument will stop defaulting to server in the near future, consider explicitly setting this argument when needed.
As of 1 August 2026, the behavior of the Primary IP assignee_type property will change, and will return unassigned when the Primary IP is not assigned (when assignee_id is null). The goal is to eventually assign Primary IPs to other resource types, not only to server.
See the changelog for more details.
In addition, the Primary IP request body assignee_type property of the operation POST /v1/primary_ips is now optional. Primary IPs created without assignee_type return server until 1 August 2026, after this date, its value will be unassigned.
See the changelog for more details.
Features
- primary-ip:
assignee_typebehavior changed when creating a primary ip (#647)