REST Resource: apps.services.versions

Resource: Version

A Version resource is a specific set of source code and configuration files that are deployed into a service.

JSON representation 
{
  "name": string,
  "id": string,
  "inboundServices": [
    enum (InboundServiceType)
  ],
  "instanceClass": string,
  "network": {
    object (Network)
  },
  "zones": [
    string
  ],
  "resources": {
    object (Resources)
  },
  "runtime": string,
  "runtimeChannel": string,
  "threadsafe": boolean,
  "vm": boolean,
  "flexibleRuntimeSettings": {
    object (FlexibleRuntimeSettings)
  },
  "appEngineApis": boolean,
  "betaSettings": {
    string: string,
    ...
  },
  "env": string,
  "servingStatus": enum (ServingStatus),
  "createdBy": string,
  "createTime": string,
  "diskUsageBytes": string,
  "runtimeApiVersion": string,
  "runtimeMainExecutablePath": string,
  "serviceAccount": string,
  "handlers": [
    {
      object (UrlMap)
    }
  ],
  "errorHandlers": [
    {
      object (ErrorHandler)
    }
  ],
  "libraries": [
    {
      object (Library)
    }
  ],
  "apiConfig": {
    object (ApiConfigHandler)
  },
  "envVariables": {
    string: string,
    ...
  },
  "buildEnvVariables": {
    string: string,
    ...
  },
  "defaultExpiration": string,
  "healthCheck": {
    object (HealthCheck)
  },
  "readinessCheck": {
    object (ReadinessCheck)
  },
  "livenessCheck": {
    object (LivenessCheck)
  },
  "nobuildFilesRegex": string,
  "deployment": {
    object (Deployment)
  },
  "versionUrl": string,
  "endpointsApiService": {
    object (EndpointsApiService)
  },
  "entrypoint": {
    object (Entrypoint)
  },
  "vpcAccessConnector": {
    object (VpcAccessConnector)
  },

  // Union field scaling can be only one of the following:
  "automaticScaling": {
    object (AutomaticScaling)
  },
  "basicScaling": {
    object (BasicScaling)
  },
  "manualScaling": {
    object (ManualScaling)
  }
  // End of list of possible types for union field scaling.
}
Fields
name

string

Full path to the Version resource in the API. Example: apps/myapp/services/default/versions/v1.

Note: This field is used in responses only. Any value specified here in a request is ignored.
id

string

Relative name of the version within the service. Example: v1. Version names can contain only lowercase letters, numbers, or hyphens. Reserved names: "default", "latest", and any name with the prefix "ah-".
inboundServices[]

enum (InboundServiceType)

Before an application can receive email or XMPP messages, the application must be configured to enable the service.
instanceClass

string

Instance class that is used to run this version. Valid values are:

  • AutomaticScaling: F1, F2, F4, F4_1G
  • ManualScaling or BasicScaling: B1, B2, B4, B8, B4_1G

Defaults to F1 for AutomaticScaling and B1 for ManualScaling or BasicScaling.
network

object (Network)

Extra network settings. Only applicable in the App Engine flexible environment.
zones[]

string

The Google Compute Engine zones that are supported by this version in the App Engine flexible environment. Deprecated.
resources

object (Resources)

Machine resources for this version. Only applicable in the App Engine flexible environment.
runtime

string

Desired runtime. Example: python27.
runtimeChannel

string

The channel of the runtime to use. Only available for some runtimes. Defaults to the default channel.
threadsafe

boolean

Whether multiple requests can be dispatched to this version at once.
vm

boolean

Whether to deploy this version in a container on a virtual machine.
flexibleRuntimeSettings

object (FlexibleRuntimeSettings)

Settings for App Engine flexible runtimes.
appEngineApis

boolean

Allows App Engine second generation runtimes to access the legacy bundled services.
betaSettings

map (key: string, value: string)

Metadata settings that are supplied to this version to enable beta runtime features.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
env

string

App Engine execution environment for this version.

Defaults to standard.
servingStatus

enum (ServingStatus)

Current serving status of this version. Only the versions with a SERVING status create instances and can be billed.

SERVING_STATUS_UNSPECIFIED is an invalid value. Defaults to SERVING.
createdBy

string

Email address of the user who created this version.

Note: This field is used in responses only. Any value specified here in a request is ignored.
createTime

string (Timestamp format)

Time that this version was created.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

Note: This field is used in responses only. Any value specified here in a request is ignored.
diskUsageBytes

string (int64 format)

Total size in bytes of all the files that are included in this version and currently hosted on the App Engine disk.

Note: This field is used in responses only. Any value specified here in a request is ignored.
runtimeApiVersion

string

The version of the API in the given runtime environment. Please see the app.yaml reference for valid values at https://cloud.google.com/appengine/docs/standard//config/appref
runtimeMainExecutablePath

string

The path or name of the app's main executable.
serviceAccount

string

The identity that the deployed version will run as. Admin API will use the App Engine Appspot service account as default if this field is neither provided in app.yaml file nor through CLI flag.
handlers[]

object (UrlMap)

An ordered list of URL-matching patterns that should be applied to incoming requests. The first matching URL handles the request and other request handlers are not attempted.

Only returned in GET requests if view=FULL is set.
errorHandlers[]

object (