BGP-API

Send inn ASN-er og opprett eller slett BGP-sesjoner. I Flux, se BGP og Servere → BGP.

Alle endepunkter krever Bearer-token-autentisering.

GET /bgp

Responsen inneholder:

• asn: alle ASN-er på kontoen uansett tilstand, med IRR-informasjon, status, rejected_reason og auth_token. Et ASN som venter på verifisering, har status pending.
• prefix_lists: IPv4- og IPv6-prefikslistene.
• sessions: konfigurerte BGP-sesjoner på tvers av alle servere.

curl https://api.gigahost.no/api/v0/bgp \
  -H "Authorization: Bearer $TOKEN"

POST /bgp/asn

Send inn et ASN for godkjenning. Maks 5 ASN-er per kunde.

Bodyen er form-kodet (application/x-www-form-urlencoded), ikke JSON.

Felt	Type	Beskrivelse
asn	number eller string	212345 eller AS212345 (AS-prefikset er valgfritt).

curl -X POST https://api.gigahost.no/api/v0/bgp/asn \
  -H "Authorization: Bearer $TOKEN" \
  -d 'asn=AS212345'

Respons:

{
  "meta": {
    "status": 200,
    "status_message": "200 OK",
    "message": "ASN and LOA has been submitted for review."
  },
  "data": {
    "id": 42,
    "asn": 212345,
    "asn_name": "EXAMPLE-AS",
    "asn_country": "NO",
    "status": "pending",
    "auth_token": "<40 heksadesimale tegn>"
  }
}

Legg auth_token inn i aut-num-objektet for ASN-et hos RIR-en din. Tokenet sendes også til e-postadressen på kontoen og returneres i GET /bgp. Gigahost sjekker tokenet og godkjenner ASN-et manuelt; til da står status på pending.

Grensen teller alle ASN-er på kontoen, også avviste. Bare support kan fjerne et ASN.

Feil (400):

• ASN is not valid
• Only five ASNs can be configured at a time. Contact support to remove an ASN first.
• The ASN already exists in the database. (ASN-et finnes allerede på kontoen din)

POST /bgp/{asn_id}/session

Opprett en BGP-peeringsesjon for et godkjent ASN. {asn_id} er IDen fra GET /bgp, ikke AS-nummeret.

Felt	Type	Beskrivelse
redundant	number	0 eller 1.
defaultroute	number	0 (full tabell) eller 1 (kun standardrute).
ip_id_v4	number	Valgfri. IPv4-ID for det lokale endepunktet.
ip_id_v6	number	Valgfri. IPv6-ID for det lokale endepunktet.

Minst én av ip_id_v4 eller ip_id_v6 må oppgis.

curl -X POST https://api.gigahost.no/api/v0/bgp/42/session \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "redundant": 0,
    "defaultroute": 0,
    "ip_id_v4": 12345,
    "ip_id_v6": 12346
  }'

DELETE /bgp/{session_id}/session

Marker en sesjon for sletting. Slettingen behandles asynkront: sesjonen går til tilstanden Deletion og fjernes fra ruteren ved neste kjøring.

curl -X DELETE https://api.gigahost.no/api/v0/bgp/9001/session \
  -H "Authorization: Bearer $TOKEN"