| Parameter | Type | Description | Example |
|---|---|---|---|
| object | The permission information. | ||
| identity | Identity | The identity to which the permissions are granted, which is a user or a group. | |
| role_id | string | The role ID. You can grant permissions by assigning roles to identities, or you can customize the permissions. To grant permissions by assigning roles to identities, specify role_id. role_id and action_list are mutually exclusive. If both parameters are specified, the value of role_id prevails. Valid values: SystemFileOwner: collaborator SystemFileDownloader: downloader SystemFileEditor: editor SystemFileEditorWithoutDelete: editor without permissions to delete the file SystemFileEditorWithoutShareLink: editor without permissions to share the file SystemFileMetaViewer: viewer of lists SystemFileUploader: uploader. SystemFileUploaderAndDownloader: uploader and downloader SystemFileDownloaderWithShareLink: downloader and sharer SystemFileUploaderAndDownloaderWithShareLink: uploader, downloader, and sharer SystemFileUploaderAndViewer: viewer and uploader SystemFileUploaderWithShareLink: uploader and sharer SystemFileViewer: viewer | SystemFileDownloader |
| expire_time | long | The time when the permissions expire. This value is a UNIX timestamp representing the number of milliseconds that have elapsed since January 1, 1970, 00:00:00 UTC. A value of 4775500800000 indicates that the permissions never expire. | 1633598085642 |
| disinherit_sub_group | boolean | Specifies whether the users of subgroups can inherit the permissions. For example, a user named user1 belongs to the group1 group, and a user named user2 belongs to the group2 group. group2 is the subgroup of group1. If you set disinherit_sub_group to true, only user1 is granted the permissions. user2 is not granted the permissions. | false |
| action_list | array | The list of permissions to grant. You can grant permissions by assigning roles to identities, or you can customize the permissions. To grant permissions by assigning roles to identities, specify role_id. role_id and action_list are mutually exclusive. If both parameters are specified, the value of role_id prevails. When you specify action_list, the system automatically generates a temporary role_id. You can use this role_id to revoke the permissions. | |
| string | The permission. Valid values:
| FILE.CREATE |