Block Commands¶
block access-authorize¶
Authorizes hosts to access a given volume
block access-authorize [OPTIONS] VOLUME_ID
Options
The id of one SoftLayer_Hardware to authorize
The id of one SoftLayer_Virtual_Guest to authorize
The id of one SoftLayer_Network_Subnet_IpAddress to authorize
An IP address to authorize
Arguments
Required argument
block access-list¶
List ACLs.
block access-list [OPTIONS] VOLUME_ID
Options
-
--sortby
<sortby>
¶ Column to sort by
-
--columns
<columns>
¶ Columns to display. Options: id, name, type, private_ip_address, source_subnet, host_iqn, username, password, allowed_host_id
Arguments
-
VOLUME_ID
¶
Required argument
block access-revoke¶
Revokes authorization for hosts accessing a given volume
block access-revoke [OPTIONS] VOLUME_ID
Options
-
-h
,
--hardware-id
<hardware_id>
¶ The id of one SoftLayer_Hardware to revoke authorization
-
-v
,
--virtual-id
<virtual_id>
¶ The id of one SoftLayer_Virtual_Guest to revoke authorization
-
-i
,
--ip-address-id
<ip_address_id>
¶ The id of one SoftLayer_Network_Subnet_IpAddress to revoke authorization
-
--ip-address
<ip_address>
¶ An IP address to revoke authorization
Arguments
-
VOLUME_ID
¶
Required argument
block access-password¶
Changes a password for a volume’s access.
access id is the allowed_host_id from slcli block access-list
block access-password [OPTIONS] ACCESS_ID
Options
-
-p
,
--password
<password>
¶ Password you want to set, this command will fail if the password is not strong
Arguments
-
ACCESS_ID
¶
Required argument
block replica-failback¶
Failback a block volume from the given replicant volume.
block replica-failback [OPTIONS] VOLUME_ID
Arguments
-
VOLUME_ID
¶
Required argument
block replica-failover¶
Failover a block volume to the given replicant volume.
block replica-failover [OPTIONS] VOLUME_ID
Options
-
--replicant-id
<replicant_id>
¶ ID of the replicant volume
Arguments
-
VOLUME_ID
¶
Required argument
block replica-order¶
Order a block storage replica volume.
block replica-order [OPTIONS] VOLUME_ID
Options
-
-s
,
--snapshot-schedule
<snapshot_schedule>
¶ Snapshot schedule to use for replication, (INTERVAL | HOURLY | DAILY | WEEKLY) [required]
Options: INTERVAL|HOURLY|DAILY|WEEKLY
-
-l
,
--location
<location>
¶ Short name of the data center for the replicant (e.g.: dal09) [required]
-
--tier
<tier>
¶ Endurance Storage Tier (IOPS per GB) of the primary volume for which a replicant is ordered [optional]
Options: 0.25|2|4|10
-
--os-type
<os_type>
¶ Operating System Type (e.g.: LINUX) of the primary volume for which a replica is ordered [optional]
Options: HYPER_V|LINUX|VMWARE|WINDOWS_2008|WINDOWS_GPT|WINDOWS|XEN
Arguments
-
VOLUME_ID
¶
Required argument
block replica-partners¶
List existing replicant volumes for a block volume.
block replica-partners [OPTIONS] VOLUME_ID
Options
-
--sortby
<sortby>
¶ Column to sort by
-
--columns
<columns>
¶ Columns to display. Options: ID, Username, Account ID, Capacity (GB), Hardware ID, Guest ID, Host ID
Arguments
-
VOLUME_ID
¶
Required argument
block replica-locations¶
List suitable replication datacenters for the given volume.
block replica-locations [OPTIONS] VOLUME_ID
Options
-
--sortby
<sortby>
¶ Column to sort by
-
--columns
<columns>
¶ Columns to display. Options: ID, Long Name, Short Name
Arguments
-
VOLUME_ID
¶
Required argument
block snapshot-cancel¶
Cancel existing snapshot space for a given volume.
block snapshot-cancel [OPTIONS] VOLUME_ID
Options
-
--reason
<reason>
¶ An optional reason for cancellation
-
--immediate
¶
Cancels the snapshot space immediately instead of on the billing anniversary
Arguments
-
VOLUME_ID
¶
Required argument
block snapshot-create¶
Creates a snapshot on a given volume
block snapshot-create [OPTIONS] VOLUME_ID
Options
-
-n
,
--notes
<notes>
¶ Notes to set on the new snapshot
Arguments
-
VOLUME_ID
¶
Required argument
block snapshot-delete¶
Deletes a snapshot on a given volume
block snapshot-delete [OPTIONS] SNAPSHOT_ID
Arguments
-
SNAPSHOT_ID
¶
Required argument
block snapshot-disable¶
Disables snapshots on the specified schedule for a given volume
block snapshot-disable [OPTIONS] VOLUME_ID
Options
-
--schedule-type
<schedule_type>
¶ Snapshot schedule [INTERVAL|HOURLY|DAILY|WEEKLY] [required]
Arguments
-
VOLUME_ID
¶
Required argument
block snapshot-enable¶
Enables snapshots for a given volume on the specified schedule
block snapshot-enable [OPTIONS] VOLUME_ID
Options
-
--schedule-type
<schedule_type>
¶ Snapshot schedule [INTERVAL|HOURLY|DAILY|WEEKLY] [required]
-
--retention-count
<retention_count>
¶ Number of snapshots to retain [required]
-
--minute
<minute>
¶ Minute of the day when snapshots should be taken
-
--hour
<hour>
¶ Hour of the day when snapshots should be taken
-
--day-of-week
<day_of_week>
¶ Day of the week when snapshots should be taken
Arguments
-
VOLUME_ID
¶
Required argument
block snapshot-schedule-list¶
Lists snapshot schedules for a given volume
block snapshot-schedule-list [OPTIONS] VOLUME_ID
Arguments
-
VOLUME_ID
¶
Required argument
block snapshot-list¶
List block storage snapshots.
block snapshot-list [OPTIONS] VOLUME_ID
Options
-
--sortby
<sortby>
¶ Column to sort by
-
--columns
<columns>
¶ Columns to display. Options: id, name, created, size_bytes
Arguments
-
VOLUME_ID
¶
Required argument
block snapshot-order¶
Order snapshot space for a block storage volume.
block snapshot-order [OPTIONS] VOLUME_ID
Options
-
--capacity
<capacity>
¶ Size of snapshot space to create in GB [required]
-
--tier
<tier>
¶ Endurance Storage Tier (IOPS per GB) of the block volume for which space is ordered [optional, and only valid for endurance storage volumes]
Options: 0.25|2|4|10
-
--upgrade
¶
Flag to indicate that the order is an upgrade
Arguments
-
VOLUME_ID
¶
Required argument
block snapshot-restore¶
Restore block volume using a given snapshot
block snapshot-restore [OPTIONS] VOLUME_ID
Options
-
-s
,
--snapshot-id
<snapshot_id>
¶ The id of the snapshot which will be used to restore the block volume
Arguments
-
VOLUME_ID
¶
Required argument
block volume-cancel¶
Cancel an existing block storage volume.
block volume-cancel [OPTIONS] VOLUME_ID
Options
-
--reason
<reason>
¶ An optional reason for cancellation
-
--immediate
¶
Cancels the block storage volume immediately instead of on the billing anniversary
Arguments
-
VOLUME_ID
¶
Required argument
block volume-count¶
List number of block storage volumes per datacenter.
block volume-count [OPTIONS]
Options
-
-d
,
--datacenter
<datacenter>
¶ Datacenter shortname
-
--sortby
<sortby>
¶ Column to sort by
block volume-detail¶
Display details for a specified volume.
block volume-detail [OPTIONS] VOLUME_ID
Arguments
-
VOLUME_ID
¶
Required argument
block volume-duplicate¶
Order a duplicate block storage volume.
block volume-duplicate [OPTIONS] ORIGIN_VOLUME_ID
Options
-
-o
,
--origin-snapshot-id
<origin_snapshot_id>
¶ ID of an origin volume snapshot to use for duplcation.
-
-c
,
--duplicate-size
<duplicate_size>
¶ Size of duplicate block volume in GB. *If no size is specified, the size of the origin volume will be used.* Potential Sizes: [20, 40, 80, 100, 250, 500, 1000, 2000, 4000, 8000, 12000] Minimum: [the size of the origin volume]
-
-i
,
--duplicate-iops
<duplicate_iops>
¶ Performance Storage IOPS, between 100 and 6000 in multiples of 100 [only used for performance volumes] *If no IOPS value is specified, the IOPS value of the origin volume will be used.* Requirements: [If IOPS/GB for the origin volume is less than 0.3, IOPS/GB for the duplicate must also be less than 0.3. If IOPS/GB for the origin volume is greater than or equal to 0.3, IOPS/GB for the duplicate must also be greater than or equal to 0.3.]
-
-t
,
--duplicate-tier
<duplicate_tier>
¶ Endurance Storage Tier (IOPS per GB) [only used for endurance volumes] *If no tier is specified, the tier of the origin volume will be used.* Requirements: [If IOPS/GB for the origin volume is 0.25, IOPS/GB for the duplicate must also be 0.25. If IOPS/GB for the origin volume is greater than 0.25, IOPS/GB for the duplicate must also be greater than 0.25.]
Options: 0.25|2|4|10
-
-s
,
--duplicate-snapshot-size
<duplicate_snapshot_size>
¶ The size of snapshot space to order for the duplicate. *If no snapshot space size is specified, the snapshot space size of the origin block volume will be used.* Input “0” for this parameter to order a duplicate volume with no snapshot space.
-
--billing
<billing>
¶ Optional parameter for Billing rate (default to monthly)
Options: hourly|monthly
-
--dependent-duplicate
<dependent_duplicate>
¶ Whether or not this duplicate will be a dependent duplicate of the origin volume. [default: False]
Arguments
-
ORIGIN_VOLUME_ID
¶
Required argument
block volume-list¶
List block storage.
block volume-list [OPTIONS]
Options
-
-u
,
--username
<username>
¶ Volume username
-
-d
,
--datacenter
<datacenter>
¶ Datacenter shortname
-
--storage-type
<storage_type>
¶ Type of storage volume
Options: performance|endurance
-
--sortby
<sortby>
¶ Column to sort by
-
--columns
<columns>
¶ Columns to display. Options: id, username, datacenter, storage_type, capacity_gb, bytes_used, iops, ip_addr, lunId, active_transactions, rep_partner_count, created_by
block volume-modify¶
Modify an existing block storage volume.
block volume-modify [OPTIONS] VOLUME_ID
Options
-
-c
,
--new-size
<new_size>
¶ New Size of block volume in GB. *If no size is given, the original size of volume is used.* Potential Sizes: [20, 40, 80, 100, 250, 500, 1000, 2000, 4000, 8000, 12000] Minimum: [the original size of the volume]
-
-i
,
--new-iops
<new_iops>
¶ Performance Storage IOPS, between 100 and 6000 in multiples of 100 [only for performance volumes] *If no IOPS value is specified, the original IOPS value of the volume will be used.* Requirements: [If original IOPS/GB for the volume is less than 0.3, new IOPS/GB must also be less than 0.3. If original IOPS/GB for the volume is greater than or equal to 0.3, new IOPS/GB for the volume must also be greater than or equal to 0.3.]
-
-t
,
--new-tier
<new_tier>
¶ Endurance Storage Tier (IOPS per GB) [only for endurance volumes] *If no tier is specified, the original tier of the volume will be used.* Requirements: [If original IOPS/GB for the volume is 0.25, new IOPS/GB for the volume must also be 0.25. If original IOPS/GB for the volume is greater than 0.25, new IOPS/GB for the volume must also be greater than 0.25.]
Options: 0.25|2|4|10
Arguments
-
VOLUME_ID
¶
Required argument
block volume-order¶
Order a block storage volume.
Valid size and iops options can be found here: https://console.bluemix.net/docs/infrastructure/BlockStorage/index.html#provisioning
block volume-order [OPTIONS]
Options
-
--storage-type
<storage_type>
¶ Type of block storage volume [required]
Options: performance|endurance
-
--size
<size>
¶ Size of block storage volume in GB. [required]
-
--iops
<iops>
¶ Performance Storage IOPs. Options vary based on storage size. [required for storage-type performance]
-
--tier
<tier>
¶ Endurance Storage Tier (IOP per GB) [required for storage-type endurance]
Options: 0.25|2|4|10
-
--os-type
<os_type>
¶ Operating System [required]
Options: HYPER_V|LINUX|VMWARE|WINDOWS_2008|WINDOWS_GPT|WINDOWS|XEN
-
--location
<location>
¶ Datacenter short name (e.g.: dal09) [required]
-
--snapshot-size
<snapshot_size>
¶ Optional parameter for ordering snapshot space along with endurance block storage; specifies the size (in GB) of snapshot space to order
-
--service-offering
<service_offering>
¶ The service offering package to use for placing the order. [optional, default is ‘storage_as_a_service’]. enterprise and performance are depreciated
Options: storage_as_a_service|enterprise|performance
-
--billing
<billing>
¶ Optional parameter for Billing rate (default to monthly)
Options: hourly|monthly
block volume-set-lun-id¶
Set the LUN ID on an existing block storage volume.
The LUN ID only takes effect during the Host Authorization process. It is recommended (but not necessary) to de-authorize all hosts before using this method. See block access-revoke.
VOLUME_ID - the volume ID on which to set the LUN ID.
LUN_ID - recommended range is an integer between 0 and 255. Advanced users can use an integer between 0 and 4095.
block volume-set-lun-id [OPTIONS] VOLUME_ID LUN_ID
Arguments
-
VOLUME_ID
¶
Required argument
-
LUN_ID
¶
Required argument
block volume-limits¶
List number of block storage volumes limit per datacenter.
block volume-limits [OPTIONS]
Options
-
--sortby
<sortby>
¶ Column to sort by
block subnets-list¶
List block storage assigned subnets for the given host id.
access_id is the host_id obtained by: slcli block access-list <volume_id>
block subnets-list [OPTIONS] ACCESS_ID
Arguments
-
ACCESS_ID
¶
Required argument
block subnets-assign¶
Assign block storage subnets to the given host id.
access_id is the host_id obtained by: slcli block access-list <volume_id>
SoftLayer_Account::iscsiisolationdisabled must be False to use this command
block subnets-assign [OPTIONS] ACCESS_ID
Options
-
--subnet-id
<subnet_id>
¶ ID of the subnets to assign; e.g.: –subnet-id 1234
Arguments
-
ACCESS_ID
¶
Required argument
block subnets-remove¶
Remove block storage subnets for the given host id.
access_id is the host_id obtained by: slcli block access-list <volume_id>
SoftLayer_Account::iscsiisolationdisabled must be False to use this command
block subnets-remove [OPTIONS] ACCESS_ID
Options
-
--subnet-id
<subnet_id>
¶ ID of the subnets to remove; e.g.: –subnet-id 1234
Arguments
-
ACCESS_ID
¶
Required argument