A container is a representation of a Docker container on a host.
Field | Type | Create | Update | Default | Notes |
---|---|---|---|---|---|
blkioDeviceOptions | map[blkioDeviceOption] | Optional | - | - | |
blkioWeight | int | Optional | - | - | |
build | dockerBuild | Optional | - | - | |
capAdd | array[enum] | Optional | - | - | |
capDrop | array[enum] | Optional | - | - | |
cgroupParent | string | Optional | - | - | |
command | array[string] | Optional | - | - | |
count | int | Optional | - | - | |
cpuCount | int | Optional | - | - | |
cpuPercent | int | Optional | - | - | |
cpuPeriod | int | Optional | - | - | |
cpuQuota | int | Optional | - | - | |
cpuSet | string | Optional | - | - | |
cpuSetMems | string | Optional | - | - | |
cpuShares | int | Optional | - | - | |
dataVolumeMounts | map[volume] | Optional | - | - | |
dataVolumes | array[string] | Optional | - | - | |
dataVolumesFrom | array[container] | Optional | - | - | |
description | string | Optional | Yes | - | |
devices | array[string] | Optional | - | - | |
diskQuota | int | Optional | - | - | |
dns | array[string] | Optional | - | - | |
dnsOpt | array[string] | Optional | - | - | |
dnsSearch | array[string] | Optional | - | - | |
domainName | string | Optional | - | - | |
entryPoint | array[string] | Optional | - | - | |
environment | map[string] | Optional | - | - | |
expose | array[string] | Optional | - | - | |
extraHosts | array[string] | Optional | - | - | |
groupAdd | array[string] | Optional | - | - | |
healthCheck | instanceHealthCheck | Optional | - | - | |
healthCmd | array[string] | Optional | - | - | |
healthInterval | int | Optional | - | - | |
healthRetries | int | Optional | - | - | |
healthTimeout | int | Optional | - | - | |
hostname | string | Optional | - | - | |
imageUuid | string | Optional | - | - | |
instanceLinks | map[instance] | Optional | - | - | |
instanceTriggeredStop | enum | Optional | - | stop | The options are stop , remove . |
ioMaximumBandwidth | int | Optional | - | - | |
ioMaximumIOps | int | Optional | - | - | |
ip | string | Optional | - | - | |
ip6 | string | Optional | - | - | |
ipcMode | string | Optional | - | - | |
isolation | string | Optional | - | - | |
kernelMemory | int | Optional | - | - | |
labels | map[string] | Optional | - | - | A map of key value pairs to be used as labels for the container |
logConfig | logConfig | Optional | - | - | |
lxcConf | map[string] | Optional | - | - | |
memory | int | Optional | - | - | |
memoryReservation | int | Optional | - | - | |
memorySwap | int | Optional | - | - | |
memorySwappiness | int | Optional | - | - | |
milliCpuReservation | int | Optional | - | - | |
name | string | Optional | Yes | - | |
netAlias | array[string] | Optional | - | - | |
networkContainerId | container | Optional | - | - | |
networkIds | array[network] | Optional | - | - | |
networkMode | string | Optional | - | managed | |
oomKillDisable | boolean | Optional | - | - | |
oomScoreAdj | int | Optional | - | - | |
pidMode | enum | Optional | - | - | The options are host . |
pidsLimit | int | Optional | - | - | |
ports | array[string] | Optional | - | - | |
privileged | boolean | Optional | - | - | |
publishAllPorts | boolean | Optional | - | - | |
readOnly | boolean | Optional | - | - | |
registryCredentialId | registryCredential | Optional | - | - | |
requestedHostId | host | Optional | - | - | |
restartPolicy | restartPolicy | Optional | - | - | |
securityOpt | array[string] | Optional | - | - | |
shmSize | int | Optional | - | - | |
startOnCreate | boolean | Optional | - | true | |
stdinOpen | boolean | Optional | - | - | |
stopSignal | string | Optional | - | - | |
storageOpt | map[string] | Optional | - | - | |
sysctls | map[string] | Optional | - | - | |
tmpfs | map[string] | Optional | - | - | |
tty | boolean | Optional | - | - | |
ulimits | array[ulimit] | Optional | - | - | |
user | string | Optional | - | - | |
usernsMode | string | Optional | - | - | |
uts | string | Optional | - | - | |
volumeDriver | string | Optional | - | - | |
workingDir | string | Optional | - | - |
Field | Type | Notes |
---|---|---|
createIndex | int | |
deploymentUnitUuid | string | |
externalId | string | |
firstRunning | date | |
healthState | enum | The options are healthy , unhealthy , updating-healthy , updating-unhealthy , initializing . |
hostId | host | The unique identifier for the associated host |
id | int | The unique identifier for the container |
mounts | array[mountEntry] | |
nativeContainer | boolean | |
primaryIpAddress | string | |
primaryNetworkId | network | |
serviceIds | array[service] | |
startCount | int | |
system | boolean | |
version | string |
Please read more about the common resource fields. These fields are read only and applicable to almost every resource. We have segregated them from the list above.
CreatePOST: /v2-beta/projects/${PROJECT_ID}/containers
DeleteDELETE: /v2-beta/projects/${PROJECT_ID}/containers/${ID}
UpdatePUT: /v2-beta/projects/${PROJECT_ID}/containers/${ID}
console
POST: /v2-beta/projects/${PROJECT_ID}/containers/${ID}?action=console
execute
POST: /v2-beta/projects/${PROJECT_ID}/containers/${ID}?action=execute
Input: ContainerExec
Field | Type | Required | Default | Notes |
---|---|---|---|---|
attachStdin | No | true | ||
attachStdout | No | true | ||
command | array[string] | Yes | ||
tty | No | true |
Output: An updated copy of the hostAccess resource
logs
POST: /v2-beta/projects/${PROJECT_ID}/containers/${ID}?action=logs
Input: ContainerLogs
Field | Type | Required | Default | Notes |
---|---|---|---|---|
follow | No | true | ||
lines | No | 100 |
Output: An updated copy of the hostAccess resource
proxy
POST: /v2-beta/projects/${PROJECT_ID}/containers/${ID}?action=proxy
Input: ContainerProxy
Field | Type | Required | Default | Notes |
---|---|---|---|---|
port | No | 80 | ||
scheme | No | http | The options are http , https . |
Output: An updated copy of the hostAccess resource
restart
POST: /v2-beta/projects/${PROJECT_ID}/containers/${ID}?action=restart
start
POST: /v2-beta/projects/${PROJECT_ID}/containers/${ID}?action=start
stop
POST: /v2-beta/projects/${PROJECT_ID}/containers/${ID}?action=stop
Input: InstanceStop
Field | Type | Required | Default | Notes |
---|---|---|---|---|
remove | No | |||
timeout | No |
Output: An updated copy of the instance resource