Hetzner Cloud API - Rhai Wrapper

This project provides a Rhai wrapper for interacting with the Hetzner Cloud API, allowing you to manage your servers through simple scripts.

Setup

To use this wrapper, you need to set your Hetzner API Token as an environment variable. You can create your own API Token by following the steps from the Hetzner docs.

export HETZNER_API_TOKEN="YOUR_API_TOKEN_HERE"

Replace "YOUR_API_TOKEN_HERE" with your actual Hetzner API token.

Usage

You can execute any of the example scripts by passing the file path to cargo run.

cargo run -- examples/<script_name>.rhai

For example, to run the script that creates a server:

cargo run -- examples/01_create_server.rhai

Examples

The examples/ directory contains a collection of scripts demonstrating the available functionality. For detailed examples, please see the files in that directory:

• examples/01_create_server.rhai: Shows how to create a new server with various configuration options using a builder pattern.
• examples/02_list_servers.rhai: Lists all servers in your project.
• examples/03_get_server_details.rhai: Fetches and displays detailed information for a single server.
• examples/04_server_actions.rhai: Demonstrates how to reboot, reset, and manage rescue mode for a server.
• examples/05_list_ssh_keys.rhai: Lists all SSH keys in your project.
• examples/06_list_images.rhai: Shows how to list system images and snapshots, with examples of filtering and sorting.
• examples/07_install_image.rhai: Demonstrates server rebuild functionality using install_image (equivalent to traditional installimage).

Features

Server Management

• Create servers with flexible configuration options
• List and inspect server details and status
• Reboot and reset servers
• Rebuild servers with new images (install_image functionality)
• Rescue mode management

Image Management

• List images with advanced filtering (by type, status, architecture, etc.)
• Support for all image types: system, backup, snapshot, and app images
• Flexible image selection by name or ID

SSH Key Management

• List SSH keys in your project
• Automatic SSH key assignment during server creation