Skip to navigation

Workspaceresource delen

Verleent een rol (een van ‘admin’, ‘editor’, ‘commenter’ of ‘viewer’) voor een workspaceresource aan een gebruiker, groep of API-sleutel van een workspace (serviceaccount). Hiermee wordt elke bestaande rol van het doel voor de resource overschreven. Geef om een gebruiker of serviceaccount als doel te kiezen alleen het e-mailadres van de gebruiker door; de gebruiker moet lid zijn van je workspace. Geef om een groep als doel te kiezen alleen de group id door. Geef om een API-sleutel van een workspace (serviceaccount) als doel te kiezen de api key id door; de resource wordt gedeeld met het serviceaccount dat aan die sleutel is gekoppeld. Je moet beheerderstoegang tot de resource hebben om deze te delen.

Path parameters

resource_idstringRequired
De ID van de doelresource.

Headers

xi-api-keystringOptional

Request

This endpoint expects an object.
roleenumRequired

Rol die aan het doel wordt toegewezen: ‘admin’, ‘editor’, ‘commenter’ of ‘viewer’.

Allowed values:
resource_typeenumRequired
Resourcetype van de doelresource.
user_emailstring or nullOptional

Het e-mailadres van de gebruiker of serviceaccount.

group_idstring or nullOptional

De ID van de doelgroep. Gebruik ‘default’ om de basisrol van de resource in te stellen — elk workspacelid krijgt deze rol, tenzij het een hogere rol heeft via een directe gebruikersmachtiging, groepslidmaatschap of API-sleutel voor de workspace (service account).

workspace_api_key_idstring or nullOptional

De ID van de API-sleutel voor de doelworkspace (service account). Dit is niet de API-sleutelstring zelf die je voor authenticatie in de header doorgeeft — het is de ID van de sleutel, die workspaceadmins kunnen vinden onder Developers → Service Accounts.

Response

Geslaagde response

Errors

422
Unprocessable Entity Error