Skip to main content

services

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

Overview

Nameservices
TypeResource
Idgoogle.appengine.services

Fields

NameDatatypeDescription
idstringOutput only. Relative name of the service within the application. Example: default.@OutputOnly
namestringOutput only. Full path to the Service resource in the API. Example: apps/myapp/services/default.@OutputOnly
generatedCustomerMetadataobjectAdditional Google Generated Customer Metadata, this field won't be provided by default and can be requested by setting the IncludeExtraData field in GetServiceRequest
labelsobjectA set of labels to apply to this service. Labels are key/value pairs that describe the service and all resources that belong to it (e.g., versions). The labels can be used to search and group resources, and are propagated to the usage and billing reports, enabling fine-grain analysis of costs. An example of using labels is to tag resources belonging to different environments (e.g., "env=prod", "env=qa"). Label keys and values can be no longer than 63 characters and can only contain lowercase letters, numeric characters, underscores, dashes, and international characters. Label keys must start with a lowercase letter or an international character. Each service can have at most 32 labels.
networkSettingsobjectA NetworkSettings resource is a container for ingress settings for a version or service.
splitobjectTraffic routing configuration for versions within a single service. Traffic splits define how traffic directed to the service is assigned to versions.

Methods

NameAccessible byRequired ParamsDescription
getSELECTappsId, servicesIdGets the current configuration of the specified service.
listSELECTappsIdLists all the services in the application.
deleteDELETEappsId, servicesIdDeletes the specified service and all enclosed versions.
patchUPDATEappsId, servicesIdUpdates the configuration of the specified service.

SELECT examples

Lists all the services in the application.

SELECT
id,
name,
generatedCustomerMetadata,
labels,
networkSettings,
split
FROM google.appengine.services
WHERE appsId = '{{ appsId }}';

UPDATE example

Updates a services resource.

/*+ update */
UPDATE google.appengine.services
SET
split = '{{ split }}',
labels = '{{ labels }}',
networkSettings = '{{ networkSettings }}',
generatedCustomerMetadata = '{{ generatedCustomerMetadata }}'
WHERE
appsId = '{{ appsId }}'
AND servicesId = '{{ servicesId }}';

DELETE example

Deletes the specified services resource.

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