std.cloud — Cloudflare-Units

Cloudflare API v4 Bindings für Lyx: 16 Units für alle Cloudflare-Dienste. Authentifizierung über API-Token (empfohlen) oder Legacy API-Key + E-Mail. Der HTTP-Transport nutzt std.net.https mit automatischem Retry.

→ std.cloud · Standard Library

Drei Authentifizierungsarten — API-Token ist die empfohlene Methode:

CFClient wird aus CFCredentials erstellt und an alle Service-Funktionen übergeben. Cloudflare-Antworten unterscheiden sich von AWS: Die API liefert immer HTTP 200 — der Erfolg wird über das success-Feld in CFResponse signalisiert.

import std.cloud.cf.credentials;
import std.cloud.cf.transport;
import std.cloud.cf.zones;

fn main(): int64 {
    // Credentials aus Umgebung laden
    var creds: CFCredentials := CFCredentialsFromEnv();
    var c: CFClient := CFClientNew(creds);

    // Alle Zones des Accounts
    var result: int64 := ZoneList(c, creds.accountId as pchar);
    if (result != 0) {
        Print(result as pchar);
        PrintLn(""c);
        free(result, StrLen(result as pchar) + 1);
    }

    CFClientFree(c);
    CFCredentialsFree(creds);
    return 0;
}

Umgebungsvariablen:

Domain-Verwaltung. Eine Zone entspricht einer Domain. 29 pub Items.

DNS-Records verwalten. 23 pub Items.

import std.cloud.cf.credentials;
import std.cloud.cf.transport;
import std.cloud.cf.dns;

fn main(): int64 {
    var creds: CFCredentials := CFCredentialsFromEnv();
    var c: CFClient := CFClientNew(creds);

    // A-Record setzen (oder aktualisieren, falls schon vorhanden)
    var r: CFDNSRecord := DNSRecordUpsert(c,
        "abc123def456"c,   // zoneId
        "A"c,              // Typ
        "api"c,            // Name → api.meine-domain.de
        "1.2.3.4"c,        // Content
        1,                 // TTL (1 = auto)
        1                  // proxied: 1 = ja (oranges Wolkensymbol)
    );
    CFDNSRecordFree(r);

    CFClientFree(c);
    CFCredentialsFree(creds);
    return 0;
}

Cloudflare Workers: serverless JavaScript/WASM an Cloudflares Edge deployen. 27 pub Items.

Workers KV: globaler Key-Value-Store für Worker-Scripts. 19 pub Items.

Cloudflare R2: S3-kompatibler Objekt-Speicher ohne Egress-Kosten. 27 pub Items.

R2 verwendet einen eigenen R2Conn-Handle (nicht CFClient), der über R2Connect erstellt wird.

D1: SQLite-Datenbank an Cloudflares Edge (für Worker-Bindings). 24 pub Items.

import std.cloud.cf.credentials;
import std.cloud.cf.transport;
import std.cloud.cf.d1;

fn main(): int64 {
    var creds: CFCredentials := CFCredentialsFromEnv();
    var c: CFClient := CFClientNew(creds);

    var db: CFD1Database := D1GetByName(c, creds.accountId as pchar, "meine-db"c);

    // Tabelle anlegen
    D1Exec(c, creds.accountId as pchar, db.id as pchar,
           "CREATE TABLE IF NOT EXISTS users (id INTEGER PRIMARY KEY, name TEXT)"c);

    // Datensatz einfügen
    D1Exec(c, creds.accountId as pchar, db.id as pchar,
           "INSERT INTO users (name) VALUES ('Alice')"c);

    // Abfrage
    var params: array<pchar> := [];
    var result: D1Result := D1Query(c, creds.accountId as pchar, db.id as pchar,
                                    "SELECT * FROM users"c, 0 as int64, 0);
    D1ResultFree(result);
    CFD1DatabaseFree(db);

    CFClientFree(c);
    CFCredentialsFree(creds);
    return 0;
}

Cache-Verwaltung, Page Rules und Transform Rules. 31 pub Items.

Häufig verwendete Konstanten für ZoneSettingSet:

Web Application Firewall: Firewall-Rules, IP-Sperren, Rate Limiting. 32 pub Items.

Cloudflare Load Balancer: Health Checks, Pools, Load Balancer. 20 pub Items.

Cloudflare Pages: statische Sites und Full-Stack-Apps deployen. 23 pub Items.

Cloudflare Tunnel (ehemals Argo Tunnel): Server hinter NAT/Firewall öffentlich erreichbar machen ohne offene Ports. 22 pub Items.

Email Routing: eingehende E-Mails an Adressen oder Worker weiterleiten. 19 pub Items.

Zone-Analytics, GraphQL-API und Logpush. 14 pub Items.

Letzte Aktualisierung: 2026-06-12