Enum HetznerError 

pub enum HetznerError {
    Http(Error),
    Api {
        code: String,
        message: String,
    },
    NotFound {
        resource_type: String,
        identifier: String,
    },
    AlreadyExists {
        resource_type: String,
        name: String,
    },
    InvalidParameter {
        parameter: String,
        reason: String,
    },
    Validation(String),
    Timeout {
        operation: String,
        timeout_secs: u64,
    },
    Serialization(Error),
    Unauthorized,
    Forbidden {
        details: String,
    },
    RateLimited {
        retry_after: Option<u64>,
    },
    ServerError {
        status_code: u16,
        details: String,
    },
    InvalidToken(String),
    BuilderError(String),
}

Comprehensive error type for Hetzner Cloud API operations.

This error type provides detailed context about what went wrong, including HTTP status codes, API error details, and contextual information.

Examples

use lmrc_hetzner::{HetznerClient, HetznerError};

let client = HetznerClient::builder()
    .api_token("your-token".to_string())
    .build()?;

match client.get::<serde_json::Value>("/servers").await {
    Ok(servers) => println!("Got servers: {:?}", servers),
    Err(HetznerError::Unauthorized) => {
        eprintln!("Invalid API token");
    }
    Err(HetznerError::RateLimited { retry_after }) => {
        eprintln!("Rate limited, retry after: {:?}", retry_after);
    }
    Err(e) => eprintln!("Other error: {}", e),
}

Variants

Http(Error)

HTTP request failed due to network or connection issues.

This typically indicates network problems, DNS failures, or connection timeouts.

Api

Hetzner API returned an error response.

Contains the error code and message from the API.

Fields

code: String

Error code from Hetzner API (e.g., “invalid_input”, “rate_limit_exceeded”)

message: String

Human-readable error message

NotFound

The requested resource was not found (HTTP 404).

This could mean the resource doesn’t exist or was already deleted.

Fields

resource_type: String

Type of resource (e.g., “server”, “network”, “firewall”)

identifier: String

The identifier used to lookup the resource

AlreadyExists

Resource already exists with the same name (HTTP 409).

Fields

resource_type: String

Type of resource that already exists

name: String

Name of the existing resource

InvalidParameter

Invalid input parameter or configuration.

Examples

use lmrc_hetzner::HetznerError;

let err = HetznerError::InvalidParameter {
    parameter: "ip_range".to_string(),
    reason: "Must be a valid CIDR notation (e.g., 10.0.0.0/16)".to_string(),
};

Fields

parameter: String

Name of the invalid parameter

reason: String

Explanation of why it’s invalid

Validation(String)

Validation failed for input data.

Timeout

Operation timed out waiting for completion.

Fields

operation: String

Description of the operation that timed out

timeout_secs: u64

Timeout duration in seconds

Serialization(Error)

JSON serialization or deserialization failed.

Unauthorized

Authentication failed (HTTP 401).

Usually indicates an invalid or expired API token.

Forbidden

Permission denied (HTTP 403).

The API token is valid but lacks permission for this operation.

Fields

details: String

Details about what permission is lacking

RateLimited

Rate limit exceeded (HTTP 429).

The API has rate limits. Wait before retrying.

Fields

retry_after: Option<u64>

Suggested time to wait before retrying

ServerError

Server error from Hetzner API (HTTP 5xx).

Fields

status_code: u16

HTTP status code

details: String

Error details if available

InvalidToken(String)

Invalid API token format.

BuilderError(String)

Builder configuration error.

Trait Implementations

impl Debug for HetznerError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for HetznerError

fn fmt(&self, __formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for HetznerError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for HetznerError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for HetznerError

fn from(source: Error) -> Self

Converts to this type from the input type.