versions

Creates, updates, deletes, gets or lists a versions resource.

Overview

Name	versions
Type	Resource
Id	google.appengine.versions

Fields

Name	Datatype	Description
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-".
name	string	Output only. Full path to the Version resource in the API. Example: apps/myapp/services/default/versions/v1.@OutputOnly
apiConfig	object	Google Cloud Endpoints (https://cloud.google.com/endpoints) configuration for API handlers.
appEngineApis	boolean	Allows App Engine second generation runtimes to access the legacy bundled services.
automaticScaling	object	Automatic scaling is based on request rate, response latencies, and other application metrics.
basicScaling	object	A service with basic scaling will create an instance when the application receives a request. The instance will be turned down when the app becomes idle. Basic scaling is ideal for work that is intermittent or driven by user activity.
betaSettings	object	Metadata settings that are supplied to this version to enable beta runtime features.
buildEnvVariables	object	Environment variables available to the build environment.Only returned in GET requests if view=FULL is set.
createTime	string	Time that this version was created.@OutputOnly
createdBy	string	Output only. Email address of the user who created this version.@OutputOnly
defaultExpiration	string	Duration that static files should be cached by web proxies and browsers. Only applicable if the corresponding StaticFilesHandler (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#StaticFilesHandler) does not specify its own expiration time.Only returned in GET requests if view=FULL is set.
deployment	object	Code and application artifacts used to deploy a version to App Engine.
diskUsageBytes	string	Output only. Total size in bytes of all the files that are included in this version and currently hosted on the App Engine disk.@OutputOnly
endpointsApiService	object	Google Cloud Endpoints (https://cloud.google.com/endpoints) configuration. The Endpoints API Service provides tooling for serving Open API and gRPC endpoints via an NGINX proxy. Only valid for App Engine Flexible environment deployments.The fields here refer to the name and configuration ID of a "service" resource in the Service Management API (https://cloud.google.com/service-management/overview).
entrypoint	object	The entrypoint for the application.
env	string	App Engine execution environment for this version.Defaults to standard.
envVariables	object	Environment variables available to the application.Only returned in GET requests if view=FULL is set.
errorHandlers	array	Custom static error pages. Limited to 10KB per page.Only returned in GET requests if view=FULL is set.
flexibleRuntimeSettings	object	Runtime settings for the App Engine flexible environment.
generatedCustomerMetadata	object	Additional Google Generated Customer Metadata, this field won't be provided by default and can be requested by setting the IncludeExtraData field in GetVersionRequest
handlers	array	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.
healthCheck	object	Health checking configuration for VM instances. Unhealthy instances are killed and replaced with new instances. Only applicable for instances in App Engine flexible environment.
inboundServices	array	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_1GDefaults to F1 for AutomaticScaling and B1 for ManualScaling or BasicScaling.
libraries	array	Configuration for third-party Python runtime libraries that are required by the application.Only returned in GET requests if view=FULL is set.
livenessCheck	object	Health checking configuration for VM instances. Unhealthy instances are killed and replaced with new instances.
manualScaling	object	A service with manual scaling runs continuously, allowing you to perform complex initialization and rely on the state of its memory over time.
network	object	Extra network settings. Only applicable in the App Engine flexible environment.
nobuildFilesRegex	string	Files that match this pattern will not be built into this version. Only applicable for Go runtimes.Only returned in GET requests if view=FULL is set.
readinessCheck	object	Readiness checking configuration for VM instances. Unhealthy instances are removed from traffic rotation.
resources	object	Machine resources for a version.
runtime	string	Desired runtime. Example: python27.
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
runtimeChannel	string	The channel of the runtime to use. Only available for some runtimes. Defaults to the default channel.
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.
servingStatus	string	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.
threadsafe	boolean	Whether multiple requests can be dispatched to this version at once.
versionUrl	string	Output only. Serving URL for this version. Example: "https://myversion-dot-myservice-dot-myapp.appspot.com"@OutputOnly
vm	boolean	Whether to deploy this version in a container on a virtual machine.
vpcAccessConnector	object	VPC access connector specification.
zones	array	The Google Compute Engine zones that are supported by this version in the App Engine flexible environment. Deprecated.

Methods

Name	Accessible by	Required Params	Description
get	SELECT	appsId, servicesId, versionsId	Gets the specified Version resource. By default, only a BASIC_VIEW will be returned. Specify the FULL_VIEW parameter to get the full resource.
list	SELECT	appsId, servicesId	Lists the versions of a service.
create	INSERT	appsId, servicesId	Deploys code and resource files to a new version.
delete	DELETE	appsId, servicesId, versionsId	Deletes an existing Version resource.
patch	UPDATE	appsId, servicesId, versionsId	Updates the specified Version resource. You can specify the following fields depending on the App Engine environment and type of scaling that the version resource uses:Standard environment instance_class (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.instance_class)automatic scaling in the standard environment: automatic_scaling.min_idle_instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.automatic_scaling) automatic_scaling.max_idle_instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.automatic_scaling) automaticScaling.standard_scheduler_settings.max_instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#StandardSchedulerSettings) automaticScaling.standard_scheduler_settings.min_instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#StandardSchedulerSettings) automaticScaling.standard_scheduler_settings.target_cpu_utilization (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#StandardSchedulerSettings) automaticScaling.standard_scheduler_settings.target_throughput_utilization (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#StandardSchedulerSettings)basic scaling or manual scaling in the standard environment: serving_status (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.serving_status) manual_scaling.instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#manualscaling)Flexible environment serving_status (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.serving_status)automatic scaling in the flexible environment: automatic_scaling.min_total_instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.automatic_scaling) automatic_scaling.max_total_instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.automatic_scaling) automatic_scaling.cool_down_period_sec (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.automatic_scaling) automatic_scaling.cpu_utilization.target_utilization (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.automatic_scaling)manual scaling in the flexible environment: manual_scaling.instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#manualscaling)

SELECT examples

Lists the versions of a service.

SELECT
id,
name,
apiConfig,
appEngineApis,
automaticScaling,
basicScaling,
betaSettings,
buildEnvVariables,
createTime,
createdBy,
defaultExpiration,
deployment,
diskUsageBytes,
endpointsApiService,
entrypoint,
env,
envVariables,
errorHandlers,
flexibleRuntimeSettings,
generatedCustomerMetadata,
handlers,
healthCheck,
inboundServices,
instanceClass,
libraries,
livenessCheck,
manualScaling,
network,
nobuildFilesRegex,
readinessCheck,
resources,
runtime,
runtimeApiVersion,
runtimeChannel,
runtimeMainExecutablePath,
serviceAccount,
servingStatus,
threadsafe,
versionUrl,
vm,
vpcAccessConnector,
zones
FROM google.appengine.versions
WHERE appsId = '{{ appsId }}'
AND servicesId = '{{ servicesId }}';

INSERT example

Use the following StackQL query and manifest file to create a new versions resource.

All Properties

/*+ create */
INSERT INTO google.appengine.versions (
appsId,
servicesId,
automaticScaling,
basicScaling,
manualScaling,
inboundServices,
instanceClass,
network,
zones,
resources,
runtime,
runtimeChannel,
threadsafe,
vm,
flexibleRuntimeSettings,
appEngineApis,
betaSettings,
env,
servingStatus,
runtimeApiVersion,
runtimeMainExecutablePath,
serviceAccount,
handlers,
errorHandlers,
libraries,
apiConfig,
envVariables,
buildEnvVariables,
defaultExpiration,
healthCheck,
readinessCheck,
livenessCheck,
nobuildFilesRegex,
deployment,
endpointsApiService,
entrypoint,
vpcAccessConnector,
generatedCustomerMetadata
)
SELECT 
'{{ appsId }}',
'{{ servicesId }}',
'{{ automaticScaling }}',
'{{ basicScaling }}',
'{{ manualScaling }}',
'{{ inboundServices }}',
'{{ instanceClass }}',
'{{ network }}',
'{{ zones }}',
'{{ resources }}',
'{{ runtime }}',
'{{ runtimeChannel }}',
{{ threadsafe }},
{{ vm }},
'{{ flexibleRuntimeSettings }}',
{{ appEngineApis }},
'{{ betaSettings }}',
'{{ env }}',
'{{ servingStatus }}',
'{{ runtimeApiVersion }}',
'{{ runtimeMainExecutablePath }}',
'{{ serviceAccount }}',
'{{ handlers }}',
'{{ errorHandlers }}',
'{{ libraries }}',
'{{ apiConfig }}',
'{{ envVariables }}',
'{{ buildEnvVariables }}',
'{{ defaultExpiration }}',
'{{ healthCheck }}',
'{{ readinessCheck }}',
'{{ livenessCheck }}',
'{{ nobuildFilesRegex }}',
'{{ deployment }}',
'{{ endpointsApiService }}',
'{{ entrypoint }}',
'{{ vpcAccessConnector }}',
'{{ generatedCustomerMetadata }}'
;

Manifest

- name: your_resource_model_name
  props:
    - name: name
      value: string
    - name: id
      value: string
    - name: automaticScaling
      value:
        - name: coolDownPeriod
          value: string
        - name: cpuUtilization
          value:
            - name: aggregationWindowLength
              value: string
            - name: targetUtilization
              value: number
        - name: maxConcurrentRequests
          value: integer
        - name: maxIdleInstances
          value: integer
        - name: maxTotalInstances
          value: integer
        - name: maxPendingLatency
          value: string
        - name: minIdleInstances
          value: integer
        - name: minTotalInstances
          value: integer
        - name: minPendingLatency
          value: string
        - name: requestUtilization
          value:
            - name: targetRequestCountPerSecond
              value: integer
            - name: targetConcurrentRequests
              value: integer
        - name: diskUtilization
          value:
            - name: targetWriteBytesPerSecond
              value: integer
            - name: targetWriteOpsPerSecond
              value: integer
            - name: targetReadBytesPerSecond
              value: integer
            - name: targetReadOpsPerSecond
              value: integer
        - name: networkUtilization
          value:
            - name: targetSentBytesPerSecond
              value: integer
            - name: targetSentPacketsPerSecond
              value: integer
            - name: targetReceivedBytesPerSecond
              value: integer
            - name: targetReceivedPacketsPerSecond
              value: integer
        - name: standardSchedulerSettings
          value:
            - name: targetCpuUtilization
              value: number
            - name: targetThroughputUtilization
              value: number
            - name: minInstances
              value: integer
            - name: maxInstances
              value: integer
    - name: basicScaling
      value:
        - name: idleTimeout
          value: string
        - name: maxInstances
          value: integer
    - name: manualScaling
      value:
        - name: instances
          value: integer
    - name: inboundServices
      value:
        - string
    - name: instanceClass
      value: string
    - name: network
      value:
        - name: forwardedPorts
          value:
            - string
        - name: instanceTag
          value: string
        - name: name
          value: string
        - name: subnetworkName
          value: string
        - name: sessionAffinity
          value: boolean
        - name: instanceIpMode
          value: string
    - name: zones
      value:
        - string
    - name: resources
      value:
        - name: cpu
          value: number
        - name: diskGb
          value: number
        - name: memoryGb
          value: number
        - name: volumes
          value:
            - - name: name
                value: string
              - name: volumeType
                value: string
              - name: sizeGb
                value: number
        - name: kmsKeyReference
          value: string
    - name: runtime
      value: string
    - name: runtimeChannel
      value: string
    - name: threadsafe
      value: boolean
    - name: vm
      value: boolean
    - name: flexibleRuntimeSettings
      value:
        - name: operatingSystem
          value: string
        - name: runtimeVersion
          value: string
    - name: appEngineApis
      value: boolean
    - name: betaSettings
      value: object
    - name: env
      value: string
    - name: servingStatus
      value: string
    - name: createdBy
      value: string
    - name: createTime
      value: string
    - name: diskUsageBytes
      value: string
    - name: runtimeApiVersion
      value: string
    - name: runtimeMainExecutablePath
      value: string
    - name: serviceAccount
      value: string
    - name: handlers
      value:
        - - name: urlRegex
            value: string
          - name: staticFiles
            value:
              - name: path
                value: string
              - name: uploadPathRegex
                value: string
              - name: httpHeaders
                value: object
              - name: mimeType
                value: string
              - name: expiration
                value: string
              - name: requireMatchingFile
                value: boolean
              - name: applicationReadable
                value: boolean
          - name: script
            value:
              - name: scriptPath
                value: string
          - name: apiEndpoint
            value:
              - name: scriptPath
                value: string
          - name: securityLevel
            value: string
          - name: login
            value: string
          - name: authFailAction
            value: string
          - name: redirectHttpResponseCode
            value: string
    - name: errorHandlers
      value:
        - - name: errorCode
            value: string
          - name: staticFile
            value: string
          - name: mimeType
            value: string
    - name: libraries
      value:
        - - name: name
            value: string
          - name: version
            value: string
    - name: apiConfig
      value:
        - name: authFailAction
          value: string
        - name: login
          value: string
        - name: script
          value: string
        - name: securityLevel
          value: string
        - name: url
          value: string
    - name: envVariables
      value: object
    - name: buildEnvVariables
      value: object
    - name: defaultExpiration
      value: string
    - name: healthCheck
      value:
        - name: disableHealthCheck
          value: boolean
        - name: host
          value: string
        - name: healthyThreshold
          value: integer
        - name: unhealthyThreshold
          value: integer
        - name: restartThreshold
          value: integer
        - name: checkInterval
          value: string
        - name: timeout
          value: string
    - name: readinessCheck
      value:
        - name: path
          value: string
        - name: host
          value: string
        - name: failureThreshold
          value: integer
        - name: successThreshold
          value: integer
        - name: checkInterval
          value: string
        - name: timeout
          value: string
        - name: appStartTimeout
          value: string
    - name: livenessCheck
      value:
        - name: path
          value: string
        - name: host
          value: string
        - name: failureThreshold
          value: integer
        - name: successThreshold
          value: integer
        - name: checkInterval
          value: string
        - name: timeout
          value: string
        - name: initialDelay
          value: string
    - name: nobuildFilesRegex
      value: string
    - name: deployment
      value:
        - name: files
          value: object
        - name: container
          value:
            - name: image
              value: string
        - name: zip
          value:
            - name: sourceUrl
              value: string
            - name: filesCount
              value: integer
        - name: cloudBuildOptions
          value:
            - name: appYamlPath
              value: string
            - name: cloudBuildTimeout
              value: string
    - name: versionUrl
      value: string
    - name: endpointsApiService
      value:
        - name: name
          value: string
        - name: configId
          value: string
        - name: rolloutStrategy
          value: string
        - name: disableTraceSampling
          value: boolean
    - name: entrypoint
      value:
        - name: shell
          value: string
    - name: vpcAccessConnector
      value:
        - name: name
          value: string
        - name: egressSetting
          value: string
    - name: generatedCustomerMetadata
      value: object

UPDATE example

Updates a versions resource.

/*+ update */
UPDATE google.appengine.versions
SET 
automaticScaling = '{{ automaticScaling }}',
basicScaling = '{{ basicScaling }}',
manualScaling = '{{ manualScaling }}',
inboundServices = '{{ inboundServices }}',
instanceClass = '{{ instanceClass }}',
network = '{{ network }}',
zones = '{{ zones }}',
resources = '{{ resources }}',
runtime = '{{ runtime }}',
runtimeChannel = '{{ runtimeChannel }}',
threadsafe = true|false,
vm = true|false,
flexibleRuntimeSettings = '{{ flexibleRuntimeSettings }}',
appEngineApis = true|false,
betaSettings = '{{ betaSettings }}',
env = '{{ env }}',
servingStatus = '{{ servingStatus }}',
runtimeApiVersion = '{{ runtimeApiVersion }}',
runtimeMainExecutablePath = '{{ runtimeMainExecutablePath }}',
serviceAccount = '{{ serviceAccount }}',
handlers = '{{ handlers }}',
errorHandlers = '{{ errorHandlers }}',
libraries = '{{ libraries }}',
apiConfig = '{{ apiConfig }}',
envVariables = '{{ envVariables }}',
buildEnvVariables = '{{ buildEnvVariables }}',
defaultExpiration = '{{ defaultExpiration }}',
healthCheck = '{{ healthCheck }}',
readinessCheck = '{{ readinessCheck }}',
livenessCheck = '{{ livenessCheck }}',
nobuildFilesRegex = '{{ nobuildFilesRegex }}',
deployment = '{{ deployment }}',
endpointsApiService = '{{ endpointsApiService }}',
entrypoint = '{{ entrypoint }}',
vpcAccessConnector = '{{ vpcAccessConnector }}',
generatedCustomerMetadata = '{{ generatedCustomerMetadata }}'
WHERE 
appsId = '{{ appsId }}'
AND servicesId = '{{ servicesId }}'
AND versionsId = '{{ versionsId }}';

DELETE example

Deletes the specified versions resource.

/*+ delete */
DELETE FROM google.appengine.versions
WHERE appsId = '{{ appsId }}'
AND servicesId = '{{ servicesId }}'
AND versionsId = '{{ versionsId }}';