Pular para o conteúdo principal
POST
/
prefix-lists
Criar uma lista de prefixos
curl --request POST \
  --url https://api.altostrat.io/prefix-lists \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "IPs do Escritório Corporativo",
  "description": "IPs estáticos para nosso escritório corporativo principal.",
  "prefixes": [
    {
      "cidr": "203.0.113.0/28",
      "description": "Bloco do ISP Principal"
    },
    {
      "cidr": "198.51.100.10/32",
      "description": "ISP de Backup"
    }
  ],
  "sites": []
}'
{
  "id": "prfx_lst_0ujsswThIGTUYm2K8FjOOfxcYpw",
  "name": "IPs do Escritório Principal",
  "description": "Faixas de IP públicas para o escritório principal.",
  "status": "active",
  "sites": [
    "site_12345"
  ],
  "prefixes": [
    {
      "id": "prfx_0ujsswThIGTUYm2K8FjOOfxcYpw",
      "cidr": "192.0.2.0/24",
      "description": "Sub-rede principal de servidores"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

A autenticação é realizada por meio de um JSON Web Token (JWT) emitido pelo Auth0. Forneça o token no cabeçalho Authorization com o esquema Bearer.

Body

application/json

Os detalhes da nova lista de prefixos.

Define as propriedades graváveis para criar ou atualizar uma lista de prefixos.

​
name
string
required

Um nome legível por humanos para a lista de prefixos.

Maximum length: 255
Example:

"Endpoints de API de Terceiros"

​
prefixes
object[]
required

Uma lista de prefixos (blocos CIDR). A lista inteira é substituída na atualização.

Maximum length: 500
​
sites
string[]
required

Uma lista de IDs de sites onde esta lista de prefixos deve ser aplicada diretamente. A lista inteira de sites é substituída na atualização.

​
description
string | null

Uma descrição opcional para a lista de prefixos.

Maximum length: 1000
Example:

"IPs estáticos para serviços com os quais integramos."

Response

A lista de prefixos foi criada com sucesso.

Representa uma coleção nomeada e reutilizável de endereços IP e blocos CIDR.

​
id
string

O identificador único para a lista de prefixos, prefixado com prfx_lst_.

Example:

"prfx_lst_0ujsswThIGTUYm2K8FjOOfxcYpw"

​
name
string

Um nome legível por humanos para a lista de prefixos.

Example:

"IPs do Escritório Principal"

​
description
string

Uma descrição opcional para a lista de prefixos.

Example:

"Faixas de IP públicas para o escritório principal."

​
status
enum<string>

O status de sincronização atual da lista de prefixos.

Opções disponíveis:
active,
syncing,
failed
Example:

"active"

​
sites
string[]

Uma lista de IDs de sites onde esta lista de prefixos é aplicada diretamente.

​
prefixes
object[]

A lista de blocos CIDR nesta lista de prefixos.