Vai al contenuto principale
PUT
/
prefix-lists
/
{prefixListId}
Aggiorna una lista di prefissi
curl --request PUT \
  --url https://api.altostrat.io/prefix-lists/{prefixListId} \
  --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.

Path Parameters

prefixListId
string
required

L'identificatore univoco della lista di prefissi da aggiornare.

Example:

"prfx_lst_0ujsswThIGTUYm2K8FjOOfxcYpw"

Body

application/json

Il nuovo stato per la 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

L'oggetto della lista di prefissi aggiornato.

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.