Saltar al contenido principal
PUT
/
prefix-lists
/
{prefixListId}
Actualizar una lista de prefijos
curl --request PUT \
  --url https://api.altostrat.io/prefix-lists/{prefixListId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "IPs Oficina Corporativa",
  "description": "IPs estáticas para nuestra oficina corporativa principal.",
  "prefixes": [
    {
      "cidr": "203.0.113.0/28",
      "description": "Bloque ISP Principal"
    },
    {
      "cidr": "198.51.100.10/32",
      "description": "ISP de Respaldo"
    }
  ],
  "sites": []
}'
{
  "id": "prfx_lst_0ujsswThIGTUYm2K8FjOOfxcYpw",
  "name": "IPs Oficina Principal",
  "description": "Rangos de IP públicas para la oficina principal.",
  "status": "active",
  "sites": [
    "site_12345"
  ],
  "prefixes": [
    {
      "id": "prfx_0ujsswThIGTUYm2K8FjOOfxcYpw",
      "cidr": "192.0.2.0/24",
      "description": "Subred principal de servidores"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

La autenticación se realiza mediante un JSON Web Token (JWT) emitido por Auth0. Proporcione el token en la cabecera Authorization con el esquema Bearer.

Path Parameters

​
prefixListId
string
required

El identificador único para la lista de prefijos a actualizar.

Example:

"prfx_lst_0ujsswThIGTUYm2K8FjOOfxcYpw"

Body

application/json

El nuevo estado para la lista de prefijos.

Define las propiedades escribibles para crear o actualizar una lista de prefijos.

​
name
string
required

Un nombre legible por humanos para la lista de prefijos.

Maximum length: 255
Example:

"Puntos de Conexión de API de Terceros"

​
prefixes
object[]
required

Una lista de prefijos (bloques CIDR). La lista completa se reemplaza en la actualización.

Maximum length: 500
​
sites
string[]
required

Una lista de IDs de sitios donde esta lista de prefijos debe ser aplicada directamente. La lista completa de sitios se reemplaza en la actualización.

​
description
string | null

Una descripción opcional para la lista de prefijos.

Maximum length: 1000
Example:

"IPs estáticas para servicios con los que nos integramos."

Response

El objeto de la lista de prefijos actualizado.

Representa una colección reutilizable y con nombre de direcciones IP y bloques CIDR.

​
id
string

El identificador único para la lista de prefijos, con el prefijo prfx_lst_.

Example:

"prfx_lst_0ujsswThIGTUYm2K8FjOOfxcYpw"

​
name
string

Un nombre legible por humanos para la lista de prefijos.

Example:

"IPs Oficina Principal"

​
description
string

Una descripción opcional para la lista de prefijos.

Example:

"Rangos de IP públicas para la oficina principal."

​
status
enum<string>

El estado de sincronización actual de la lista de prefijos.

Opciones disponibles:
active,
syncing,
failed
Example:

"active"

​
sites
string[]

Una lista de IDs de sitios donde esta lista de prefijos se aplica directamente.

​
prefixes
object[]

La lista de bloques CIDR en esta lista de prefijos.