Support-Zugriffsfreigabe widerrufen
DELETE /v1/support-access-grants/{grant_id} · Berechtigung support-access-grants:write
Widerruft eine Support-Zugriffsfreigabe vor ihrem Ablauf: revoked_at wird gesetzt, der darauf beruhende Mitarbeiterzugriff endet und ein Ereignis support_access_grant.revoked wird veröffentlicht. Der Datensatz bleibt für das Audit erhalten. Das Widerrufen einer bereits widerrufenen oder abgelaufenen Freigabe ändert nichts und liefert trotzdem 204. Nur im Dashboard, von einem owner oder admin, der sich in den letzten 5 Minuten erneut angemeldet hat; API-Schlüssel und Maschinenclients erhalten 403 insufficient_permissions.
Anfrage
| Feld | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
grant_id |
string | ja | Freigabe-ID (sag_…). |
Kein Anfrage-Body.
Antwort
204 No Content.
Fehler
| HTTP | Code | Wann |
|---|---|---|
| 404 | not_found |
Die Freigabe existiert nicht oder gehört zu einer anderen Umgebung. |
| 403 | insufficient_permissions |
Die Anfrage wurde nicht aus dem Dashboard von einem owner oder admin gestellt, oder der Anmeldeinformation fehlt die erforderliche Berechtigung. |
| 401 | unauthenticated |
Die Anmeldeinformation fehlt, ist ungültig oder widerrufen. |
| 429 | rate_limited |
Das Ratenlimit wurde überschritten; nach Ablauf der Retry-After-Zeit erneut versuchen. |
| 503 | service_unavailable |
Eine Abhängigkeit ist vorübergehend nicht verfügbar; nach Ablauf der Retry-After-Zeit erneut versuchen. |
Beispiel
Erstellen und Widerrufen sind Aktionen im Dashboard. Die Anfrage, die das Dashboard sendet:
DELETE /v1/support-access-grants/sag_01j9xk3m7q8r2s4t6v8w0y2z4a