Service.Container

Container methods.

Summary
Service.ContainerContainer methods.
Functions
orderOrder a Container
orderResourceChangeOrders a resource change for a Container
addIPAddressAdd an additional IP address to the container
removeIPAddressRemove an extra IP from the container
destroyDelete a Container
renameRename a Container
startStart a Container
stopStop a Container
rebootReboot a Container
findSearch for a container.
getUuidGet a UUID for a Container.
setSettingsSet a list of settings on the Container
getCurrentResourceUsageGet the current resource usage
getHistoricalResourceUsageGet a list of usage data for a given interval The creation time of the container must not come after startTime + intervalTime or errors may occur
listEnvironmentsReturns a list of Environments that this container is serving.
getProcessTableGraphGet a process table graph for a container over a period of time
getProcessTableGet a process table for a moment in time
listOSesList all the available OSes
listTypesList all the available types to containers
listConvertTypesList all the available upgrades for a container
convertTypeConvert a container to a different type, if possible
listCommandsList all the available commands that can be run against a container
runCommandRun a command against a container
getHistoricalStatusList container status changes
getHistoricalAlertsList container status changes
getOOMEventsList container out of memory events
listBackupsList all backups made of a container
createBackupCreate a backup
destroyBackupDelete a backup
restoreBackupRestore a backup

Functions

order

Order a Container

Parameters

customerIdno docs (idx: 1, type: Types.CustomerId)
nameno docs (idx: 2, type: Types.ContainerName)
typeno docs (idx: 7, type: Types.ContainerTypeId)
sizeno docs (idx: 4, type: Types.ContainerSize, optional)
diskSpaceno docs (idx: 10, type: Types.ContainerDiskSpace, optional)
paymentMethodIdno docs (idx: 5, type: Types.PBA_paymentMethodId, optional)
promoCode, (idx: 6, type: Thrift.string, optional)
provisioningDatano docs (idx: 8, type: Thrift.map (Thrift.string => Thrift.string), optional)
osIdno docs (idx: 9, type: Types.OSId)

Returns

Types.ContainerDetails

Throws

Exceptions.InvalidArguments (idx: 1) Exceptions.BillingFailed (idx: 2)

Roles

  • customer

orderResourceChange

Orders a resource change for a Container

Parameters

idno docs (idx: 1, type: Types.ContainerId)
sizeno docs (idx: 2, type: Types.ContainerSize, optional)
diskSpaceno docs (idx: 3, type: Types.ContainerDiskSpace, optional)

Returns

Thrift.void

Throws

Exceptions.InvalidArguments (idx: 1) Exceptions.BillingFailed (idx: 2)

Roles

  • customer

addIPAddress

Add an additional IP address to the container

Parameters

idno docs (idx: 1, type: Types.ContainerId)

Returns

Types.IPAddress

Throws

Exceptions.InvalidArguments (idx: 1)

Roles

  • customer

removeIPAddress

Remove an extra IP from the container

Parameters

idno docs (idx: 1, type: Types.ContainerId)
addressno docs (idx: 2, type: Types.IPAddress)

Returns

Thrift.void

Throws

Exceptions.InvalidArguments (idx: 1)

Roles

  • customer

destroy

Delete a Container

Parameters

idID of the Container you wish to destroy (idx: 1, type: Types.ContainerId)

Returns

Thrift.void

Throws

Exceptions.InvalidArguments (idx: 1)

Roles

  • customer

rename

Rename a Container

Parameters

idno docs (idx: 1, type: Types.ContainerId)
nameno docs (idx: 2, type: Types.ContainerName)

Returns

Thrift.void

Throws

Exceptions.InvalidArguments (idx: 1)

Roles

  • customer

start

Start a Container

Parameters

idID of the Container you wish to start (idx: 1, type: Types.ContainerId)

Returns

Thrift.void

Throws

Exceptions.InvalidArguments (idx: 1)

Roles

  • customer

stop

Stop a Container

Parameters

idID of the Container you wish to stop (idx: 1, type: Types.ContainerId)

Returns

Thrift.void

Throws

Exceptions.InvalidArguments (idx: 1)

Roles

  • customer

reboot

Reboot a Container

Parameters

idID of the Container you wish to reboot (idx: 1, type: Types.ContainerId)

Returns

Thrift.void

Throws

Exceptions.InvalidArguments (idx: 1)

Roles

  • customer

find

Search for a container.

Parameters

uuidUUID of the container to find (idx: 1, type: Types.ContainerUuid, optional)
addressIP address belonging to the container (idx: 2, type: Types.IPAddress, optional)
customerIdID of a customer (idx: 3, type: Types.CustomerId, optional)
idno docs (idx: 4, type: Types.ContainerId, optional)

Returns

Thrift.list (Types.ContainerDetails) a list of ContainerId

Throws

Exceptions.InvalidArguments (idx: 1)

Roles

  • customer

getUuid

Get a UUID for a Container.

Parameters

idno docs (idx: 1, type: Types.ContainerId)

Returns

Types.ContainerUuid

Throws

Exceptions.InvalidArguments (idx: 1)

Roles

  • customer

setSettings

Set a list of settings on the Container

Parameters

idthe ID of the Container (idx: 1, type: Types.ContainerId)
settingsa list of the settings (idx: 2, type: Types.SettingList)

Returns

Thrift.void

Throws

Exceptions.InvalidArguments (idx: 1)

Roles

  • customer

getCurrentResourceUsage

Get the current resource usage

Parameters

idno docs (idx: 1, type: Types.ContainerId)

Returns

Types.ResourceCurrentUsage

Throws

Exceptions.InvalidArguments (idx: 1)

Roles

  • customer

getHistoricalResourceUsage

Get a list of usage data for a given interval The creation time of the container must not come after startTime + intervalTime or errors may occur

Parameters

idno docs (idx: 1, type: Types.ContainerId)
startTimeno docs (idx: 2, type: Types.UnixTime)
endTimeno docs (idx: 3, type: Types.UnixTime)
intervalTimeThe time in seconds between each record (idx: 4, type: Thrift.i32)
typesA list of which resource usage types you’d like data for (idx: 5, type: Thrift.list (Types.ResourceUsageType))

Returns

Thrift.list (Types.ResourceHistoricalUsage)

Throws

Exceptions.InvalidArguments (idx: 1)

Roles

  • customer

listEnvironments

Returns a list of Environments that this container is serving.  Returns list<ContainerEnvironmentDetails>

Parameters

idno docs (idx: 1, type: Types.ContainerId)

Returns

Thrift.list (Types.ContainerEnvironmentDetails)

Throws

Exceptions.InvalidArguments (idx: 1)

Roles

  • customer

getProcessTableGraph

Get a process table graph for a container over a period of time

Parameters

idno docs (idx: 1, type: Types.ContainerId)
startTimeno docs (idx: 2, type: Types.UnixTime)
endTimeno docs (idx: 3, type: Types.UnixTime)
intervalTimeThe time in seconds between each record (idx: 4, type: Thrift.i32)
limitLimit the number of processes returned (idx: 5, type: Thrift.i16, optional)
metricsWhat metrics are we graphing (idx: 6, type: Thrift.list (Types.ProcessTableMetric))
thresholdsRequire all processes that are returned to have some values above this threshold.  Units are contextual to the metric.  (idx: 7, type: Thrift.map (Types.ProcessTableMetric => Thrift.i32), optional)

Returns

Types.ProcessTableGraph

Throws

Exceptions.InvalidArguments (idx: 1)

Roles

  • customer

getProcessTable

Get a process table for a moment in time

Parameters

idno docs (idx: 1, type: Types.ContainerId)
timeno docs (idx: 2, type: Types.UnixTime)

Returns

Types.ProcessTable

Throws

Exceptions.InvalidArguments (idx: 1)

Roles

  • customer

listOSes

List all the available OSes

Returns

Thrift.list (Types.OS)

Throws

Exceptions.InvalidArguments (idx: 1)

Roles

  • customer

listTypes

List all the available types to containers

Returns

Thrift.list (Types.ContainerType)

Throws

Exceptions.InvalidArguments (idx: 1)

Roles

  • customer

listConvertTypes

List all the available upgrades for a container

Parameters

typeIdno docs (idx: 1, type: Types.ContainerTypeId)

Returns

Thrift.list (Types.ContainerType)

Throws

Exceptions.InvalidArguments (idx: 1)

Roles

  • customer

convertType

Convert a container to a different type, if possible

Parameters

idno docs (idx: 1, type: Types.ContainerId)
typeIdno docs (idx: 2, type: Types.ContainerTypeId)

Returns

Thrift.void

Throws

Exceptions.InvalidArguments (idx: 1)

Roles

  • customer

listCommands

List all the available commands that can be run against a container

Parameters

idno docs (idx: 1, type: Types.ContainerId)

Returns

Thrift.list (Types.ContainerCommand)

Throws

Exceptions.InvalidArguments (idx: 1)

Roles

  • customer

runCommand

Run a command against a container

Parameters

idno docs (idx: 1, type: Types.ContainerId)
commandIdno docs (idx: 2, type: Types.ContainerCommandId, optional)
commandNameno docs (idx: 3, type: Thrift.string, optional)
argumentsno docs (idx: 4, type: Thrift.list (Types.ContainerCommandArgument))

Returns

Types.ContainerCommandResponse

Throws

Exceptions.InvalidArguments (idx: 1)

Roles

  • customer

getHistoricalStatus

List container status changes

Parameters

idno docs (idx: 1, type: Types.ContainerId)
startTimeno docs (idx: 2, type: Types.UnixTime, optional)
endTimeno docs (idx: 3, type: Types.UnixTime, optional)
limitLimit the number of records returned (idx: 4, type: Thrift.i16, optional)
statusLimit only to these status (idx: 5, type: Thrift.list (Types.ContainerHistoricalStatusName), optional)
transitionsLimit only to these transitions (idx: 6, type: Thrift.list (Types.ContainerHistoricalTransitionName), optional)

Returns

Thrift.list (Types.ContainerHistoricalStatus)

Throws

Exceptions.InvalidArguments (idx: 1)

Roles

  • customer

getHistoricalAlerts

List container status changes

Parameters

idno docs (idx: 1, type: Types.ContainerId)
startTimeno docs (idx: 2, type: Types.UnixTime, optional)
endTimeno docs (idx: 3, type: Types.UnixTime, optional)
limitLimit the number of records returned (idx: 4, type: Thrift.i16, optional)
countersLimit only to these counters (idx: 5, type: Thrift.list (Types.ContainerHistoricalAlertCounter), optional)

Returns

Thrift.list (Types.ContainerHistoricalAlert)

Throws

Exceptions.InvalidArguments (idx: 1)

Roles

  • customer

getOOMEvents

List container out of memory events

Parameters

idno docs (idx: 1, type: Types.ContainerId)
startTimeno docs (idx: 2, type: Types.UnixTime, optional)
endTimeno docs (idx: 3, type: Types.UnixTime, optional)
limitLimit the number of records returned (idx: 4, type: Thrift.i16, optional)

Returns

Thrift.list (Types.ContainerOOMEvent)

Throws

Exceptions.InvalidArguments (idx: 1)

Roles

  • customer

listBackups

List all backups made of a container

Parameters

idno docs (idx: 1, type: Types.ContainerId)

Returns

Thrift.list (Types.ContainerBackup)

Throws

Exceptions.InvalidArguments (idx: 1)

Roles

  • customer

createBackup

Create a backup

Parameters

idno docs (idx: 1, type: Types.ContainerId)
descriptionno docs (idx: 2, type: Thrift.string)
typeno docs (idx: 3, type: Types.ContainerBackupType)

Returns

Types.ContainerBackup

Throws

Exceptions.InvalidArguments (idx: 1)

Roles

  • customer

destroyBackup

Delete a backup

Parameters

containerIdno docs (idx: 1, type: Types.ContainerId)
backupIdno docs (idx: 2, type: Types.ContainerBackupId)

Returns

Thrift.void

Throws

Exceptions.InvalidArguments (idx: 1)

Roles

  • customer

restoreBackup

Restore a backup

Parameters

containerIdno docs (idx: 1, type: Types.ContainerId)
backupIdno docs (idx: 2, type: Types.ContainerBackupId)

Returns

Thrift.void

Throws

Exceptions.InvalidArguments (idx: 1)

Roles

  • customer
Base type Thrift.i16
Base type Thrift.string
Base type Thrift.i16
Base type Thrift.i16
Base type Thrift.i32
A Thrift built-in type.
A Thrift built-in type.
Base type Thrift.i16
Returned from some Container.* calls
The billing failed
Base type Thrift.i32
A Thrift built-in type.
Base type Thrift.string
Base type Thrift.string
A Thrift built-in type.
Base type Thrift.map (Types.SettingKey => Types.SettingValue)
Current resource usage for a container.
Base type Thrift.i32
A Thrift built-in type.
Moment in time resource usage for a container.
Container configuration for a specific environment
A Thrift built-in type.
A graph of process data over a period of time See Container.getProcessTableGraph
A sample of all the processes running on a container at a moment in time
OS db object
Struct to define the type of a container or site environment stack
A command one can call against a container
Base type Thrift.i16
Struct of both the spec and passed value of arguments
The result of a command called against a container
A past Container status
A past Container alert
An event indicating a moment when memory was running out on a container and an effort was made to kill a process using too much memory.
Representation of PVA backup object
Base type Thrift.string
Close