Create a volume with the specified name and size (default unit: GiB) in a datastore.
Procedure
Run the following command on any node in the cluster:
zbs-meta volume create <pool_name> <volume_name> <volume_size> [--thin_provision <THIN_PROVISION>] [--resiliency_type <RESILIENCY_TYPE>] [--replica_num <REPLICA_NUM>] [--encrypt_method ENCRYPT_METHOD] [--ec_block_size <EC_BLOCK_SIZE>] [--read_only <READ_ONLY>] [--snapshot <SNAPSHOT>] [--snapshot_id <SNAPSHOT_ID>] [--stripe_num <STRIPE_NUM>] [--stripe_size <STRIPE_SIZE>] [--preferred_cid <PREFERRED_CID>] [--prioritized <PRIORITIZED>]
| Parameter | Description |
|---|---|
volume_name | Specifies the volume name. |
volume_size | Specifies the volume size. |
--thin_provision <THIN_PROVISION> | Specifies whether the new volume uses thin provisioning. Valid values: True or False. |
--resiliency_type <RESILIENCY_TYPE> | Specifies the redundancy mode, either REPLICA (replication) or EC (erasure coding). If not specified, the value is inherited from the datastore. Default: None. |
--replica_num <REPLICA_NUM> | Specifies the default replication factor for the new volume. Valid values: 2 or 3. Default: None. |
--encrypt_method <ENCRYPT_METHOD> | Specifies the data encryption method. The default is no encryption. |
--ec_block_size <EC_BLOCK_SIZE> | Specifies the extent size used by the EC algorithm. Default: 4096 if EC mode, otherwise None. |
--read_only <READ_ONLY> | Specifies whether the volume is read-only. Valid values: True or False. |
--snapshot <SNAPSHOT> | Specifies the snapshot path to create a volume from the snapshot. |
--snapshot_id <SNAPSHOT_ID> | Specifies the snapshot ID to create a volume from the snapshot. |
--stripe_num <STRIPE_NUM> | The stripe number of the new volume. |
--stripe_size <STRIPE_SIZE> | The stripe size of the new volume. |
--preferred_cid <PREFERRED_CID> | Specifies the preferred chunk ID. Meta prioritizes proximity to this Chunk when allocating PExtent replicas. |
--prioritized <PRIORITIZED> | Specifies whether all volume data should remain in the performance tier. Valid values: True or False. |
Output note
If the command succeeds, no output is displayed.
