API, riga di comando e Terraform

1. Crea una chiave API

Crea una chiave dalla pagina Chiavi API del pannello. Una chiave è legata a un solo account e non ha mai più permessi del tuo ruolo al suo interno; può essere di sola lettura, limitata a prodotti specifici e dotata di una data di scadenza. La chiave completa viene mostrata una sola volta, al momento della creazione.

2. La tua prima richiesta

Invia la chiave nell'intestazione Authorization:

curl -H "Authorization: Bearer hz_..." \
  https://api.haizora.com/v1/portal/servers

Cosa devi sapere

• Le chiavi di sola lettura possono effettuare solo richieste di lettura e si comportano come un ruolo di sola lettura sull'account.
• Una chiave di scrittura opera con il ruolo attuale di chi l'ha creata; se la persona viene rimossa dall'account, la chiave diventa subito non valida.
• Con una chiave non si possono creare altre chiavi; le azioni su team e inviti si fanno solo dal pannello.
• Le risposte di errore contengono i campi error.code ed error.message.
• Ogni chiave può effettuare al massimo 300 richieste al minuto; in caso di superamento viene restituito 429 con un'intestazione Retry-After.

Strumento da riga di comando: haizoraIn preparazione per la pubblicazione

Uno strumento Node.js senza dipendenze per accesso, elenco dei server e azioni di alimentazione, record DNS e pubblicazione di funzioni (Node 18 o superiore).

haizora login                   # paste an hz_... token
haizora servers list
haizora servers power <id> reboot
haizora dns list example.com
haizora dns add example.com A www 203.0.113.10 --ttl 300
haizora workers deploy ./worker.js --name hello

Provider TerraformIn preparazione per la pubblicazione

Risorse per server, database gestiti, funzioni serverless e record DNS. Le risorse server e database generano ordini; il servizio viene predisposto dopo il pagamento della fattura.

provider "haizora" {}   # HAIZORA_TOKEN

resource "haizora_dns_record" "www" {
  domain_id = data.haizora_domain.main.id
  type      = "A"
  name      = "www"
  value     = "203.0.113.10"
}

resource "haizora_function" "hello" {
  name = "hello"
  code = file("worker.js")
}

Lo strumento da riga di comando e il provider Terraform non sono ancora stati pubblicati su npm e su Terraform Registry. Nel frattempo puoi usare direttamente l'API REST.

Riferimento API

Questo elenco è generato dal documento OpenAPI 3.1. Puoi scaricare il documento per generare un client con Postman, Insomnia o openapi-generator.