1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
|
"""Order a block storage volume."""
# :license: MIT, see LICENSE for more details.
import click
import SoftLayer
from SoftLayer.CLI import environment
from SoftLayer.CLI import exceptions
CONTEXT_SETTINGS = {'token_normalize_func': lambda x: x.upper()}
@click.command(cls=SoftLayer.CLI.command.SLCommand, context_settings=CONTEXT_SETTINGS)
@click.option('--storage-type',
help='Type of block storage volume',
type=click.Choice(['performance', 'endurance']),
required=True)
@click.option('--size',
type=int,
help='Size of block storage volume in GB.',
required=True)
@click.option('--iops',
type=int,
help="""Performance Storage IOPs. Options vary based on storage size.
[required for storage-type performance]""")
@click.option('--tier',
help='Endurance Storage Tier (IOP per GB) [required for storage-type endurance]',
type=click.Choice(['0.25', '2', '4', '10']))
@click.option('--os-type',
help='Operating System',
type=click.Choice([
'HYPER_V',
'LINUX',
'VMWARE',
'WINDOWS_2008',
'WINDOWS_GPT',
'WINDOWS',
'XEN']),
required=True)
@click.option('--location',
help='Datacenter short name (e.g.: dal09)',
required=True)
@click.option('--snapshot-size',
type=int,
help='Optional parameter for ordering snapshot '
'space along with endurance block storage; specifies '
'the size (in GB) of snapshot space to order')
@click.option('--service-offering',
help="""The service offering package to use for placing the order.
[optional, default is \'storage_as_a_service\']. enterprise and performance are depreciated""",
default='storage_as_a_service',
type=click.Choice([
'storage_as_a_service',
'enterprise',
'performance']))
@click.option('--billing',
type=click.Choice(['hourly', 'monthly']),
default='monthly',
help="Optional parameter for Billing rate (default to monthly)")
@environment.pass_env
def cli(env, storage_type, size, iops, tier, os_type,
location, snapshot_size, service_offering, billing):
"""Order a block storage volume.
Valid size and iops options can be found here:
https://cloud.ibm.com/docs/BlockStorage/index.html#provisioning-considerations
"""
block_manager = SoftLayer.BlockStorageManager(env.client)
storage_type = storage_type.lower()
hourly_billing_flag = False
if billing.lower() == "hourly":
hourly_billing_flag = True
if service_offering != 'storage_as_a_service':
click.secho(f"{service_offering} is a legacy storage offering", fg='red')
if hourly_billing_flag:
raise exceptions.CLIAbort(
'Hourly billing is only available for the storage_as_a_service service offering'
)
order = {}
if storage_type == 'performance':
if iops is None:
raise exceptions.CLIAbort('Option --iops required with Performance')
if service_offering == 'performance' and snapshot_size is not None:
raise exceptions.CLIAbort(
'--snapshot-size is not available for performance service offerings. '
'Use --service-offering storage_as_a_service'
)
try:
order = block_manager.order_block_volume(
storage_type=storage_type,
location=location,
size=int(size),
iops=iops,
os_type=os_type,
snapshot_size=snapshot_size,
service_offering=service_offering,
hourly_billing_flag=hourly_billing_flag
)
except ValueError as ex:
raise exceptions.ArgumentError(str(ex))
if storage_type == 'endurance':
if tier is None:
raise exceptions.CLIAbort(
'Option --tier required with Endurance in IOPS/GB [0.25,2,4,10]'
)
try:
order = block_manager.order_block_volume(
storage_type=storage_type,
location=location,
size=int(size),
tier_level=float(tier),
os_type=os_type,
snapshot_size=snapshot_size,
service_offering=service_offering,
hourly_billing_flag=hourly_billing_flag
)
except ValueError as ex:
raise exceptions.ArgumentError(str(ex))
if 'placedOrder' in order.keys():
click.echo(f"Order #{order['placedOrder']['id']} placed successfully!")
for item in order['placedOrder']['items']:
click.echo(" > %s" % item['description'])
click.echo(f"\nYou may run 'slcli block volume-list --order {order['placedOrder']['id']}' "
"to find this block volume after it is ready.")
else:
click.echo("Order could not be placed! Please verify your options and try again.")
|
