Ottenere l'ambiente corrente

GET /v1/environment · permesso environment-settings:read

Restituisce l'ambiente a cui appartiene la credenziale chiamante: il suo ID, il tipo, la regione, la cella, lo stato e il piano. L'ambiente proviene sempre dalla credenziale; questo endpoint non può leggere un altro ambiente. L'endpoint è di sola lettura ed è disponibile in ogni piano. La data source OpenTofu/Terraform keenauth_environment lo legge.

Richiesta

Nessun parametro.

Risposta

200 OK

{
  "id": "env_01h455vb4pex5vsknk084sn02q",
  "type": "production",
  "region": "eu",
  "cell_id": "eu1",
  "state": "active",
  "plan": "business"
}

Campo	Descrizione
`id`	ID dell'ambiente (`env_…`).
`type`	`development`, `staging` o `production`. Non cambia mai.
`region`	Regione dei dati (`eu`, `us`). L'host dell'API di gestione è `api.<region>.keenauth.com`.
`cell_id`	Cella che serve l'ambiente, per esempio `eu1`.
`state`	`active`, `suspended_dashboard`, `suspended_nonprod`, `export_only` o `deleting`.
`plan`	`free`, `startup`, `business`, `enterprise` o `internal`; `null` finché il piano non ha raggiunto la cella. Non presumere un piano quando è `null`.

Questa versione non restituisce il nome visualizzato, l'ora di creazione, l'host predefinito o i domini personalizzati. GET /v1/custom-domains elenca i domini personalizzati.

Errori

HTTP	code	Quando
403	`insufficient_permissions`	La credenziale non ha `environment-settings:read`.
503	`service_unavailable`	Non è stato possibile leggere il registro degli ambienti; riprova più tardi.

Esempio

curl -i https://api.eu.keenauth.com/v1/environment \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

CLI: keenauth environment get