view bulk-permission-update

Prev Next

This command lets you set up and run a bulk permission update on a view.

Usage

view bulk-permission-update --id ID
                            --target-path PATH 
                            --template-view-id TEMPLATE_ID
                            --template-dir-path TEMPLATE_DIR_PATH
                            [--template-file-path TEMPLATE_FILE_PATH]

Required Parameters

--id ID

Specify the ID of the view that exposes the files and directories for which you want to update permissions.

--target-path PATH

Specify a view path where files and directories for which to update permissions reside.

--template-view-id TEMPLATE_ID

Specify a view that exposes a directory and (optionally) a file from which to copy permissions and ownership attributes.

This view should be on the same tenant as the view specified on --target-path.

It is strongly recommended that the target view and the template view have view policies with the same security flavor. Running a bulk permission update on a view where the security flavor does not match that of the template view may result in inaccessible or incompatible permissions set.

--template-dir-path TEMPLATE_DIR_PATH

Specify a path to the directory from which to copy permissions and ownership attributes to the directories under --target-path. For more information about choosing a template directory, see Choosing a Template Directory or File.

Options

--template-file-path TEMPLATE_FILE_PATH

Specify a path to the file from which to copy permissions and ownership attributes to the files under --target-path.

If not specified, the attributes are copied from the directory specified on --template-dir-path.

For more information about choosing a template file, see Choosing a Template Directory or File.

Example

After the following command is run, all directories under /mydir/test on view 7 will have permissions and ownership as of /template on view 1, and all files under /mydir/test  on view 7 will have permissions and ownership as of /template.txt on view 1:

vcli: admin> view bulk-permission-update --id 7 --target-path /mydir/test --template-view-id 1 --template-dir-path /template --template-file-path /template.txt