Freigabe für Workspace-Ressource aufheben

POST

/v1/workspace/resources/:resource_id/unshare

Entfernt jede bestehende Rolle für eine Workspace-Ressource von einem Benutzer, einer Gruppe oder einem API-Schlüssel für Workspace-Servicekonten. Um einen Benutzer oder ein Servicekonto anzusprechen, geben Sie nur die Benutzer-E-Mail an; der Benutzer muss Ihrem Workspace angehören. Um eine Gruppe anzusprechen, geben Sie nur die Gruppen-ID an. Um einen API-Schlüssel für ein Workspace-Servicekonto anzusprechen, geben Sie die API-Schlüssel-ID an; die Freigabe der Ressource für das mit diesem Schlüssel verknüpfte Servicekonto wird aufgehoben. Sie benötigen Administratorzugriff auf die Ressource, um ihre Freigabe aufzuheben. Sie können dem Benutzer, der die Ressource erstellt hat, keine Berechtigungen entziehen.

Pfadparameter

resource_idstringErforderlich

Die ID der Zielressource.

Anfrage

This endpoint expects an object.

resource_typeenumErforderlich

Ressourcentyp der Zielressource.

user_emailstring or nullOptional

Die E-Mail-Adresse des Benutzers oder Dienstkontos.

group_idstring or nullOptional

Die ID der Zielgruppe. Verwenden Sie „default“, um die Basisrolle der Ressource festzulegen. Jedes Workspace-Mitglied erhält diese Rolle, sofern es nicht durch eine direkte Benutzerberechtigung, Gruppenmitgliedschaft oder einen Workspace-API-Schlüssel (Service Account) eine höhere Rolle hat.

workspace_api_key_idstring or nullOptional

Die ID des API-Schlüssels für den Ziel-Workspace (Service Account). Dies ist nicht die API-Schlüsselzeichenfolge selbst, die Sie zur Authentifizierung im Header übergeben, sondern die Schlüssel-ID, die Workspace-Administratoren unter Entwickler → Service Accounts finden.

Antwort

Erfolgreiche Antwort

Fehler

422

Unprocessable Entity Error