Edit vault authorization

Edit online

Update the permissions that users and groups have on a vault in the system. Also, provide or deny anonymousPermissions.

CAUTION:
Permissions cannot be assigned to Container Vaults.

Request

Edit online

Security

Edit online
Table 1. Roles capable of executing the Edit Vault Authorization (editVaultAuthorization) API method
Any Super User System Admin Security Admin Operator
  superUser   securityAdmin  

HTTP method

Edit online

POST /manager/api/{apiResponseType}/1.0/editVaultAuthorization.adm HTTP/1.1 Host:{manager.dsnet} id={vaultId}&anonymousPermission={readOnly|readWrite|disabled|owner}&userPermissions[{userId}]={readOnly|readWrite|disabled|owner}&groupPermissions[{groupId}]={readOnly|readWrite|disabled|owner}

Curl method

Edit online

curl -u {admin}:{password} 
     -k ”https://{manager.dsnet}/manager/api/json/1.0/editVaultAuthorization.adm“ 
     -d ”id={vaultId}&anonymousPermission={readOnly|readWrite|disabled|owner}
                     &userPermissions[{userId}]={readOnly|readWrite|disabled|owner}
                     &groupPermissions[{groupId}]={readOnly|readWrite|disabled|owner}“

Parameters

Edit online
Table 2. Request parameters for Edit Vault Authorization (editVaultAuthorization) API method
Parameter Type Usage Default Description
id Long Required  

ID of vault to edit the authorizations of.
anonymousPermission String Optional disabled

Permissions for anonymous users of vault.

  • disabled
  • readOnly
  • readWrite
  • owner
userPermissions Map[{userId}] Optional  

Permissions to grant to a specific user.

  • disabled
  • readOnly
  • readWrite
  • owner

User IDs are passed as a hash with the user's ID as the key and the permission as the value:

userPermissions[{userId}]={permission}
groupPermissions Map[{groupId}] Optional  

Permissions level to grant to a specific group.

  • disabled
  • readOnly
  • readWrite
  • owner

Group IDs are passed as a hash with the group's ID as the key and the permission as the value:

groupPermissions[{userId}]={permission}