st_volume_add_label
A label is an arbitrary string that can be used to identify or classify a volume.
It has no impact on the operation of the volume. The number of labels for a volume
is not limited. Labels are by default stored in the same order as they have been added.
Setting the 'front' flag will add the label in front of any other labels.
Mandatory parameters
| Parameter name | Data type | Description |
|---|---|---|
| vid | integer | ID of an existing volume |
| label | string | The label. Can be any string |
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