Welcome to Hetzner Cloud DotNet

This library allows you to manage all the services offered by Hetzner Cloud, with this library you can manage and automate the creation of servers until the implementation of applications that allow you to scale horizontally.

📢 ATTENTION: This package has been marked as obsolete 📢

Hello to all HetznerCloudApiDotNet users 👋. We want to inform you that this library will no longer be actively maintained. But don't worry, we have something better for you! 😃

🚀 Introducing the new and improved package: HetznerCloud.API 🚀

This new package is the advanced version of HetznerCloudApiDotNet. Here are some key points:

Better Documentation: We've worked hard to ensure you understand everything you need to know quickly and easily.
Easier to Use: Designed with simplicity in mind, so you can integrate it into your projects without any complications.
Method Compatibility: All methods are backward compatible, requiring very few changes for migration.
Updated Features: Take advantage of the latest features and improvements in managing the Hetzner Cloud API.

🔗 Find the new package here: github.com/ljchuello/HetznerCloud.API

We encourage you to migrate to this new package for a better experience, easy adaptation, and ongoing support. If you have any questions or need help with the migration, feel free to contact us.

Thank you for your continued support! 🙏

Compatibility

This library is developed in .NET Standard 2.1 and is compatible with all .NET and .NET Core implementations (.NET Framework is not supported), it can also be used in Console projects, Web API, Class Library and even with Blazor WASM .

.NET implementation	Version support
.NET and .NET Core	3.0, 3.1, 5.0, 6.0, 7.0
.NET Framework	N/A

Installation

To install you must go to Nuget package manager and search for "HetznerCloudApiDotNet" and then install.

NuGet Package

PM> Install-Package HetznerCloudApiDotNet

Usage

// Set token
HetznerDotNet.ApiCore.ApiToken = "UltraPrivateSecretKeyHetzner";

// Get SSH
HetznerDotNet.Api.SshKey sshKey = await HetznerDotNet.Api.SshKey.Get(123456789);

// Get location
HetznerDotNet.Api.Location location = await HetznerDotNet.Api.Location.Get(3);

// Get Ubuntu image
HetznerDotNet.Api.Image image = await HetznerDotNet.Api.Image.Get(67794396);

// Create Server
await HetznerDotNet.Api.Server.Create("Server Test", new List<long> { sshKey.Id }, location.Id, image.Id, 15);

Implemented functionality

✔️ - Available on API, implemented
❌ - Available on API, not implemented
➖ - Not available on API

	Get one	Get all	Create	Update	Delete	Actions
Certificates	❌	❌	❌	❌	❌	❌
Datacenters	✔️	✔️	➖	➖	➖	➖
Firewalls	✔️	✔️	✔️	✔️	✔️	✔️
Floating IPs	❌	❌	❌	❌	❌	❌
Images	✔️	✔️	➖	➖	➖	➖
ISOs	❌	❌	➖	➖	➖	➖
Load Balancers	✔️	✔️	✔️	✔️	✔️	✔️
Locations	✔️	✔️	➖	➖	➖	➖
Primary IPs	❌	❌	❌	❌	❌	❌
Networks	✔️	✔️	✔️	✔️	✔️	✔️
Placement Groups	✔️	✔️	✔️	✔️	✔️	✔️
Pricing	➖	❌	➖	➖	➖	➖
Servers	✔️	✔️	✔️	❌	❌	❌
Server Types	✔️	✔️	➖	➖	➖	➖
SSH Keys	✔️	✔️	✔️	✔️	✔️	➖
Volumes	✔️	✔️	✔️	✔️	✔️	✔️

To have the complete list of the functionalities implemented in this library consult the Wiki

Made with ❤️ in LATAM for the 🌎

ljchuello / Hetzner-Cloud-DotNet