Vai al contenuto principale
GET
/
instances
Elenca tutte le istanze VPN
curl --request GET \
  --url https://api.altostrat.io/instances \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
    "name": "VPN di Produzione Primaria",
    "region": "sjc",
    "hostname": "my-vpn-gateway.vpn.altostr.at",
    "configured": true,
    "rsa_ready": true,
    "diffie_hellman_ready": true,
    "server_ready": true,
    "status": [
      "peer-created"
    ],
    "pushed_routes": [
      "10.0.0.0/8"
    ],
    "public_dns": [
      "9.9.9.9"
    ],
    "split_dns": [
      "192.168.1.1"
    ],
    "domains": [
      "internal.corp"
    ],
    "dns_custom": [
      {
        "name": "fileserver.internal.corp",
        "type": "A",
        "value": "192.168.1.10"
      }
    ],
    "firewall": [
      {
        "name": "Consenti ICMP",
        "protocol": "icmp",
        "port": "1-65535",
        "source": "0.0.0.0/0",
        "destination": "0.0.0.0/0"
      }
    ],
    "created_at": "2025-10-29T12:30:31Z"
  }
]

Authorizations

​
Authorization
string
header
required

Inserisci il tuo bearer token nel formato: Bearer {token}

Response

Un elenco di istanze VPN.

​
id
string<uuid>

L'identificatore univoco per l'istanza VPN.

Example:

"d290f1ee-6c54-4b01-90e6-d701748f0851"

​
name
string

Un nome leggibile per l'istanza.

Example:

"VPN di Produzione Primaria"

​
region
string

La regione geografica in cui è distribuita l'istanza.

Example:

"sjc"

​
hostname
string

Il nome di dominio completo (FQDN) dell'istanza VPN.

Example:

"my-vpn-gateway.vpn.altostr.at"

​
configured
boolean

Indica se la configurazione iniziale del server è stata completata.

Example:

true

​
rsa_ready
boolean

Indica se i certificati RSA sono stati generati.

Example:

true

​
diffie_hellman_ready
boolean

Indica se i parametri Diffie-Hellman sono stati generati.

Example:

true

​
server_ready
boolean

Un indicatore generale dello stato di prontezza del server.

Example:

true

​
status
string[]

Un array di stringhe che indica eventuali modifiche di configurazione in corso. Un array vuoto significa che la configurazione è stabile.

Example:
["peer-created"]
​
pushed_routes
string[]

Un elenco di route di rete (in notazione CIDR) che verranno distribuite ai client in connessione.

​
public_dns
string<ipv4>[]

Un elenco di server DNS pubblici da utilizzare per i client.

​
split_dns
string<ipv4>[]

Un elenco di server DNS privati per domini specifici (DNS split-tunnel).

​
domains
string[]

Un elenco di nomi di dominio che dovrebbero essere risolti utilizzando i server split_dns.

​
dns_custom
object[]

Un elenco di record DNS personalizzati che verranno serviti dal proxy DNS dell'istanza.

​
firewall
object[]

Un elenco di regole firewall applicate all'istanza.

​
created_at
string<date-time>

La data e l'ora di creazione dell'istanza.

Example:

"2025-10-29T12:30:31Z"