The introduction of Flavors to VSI ordering significantly changes how VSIs are ordered, and the old style of ordering will eventually become unsupported. This page will hopefully explain what changes need to be made to any scripts that order VSIs.
Support for flavors has been added to the SLCLI, so make sure you have at least version 5.4.0.
SoftLayer_Virtual_Guest::getCreateObjectOptions is where you can find out the flavor listing, along with all other options you might want to supply to SoftLayer_Virtual_Guest::createObject
In the response from getCreateObjectOptions, will be a key “flavors”, with an array of different flavors and some information about their configuration.
curl -u $SL_USER:$SL_APIKEY -X GET -H "Accept: */*" -H "Accept-Encoding: gzip, deflate, compress" "https://api.softlayer.com/rest/v3/SoftLayer_Virtual_Guest/getCreateObjectOptions" | python -m json.tool
{ommitted}
"flavors": [
{
"flavor": {
"keyName": "B1_1X2X25",
"name": "B1.1x2x25",
"configuration": [
{
"category": {
"name": "First Disk"
},
"price": {
"hourlyRecurringFee": "0",
"item": {
"description": "25 GB (SAN)"
}
}
},
{
"category": {
"name": "RAM"
},
"price": {
"hourlyRecurringFee": ".03",
"item": {
"description": "2 GB"
}
}
},
{
"category": {
"name": "Computing Instance"
},
"price": {
"hourlyRecurringFee": ".023",
"item": {
"description": "1 x 2.0 GHz Core"
}
}
}
],
"totalMinimumHourlyFee": "0.053",
"totalMinimumRecurringFee": "35.17"
},
"template": {
"id": null,
"supplementalCreateObjectOptions": {
"flavorKeyName": "B1_1X2X25"
}
}
},
{ommitted}
The same information can be retrieved from the SLCLI as well.
slcli vs create-options
Basically, instead of specifying a CPU, Memory, and Disk specifically, you remove those options and instead add a new “supplementalCreateObjectOptions” field that has the flavor. Here is a REST Example
And here is how to use the SLCLI for ordering
slcli vs create --os=UBUNTU_LATEST_64 \
--flavor=BL1_2X4X100 \
--billing=hourly \
--domain=softlayer.com \
--hostname=sldn-testing \
--datacenter=hou02
SoftLayer_Virtual_Guest::getObject is where you can find out the flavor preset of the VSI specific, use with a mask to getting the information
In the response from getObject, will be a VSI information, and with information about their flavor preset.
curl -u $SL_USER:$SL_APIKEY -X GET -H "Accept: */*" -H "Accept-Encoding: gzip, deflate, compress" 'https://api.softlayer.com/rest/v3.1/SoftLayer_Virtual_Guest/11223344/getObject.json?objectMask=mask%5BbillingItem%5BorderItem%5Bpreset%5D%5D%5D'
The same information can be retrieved from the SLCLI as well.
slcli --format=json call-api Virtual_Guest getObject
--id=123456
--mask=billingItem.orderItem.preset
SoftLayer_Virtual_Guest::getObject is where you can find out the order details of the VSI specific, use with a mask to getting the information
In the response from getObject, will be a VSI information, and with information about their order with items.
curl -u $SL_USER:$SL_APIKEY -X GET -H "Accept: */*" -H "Accept-Encoding: gzip, deflate, compress" 'https://api.softlayer.com/rest/v3.1/SoftLayer_Virtual_Guest/112238162/getObject.json?objectMask=mask%5BbillingItem%5BorderItem%5Border%5Bitems%5D%5D%5D'
The same information can be retrieved from the SLCLI as well.
slcli --format=json call-api Virtual_Guest getObject
--id=123456
--mask=billingItem.orderItem.order.items
If this article contains any error, or leaves any of your questions unanswered, please help us out by
opening up a github issue.
Open an issue