Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/lk-code/hetzner-cloud-api-net

the project is a .NET library to access the Hetzner Cloud
https://github.com/lk-code/hetzner-cloud-api-net

blazor csharp dotnet hetzner hetzner-cloud maui nuget uwp winui wpf xamarin

Last synced: about 1 month ago
JSON representation

the project is a .NET library to access the Hetzner Cloud

Awesome Lists containing this project

README

        

# Hetzner Cloud API for .NET

![Hetzner Cloud API for .NET](https://raw.githubusercontent.com/lk-code/hetzner-cloud-api-net/main/icon_128.png)

[![.NET Version](https://img.shields.io/badge/dotnet%20version-net6.0-blue?style=flat-square)](http://www.nuget.org/packages/hetznercloudapi/)
[![License](https://img.shields.io/github/license/lk-code/hetzner-cloud-api-net.svg?style=flat-square)](https://github.com/lk-code/hetzner-cloud-api-net/blob/master/LICENSE)
[![Build](https://github.com/lk-code/hetzner-cloud-api-net/actions/workflows/dotnet.yml/badge.svg)](https://github.com/lk-code/hetzner-cloud-api-net/actions/workflows/dotnet.yml)
[![Downloads](https://img.shields.io/nuget/dt/hetznercloudapi.svg?style=flat-square)](http://www.nuget.org/packages/hetznercloudapi/)
[![NuGet](https://img.shields.io/nuget/v/hetznercloudapi.svg?style=flat-square)](http://nuget.org/packages/hetznercloudapi)

[![Lines of Code](https://sonarcloud.io/api/project_badges/measure?project=lk-code_hetzner-cloud-api-net&metric=ncloc)](https://sonarcloud.io/summary/new_code?id=lk-code_hetzner-cloud-api-net)
[![Vulnerabilities](https://sonarcloud.io/api/project_badges/measure?project=lk-code_hetzner-cloud-api-net&metric=vulnerabilities)](https://sonarcloud.io/summary/new_code?id=lk-code_hetzner-cloud-api-net)

Here you can find a .NET library for the Hetzner Cloud API, with which all functions of the endpoints can be used.

The current version is provided as .NET Standard 2.0, currently I am working on a new version for .NET 6 (with features like dependency injection, etc.)

Buy Me A Coffee

# Hetzner Cloud API Client for .NET

## installation

see the getting started page here https://github.com/lk-code/hetzner-cloud-api-net/wiki/getting-started

## demo

see the demo projects here https://github.com/lk-code/hetzner-cloud-api-net-demo

## documentation

see the documentation on https://github.com/lk-code/hetzner-cloud-api-net/wiki

## informations :)

see the demo projects here https://github.com/lk-code/hetzner-cloud-api-net-demo

# New Documentation for Hetzner Cloud API Client (based on v3-Client)

[![.NET Version](https://img.shields.io/badge/dotnet%20version-net8.0-blue?style=flat-square)](http://www.nuget.org/packages/hetznercloudapi/)
[![License](https://img.shields.io/github/license/lk-code/hetzner-cloud-api-net.svg?style=flat-square)](https://github.com/lk-code/hetzner-cloud-api-net/blob/master/LICENSE)
[![Build](https://github.com/lk-code/hetzner-cloud-api-net/actions/workflows/dotnet.yml/badge.svg)](https://github.com/lk-code/hetzner-cloud-api-net/actions/workflows/dotnet.yml)
[![Downloads](https://img.shields.io/nuget/dt/hetznercloudapi.svg?style=flat-square)](http://www.nuget.org/packages/hetznercloudapi/)
[![NuGet](https://img.shields.io/nuget/v/hetznercloudapi.svg?style=flat-square)](http://nuget.org/packages/hetznercloudapi)

[![Lines of Code](https://sonarcloud.io/api/project_badges/measure?project=lk-code_hetzner-cloud-api-net&metric=ncloc)](https://sonarcloud.io/summary/new_code?id=lk-code_hetzner-cloud-api-net)
[![Vulnerabilities](https://sonarcloud.io/api/project_badges/measure?project=lk-code_hetzner-cloud-api-net&metric=vulnerabilities)](https://sonarcloud.io/summary/new_code?id=lk-code_hetzner-cloud-api-net)

## installation

The v3 client is currently only available as a **prerelease**. Accordingly, the **"Include Prerelease"** flag must be set in the NuGet search.

```
dotnet add package hetznercloudapi
```

## usage

### initialization

#### API Token via AppSettings

add the following block to your AppSettings:

```
{
"HetznerCloud": {
"ApiToken": "YOUR_API_TOKEN"
}
}
```

#### Load API Token dynamically

Alternatively, the API token can also be set dynamically:

```
IHetznerCloudService _hetznerCloudService = {get instance via DI};

...

_hetznerCloudService.LoadApiToken("{YOUR_API_TOKEN}");
```

### Server

Access via `IServerService`

#### Get all servers

Definition:

```
Task> GetAllAsync(int page = 1,
int itemsPerPage = 25,
List? filter = null,
Sorting? sorting = null,
CancellationToken cancellationToken = default);
```

[![Contributors](https://contrib.rocks/image?repo=lk-code/hetzner-cloud-api-net)](https://github.com/lk-code/hetzner-cloud-api-net/graphs/contributors)