Merge pull request #2063 from softlayer/jayasilan-issue2017

Example for slcli block volume-modify, slcli block volume-options #2017

Author: allmightyspiff

SoftLayer/CLI/block/modify.py

@@ -33,7 +33,16 @@
               type=click.Choice(['0.25', '2', '4', '10']))
 @environment.pass_env
 def cli(env, volume_id, new_size, new_iops, new_tier):
-    """Modify an existing block storage volume."""
+    """Modify an existing block storage volume.
+
+    Example::
+        slcli block volume-modify 12345678 --new-size 1000 --new-iops 4000
+        This command modify a volume 12345678 with size is 1000GB, IOPS is 4000.
+
+        slcli block volume-modify 12345678 --new-size 500 --new-tier 4
+        This command modify a volume 12345678 with size is 500GB, tier level is 4 IOPS per GB.
+"""
+
     block_manager = SoftLayer.BlockStorageManager(env.client)
 
     if new_tier is not None:

SoftLayer/CLI/block/options.py

@@ -19,7 +19,23 @@
                    'add it to the --prices option using location short name, e.g. --prices dal13')
 @environment.pass_env
 def cli(env, prices, location=None):
-    """List all options for ordering a block storage"""
+    """List all options for ordering a block storage
+
+    Example::
+        slcli block volume-options
+        This command lists all options for creating a \
+block storage volume, including storage type, volume size, OS type, IOPS, tier level, datacenter, and snapshot size.
+
+        slcli block volume-options --prices
+        This command lists all options for creating a \
+block storage volume, including storage type, volume size, OS type, IOPS, tier level, \
+datacenter, and snapshot size along with prices.
+
+        slcli block volume-options --prices dal03
+        This command lists all options for creating a \
+block storage volume, including storage type, volume size, \
+OS type, IOPS, tier level, datacenter, and snapshot size along with prices for a given location.
+"""
 
     order_manager = SoftLayer.OrderingManager(env.client)
     items = order_manager.get_items(PACKAGE_STORAGE, mask="mask[categories]")