"SoftLayer_" prefix removed for readability.
The hardware configuration container is used to provide configuration options for servers.
Each configuration option will include both an itemPrice and a template.
The itemPrice value will provide hourly and monthly costs (if either are applicable), and a description of the option.
The template will provide a fragment of the request with the properties and values that must be sent when creating a server with the option.
The SoftLayer_Hardware::getCreateObjectOptions method returns this data structure.
The datacenter.name value in the template represents which datacenter the server will be provisioned in.
The fixedConfigurationPreset.keyName value in the template is an identifier for a particular fixed configuration. When provided exactly as shown in the template, that fixed configuration will be used.
When providing a fixedConfigurationPreset.keyName while ordering a server the processors and hardDrives configuration options cannot be used.
A server will have at least one hard drive.
The hardDrives.capacity value in the template represents the size, in gigabytes, of the disk.
The networkComponent.maxSpeed value in the template represents the link speed, in megabits per second, of the network connections for a server.
The operatingSystemReferenceCode value in the template is an identifier for a particular operating system. When provided exactly as shown in the template, that operating system will be used.
A reference code is structured as three tokens separated by underscores. The first token represents the product, the second is the version of the product, and the third is whether the OS is 32 or 64bit.
When providing an operatingSystemReferenceCode while ordering a server the only token required to match exactly is the product. The version token may be given as ‘LATEST’, else it will require an exact match as well. When the bits token is not provided, 64 bits will be assumed.
Providing the value of ‘LATEST’ for a version will select the latest release of that product for the operating system. As this may change over time, you should be sure that the release version is irrelevant for your applications.
For Windows based operating systems the version will represent both the release version (2008, 2012, etc) and the edition (Standard, Enterprise, etc). For all other operating systems the version will represent the major version (Centos 6, Ubuntu 12, etc) of that operating system, minor versions are represented in few reference codes where they are significant.
The processorCoreAmount value in the template represents the number of cores allocated to the server.
The memoryCapacity value in the template represents the amount of memory, in gigabytes, allocated to the server.