SoftLayer.ordering¶
Ordering Manager
license: | MIT, see LICENSE for more details. |
---|
-
class
SoftLayer.managers.ordering.
OrderingManager
(client)[source]¶ Manager to help ordering via the SoftLayer API.
Parameters: client (SoftLayer.API.BaseClient) – the client instance -
static
filter_outlet_packages
(packages)[source]¶ Remove packages designated as OUTLET.
Those type of packages must be handled in a different way, and they are not supported at the moment.
Parameters: packages – Dictionary of packages. Name and description keys must be present in each of them.
-
generate_order
(package_keyname, location, item_keynames, complex_type=None, hourly=True, preset_keyname=None, extras=None, quantity=1)[source]¶ Generates an order with the given package and prices.
This function takes in parameters needed for an order and generates an order dictionary. This dictionary can then be used in either verify or placeOrder().
Parameters: - package_keyname (str) – The keyname for the package being ordered
- location (str) – The datacenter location string for ordering (Ex: DALLAS13)
- item_keynames (list) – The list of item keyname strings to order. To see list of possible keynames for a package, use list_items() (or slcli order item-list)
- complex_type (str) – The complex type to send with the order. Typically begins with SoftLayer_Container_Product_Order_.
- hourly (bool) – If true, uses hourly billing, otherwise uses monthly billing
- preset_keyname (string) – If needed, specifies a preset to use for that package. To see a list of possible keynames for a package, use list_preset() (or slcli order preset-list)
- extras (dict) – The extra data for the order in dictionary format. Example: A VSI order requires hostname and domain to be set, so extras will look like the following: {‘virtualGuests’: [{‘hostname’: ‘test’, ‘domain’: ‘softlayer.com’}]}
- quantity (int) – The number of resources to order
-
generate_order_template
(quote_id, extra, quantity=1)[source]¶ Generate a complete order template.
Parameters: - quote_id (int) – ID of target quote
- extra (dictionary) – Overrides for the defaults of SoftLayer_Container_Product_Order
- quantity (int) – Number of items to order.
-
get_item_prices
(package_id)[source]¶ Get item prices.
Retrieve a SoftLayer_Product_Package item prices record.
Parameters: package_id (int) – package identifier. Returns: A list of price IDs associated with the given package.
-
get_location_id
(location)[source]¶ Finds the location ID of a given datacenter
This is mostly used so either a dc name, or regions keyname can be used when ordering :param str location: Region Keyname (DALLAS13) or datacenter name (dal13) :returns: integer id of the datacenter
-
static
get_only_active_packages
(packages)[source]¶ Return only active packages.
If a package is active, it is eligible for ordering This will inspect the ‘isActive’ property on the provided packages
Parameters: packages – Dictionary of packages, isActive key must be present
-
get_order_container
(quote_id)[source]¶ Generate an order container from a quote object.
Parameters: quote_id – ID number of target quote
-
get_package_by_key
(package_keyname, mask=None)[source]¶ Get a single package with a given key.
If no packages are found, returns None
Parameters: - package_keyname – string representing the package key name we are interested in.
- mask (string) – Mask to specify the properties we want to retrieve
-
get_package_by_type
(package_type, mask=None)[source]¶ Get a single package of a given type.
Syntactic sugar to retrieve a single package of a given type. If multiple packages share the given type, this will return the first one returned by the API. If no packages are found, returns None
Parameters: package_type (string) – representing the package type key name we are interested in
-
get_package_id_by_type
(package_type)[source]¶ Return the package ID of a Product Package with a given type.
Parameters: package_type (string) – representing the package type key name we are interested in Raises: ValueError – when no package of the given type is found
-
get_packages_of_type
(package_types, mask=None)[source]¶ Get packages that match a certain type.
Each ordering package has a type, so return all packages that match the types we are looking for
Parameters: - package_types (list) – List of strings representing the package type keynames we are interested in.
- mask (string) – Mask to specify the properties we want to retrieve
-
get_preset_by_key
(package_keyname, preset_keyname, mask=None)[source]¶ Gets a single preset with the given key.
-
get_preset_prices
(preset)[source]¶ Get preset item prices.
Retrieve a SoftLayer_Product_Package_Preset record.
Parameters: preset (int) – preset identifier. Returns: A list of price IDs associated with the given preset_id.
-
get_price_id_list
(package_keyname, item_keynames, core=None)[source]¶ Converts a list of item keynames to a list of price IDs.
This function is used to convert a list of item keynames into a list of price IDs that are used in the Product_Order verifyOrder() and placeOrder() functions.
Parameters: - package_keyname (str) – The package associated with the prices
- item_keynames (list) – A list of item keyname strings
- core (str) – preset guest core capacity.
Returns: A list of price IDs associated with the given item keynames in the given package
-
get_quote_details
(quote_id)[source]¶ Retrieve quote details.
Parameters: quote_id – ID number of target quote
-
get_quotes
()[source]¶ Retrieve a list of active quotes.
Returns: a list of SoftLayer_Billing_Order_Quote
-
list_categories
(package_keyname, **kwargs)[source]¶ List the categories for the given package.
Parameters: package_keyname (str) – The package for which to get the categories. Returns: List of categories associated with the package
-
list_items
(package_keyname, **kwargs)[source]¶ List the items for the given package.
Parameters: package_keyname (str) – The package for which to get the items. Returns: List of items in the package
-
list_presets
(package_keyname, **kwargs)[source]¶ Gets active presets for the given package.
Parameters: package_keyname (str) – The package for which to get presets Returns: A list of package presets that can be used for ordering
-
order_quote
(quote_id, extra)[source]¶ Places an order using a quote
extras = { 'hardware': {'hostname': 'test', 'domain': 'testing.com'}, 'quantity': 2 } manager = ordering.OrderingManager(env.client) result = manager.order_quote(12345, extras)
Parameters: - quote_id (int) – ID for the target quote
- extra (dictionary) – Overrides for the defaults of SoftLayer_Container_Product_Order
- quantity (int) – Quantity to override default
-
package_locations
(package_keyname)[source]¶ List datacenter locations for a package keyname
Parameters: package_keyname (str) – The package for which to get the items. Returns: List of locations a package is orderable in
-
place_order
(package_keyname, location, item_keynames, complex_type=None, hourly=True, preset_keyname=None, extras=None, quantity=1)[source]¶ Places an order with the given package and prices.
This function takes in parameters needed for an order and places the order.
Parameters: - package_keyname (str) – The keyname for the package being ordered
- location (str) – The datacenter location string for ordering (Ex: DALLAS13)
- item_keynames (list) – The list of item keyname strings to order. To see list of possible keynames for a package, use list_items() (or slcli order item-list)
- complex_type (str) – The complex type to send with the order. Typically begins with SoftLayer_Container_Product_Order_.
- hourly (bool) – If true, uses hourly billing, otherwise uses monthly billing
- preset_keyname (string) – If needed, specifies a preset to use for that package. To see a list of possible keynames for a package, use list_preset() (or slcli order preset-list)
- extras (dict) – The extra data for the order in dictionary format. Example: A VSI order requires hostname and domain to be set, so extras will look like the following: {‘virtualGuests’: [{‘hostname’: ‘test’, domain’: ‘softlayer.com’}]}
- quantity (int) – The number of resources to order
-
place_quote
(package_keyname, location, item_keynames, complex_type=None, preset_keyname=None, extras=None, quantity=1, quote_name=None, send_email=False)[source]¶ Place a quote with the given package and prices.
This function takes in parameters needed for an order and places the quote.
Parameters: - package_keyname (str) – The keyname for the package being ordered
- location (str) – The datacenter location string for ordering (Ex: DALLAS13)
- item_keynames (list) – The list of item keyname strings to order. To see list of possible keynames for a package, use list_items() (or slcli order item-list)
- complex_type (str) – The complex type to send with the order. Typically begins with SoftLayer_Container_Product_Order_.
- preset_keyname (string) – If needed, specifies a preset to use for that package. To see a list of possible keynames for a package, use list_preset() (or slcli order preset-list)
- extras (dict) – The extra data for the order in dictionary format. Example: A VSI order requires hostname and domain to be set, so extras will look like the following: {‘virtualGuests’: [{‘hostname’: ‘test’, domain’: ‘softlayer.com’}]}
- quantity (int) – The number of resources to order
- quote_name (string) – A custom name to be assigned to the quote (optional).
- send_email (bool) – This flag indicates that the quote should be sent to the email address associated with the account or order.
-
verify_order
(package_keyname, location, item_keynames, complex_type=None, hourly=True, preset_keyname=None, extras=None, quantity=1)[source]¶ Verifies an order with the given package and prices.
This function takes in parameters needed for an order and verifies the order to ensure the given items are compatible with the given package.
Parameters: - package_keyname (str) – The keyname for the package being ordered
- location (str) – The datacenter location string for ordering (Ex: DALLAS13)
- item_keynames (list) – The list of item keyname strings to order. To see list of possible keynames for a package, use list_items() (or slcli order item-list)
- complex_type (str) – The complex type to send with the order. Typically begins with SoftLayer_Container_Product_Order_.
- hourly (bool) – If true, uses hourly billing, otherwise uses monthly billing
- preset_keyname (string) – If needed, specifies a preset to use for that package. To see a list of possible keynames for a package, use list_preset() (or slcli order preset-list)
- extras (dict) – The extra data for the order in dictionary format. Example: A VSI order requires hostname and domain to be set, so extras will look like the following: ‘virtualGuests’: [{‘hostname’: ‘test’, ‘domain’: ‘softlayer.com’}]}
- quantity (int) – The number of resources to order
-
verify_quote
(quote_id, extra)[source]¶ Verifies that a quote order is valid.
extras = { 'hardware': {'hostname': 'test', 'domain': 'testing.com'}, 'quantity': 2 } manager = ordering.OrderingManager(env.client) result = manager.verify_quote(12345, extras)
Parameters: - quote_id (int) – ID for the target quote
- extra (dictionary) – Overrides for the defaults of SoftLayer_Container_Product_Order
- quantity (int) – Quantity to override default
-
static