diff --git a/website/content/docs/commands/volume/create.mdx b/website/content/docs/commands/volume/create.mdx index cbf37e83a..3dc68f39d 100644 --- a/website/content/docs/commands/volume/create.mdx +++ b/website/content/docs/commands/volume/create.mdx @@ -108,17 +108,25 @@ parameters { volume. If omitted, the volume will be created from scratch. The `clone_id` cannot be set if the `snapshot_id` field is set. -- `capacity_min` `(string: )` - Option for setting the capacity. The - volume must be at least this large, in bytes. The storage provider may - return a volume that is larger than this value. Accepts human-friendly - suffixes such as `"100GiB"`. This field may not be supported by all - storage providers. +- `capacity_min` `(string: )` - Option for requesting a + minimum capacity, in bytes. The capacity of a volume may be the + physical size of a disk, or a quota, depending on the storage + provider. The specific size of the resulting volume will be + somewhere between `capacity_min` and `capacity_max`; the exact + behavior is up to the storage provider. If you want to specify an + exact size, you should set `capacity_min` and `capacity_max` to the + same value. Accepts human-friendly suffixes such as `"100GiB"`. This + field may not be supported by all storage providers. -- `capacity_max` `(string: )` - Option for setting the capacity. The - volume must be no more than this large, in bytes. The storage provider may - return a volume that is smaller than this value. Accepts human-friendly - suffixes such as `"100GiB"`. This field may not be supported by all - storage providers. +- `capacity_max` `(string: )` - Option for requesting a + maximum capacity, in bytes. The capacity of a volume may be the + physical size of a disk, or a quota, depending on the storage + provider. The specific size of the resulting volume will be + somewhere between `capacity_min` and `capacity_max`; the exact + behavior is up to the storage provider. If you want to specify an + exact size, you should set `capacity_min` and `capacity_max` to the + same value. Accepts human-friendly suffixes such as `"100GiB"`. This + field may not be supported by all storage providers. - `capability` `(Capability: )` - Option for validating the capability of a volume. You must provide at least one `capability` block, and