Langsung ke konten utama
POST
/
prefix-lists
Membuat daftar prefiks
curl --request POST \
  --url https://api.altostrat.io/prefix-lists \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "IP Kantor Korporat",
  "description": "IP statis untuk kantor korporat utama kami.",
  "prefixes": [
    {
      "cidr": "203.0.113.0/28",
      "description": "Blok ISP Utama"
    },
    {
      "cidr": "198.51.100.10/32",
      "description": "ISP Cadangan"
    }
  ],
  "sites": []
}'
{
  "id": "prfx_lst_0ujsswThIGTUYm2K8FjOOfxcYpw",
  "name": "IP Kantor Pusat",
  "description": "Rentang IP publik untuk kantor pusat.",
  "status": "active",
  "sites": [
    "site_12345"
  ],
  "prefixes": [
    {
      "id": "prfx_0ujsswThIGTUYm2K8FjOOfxcYpw",
      "cidr": "192.0.2.0/24",
      "description": "Subnet server utama"
    }
  ]
}

Authorizations

โ€‹
Authorization
string
header
required

Autentikasi dilakukan melalui JSON Web Token (JWT) yang dikeluarkan oleh Auth0. Sediakan token di header Authorization dengan skema Bearer.

Body

application/json

Detail dari daftar prefiks yang baru.

Mendefinisikan properti yang dapat ditulis untuk membuat atau memperbarui daftar prefiks.

โ€‹
name
string
required

Nama yang dapat dibaca manusia untuk daftar prefiks.

Maximum length: 255
Example:

"Endpoint API Pihak Ketiga"

โ€‹
prefixes
object[]
required

Daftar prefiks (blok CIDR). Seluruh daftar diganti saat pembaruan.

Maximum length: 500
โ€‹
sites
string[]
required

Daftar ID situs di mana daftar prefiks ini harus diterapkan secara langsung. Seluruh daftar situs diganti saat pembaruan.

โ€‹
description
string | null

Deskripsi opsional untuk daftar prefiks.

Maximum length: 1000
Example:

"IP statis untuk layanan yang terintegrasi dengan kami."

Response

Daftar prefiks berhasil dibuat.

Mewakili koleksi bernama yang dapat digunakan kembali dari alamat IP dan blok CIDR.

โ€‹
id
string

Pengidentifikasi unik untuk daftar prefiks, diawali dengan prfx_lst_.

Example:

"prfx_lst_0ujsswThIGTUYm2K8FjOOfxcYpw"

โ€‹
name
string

Nama yang dapat dibaca manusia untuk daftar prefiks.

Example:

"IP Kantor Pusat"

โ€‹
description
string

Deskripsi opsional untuk daftar prefiks.

Example:

"Rentang IP publik untuk kantor pusat."

โ€‹
status
enum<string>

Status sinkronisasi saat ini dari daftar prefiks.

Opsi yang tersedia:
active,
syncing,
failed
Example:

"active"

โ€‹
sites
string[]

Daftar ID situs di mana daftar prefiks ini diterapkan secara langsung.

โ€‹
prefixes
object[]

Daftar blok CIDR dalam daftar prefiks ini.