Vai al contenuto principale
POST
/
prefix-lists
Crea una lista di prefissi
curl --request POST \
  --url https://api.altostrat.io/prefix-lists \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "IP Ufficio Aziendale",
  "description": "IP statici per il nostro ufficio aziendale principale.",
  "prefixes": [
    {
      "cidr": "203.0.113.0/28",
      "description": "Blocco ISP primario"
    },
    {
      "cidr": "198.51.100.10/32",
      "description": "ISP di backup"
    }
  ],
  "sites": []
}'
{
  "id": "prfx_lst_0ujsswThIGTUYm2K8FjOOfxcYpw",
  "name": "IP Ufficio Principale",
  "description": "Intervalli di IP pubblici per l'ufficio principale.",
  "status": "active",
  "sites": [
    "site_12345"
  ],
  "prefixes": [
    {
      "id": "prfx_0ujsswThIGTUYm2K8FjOOfxcYpw",
      "cidr": "192.0.2.0/24",
      "description": "Subnet server principale"
    }
  ]
}

Authorizations

Authorization
string
header
required

L'autenticazione viene eseguita tramite un JSON Web Token (JWT) emesso da Auth0. Fornire il token nell'header Authorization con lo schema Bearer.

Body

application/json

I dettagli della nuova lista di prefissi.

Definisce le proprietà scrivibili per la creazione o l'aggiornamento di una lista di prefissi.

name
string
required

Un nome leggibile per la lista di prefissi.

Maximum length: 255
Example:

"Endpoint API di Terze Parti"

prefixes
object[]
required

Un elenco di prefissi (blocchi CIDR). L'intero elenco viene sostituito durante l'aggiornamento.

Maximum length: 500
sites
string[]
required

Un elenco di ID di siti in cui questa lista di prefissi dovrebbe essere applicata direttamente. L'intero elenco di siti viene sostituito durante l'aggiornamento.

description
string | null

Una descrizione opzionale per la lista di prefissi.

Maximum length: 1000
Example:

"IP statici per servizi con cui ci integriamo."

Response

La lista di prefissi è stata creata con successo.

Rappresenta una collezione riutilizzabile e nominata di indirizzi IP e blocchi CIDR.

id
string

L'identificatore univoco per la lista di prefissi, con prefisso prfx_lst_.

Example:

"prfx_lst_0ujsswThIGTUYm2K8FjOOfxcYpw"

name
string

Un nome leggibile per la lista di prefissi.

Example:

"IP Ufficio Principale"

description
string

Una descrizione opzionale per la lista di prefissi.

Example:

"Intervalli di IP pubblici per l'ufficio principale."

status
enum<string>

Lo stato di sincronizzazione attuale della lista di prefissi.

Opzioni disponibili:
active,
syncing,
failed
Example:

"active"

sites
string[]

Un elenco di ID di siti in cui questa lista di prefissi è applicata direttamente.

prefixes
object[]

L'elenco dei blocchi CIDR in questa lista di prefissi.