Block Commands

block access-authorize

Authorizes hosts to access a given volume

block access-authorize [OPTIONS] VOLUME_ID

Options

-h, --hardware-id <hardware_id>

The id of one SoftLayer_Hardware to authorize

-v, --virtual-id <virtual_id>

The id of one SoftLayer_Virtual_Guest to authorize

-i, --ip-address-id <ip_address_id>

The id of one SoftLayer_Network_Subnet_IpAddress to authorize

--ip-address <ip_address>

An IP address to authorize

Arguments

VOLUME_ID

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

block volume-refresh

“Refresh a dependent duplicate volume with a snapshot from its parent.

block volume-refresh [OPTIONS] VOLUME_ID SNAPSHOT_ID

Arguments

VOLUME_ID

Required argument

SNAPSHOT_ID

Required argument

block volume-convert

Convert a dependent duplicate volume to an independent volume.

block volume-convert [OPTIONS] VOLUME_ID

Arguments

VOLUME_ID

Required argument