API, linha de comando e Terraform

1. Crie uma chave de API

No painel, crie uma chave na página Chaves de API. A chave é vinculada a uma única conta e não tem mais permissões do que o seu papel nela; pode ser somente leitura, limitada a determinados produtos e ter data de expiração. A chave completa é exibida uma única vez, no momento da criação.

2. Sua primeira requisição

Envie a chave no cabeçalho Authorization:

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

O que você precisa saber

• Chaves somente leitura só podem fazer requisições de leitura e se comportam como o papel somente leitura na conta.
• Uma chave de escrita funciona com o papel que quem a criou tem no momento; se essa pessoa for removida da conta, a chave deixa de valer imediatamente.
• Não é possível criar outra chave usando uma chave; as ações de equipe e de convites só podem ser feitas pelo painel.
• As respostas de erro trazem os campos error.code e error.message.
• São permitidas no máximo 300 requisições por minuto para cada chave; ao exceder, a resposta é 429 com o cabeçalho Retry-After.

Ferramenta de linha de comando: haizoraEm preparação para lançamento

Uma ferramenta Node.js sem dependências (Node 18 ou superior) para login, listagem de servidores e ações de energia, registros DNS e publicação de funções.

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

Provedor TerraformEm preparação para lançamento

Recursos de servidor, banco de dados gerenciado, função serverless e registro DNS. Os recursos de servidor e de banco de dados criam um pedido; o serviço é provisionado depois que a fatura é paga.

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")
}

A ferramenta de linha de comando e o provedor Terraform ainda não foram publicados no npm nem no Terraform Registry. Até lá, você pode usar a API REST diretamente.

Referência da API

Esta lista é gerada a partir do documento OpenAPI 3.1. Você pode baixar o documento para gerar clientes com Postman, Insomnia ou openapi-generator.