API, 명령줄, Terraform

1. API 키 만들기

패널의 API 키 페이지에서 키를 만드세요. 키는 하나의 계정에 연결되며 해당 계정에서의 내 역할보다 높은 권한을 갖지 않습니다. 읽기 전용으로 만들 수 있고, 특정 제품으로 제한할 수 있으며, 만료일을 지정할 수 있습니다. 키 전체는 만들 때 한 번만 표시됩니다.

2. 첫 번째 요청

Authorization 헤더에 키를 담아 보내세요.

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

알아 두어야 할 사항

• 읽기 전용 키는 읽기 요청만 할 수 있으며, 계정에서 읽기 전용 역할처럼 동작합니다.
• 쓰기 키는 만든 사람의 현재 역할로 동작하며, 만든 사람이 계정에서 제거되면 키는 즉시 무효가 됩니다.
• 키로 다른 키를 만들 수 없습니다. 팀 및 초대 작업은 패널에서만 할 수 있습니다.
• 오류 응답에는 error.code와 error.message 필드가 포함됩니다.
• 키당 분당 최대 300개의 요청을 보낼 수 있으며, 초과하면 429와 Retry-After 헤더가 반환됩니다.

명령줄 도구: haizora출시 준비 중

로그인, 서버 목록 조회 및 전원 작업, DNS 레코드, 함수 배포를 지원하는 의존성 없는 Node.js 도구입니다 (Node 18 이상).

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

Terraform 프로바이더출시 준비 중

서버, 관리형 데이터베이스, 서버리스 함수, DNS 레코드 리소스를 지원합니다. 서버와 데이터베이스 리소스는 주문을 생성하며, 청구서가 결제된 후 서비스가 준비됩니다.

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

명령줄 도구와 Terraform 프로바이더는 아직 npm과 Terraform Registry에 게시되지 않았습니다. 그때까지는 REST API를 직접 사용할 수 있습니다.

API 레퍼런스

이 목록은 OpenAPI 3.1 문서에서 생성됩니다. Postman, Insomnia 또는 openapi-generator로 클라이언트를 생성하려면 문서를 다운로드하세요.