Reference documentation and code samples for the Google Cloud Appengine Admin V1 Client class Version.
A Version resource is a specific set of source code and configuration files that are deployed into a service.
Generated from protobuf message google.appengine.v1.Version
Namespace
Google \ Cloud \ AppEngine \ V1Methods
__construct
Constructor.
data
array
Optional. Data for populating the Message object.
↳ name
string
Full path to the Version resource in the API. Example: apps/myapp/services/default/versions/v1
. @OutputOnly
↳ 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-".
↳ automatic_scaling
AutomaticScaling
Automatic scaling is based on request rate, response latencies, and other application metrics. Instances are dynamically created and destroyed as needed in order to handle traffic.
↳ basic_scaling
BasicScaling
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.
↳ manual_scaling
ManualScaling
A service with manual scaling runs continuously, allowing you to perform complex initialization and rely on the state of its memory over time. Manually scaled versions are sometimes referred to as "backends".
↳ inbound_services
array
Before an application can receive email or XMPP messages, the application must be configured to enable the service.
↳ instance_class
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
↳ zones
array
The Google Compute Engine zones that are supported by this version in the App Engine flexible environment. Deprecated.
↳ resources
Resources
Machine resources for this version. Only applicable in the App Engine flexible environment.
↳ runtime
string
Desired runtime. Example: python27
.
↳ runtime_channel
string
The channel of the runtime to use. Only available for some runtimes. Defaults to the default
channel.
↳ threadsafe
bool
Whether multiple requests can be dispatched to this version at once.
↳ vm
bool
Whether to deploy this version in a container on a virtual machine.
↳ app_engine_apis
bool
Allows App Engine second generation runtimes to access the legacy bundled services.
↳ beta_settings
array| Google\Protobuf\Internal\MapField
Metadata settings that are supplied to this version to enable beta runtime features.
↳ env
string
App Engine execution environment for this version. Defaults to standard
.
↳ serving_status
int
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
.
↳ created_by
string
Email address of the user who created this version. @OutputOnly
↳ create_time
↳ disk_usage_bytes
int|string
Total size in bytes of all the files that are included in this version and currently hosted on the App Engine disk. @OutputOnly
↳ runtime_api_version
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/
↳ runtime_main_executable_path
string
The path or name of the app's main executable.
↳ service_account
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
array< 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.
↳ error_handlers
array< ErrorHandler
>
Custom static error pages. Limited to 10KB per page. Only returned in GET
requests if view=FULL
is set.
↳ libraries
array< Library
>
Configuration for third-party Python runtime libraries that are required by the application. Only returned in GET
requests if view=FULL
is set.
↳ api_config
ApiConfigHandler
Serving configuration for Google Cloud Endpoints
. Only returned in GET
requests if view=FULL
is set.
↳ env_variables
array| Google\Protobuf\Internal\MapField
Environment variables available to the application. Only returned in GET
requests if view=FULL
is set.
↳ build_env_variables
array| Google\Protobuf\Internal\MapField
Environment variables available to the build environment. Only returned in GET
requests if view=FULL
is set.
↳ default_expiration
Google\Protobuf\Duration
Duration that static files should be cached by web proxies and browsers. Only applicable if the corresponding StaticFilesHandler
does not specify its own expiration time. Only returned in GET
requests if view=FULL
is set.
↳ health_check
HealthCheck
Configures health checking for instances. Unhealthy instances are stopped and replaced with new instances. Only applicable in the App Engine flexible environment. Only returned in GET
requests if view=FULL
is set.
↳ readiness_check
ReadinessCheck
Configures readiness health checking for instances. Unhealthy instances are not put into the backend traffic rotation. Only returned in GET
requests if view=FULL
is set.
↳ liveness_check
LivenessCheck
Configures liveness health checking for instances. Unhealthy instances are stopped and replaced with new instances Only returned in GET
requests if view=FULL
is set.
↳ nobuild_files_regex
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.
↳ deployment
Deployment
Code and application artifacts that make up this version. Only returned in GET
requests if view=FULL
is set.
↳ version_url
string
Serving URL for this version. Example: " https://myversion-dot-myservice-dot-myapp.appspot.com " @OutputOnly
↳ endpoints_api_service
EndpointsApiService
Cloud Endpoints configuration. If endpoints_api_service is set, the Cloud Endpoints Extensible Service Proxy will be provided to serve the API implemented by the app.
↳ entrypoint
↳ vpc_access_connector
getName
Full path to the Version resource in the API. Example: apps/myapp/services/default/versions/v1
.
@OutputOnly
string
setName
Full path to the Version resource in the API. Example: apps/myapp/services/default/versions/v1
.
@OutputOnly
var
string
$this
getId
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-".
string
setId
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-".
var
string
$this
getAutomaticScaling
Automatic scaling is based on request rate, response latencies, and other application metrics. Instances are dynamically created and destroyed as needed in order to handle traffic.
hasAutomaticScaling
setAutomaticScaling
Automatic scaling is based on request rate, response latencies, and other application metrics. Instances are dynamically created and destroyed as needed in order to handle traffic.
$this
getBasicScaling
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.
hasBasicScaling
setBasicScaling
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.
$this
getManualScaling
A service with manual scaling runs continuously, allowing you to perform complex initialization and rely on the state of its memory over time.
Manually scaled versions are sometimes referred to as "backends".
hasManualScaling
setManualScaling
A service with manual scaling runs continuously, allowing you to perform complex initialization and rely on the state of its memory over time.
Manually scaled versions are sometimes referred to as "backends".
$this
getInboundServices
Before an application can receive email or XMPP messages, the application must be configured to enable the service.
setInboundServices
Before an application can receive email or XMPP messages, the application must be configured to enable the service.
var
int[]
$this
getInstanceClass
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 toF1
for AutomaticScaling andB1
for ManualScaling or BasicScaling.
string
setInstanceClass
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 toF1
for AutomaticScaling andB1
for ManualScaling or BasicScaling.
var
string
$this
getNetwork
Extra network settings.
Only applicable in the App Engine flexible environment.
hasNetwork
clearNetwork
setNetwork
Extra network settings.
Only applicable in the App Engine flexible environment.
$this
getZones
The Google Compute Engine zones that are supported by this version in the App Engine flexible environment. Deprecated.
setZones
The Google Compute Engine zones that are supported by this version in the App Engine flexible environment. Deprecated.
var
string[]
$this
getResources
Machine resources for this version.
Only applicable in the App Engine flexible environment.
hasResources
clearResources
setResources
Machine resources for this version.
Only applicable in the App Engine flexible environment.
$this
getRuntime
Desired runtime. Example: python27
.
string
setRuntime
Desired runtime. Example: python27
.
var
string
$this
getRuntimeChannel
The channel of the runtime to use. Only available for some
runtimes. Defaults to the default
channel.
string
setRuntimeChannel
The channel of the runtime to use. Only available for some
runtimes. Defaults to the default
channel.
var
string
$this
getThreadsafe
Whether multiple requests can be dispatched to this version at once.
bool
setThreadsafe
Whether multiple requests can be dispatched to this version at once.
var
bool
$this
getVm
Whether to deploy this version in a container on a virtual machine.
bool
setVm
Whether to deploy this version in a container on a virtual machine.
var
bool
$this
getAppEngineApis
Allows App Engine second generation runtimes to access the legacy bundled services.
bool
setAppEngineApis
Allows App Engine second generation runtimes to access the legacy bundled services.
var
bool
$this
getBetaSettings
Metadata settings that are supplied to this version to enable beta runtime features.
setBetaSettings
Metadata settings that are supplied to this version to enable beta runtime features.
$this
getEnv
App Engine execution environment for this version.
Defaults to standard
.
string
setEnv
App Engine execution environment for this version.
Defaults to standard
.
var
string
$this
getServingStatus
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
.
int
setServingStatus
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
.
var
int
$this
getCreatedBy
Email address of the user who created this version.
@OutputOnly
string
setCreatedBy
Email address of the user who created this version.
@OutputOnly
var
string
$this
getCreateTime
Time that this version was created.
@OutputOnly
hasCreateTime
clearCreateTime
setCreateTime
Time that this version was created.
@OutputOnly
$this
getDiskUsageBytes
Total size in bytes of all the files that are included in this version and currently hosted on the App Engine disk.
@OutputOnly
int|string
setDiskUsageBytes
Total size in bytes of all the files that are included in this version and currently hosted on the App Engine disk.
@OutputOnly
var
int|string
$this
getRuntimeApiVersion
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/
string
setRuntimeApiVersion
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/
var
string
$this
getRuntimeMainExecutablePath
The path or name of the app's main executable.
string
setRuntimeMainExecutablePath
The path or name of the app's main executable.
var
string
$this
getServiceAccount
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.
string
setServiceAccount
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.
var
string
$this
getHandlers
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.
setHandlers
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.
$this
getErrorHandlers
Custom static error pages. Limited to 10KB per page.
Only returned in GET
requests if view=FULL
is set.
setErrorHandlers
Custom static error pages. Limited to 10KB per page.
Only returned in GET
requests if view=FULL
is set.
$this
getLibraries
Configuration for third-party Python runtime libraries that are required by the application.
Only returned in GET
requests if view=FULL
is set.
setLibraries
Configuration for third-party Python runtime libraries that are required by the application.
Only returned in GET
requests if view=FULL
is set.
$this
getApiConfig
Serving configuration for Google Cloud Endpoints .
Only returned in GET
requests if view=FULL
is set.
hasApiConfig
clearApiConfig
setApiConfig
Serving configuration for Google Cloud Endpoints .
Only returned in GET
requests if view=FULL
is set.
$this
getEnvVariables
Environment variables available to the application.
Only returned in GET
requests if view=FULL
is set.
setEnvVariables
Environment variables available to the application.
Only returned in GET
requests if view=FULL
is set.
$this
getBuildEnvVariables
Environment variables available to the build environment.
Only returned in GET
requests if view=FULL
is set.
setBuildEnvVariables
Environment variables available to the build environment.
Only returned in GET
requests if view=FULL
is set.
$this
getDefaultExpiration
Duration that static files should be cached by web proxies and browsers.
Only applicable if the corresponding StaticFilesHandler
does not specify its own expiration time.
Only returned in GET
requests if view=FULL
is set.
hasDefaultExpiration
clearDefaultExpiration
setDefaultExpiration
Duration that static files should be cached by web proxies and browsers.
Only applicable if the corresponding StaticFilesHandler
does not specify its own expiration time.
Only returned in GET
requests if view=FULL
is set.
$this
getHealthCheck
Configures health checking for instances. Unhealthy instances are stopped and replaced with new instances.
Only applicable in the App Engine flexible environment.
Only returned in GET
requests if view=FULL
is set.
hasHealthCheck
clearHealthCheck
setHealthCheck
Configures health checking for instances. Unhealthy instances are stopped and replaced with new instances.
Only applicable in the App Engine flexible environment.
Only returned in GET
requests if view=FULL
is set.
$this
getReadinessCheck
Configures readiness health checking for instances.
Unhealthy instances are not put into the backend traffic rotation.
Only returned in GET
requests if view=FULL
is set.
hasReadinessCheck
clearReadinessCheck
setReadinessCheck
Configures readiness health checking for instances.
Unhealthy instances are not put into the backend traffic rotation.
Only returned in GET
requests if view=FULL
is set.
$this
getLivenessCheck
Configures liveness health checking for instances.
Unhealthy instances are stopped and replaced with new instances
Only returned in GET
requests if view=FULL
is set.
hasLivenessCheck
clearLivenessCheck
setLivenessCheck
Configures liveness health checking for instances.
Unhealthy instances are stopped and replaced with new instances
Only returned in GET
requests if view=FULL
is set.
$this
getNobuildFilesRegex
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.
string
setNobuildFilesRegex
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.
var
string
$this
getDeployment
Code and application artifacts that make up this version.
Only returned in GET
requests if view=FULL
is set.
hasDeployment
clearDeployment
setDeployment
Code and application artifacts that make up this version.
Only returned in GET
requests if view=FULL
is set.
$this
getVersionUrl
Serving URL for this version. Example: " https://myversion-dot-myservice-dot-myapp.appspot.com " @OutputOnly
string
setVersionUrl
Serving URL for this version. Example: " https://myversion-dot-myservice-dot-myapp.appspot.com " @OutputOnly
var
string
$this
getEndpointsApiService
Cloud Endpoints configuration.
If endpoints_api_service is set, the Cloud Endpoints Extensible Service Proxy will be provided to serve the API implemented by the app.
hasEndpointsApiService
clearEndpointsApiService
setEndpointsApiService
Cloud Endpoints configuration.
If endpoints_api_service is set, the Cloud Endpoints Extensible Service Proxy will be provided to serve the API implemented by the app.
$this
getEntrypoint
The entrypoint for the application.
hasEntrypoint
clearEntrypoint
setEntrypoint
The entrypoint for the application.
$this
getVpcAccessConnector
Enables VPC connectivity for standard apps.
hasVpcAccessConnector
clearVpcAccessConnector
setVpcAccessConnector
Enables VPC connectivity for standard apps.
$this
getScaling
string