Ühenduste API

Ühendused kujutavad lingitud Microsoft 365 halduskeskkondi. Iga ühendus vastab Microsofti halduskeskkonnale (identifitseeritud msTenantId-ga), millele on antud administraatori nõusolek.

Ühenduste loetelu

Tagastab kõik autenditud kontoga ühendatud Microsoft 365 halduskeskkonnad.

GET /tenants/me/connections

Näidispäring

curl https://api.aether365.io/tenants/me/connections \
  -H "Authorization: Bearer <token>"

Näidisvastus

{
  "success": true,
  "data": [
    {
      "id": "conn_abc123",
      "msTenantId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "label": "Contoso Production",
      "connectedAt": "2026-02-01T09:00:00Z",
      "isPrimary": true
    },
    {
      "id": "conn_def456",
      "msTenantId": "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy",
      "label": "Contoso Staging",
      "connectedAt": "2026-03-15T14:30:00Z",
      "isPrimary": false
    }
  ]
}

Vastuse väljad

Väli	Tüüp	Kirjeldus
id	string	Ühenduse identifikaator
msTenantId	string	Microsoft Entra halduskeskkonna ID (GUID)
label	string	Ühendamise ajal määratud kuvatav silt
connectedAt	string	ISO 8601 ajatempel halduskeskkonna ühendamise ajast
isPrimary	boolean	Kas see on praegu aktiivne halduskeskkond

---

Ühenduse aktiveerimine

Seab ühendatud halduskeskkonna aktiivseks halduskeskkonnaks. Töölaua vaated ja API päringud ilma selge halduskeskkonna filtrita töötavad aktiivse halduskeskkonna andmetega.

POST /tenants/me/connections/{connectionId}/activate

Tee parameetrid

Parameeter	Tüüp	Kirjeldus
connectionId	string	Aktiveeritava ühenduse ID

Näidispäring

curl -X POST https://api.aether365.io/tenants/me/connections/conn_def456/activate \
  -H "Authorization: Bearer <token>"

Näidisvastus

{
  "success": true,
  "data": {
    "id": "conn_def456",
    "msTenantId": "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy",
    "label": "Contoso Staging",
    "connectedAt": "2026-03-15T14:30:00Z",
    "isPrimary": true
  }
}

---

Ühenduse eemaldamine

Katkestab Microsoft 365 halduskeskkonna ühenduse. Peatab selle halduskeskkonna edaspidised skaneerimised. Olemasolevad skaneerimisandmed säilitatakse vastavalt säilitamispoliitikale.

DELETE /tenants/me/connections/{connectionId}

WARNING

Seda toimingut ei saa tagasi võtta. Halduskeskkonna taasühendamine nõuab administraatori nõusoleku voo uuesti läbimist.

Tee parameetrid

Parameeter	Tüüp	Kirjeldus
connectionId	string	Eemaldatava ühenduse ID

Näidispäring

curl -X DELETE https://api.aether365.io/tenants/me/connections/conn_def456 \
  -H "Authorization: Bearer <token>"

Näidisvastus

{
  "success": true,
  "data": null
}

Vead

Kood	HTTP	Kirjeldus
CONNECTION_NOT_FOUND	404	Selle ID-ga ühendust selle halduskeskkonna jaoks pole
CANNOT_REMOVE_LAST_CONNECTION	409	Ainsat allesjäänud ühendust ei saa eemaldada