st_volume_create
This job creates a new local volume and returns the volume ID. The type of volume (data or archive) depends on the "type" parameter value.
Mandatory parameters
| Parameter name | Data type | Description |
|---|---|---|
| name | string | Name of the new volume |
| type | string | The volume type ('data' or 'archive'). |
| disk | string | Name of the disk to be used for the volume. |
| size | string | Volume size with unit in string format. Example: 1 GiB. |
| nodes | list | List of node IDs (integers) |
| redundancy | integer | redundancy level |
Optional parameters
| Parameter name | Data type | Description |
|---|---|---|
| owner | tuple, list | Owner of the new volume given as (user id, group id). Defaults to (uid of exadefusr, gid of exausers). |
| num_master_nodes | integer | Number of master nodes in the new volume. |
| block_size | string, integer | Block size of the new volume with unit. Example: 64 KiB. |
| stripe_size | string, integer | Stripe size of the new volume. Example: 64 KiB. |
| partition_size | string, integer | The size of the partitions, applies only to archive volumes, default is 4 GiB. |
| permissions | string | permissions of the new volume. |
| shared | boolean | Boolean value which indicating whether the volume is shared. |
| priority | string | Volume priority. |
| http_port | integer | HTTP port, on which the archive volume should be accessible. |
| https_port | integer | HTTPS port, on which the archive volume should be accessible. |
| ftp_port | integer | FTP port, on which the archive volume should be accessible. |
| ftps_port | integer | FTPS port, on which the archive volume should be accessible. |
| sftp_port | integer | SFTP port, on which the archive volume should be accessible. |
Substitute parameters
There are no substitute parameters.
Allowed users
There are no defined allowed users.
Allowed groups
The following groups are allowed to run this job:
- root
- exaadm
- exadbadm
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.
conn.job_exec('st_volume_create', {'params': {'name': 'new_vol0', 'disk': 'default', 'type': 'data', 'size': '1 GiB', 'nodes': [11], 'redundancy': 1}})
confd_client st_volume_create name: new_vol0 disk: default type: data size: '1 GiB' nodes: '[11]' redundancy: 1