This is the ID of the SoftLayer_Billing_Order_Item of this configuration/container. It is used for rebuilding an order container from a quote and is set automatically.

Type:

integer

cancelUrl

The URL to which PayPal redirects browser after checkout has been canceled before completion of a payment.

Type:

string

containerIdentifier

User-specified description to identify a particular order container. This is useful if you have a multi-configuration order (multiple orderContainers) and you want to be able to easily determine one from another. Populating this value may be helpful if an exception is thrown when placing an order and it's tied to a specific order container.

Type:

string

containerSplHash

This hash is internally-generated and is used to for tracking order containers.

Type:

string

currencyShortName

The currency type chosen at checkout.

Type:

string

deviceFingerprintId

Device Fingerprint Identifier - Optional.

Type:

string

displayLayerSessionId

This is the configuration identifier for tracking orders on the HTML order forms.

Type:

string

extendedHardwareTesting

Type:

boolean

flexibleCreditProgramPrice

The SoftLayer_Product_Item_Price for the Flexible Credit Program discount. The oneTimeFee field contains the calculated discount being applied to the order.

For orders that contain servers (bare metal, virtual server, big data, etc.), the hardware property is required. This property is an array of SoftLayer_Hardware objects. The hostname and domain properties are required for each hardware object. Note that virtual server (SoftLayer_Container_Product_Order_Virtual_Guest) orders may populate this field instead of the virtualGuests property.

This SoftLayer_Location object will be determined from the location property and will be returned in the order verification or placement response. Any value specified here will get overwritten by the verification process.

A generic message about the order. Does not need to be sent in with any orders.

Type:

string

orderContainers

Orders may contain an array of configurations. Populating this property allows you to purchase multiple configurations within a single order. Each order container will have its own individual settings independent of the other order containers. For example, it is possible to order a bare metal server in one configuration and a virtual server in another.

If orderContainers is populated on the base order container, most of the configuration-specific properties are ignored on the base container. For example, prices, location and packageId will be ignored on the base container, but since the billingInformation is a property that's not specific to a single order container (but the order as a whole) it must be populated on the base container.

Collection of exceptions resulting from the verification of the order. This value is set internally and is not required for end users when placing an order. When placing API orders, users can use this value to determine the container-specific exception that was thrown.

This must be populated for block storage orders. This should match the OS type of the host(s) that will connect to the volume. The only required property is the keyName of the OS type. This property is ignored for file storage orders.

The Payment Type is Optional. If nothing is sent in, then the normal method of payment will be used. For paypal customers, this means a paypalToken will be returned in the receipt. This token is to be used on the paypal website to complete the order. For Credit Card customers, the card on file in our system will be used to make an initial authorization. To force the order to use a payment type, use one of the following: CARD_ON_FILE or PAYPAL

Type:

string

postTaxRecurring

The post-tax recurring charge for the order. This is the sum of preTaxRecurring + totalRecurringTax.

Type:

decimal

postTaxRecurringHourly

The post-tax recurring hourly charge for the order. Since taxes are not calculated for hourly orders, this value will be the same as preTaxRecurringHourly.

Type:

decimal

postTaxRecurringMonthly

The post-tax recurring monthly charge for the order. This is the sum of preTaxRecurringMonthly + totalRecurringTax.

Type:

decimal

postTaxSetup

The post-tax setup fees of the order. This is the sum of preTaxSetup + totalSetupTax;

Type:

decimal

presaleEvent

If there are any presale events available for an order, this value will be populated. It is set internally and is not required for end users when placing an order. See SoftLayer_Sales_Presale_Event for more info.

A preset configuration id for the package. Is required if not submitting any prices.

Type:

integer

preTaxRecurring

The pre-tax recurring total of the order. If there are mixed monthly and hourly prices on the order, this will be the sum of preTaxRecurringHourly and preTaxRecurringMonthly.

Type:

decimal

preTaxRecurringHourly

The pre-tax hourly recurring total of the order. If there are only monthly prices on the order, this value will be 0.

Type:

decimal

preTaxRecurringMonthly

The pre-tax monthly recurring total of the order. If there are only hourly prices on the order, this value will be 0.

Type:

decimal

preTaxSetup

The pre-tax setup fee total of the order.

Type:

decimal

prices

This is a collection of SoftLayer_Product_Item_Price objects. The only required property to populate for an item price object when ordering is its id - all other supplied information about the price (e.g., recurringFee, setupFee, etc.) will be ignored. Unless the SoftLayer_Product_Package associated with the order allows for preset prices, this property is required to place an order.

The Prorated Initial Charge plus the balance on the account. Only the recurring fees are prorated. Here's how the calculation works: We take the postTaxRecurring value and we prorate it based on the time between now and the next bill date for this account. After this, we add in the setup fee since this is not prorated. Then, if there is a balance on the account, we add that to the account. In the event that there is a credit balance on the account, we will subtract this amount from the order total. If the credit balance on the account is greater than the prorated initial charge, the order will go through without a charge to the credit card on the account or requiring a paypal payment. The credit on the account will be reduced by the order total, and the order will await approval from sales, as normal. If there is a pending order already in the system, We will ignore the balance on the account completely, in the calculation of the initial charge. This is to protect against two orders coming into the system and getting the benefit of a credit balance, or worse, both orders being charged the order amount + the balance on the account.

Type:

decimal

proratedOrderTotal

This is the same as the proratedInitialCharge, except the balance on the account is ignored. This is the prorated total amount of the order.

Type:

decimal

provisionScripts

The URLs for scripts to execute on their respective servers after they have been provisioned. Provision scripts are not available for Microsoft Windows servers.

Type:

array of strings

quantity

The quantity of the item being ordered

Type:

integer

quoteName

A custom name to be assigned to the quote.

Type:

string

regionalGroup

Specifying a regional group name allows you to not worry about placing your server or service at a specific datacenter, but to any datacenter within that regional group. See SoftLayer_Location_Group_Regional to get a list of available regional group names.

location and regionalGroup are mutually exclusive on an order container. If both location and regionalGroup are provided, an exception will be thrown indicating that only 1 is allowed.

If a regional group is provided and VLANs are specified (within the hardware or virtualGuests properties), we will use the datacenter where the VLANs are located. If no VLANs are specified, we will use the preferred datacenter on the regional group object.

Type:

string

resourceGroupId

An optional resource group identifier specifying the resource group to attach the order to

Type:

integer

resourceGroupName

This variable specifies the name of the resource group the server configuration belongs to. For MongoDB Replica sets, it would be the replica set name.

Type:

string

resourceGroupTemplateId

An optional resource group template identifier to be used as a deployment base for a Virtual Server (Private Node) order.

Type:

integer

returnUrl

The URL to which PayPal redirects browser after a payment is completed.

Type:

string

sendQuoteEmailFlag

This flag indicates that the quote should be sent to the email address associated with the account or order.

Type:

boolean

serverCoreCount

The number of cores for the server being ordered. This value is set internally.

Type:

integer

serviceToken

The token of a requesting service. Do not set.

Type:

string

sourceVirtualGuestId

An optional computing instance identifier to be used as an installation base for a computing instance order

Type:

integer

sshKeys

The containers which hold SoftLayer_Security_Ssh_Key IDs to add to their respective servers. The order of containers passed in needs to match the order they are assigned to either hardware or virtualGuests. SSH Keys will not be assigned for servers with Microsoft Windows.

For orders that want to add storage groups such as RAID across multiple disks, simply add SoftLayer_Container_Product_Order_Storage_Group objects to this array. Storage groups will only be used if the 'RAID' disk controller price is selected. Any other disk controller types will ignore the storage groups set here.

The first storage group in this array will be considered the primary storage group, which is used for the OS. Any other storage groups will act as data storage.

The order container may not contain the final tax rates when it is returned from verifyOrder. This hash will facilitate checking if the tax rates have finished being calculated and retrieving the accurate tax rate values.

Type:

string

taxCompletedFlag

Flag to indicate if the order container has the final tax rates for the order. Some tax rates are calculated in the background because they take longer, and they might not be finished when the container is returned from verifyOrder.

Type:

boolean

techIncubatorItemPrice

The SoftLayer_Product_Item_Price for the Tech Incubator discount. The oneTimeFee field contain the calculated discount being applied to the order.

An optional flag to use hourly pricing instead of standard monthly pricing.

Type:

boolean

virtualGuests

For virtual guest (virtual server) orders, this property is required if you did not specify data in the hardware property. This is an array of SoftLayer_Virtual_Guest objects. The hostname and domain properties are required for each virtual guest object. There is no need to specify data in this property and the hardware property - only one is required for virtual server orders.