st_volume_change_permissions
Only the owner of a volume (and root) is allowed to change its permissions. Partitions that have already opened the specified volume can continue to use it even if the new permissions would not allow it, but subsequent calls to open_volume() will fail.
Note: After executing this job successfully, it can take up to five minutes until the change is reflected in http(s)/ftp(s)/sftp interfaces configured for this volume (using st_volume_set_ports).
Mandatory parameters
| Parameter name | Data type | Description |
|---|---|---|
| vid | integer | ID of an existing volume |
| mode | string | The new permissions |
Optional parameters
| Parameter name | Data type | Description |
|---|---|---|
| vname | string | Name of an existing volume |
Substitute parameters
The following table describes what parameters can be substituted for another parameter.
| Parameter name | Substitute parameter |
|---|---|
| vid | vname |
| vname | vid |
Allowed users
The following users are allowed to run this job:
- root
Allowed groups
The following groups are allowed to run this job:
- root
- exastoradm
- exaadm
Examples
The following examples show how to run this job in a Python program using XML-RPC or on the command line using confd_client.
Python using XML-RPC