Skip to content

Releases

v2.27.0

Choose a tag to compare

@hcloud-bot hcloud-bot released this 05 Oct 13:26
a2e8012

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

  • allow creating load balancers with primary ips (#700) (84e3a19)
  • delete load balancer now returns an action (#700) (84e3a19)

v2.26.0

Choose a tag to compare

@hcloud-bot hcloud-bot released this 02 Oct 14:54
b150ac4

Features

  • load-balancer: add health check diagnostic details (#696) (80b74c9)

v2.25.1

Choose a tag to compare

@hcloud-bot hcloud-bot released this 17 Sep 07:46
61d7bcc

Bug Fixes

  • only send load balancer service health_check properties when defined (#691) (e3bf6f2)

v2.25.0

Choose a tag to compare

@hcloud-bot hcloud-bot released this 17 Sep 07:23
f7b8a31

Features

Bug Fixes

  • only send load balancer service certificates when defined (#690) (c6bc24a)

v2.24.0

Choose a tag to compare

@hcloud-bot hcloud-bot released this 11 Sep 11:14
ca4efb8

Features

v2.23.0

Choose a tag to compare

@hcloud-bot hcloud-bot released this 21 Jul 12:30
48f3424

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

  • remove datacenter property from server and primary_ip (#668) (abdadf3)
  • add deprecation info to load balancer type (#674) (aeebcf8)

v2.22.0

Choose a tag to compare

@hcloud-bot hcloud-bot released this 18 Jun 15:33
6fdc2d7

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

Choose a tag to compare

@hcloud-bot hcloud-bot released this 12 Jun 12:38
32ea380

Features

  • retry requests on api bad_gateway error (#658)

v2.20.0

Choose a tag to compare

@hcloud-bot hcloud-bot released this 07 May 14:27
0bbc9dd

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_idle http service field (#649)

v2.19.0

Choose a tag to compare

@hcloud-bot hcloud-bot released this 28 Apr 12:01
5dd14c4

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_type behavior changed when creating a primary ip (#647)