Skip to main content

ExecAppStatus

Whether an app’s ck-exec code may run: its active version and its switches.

type ExecAppStatus {
  activeVersion: Int
  disabled: Boolean!
  disabledTypes: [String!]!
  budgetPaused: Boolean!
  budgetPauseReason: String
  maxInstances: Int
  maxReservedMb: Int
  instanceLimit: Int
  instances: Int
  reservedMb: Int
}

Fields​

ExecAppStatus.activeVersion ● Int scalar​

The active version; null before the first deploy.

ExecAppStatus.disabled ● Boolean! non-null scalar​

The whole app is switched off (execSetEnabled without a node type).

ExecAppStatus.disabledTypes ● [String!]! non-null scalar​

Node types of the active version switched off one by one. A deploy or a rollback that drops a type drops its switch too, so a version that deploys the type again starts it switched on.

ExecAppStatus.budgetPaused ● Boolean! non-null scalar​

Paused while the app's runtime gate is not active (no funds, a spend cap, a lapsed subscription) or it is over its compute budget; it resumes by itself once the cause clears.

ExecAppStatus.budgetPauseReason ● String scalar​

Why the app is paused: insufficient_funds, spend_cap, subscription_lapsed or compute_budget. Null when it is not paused (or the manager predates reasons).

ExecAppStatus.maxInstances ● Int scalar​

The most instances the app may have placed in this datacenter. The free hub tier (an organization that has not funded the app) allows 16; null means the manager's default.

ExecAppStatus.maxReservedMb ● Int scalar​

The most memory, in MB, the app's placed instances may reserve in this datacenter (each instance reserves its type's memory). The free hub tier allows 1,024; null means no memory limit beyond the instance count.

ExecAppStatus.instanceLimit ● Int scalar​

The instance limit in force: maxInstances, or the manager’s default when that is null. Null from a manager older than ck-exec 0.15.

ExecAppStatus.instances ● Int scalar​

Instances of the app placed and not yet stopped in this datacenter now, mods included. Null from a manager older than ck-exec 0.15.

ExecAppStatus.reservedMb ● Int scalar​

Memory, in MB, those instances reserve now (what maxReservedMb limits). Null from a manager older than ck-exec 0.15.

Returned By​

execActivateVersion mutation ● execAppStatus query ● execSetEnabled mutation