instances

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

Overview

Name	instances
Type	Resource
Id	google.appengine.instances

Fields

Name	Datatype	Description
id	string	Output only. Relative name of the instance within the version. Example: instance-1.
name	string	Output only. Full path to the Instance resource in the API. Example: apps/myapp/services/default/versions/v1/instances/instance-1.
appEngineRelease	string	Output only. App Engine release this instance is running on.
availability	string	Output only. Availability of the instance.
averageLatency	integer	Output only. Average latency (ms) over the last minute.
errors	integer	Output only. Number of errors since this instance was started.
memoryUsage	string	Output only. Total memory in use (bytes).
qps	number	Output only. Average queries per second (QPS) over the last minute.
requests	integer	Output only. Number of requests since this instance was started.
startTime	string	Output only. Time that this instance was started.@OutputOnly
vmDebugEnabled	boolean	Output only. Whether this instance is in debug mode. Only applicable for instances in App Engine flexible environment.
vmId	string	Output only. Virtual machine ID of this instance. Only applicable for instances in App Engine flexible environment.
vmIp	string	Output only. The IP address of this instance. Only applicable for instances in App Engine flexible environment.
vmLiveness	string	Output only. The liveness health check of this instance. Only applicable for instances in App Engine flexible environment.
vmName	string	Output only. Name of the virtual machine where this instance lives. Only applicable for instances in App Engine flexible environment.
vmStatus	string	Output only. Status of the virtual machine where this instance lives. Only applicable for instances in App Engine flexible environment.
vmZoneName	string	Output only. Zone where the virtual machine is located. Only applicable for instances in App Engine flexible environment.

Methods

Name	Accessible by	Required Params	Description
get	SELECT	appsId, instancesId, servicesId, versionsId	Gets instance information.
list	SELECT	appsId, servicesId, versionsId	Lists the instances of a version.Tip: To aggregate details about instances over time, see the Stackdriver Monitoring API (https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.timeSeries/list).
delete	DELETE	appsId, instancesId, servicesId, versionsId	Stops a running instance.The instance might be automatically recreated based on the scaling settings of the version. For more information, see "How Instances are Managed" (standard environment (https://cloud.google.com/appengine/docs/standard/python/how-instances-are-managed)
debug	EXEC	appsId, instancesId, servicesId, versionsId	Enables debugging on a VM instance. This allows you to use the SSH command to connect to the virtual machine where the instance lives. While in "debug mode", the instance continues to serve live traffic. You should delete the instance when you are done debugging and then allow the system to take over and determine if another instance should be started.Only applicable for instances in App Engine flexible environment.

SELECT examples

Lists the instances of a version.Tip: To aggregate details about instances over time, see the Stackdriver Monitoring API (https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.timeSeries/list).

SELECT
id,
name,
appEngineRelease,
availability,
averageLatency,
errors,
memoryUsage,
qps,
requests,
startTime,
vmDebugEnabled,
vmId,
vmIp,
vmLiveness,
vmName,
vmStatus,
vmZoneName
FROM google.appengine.instances
WHERE appsId = '{{ appsId }}'
AND servicesId = '{{ servicesId }}'
AND versionsId = '{{ versionsId }}';

DELETE example

Deletes the specified instances resource.

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