Saltar al contenido principal
GET
/
prefix-lists
/
{prefixListId}
Obtener una lista de prefijos
curl --request GET \
  --url https://api.altostrat.io/prefix-lists/{prefixListId} \
  --header 'Authorization: Bearer <token>'
{
  "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, con el prefijo prfx_lst_.

Example:

"prfx_lst_0ujsswThIGTUYm2K8FjOOfxcYpw"

Response

El objeto de la lista de prefijos solicitado.

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.