hetzner 1.0.0

A Rust library for managing DNS records and zones on Hetzner's platform, providing tools for networking and DNS management.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87

use crate::HetznerClient;
use crate::error::Result;
use crate::types::{CreatedRecord, RecordEnvelope, RecordsEnvelope};
use reqwest::Method;
use serde::Serialize;
use serde_json::json;

#[derive(Debug, Clone, Serialize)]
pub struct CreateRecordInput {
    pub value: String,
    pub ttl: u64,
    #[serde(rename = "type")]
    pub record_type: String,
    pub name: String,
    pub zone_id: String,
}

#[derive(Debug, Clone, Serialize)]
pub struct UpdateRecordInput {
    pub zone_id: String,
    #[serde(rename = "type")]
    pub record_type: String,
    pub name: String,
    pub value: String,
    pub ttl: u64,
}

#[derive(Debug, Clone, Copy)]
pub struct RecordsApi<'a> {
    pub(crate) client: &'a HetznerClient,
    pub(crate) zone_id: &'a str,
}

#[derive(Debug, Clone, Copy)]
pub struct RecordApi<'a> {
    pub(crate) client: &'a HetznerClient,
    pub(crate) record_id: &'a str,
}

impl<'a> RecordsApi<'a> {
    pub async fn list(self) -> Result<Vec<crate::types::Record>> {
        let path = format!("records?zone_id={}", self.zone_id);
        let response: RecordsEnvelope = self.client.request_dns(Method::GET, &path, None).await?;
        Ok(response.records)
    }

    pub async fn create(
        self,
        name: impl Into<String>,
        record_type: impl Into<String>,
        value: impl Into<String>,
        ttl: u64,
    ) -> Result<CreatedRecord> {
        let payload = CreateRecordInput {
            value: value.into(),
            ttl,
            record_type: record_type.into(),
            name: name.into(),
            zone_id: self.zone_id.to_string(),
        };

        self.client
            .request_dns(Method::POST, "records", Some(json!(payload)))
            .await
    }
}

impl<'a> RecordApi<'a> {
    pub async fn get(self) -> Result<RecordEnvelope> {
        let path = format!("records/{}", self.record_id);
        self.client.request_dns(Method::GET, &path, None).await
    }

    pub async fn update(self, input: UpdateRecordInput) -> Result<RecordEnvelope> {
        let path = format!("records/{}", self.record_id);
        self.client
            .request_dns(Method::PUT, &path, Some(json!(input)))
            .await
    }

    pub async fn delete(self) -> Result<()> {
        let path = format!("records/{}", self.record_id);
        self.client
            .request_dns_unit(Method::DELETE, &path, None)
            .await
    }
}