Ticket
SoftLayer_Ticket::createUpgradeTicket

Overview

Create a ticket for the SoftLayer sales team to perform a hardware or service upgrade. Our sales team will work with you on upgrade feasibility and pricing and then send the upgrade ticket to the proper department to perform the actual upgrade. Service affecting upgrades, such as server hardware or CloudLayer Computing Instance upgrades that require the server powered down must have a two hour maintenance specified for our datacenter engineers to perform your upgrade. Account level upgrades, such as adding PPTP VPN users, CDNLayer accounts, and monitoring services are processed much faster and do not require a maintenance window.

Parameters

attachmentId

integer

An optional hardware identifier if your upgrade request is related to a specific server on your account.

genericUpgrade

string

A brief description of what you wish to upgrade or add to your account. Descriptions like "CPU", "RAM", "RAID cards", "PPTP VPN users", and "StorageLayer".

upgradeMaintenanceWindow

string

If your upgrade is service affecting then please provide an appropriate two hour maintenance window in which SoftLayer's staff can upgrade your server.

details

string

A detailed description of the the server or account upgrade you wish to perform.

attachmentType

string

  • HARDWARE
  • VIRTUAL_GUEST
  • NONE
title

string

A custom ticket title

Headers

SoftLayer_TicketObjectMask, SoftLayer_ObjectMask
authenticate

Return Values

SoftLayer_Ticket

Error Handling

  • SoftLayer_Exception: Throw the exception "Unable to open an upgrade ticket on hardware id <$attachmentId>" when the given hardware or CloudLayer Computing Instance id does not exist or if the user accessing the API doesn't have access to that piece of hardware or instance.
  • SoftLayer_Exception: Throw the exception "Please provide an upgrade maintenance window." when a maintenace window is not provided.
  • SoftLayer_Exception: Throw the exception "Please provide upgrade details." when upgrade details are not provided.