on develop help sign in
Regenerating gogol-appengine from latest service definition
commit2be77a8ac5e18f2a1858894701e5fba7f76061b0 authorBrendan Hay <brendan.g.hay@gmail.com> dateTue 25 Oct 2016, 11:37 (10 years ago) parent9bd4988
29 files changed+6431−1158
gen/model/appengine/v1/appengine-api.json+2154 gen/model/appengine/v1beta4/appengine-api.json+646−297 gen/model/appengine/v1beta5/appengine-api.json+541−192 gogol-appengine/gen/Network/Google/AppEngine.hs+113−20 gogol-appengine/gen/Network/Google/AppEngine/Types.hs+70−22 gogol-appengine/gen/Network/Google/AppEngine/Types/Product.hs+886−516 gogol-appengine/gen/Network/Google/Resource/AppEngine/Apps/Get.hs+13−31 gogol-appengine/gen/Network/Google/Resource/AppEngine/Apps/Locations/Get.hs+185 gogol-appengine/gen/Network/Google/Resource/AppEngine/Apps/Locations/List.hs+210 gogol-appengine/gen/Network/Google/Resource/AppEngine/Apps/Operations/Get.hs+1−1 gogol-appengine/gen/Network/Google/Resource/AppEngine/Apps/Operations/List.hs+1−1 gogol-appengine/gen/Network/Google/Resource/AppEngine/Apps/Patch.hs+194 gogol-appengine/gen/Network/Google/Resource/AppEngine/Apps/Repair.hs+190 gogol-appengine/gen/Network/Google/Resource/AppEngine/Apps/Services/Delete.hs+5−5 gogol-appengine/gen/Network/Google/Resource/AppEngine/Apps/Services/Get.hs+5−5 gogol-appengine/gen/Network/Google/Resource/AppEngine/Apps/Services/List.hs+3−3 gogol-appengine/gen/Network/Google/Resource/AppEngine/Apps/Services/Patch.hs+33−20 gogol-appengine/gen/Network/Google/Resource/AppEngine/Apps/Services/Versions/Create.hs+6−6 gogol-appengine/gen/Network/Google/Resource/AppEngine/Apps/Services/Versions/Delete.hs+5−5 gogol-appengine/gen/Network/Google/Resource/AppEngine/Apps/Services/Versions/Get.hs+9−5 gogol-appengine/gen/Network/Google/Resource/AppEngine/Apps/Services/Versions/Instances/Debug.hs+247 gogol-appengine/gen/Network/Google/Resource/AppEngine/Apps/Services/Versions/Instances/Delete.hs+213 gogol-appengine/gen/Network/Google/Resource/AppEngine/Apps/Services/Versions/Instances/Get.hs+221 gogol-appengine/gen/Network/Google/Resource/AppEngine/Apps/Services/Versions/Instances/List.hs+5−5 gogol-appengine/gen/Network/Google/Resource/AppEngine/Apps/Services/Versions/List.hs+4−4 gogol-appengine/gen/Network/Google/Resource/AppEngine/Apps/Services/Versions/Patch.hs+47−19 gogol-appengine/gen/Network/Google/Resource/AppEngine/Experimental/Apps/Operations/Get.hs+192 gogol-appengine/gen/Network/Google/Resource/AppEngine/Experimental/Apps/Operations/List.hs+222 gogol-appengine/gogol-appengine.cabal+10−1
gen/model/appengine/v1/appengine-api.jsonnew file+2154
@@ -0,0 +1,2154 @@
1+{
2+ "kind": "discovery#restDescription",
3+ "etag": "\"C5oy1hgQsABtYOYIOXWcR3BgYqU/keDq5Gfgc8YWx53wam17Q0yFjvc\"",
4+ "discoveryVersion": "v1",
5+ "id": "appengine:v1",
6+ "name": "appengine",
7+ "version": "v1",
8+ "revision": "20161012",
9+ "title": "Google App Engine Admin API",
10+ "description": "Provisions and manages App Engine applications.",
11+ "ownerDomain": "google.com",
12+ "ownerName": "Google",
13+ "icons": {
14+ "x16": "http://www.google.com/images/icons/product/search-16.gif",
15+ "x32": "http://www.google.com/images/icons/product/search-32.gif"
16+ },
17+ "documentationLink": "https://cloud.google.com/appengine/docs/admin-api/",
18+ "protocol": "rest",
19+ "baseUrl": "https://appengine.googleapis.com/",
20+ "basePath": "",
21+ "rootUrl": "https://appengine.googleapis.com/",
22+ "servicePath": "",
23+ "batchPath": "batch",
24+ "version_module": true,
25+ "parameters": {
26+ "access_token": {
27+ "type": "string",
28+ "description": "OAuth access token.",
29+ "location": "query"
30+ },
31+ "alt": {
32+ "type": "string",
33+ "description": "Data format for response.",
34+ "default": "json",
35+ "enumDescriptions": [
36+ "Responses with Content-Type of application/json",
37+ "Media download with context-dependent Content-Type",
38+ "Responses with Content-Type of application/x-protobuf"
39+ ],
40+ "location": "query"
41+ },
42+ "bearer_token": {
43+ "type": "string",
44+ "description": "OAuth bearer token.",
45+ "location": "query"
46+ },
47+ "callback": {
48+ "type": "string",
49+ "description": "JSONP",
50+ "location": "query"
51+ },
52+ "fields": {
53+ "type": "string",
54+ "description": "Selector specifying which fields to include in a partial response.",
55+ "location": "query"
56+ },
57+ "key": {
58+ "type": "string",
59+ "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
60+ "location": "query"
61+ },
62+ "oauth_token": {
63+ "type": "string",
64+ "description": "OAuth 2.0 token for the current user.",
65+ "location": "query"
66+ },
67+ "pp": {
68+ "type": "boolean",
69+ "description": "Pretty-print response.",
70+ "default": "true",
71+ "location": "query"
72+ },
73+ "prettyPrint": {
74+ "type": "boolean",
75+ "description": "Returns response with indentations and line breaks.",
76+ "default": "true",
77+ "location": "query"
78+ },
79+ "quotaUser": {
80+ "type": "string",
81+ "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.",
82+ "location": "query"
83+ },
84+ "upload_protocol": {
85+ "type": "string",
86+ "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
87+ "location": "query"
88+ },
89+ "uploadType": {
90+ "type": "string",
91+ "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
92+ "location": "query"
93+ },
94+ "$.xgafv": {
95+ "type": "string",
96+ "description": "V1 error format.",
97+ "enumDescriptions": [
98+ "v1 error format",
99+ "v2 error format"
100+ ],
101+ "location": "query"
102+ }
103+ },
104+ "auth": {
105+ "oauth2": {
106+ "scopes": {
107+ "https://www.googleapis.com/auth/cloud-platform": {
108+ "description": "View and manage your data across Google Cloud Platform services"
109+ }
110+ }
111+ }
112+ },
113+ "schemas": {
114+ "Operation": {
115+ "id": "Operation",
116+ "type": "object",
117+ "description": "This resource represents a long-running operation that is the result of a network API call.",
118+ "properties": {
119+ "name": {
120+ "type": "string",
121+ "description": "The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`."
122+ },
123+ "metadata": {
124+ "type": "object",
125+ "description": "Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.",
126+ "additionalProperties": {
127+ "type": "any",
128+ "description": "Properties of the object. Contains field @type with type URL."
129+ }
130+ },
131+ "done": {
132+ "type": "boolean",
133+ "description": "If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available."
134+ },
135+ "error": {
136+ "$ref": "Status",
137+ "description": "The error result of the operation in case of failure."
138+ },
139+ "response": {
140+ "type": "object",
141+ "description": "The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.",
142+ "additionalProperties": {
143+ "type": "any",
144+ "description": "Properties of the object. Contains field @type with type URL."
145+ }
146+ }
147+ }
148+ },
149+ "Status": {
150+ "id": "Status",
151+ "type": "object",
152+ "description": "The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons.",
153+ "properties": {
154+ "code": {
155+ "type": "integer",
156+ "description": "The status code, which should be an enum value of google.rpc.Code.",
157+ "format": "int32"
158+ },
159+ "message": {
160+ "type": "string",
161+ "description": "A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client."
162+ },
163+ "details": {
164+ "type": "array",
165+ "description": "A list of messages that carry the error details. There will be a common set of message types for APIs to use.",
166+ "items": {
167+ "type": "object",
168+ "additionalProperties": {
169+ "type": "any",
170+ "description": "Properties of the object. Contains field @type with type URL."
171+ }
172+ }
173+ }
174+ }
175+ },
176+ "ListOperationsResponse": {
177+ "id": "ListOperationsResponse",
178+ "type": "object",
179+ "description": "The response message for Operations.ListOperations.",
180+ "properties": {
181+ "operations": {
182+ "type": "array",
183+ "description": "A list of operations that matches the specified filter in the request.",
184+ "items": {
185+ "$ref": "Operation"
186+ }
187+ },
188+ "nextPageToken": {
189+ "type": "string",
190+ "description": "The standard List next-page token."
191+ }
192+ }
193+ },
194+ "Application": {
195+ "id": "Application",
196+ "type": "object",
197+ "description": "An Application resource contains the top-level configuration of an App Engine application.",
198+ "properties": {
199+ "name": {
200+ "type": "string",
201+ "description": "Full path to the Application resource in the API. Example: `apps/myapp`. @OutputOnly"
202+ },
203+ "id": {
204+ "type": "string",
205+ "description": "Identifier of the Application resource. This identifier is equivalent to the project ID of the Google Cloud Platform project where you want to deploy your application. Example: `myapp`."
206+ },
207+ "dispatchRules": {
208+ "type": "array",
209+ "description": "HTTP path dispatch rules for requests to the application that do not explicitly target a service or version. Rules are order-dependent. @OutputOnly",
210+ "items": {
211+ "$ref": "UrlDispatchRule"
212+ }
213+ },
214+ "authDomain": {
215+ "type": "string",
216+ "description": "Google Apps authentication domain that controls which users can access this application. Defaults to open access for any Google Account."
217+ },
218+ "locationId": {
219+ "type": "string",
220+ "description": "Location from which this application will be run. Application instances will run out of data centers in the chosen location, which is also where all of the application's end user content is stored. Defaults to `us-central`. Options are: `us-central` - Central US `europe-west` - Western Europe `us-east1` - Eastern US"
221+ },
222+ "codeBucket": {
223+ "type": "string",
224+ "description": "Google Cloud Storage bucket that can be used for storing files associated with this application. This bucket is associated with the application and can be used by the gcloud deployment commands. @OutputOnly"
225+ },
226+ "defaultCookieExpiration": {
227+ "type": "string",
228+ "description": "Cookie expiration policy for this application. @OutputOnly"
229+ },
230+ "defaultHostname": {
231+ "type": "string",
232+ "description": "Hostname used to reach this application, as resolved by App Engine. @OutputOnly"
233+ },
234+ "defaultBucket": {
235+ "type": "string",
236+ "description": "Google Cloud Storage bucket that can be used by this application to store content. @OutputOnly"
237+ }
238+ }
239+ },
240+ "UrlDispatchRule": {
241+ "id": "UrlDispatchRule",
242+ "type": "object",
243+ "description": "Rules to match an HTTP request and dispatch that request to a service.",
244+ "properties": {
245+ "domain": {
246+ "type": "string",
247+ "description": "Domain name to match against. The wildcard \"`*`\" is supported if specified before a period: \"`*.`\". Defaults to matching all domains: \"`*`\"."
248+ },
249+ "path": {
250+ "type": "string",
251+ "description": "Pathname within the host. Must start with a \"`/`\". A single \"`*`\" can be included at the end of the path. The sum of the lengths of the domain and path may not exceed 100 characters."
252+ },
253+ "service": {
254+ "type": "string",
255+ "description": "Resource ID of a service in this application that should serve the matched request. The service must already exist. Example: `default`."
256+ }
257+ }
258+ },
259+ "RepairApplicationRequest": {
260+ "id": "RepairApplicationRequest",
261+ "type": "object",
262+ "description": "Request message for 'Applications.RepairApplication'."
263+ },
264+ "ListServicesResponse": {
265+ "id": "ListServicesResponse",
266+ "type": "object",
267+ "description": "Response message for `Services.ListServices`.",
268+ "properties": {
269+ "services": {
270+ "type": "array",
271+ "description": "The services belonging to the requested application.",
272+ "items": {
273+ "$ref": "Service"
274+ }
275+ },
276+ "nextPageToken": {
277+ "type": "string",
278+ "description": "Continuation token for fetching the next page of results."
279+ }
280+ }
281+ },
282+ "Service": {
283+ "id": "Service",
284+ "type": "object",
285+ "description": "A Service resource is a logical component of an application that can share state and communicate in a secure fashion with other services. For example, an application that handles customer requests might include separate services to handle tasks such as backend data analysis or API requests from mobile devices. Each service has a collection of versions that define a specific set of code used to implement the functionality of that service.",
286+ "properties": {
287+ "name": {
288+ "type": "string",
289+ "description": "Full path to the Service resource in the API. Example: `apps/myapp/services/default`. @OutputOnly"
290+ },
291+ "id": {
292+ "type": "string",
293+ "description": "Relative name of the service within the application. Example: `default`. @OutputOnly"
294+ },
295+ "split": {
296+ "$ref": "TrafficSplit",
297+ "description": "Mapping that defines fractional HTTP traffic diversion to different versions within the service."
298+ }
299+ }
300+ },
301+ "TrafficSplit": {
302+ "id": "TrafficSplit",
303+ "type": "object",
304+ "description": "Traffic routing configuration for versions within a single service. Traffic splits define how traffic directed to the service is assigned to versions.",
305+ "properties": {
306+ "shardBy": {
307+ "type": "string",
308+ "description": "Mechanism used to determine which version a request is sent to. The traffic selection algorithm will be stable for either type until allocations are changed.",
309+ "enum": [
310+ "UNSPECIFIED",
311+ "COOKIE",
312+ "IP"
313+ ]
314+ },
315+ "allocations": {
316+ "type": "object",
317+ "description": "Mapping from version IDs within the service to fractional (0.000, 1] allocations of traffic for that version. Each version can be specified only once, but some versions in the service may not have any traffic allocation. Services that have traffic allocated cannot be deleted until either the service is deleted or their traffic allocation is removed. Allocations must sum to 1. Up to two decimal place precision is supported for IP-based splits and up to three decimal places is supported for cookie-based splits.",
318+ "additionalProperties": {
319+ "type": "number",
320+ "format": "double"
321+ }
322+ }
323+ }
324+ },
325+ "ListVersionsResponse": {
326+ "id": "ListVersionsResponse",
327+ "type": "object",
328+ "description": "Response message for `Versions.ListVersions`.",
329+ "properties": {
330+ "versions": {
331+ "type": "array",
332+ "description": "The versions belonging to the requested service.",
333+ "items": {
334+ "$ref": "Version"
335+ }
336+ },
337+ "nextPageToken": {
338+ "type": "string",
339+ "description": "Continuation token for fetching the next page of results."
340+ }
341+ }
342+ },
343+ "Version": {
344+ "id": "Version",
345+ "type": "object",
346+ "description": "A Version resource is a specific set of source code and configuration files that are deployed into a service.",
347+ "properties": {
348+ "name": {
349+ "type": "string",
350+ "description": "Full path to the Version resource in the API. Example: `apps/myapp/services/default/versions/v1`. @OutputOnly"
351+ },
352+ "id": {
353+ "type": "string",
354+ "description": "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-\"."
355+ },
356+ "automaticScaling": {
357+ "$ref": "AutomaticScaling",
358+ "description": "Automatic scaling is based on request rate, response latencies, and other application metrics."
359+ },
360+ "basicScaling": {
361+ "$ref": "BasicScaling",
362+ "description": "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."
363+ },
364+ "manualScaling": {
365+ "$ref": "ManualScaling",
366+ "description": "A service with manual scaling runs continuously, allowing you to perform complex initialization and rely on the state of its memory over time."
367+ },
368+ "inboundServices": {
369+ "type": "array",
370+ "description": "Before an application can receive email or XMPP messages, the application must be configured to enable the service.",
371+ "enumDescriptions": [
372+ "Not specified.",
373+ "Allows an application to receive mail.",
374+ "Allows an application to receive email-bound notifications.",
375+ "Allows an application to receive error stanzas.",
376+ "Allows an application to receive instant messages.",
377+ "Allows an application to receive user subscription POSTs.",
378+ "Allows an application to receive a user's chat presence.",
379+ "Registers an application for notifications when a client connects or disconnects from a channel.",
380+ "Enables warmup requests."
381+ ],
382+ "items": {
383+ "type": "string",
384+ "enum": [
385+ "INBOUND_SERVICE_UNSPECIFIED",
386+ "INBOUND_SERVICE_MAIL",
387+ "INBOUND_SERVICE_MAIL_BOUNCE",
388+ "INBOUND_SERVICE_XMPP_ERROR",
389+ "INBOUND_SERVICE_XMPP_MESSAGE",
390+ "INBOUND_SERVICE_XMPP_SUBSCRIBE",
391+ "INBOUND_SERVICE_XMPP_PRESENCE",
392+ "INBOUND_SERVICE_CHANNEL_PRESENCE",
393+ "INBOUND_SERVICE_WARMUP"
394+ ]
395+ }
396+ },
397+ "instanceClass": {
398+ "type": "string",
399+ "description": "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."
400+ },
401+ "network": {
402+ "$ref": "Network",
403+ "description": "Extra network settings. Only applicable for VM runtimes."
404+ },
405+ "resources": {
406+ "$ref": "Resources",
407+ "description": "Machine resources for this version. Only applicable for VM runtimes."
408+ },
409+ "runtime": {
410+ "type": "string",
411+ "description": "Desired runtime. Example: `python27`."
412+ },
413+ "threadsafe": {
414+ "type": "boolean",
415+ "description": "Whether multiple requests can be dispatched to this version at once."
416+ },
417+ "vm": {
418+ "type": "boolean",
419+ "description": "Whether to deploy this version in a container on a virtual machine."
420+ },
421+ "betaSettings": {
422+ "type": "object",
423+ "description": "Metadata settings that are supplied to this version to enable beta runtime features.",
424+ "additionalProperties": {
425+ "type": "string"
426+ }
427+ },
428+ "env": {
429+ "type": "string",
430+ "description": "App Engine execution environment for this version. Defaults to `standard`."
431+ },
432+ "servingStatus": {
433+ "type": "string",
434+ "description": "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`.",
435+ "enum": [
436+ "SERVING_STATUS_UNSPECIFIED",
437+ "SERVING",
438+ "STOPPED"
439+ ]
440+ },
441+ "createdBy": {
442+ "type": "string",
443+ "description": "Email address of the user who created this version. @OutputOnly"
444+ },
445+ "createTime": {
446+ "type": "string",
447+ "description": "Time that this version was created. @OutputOnly"
448+ },
449+ "diskUsageBytes": {
450+ "type": "string",
451+ "description": "Total size in bytes of all the files that are included in this version and curerntly hosted on the App Engine disk. @OutputOnly",
452+ "format": "int64"
453+ },
454+ "handlers": {
455+ "type": "array",
456+ "description": "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.",
457+ "items": {
458+ "$ref": "UrlMap"
459+ }
460+ },
461+ "errorHandlers": {
462+ "type": "array",
463+ "description": "Custom static error pages. Limited to 10KB per page. Only returned in `GET` requests if `view=FULL` is set.",
464+ "items": {
465+ "$ref": "ErrorHandler"
466+ }
467+ },
468+ "libraries": {
469+ "type": "array",
470+ "description": "Configuration for third-party Python runtime libraries that are required by the application. Only returned in `GET` requests if `view=FULL` is set.",
471+ "items": {
472+ "$ref": "Library"
473+ }
474+ },
475+ "apiConfig": {
476+ "$ref": "ApiConfigHandler",
477+ "description": "Serving configuration for [Google Cloud Endpoints](https://cloud.google.com/appengine/docs/python/endpoints/). Only returned in `GET` requests if `view=FULL` is set."
478+ },
479+ "envVariables": {
480+ "type": "object",
481+ "description": "Environment variables available to the application. Only returned in `GET` requests if `view=FULL` is set.",
482+ "additionalProperties": {
483+ "type": "string"
484+ }
485+ },
486+ "defaultExpiration": {
487+ "type": "string",
488+ "description": "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."
489+ },
490+ "healthCheck": {
491+ "$ref": "HealthCheck",
492+ "description": "Configures health checking for VM instances. Unhealthy instances are stopped and replaced with new instances. Only applicable for VM runtimes. Only returned in `GET` requests if `view=FULL` is set."
493+ },
494+ "nobuildFilesRegex": {
495+ "type": "string",
496+ "description": "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."
497+ },
498+ "deployment": {
499+ "$ref": "Deployment",
500+ "description": "Code and application artifacts that make up this version. Only returned in `GET` requests if `view=FULL` is set."
501+ },
502+ "versionUrl": {
503+ "type": "string",
504+ "description": "Serving URL for this version. Example: \"https://myversion-dot-myservice-dot-myapp.appspot.com\" @OutputOnly"
505+ }
506+ }
507+ },
508+ "AutomaticScaling": {
509+ "id": "AutomaticScaling",
510+ "type": "object",
511+ "description": "Automatic scaling is based on request rate, response latencies, and other application metrics.",
512+ "properties": {
513+ "coolDownPeriod": {
514+ "type": "string",
515+ "description": "Amount of time that the [Autoscaler](https://cloud.google.com/compute/docs/autoscaler/) should wait between changes to the number of virtual machines. Only applicable for VM runtimes."
516+ },
517+ "cpuUtilization": {
518+ "$ref": "CpuUtilization",
519+ "description": "Target scaling by CPU usage."
520+ },
521+ "maxConcurrentRequests": {
522+ "type": "integer",
523+ "description": "Number of concurrent requests an automatic scaling instance can accept before the scheduler spawns a new instance. Defaults to a runtime-specific value.",
524+ "format": "int32"
525+ },
526+ "maxIdleInstances": {
527+ "type": "integer",
528+ "description": "Maximum number of idle instances that should be maintained for this version.",
529+ "format": "int32"
530+ },
531+ "maxTotalInstances": {
532+ "type": "integer",
533+ "description": "Maximum number of instances that should be started to handle requests.",
534+ "format": "int32"
535+ },
536+ "maxPendingLatency": {
537+ "type": "string",
538+ "description": "Maximum amount of time that a request should wait in the pending queue before starting a new instance to handle it."
539+ },
540+ "minIdleInstances": {
541+ "type": "integer",
542+ "description": "Minimum number of idle instances that should be maintained for this version. Only applicable for the default version of a service.",
543+ "format": "int32"
544+ },
545+ "minTotalInstances": {
546+ "type": "integer",
547+ "description": "Minimum number of instances that should be maintained for this version.",
548+ "format": "int32"
549+ },
550+ "minPendingLatency": {
551+ "type": "string",
552+ "description": "Minimum amount of time a request should wait in the pending queue before starting a new instance to handle it."
553+ },
554+ "requestUtilization": {
555+ "$ref": "RequestUtilization",
556+ "description": "Target scaling by request utilization."
557+ },
558+ "diskUtilization": {
559+ "$ref": "DiskUtilization",
560+ "description": "Target scaling by disk usage."
561+ },
562+ "networkUtilization": {
563+ "$ref": "NetworkUtilization",
564+ "description": "Target scaling by network usage."
565+ }
566+ }
567+ },
568+ "CpuUtilization": {
569+ "id": "CpuUtilization",
570+ "type": "object",
571+ "description": "Target scaling by CPU usage.",
572+ "properties": {
573+ "aggregationWindowLength": {
574+ "type": "string",
575+ "description": "Period of time over which CPU utilization is calculated."
576+ },
577+ "targetUtilization": {
578+ "type": "number",
579+ "description": "Target CPU utilization ratio to maintain when scaling. Must be between 0 and 1.",
580+ "format": "double"
581+ }
582+ }
583+ },
584+ "RequestUtilization": {
585+ "id": "RequestUtilization",
586+ "type": "object",
587+ "description": "Target scaling by request utilization. Only applicable for VM runtimes.",
588+ "properties": {
589+ "targetRequestCountPerSecond": {
590+ "type": "integer",
591+ "description": "Target requests per second.",
592+ "format": "int32"
593+ },
594+ "targetConcurrentRequests": {
595+ "type": "integer",
596+ "description": "Target number of concurrent requests.",
597+ "format": "int32"
598+ }
599+ }
600+ },
601+ "DiskUtilization": {
602+ "id": "DiskUtilization",
603+ "type": "object",
604+ "description": "Target scaling by disk usage. Only applicable for VM runtimes.",
605+ "properties": {
606+ "targetWriteBytesPerSecond": {
607+ "type": "integer",
608+ "description": "Target bytes written per second.",
609+ "format": "int32"
610+ },
611+ "targetWriteOpsPerSecond": {
612+ "type": "integer",
613+ "description": "Target ops written per second.",
614+ "format": "int32"
615+ },
616+ "targetReadBytesPerSecond": {
617+ "type": "integer",
618+ "description": "Target bytes read per second.",
619+ "format": "int32"
620+ },
621+ "targetReadOpsPerSecond": {
622+ "type": "integer",
623+ "description": "Target ops read per seconds.",
624+ "format": "int32"
625+ }
626+ }
627+ },
628+ "NetworkUtilization": {
629+ "id": "NetworkUtilization",
630+ "type": "object",
631+ "description": "Target scaling by network usage. Only applicable for VM runtimes.",
632+ "properties": {
633+ "targetSentBytesPerSecond": {
634+ "type": "integer",
635+ "description": "Target bytes sent per second.",
636+ "format": "int32"
637+ },
638+ "targetSentPacketsPerSecond": {
639+ "type": "integer",
640+ "description": "Target packets sent per second.",
641+ "format": "int32"
642+ },
643+ "targetReceivedBytesPerSecond": {
644+ "type": "integer",
645+ "description": "Target bytes received per second.",
646+ "format": "int32"
647+ },
648+ "targetReceivedPacketsPerSecond": {
649+ "type": "integer",
650+ "description": "Target packets received per second.",
651+ "format": "int32"
652+ }
653+ }
654+ },
655+ "BasicScaling": {
656+ "id": "BasicScaling",
657+ "type": "object",
658+ "description": "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.",
659+ "properties": {
660+ "idleTimeout": {
661+ "type": "string",
662+ "description": "Duration of time after the last request that an instance must wait before the instance is shut down."
663+ },
664+ "maxInstances": {
665+ "type": "integer",
666+ "description": "Maximum number of instances to create for this version.",
667+ "format": "int32"
668+ }
669+ }
670+ },
671+ "ManualScaling": {
672+ "id": "ManualScaling",
673+ "type": "object",
674+ "description": "A service with manual scaling runs continuously, allowing you to perform complex initialization and rely on the state of its memory over time.",
675+ "properties": {
676+ "instances": {
677+ "type": "integer",
678+ "description": "Number of instances to assign to the service at the start. This number can later be altered by using the [Modules API](https://cloud.google.com/appengine/docs/python/modules/functions) `set_num_instances()` function.",
679+ "format": "int32"
680+ }
681+ }
682+ },
683+ "Network": {
684+ "id": "Network",
685+ "type": "object",
686+ "description": "Extra network settings. Only applicable for VM runtimes.",
687+ "properties": {
688+ "forwardedPorts": {
689+ "type": "array",
690+ "description": "List of ports, or port pairs, to forward from the virtual machine to the application container.",
691+ "items": {
692+ "type": "string"
693+ }
694+ },
695+ "instanceTag": {
696+ "type": "string",
697+ "description": "Tag to apply to the VM instance during creation."
698+ },
699+ "name": {
700+ "type": "string",
701+ "description": "Google Cloud Platform network where the virtual machines are created. Specify the short name, not the resource path. Defaults to `default`."
702+ }
703+ }
704+ },
705+ "Resources": {
706+ "id": "Resources",
707+ "type": "object",
708+ "description": "Machine resources for a version.",
709+ "properties": {
710+ "cpu": {
711+ "type": "number",
712+ "description": "Number of CPU cores needed.",
713+ "format": "double"
714+ },
715+ "diskGb": {
716+ "type": "number",
717+ "description": "Disk size (GB) needed.",
718+ "format": "double"
719+ },
720+ "memoryGb": {
721+ "type": "number",
722+ "description": "Memory (GB) needed.",
723+ "format": "double"
724+ }
725+ }
726+ },
727+ "UrlMap": {
728+ "id": "UrlMap",
729+ "type": "object",
730+ "description": "URL pattern and description of how the URL should be handled. App Engine can handle URLs by executing application code or by serving static files uploaded with the version, such as images, CSS, or JavaScript.",
731+ "properties": {
732+ "urlRegex": {
733+ "type": "string",
734+ "description": "URL prefix. Uses regular expression syntax, which means regexp special characters must be escaped, but should not contain groupings. All URLs that begin with this prefix are handled by this handler, using the portion of the URL after the prefix as part of the file path."
735+ },
736+ "staticFiles": {
737+ "$ref": "StaticFilesHandler",
738+ "description": "Returns the contents of a file, such as an image, as the response."
739+ },
740+ "script": {
741+ "$ref": "ScriptHandler",
742+ "description": "Executes a script to handle the request that matches this URL pattern."
743+ },
744+ "apiEndpoint": {
745+ "$ref": "ApiEndpointHandler",
746+ "description": "Uses API Endpoints to handle requests."
747+ },
748+ "securityLevel": {
749+ "type": "string",
750+ "description": "Security (HTTPS) enforcement for this URL.",
751+ "enum": [
752+ "SECURE_UNSPECIFIED",
753+ "SECURE_DEFAULT",
754+ "SECURE_NEVER",
755+ "SECURE_OPTIONAL",
756+ "SECURE_ALWAYS"
757+ ]
758+ },
759+ "login": {
760+ "type": "string",
761+ "description": "Level of login required to access this resource.",
762+ "enum": [
763+ "LOGIN_UNSPECIFIED",
764+ "LOGIN_OPTIONAL",
765+ "LOGIN_ADMIN",
766+ "LOGIN_REQUIRED"
767+ ]
768+ },
769+ "authFailAction": {
770+ "type": "string",
771+ "description": "Action to take when users access resources that require authentication. Defaults to `redirect`.",
772+ "enum": [
773+ "AUTH_FAIL_ACTION_UNSPECIFIED",
774+ "AUTH_FAIL_ACTION_REDIRECT",
775+ "AUTH_FAIL_ACTION_UNAUTHORIZED"
776+ ]
777+ },
778+ "redirectHttpResponseCode": {
779+ "type": "string",
780+ "description": "`30x` code to use when performing redirects for the `secure` field. Defaults to `302`.",
781+ "enum": [
782+ "REDIRECT_HTTP_RESPONSE_CODE_UNSPECIFIED",
783+ "REDIRECT_HTTP_RESPONSE_CODE_301",
784+ "REDIRECT_HTTP_RESPONSE_CODE_302",
785+ "REDIRECT_HTTP_RESPONSE_CODE_303",
786+ "REDIRECT_HTTP_RESPONSE_CODE_307"
787+ ]
788+ }
789+ }
790+ },
791+ "StaticFilesHandler": {
792+ "id": "StaticFilesHandler",
793+ "type": "object",
794+ "description": "Files served directly to the user for a given URL, such as images, CSS stylesheets, or JavaScript source files. Static file handlers describe which files in the application directory are static files, and which URLs serve them.",
795+ "properties": {
796+ "path": {
797+ "type": "string",
798+ "description": "Path to the static files matched by the URL pattern, from the application root directory. The path can refer to text matched in groupings in the URL pattern."
799+ },
800+ "uploadPathRegex": {
801+ "type": "string",
802+ "description": "Regular expression that matches the file paths for all files that should be referenced by this handler."
803+ },
804+ "httpHeaders": {
805+ "type": "object",
806+ "description": "HTTP headers to use for all responses from these URLs.",
807+ "additionalProperties": {
808+ "type": "string"
809+ }
810+ },
811+ "mimeType": {
812+ "type": "string",
813+ "description": "MIME type used to serve all files served by this handler. Defaults to file-specific MIME types, which are derived from each file's filename extension."
814+ },
815+ "expiration": {
816+ "type": "string",
817+ "description": "Time a static file served by this handler should be cached by web proxies and browsers."
818+ },
819+ "requireMatchingFile": {
820+ "type": "boolean",
821+ "description": "Whether this handler should match the request if the file referenced by the handler does not exist."
822+ },
823+ "applicationReadable": {
824+ "type": "boolean",
825+ "description": "Whether files should also be uploaded as code data. By default, files declared in static file handlers are uploaded as static data and are only served to end users; they cannot be read by the application. If enabled, uploads are charged against both your code and static data storage resource quotas."
826+ }
827+ }
828+ },
829+ "ScriptHandler": {
830+ "id": "ScriptHandler",
831+ "type": "object",
832+ "description": "Executes a script to handle the request that matches the URL pattern.",
833+ "properties": {
834+ "scriptPath": {
835+ "type": "string",
836+ "description": "Path to the script from the application root directory."
837+ }
838+ }
839+ },
840+ "ApiEndpointHandler": {
841+ "id": "ApiEndpointHandler",
842+ "type": "object",
843+ "description": "Uses Google Cloud Endpoints to handle requests.",
844+ "properties": {
845+ "scriptPath": {
846+ "type": "string",
847+ "description": "Path to the script from the application root directory."
848+ }
849+ }
850+ },
851+ "ErrorHandler": {
852+ "id": "ErrorHandler",
853+ "type": "object",
854+ "description": "Custom static error page to be served when an error occurs.",
855+ "properties": {
856+ "errorCode": {
857+ "type": "string",
858+ "description": "Error condition this handler applies to.",
859+ "enum": [
860+ "ERROR_CODE_UNSPECIFIED",
861+ "ERROR_CODE_DEFAULT",
862+ "ERROR_CODE_OVER_QUOTA",
863+ "ERROR_CODE_DOS_API_DENIAL",
864+ "ERROR_CODE_TIMEOUT"
865+ ]
866+ },
867+ "staticFile": {
868+ "type": "string",
869+ "description": "Static file content to be served for this error."
870+ },
871+ "mimeType": {
872+ "type": "string",
873+ "description": "MIME type of file. Defaults to `text/html`."
874+ }
875+ }
876+ },
877+ "Library": {
878+ "id": "Library",
879+ "type": "object",
880+ "description": "Third-party Python runtime library that is required by the application.",
881+ "properties": {
882+ "name": {
883+ "type": "string",
884+ "description": "Name of the library. Example: \"django\"."
885+ },
886+ "version": {
887+ "type": "string",
888+ "description": "Version of the library to select, or \"latest\"."
889+ }
890+ }
891+ },
892+ "ApiConfigHandler": {
893+ "id": "ApiConfigHandler",
894+ "type": "object",
895+ "description": "[Google Cloud Endpoints](https://cloud.google.com/appengine/docs/python/endpoints/) configuration for API handlers.",
896+ "properties": {
897+ "authFailAction": {
898+ "type": "string",
899+ "description": "Action to take when users access resources that require authentication. Defaults to `redirect`.",
900+ "enum": [
901+ "AUTH_FAIL_ACTION_UNSPECIFIED",
902+ "AUTH_FAIL_ACTION_REDIRECT",
903+ "AUTH_FAIL_ACTION_UNAUTHORIZED"
904+ ]
905+ },
906+ "login": {
907+ "type": "string",
908+ "description": "Level of login required to access this resource. Defaults to `optional`.",
909+ "enum": [
910+ "LOGIN_UNSPECIFIED",
911+ "LOGIN_OPTIONAL",
912+ "LOGIN_ADMIN",
913+ "LOGIN_REQUIRED"
914+ ]
915+ },
916+ "script": {
917+ "type": "string",
918+ "description": "Path to the script from the application root directory."
919+ },
920+ "securityLevel": {
921+ "type": "string",
922+ "description": "Security (HTTPS) enforcement for this URL.",
923+ "enum": [
924+ "SECURE_UNSPECIFIED",
925+ "SECURE_DEFAULT",
926+ "SECURE_NEVER",
927+ "SECURE_OPTIONAL",
928+ "SECURE_ALWAYS"
929+ ]
930+ },
931+ "url": {
932+ "type": "string",
933+ "description": "URL to serve the endpoint at."
934+ }
935+ }
936+ },
937+ "HealthCheck": {
938+ "id": "HealthCheck",
939+ "type": "object",
940+ "description": "Health checking configuration for VM instances. Unhealthy instances are killed and replaced with new instances. Only applicable for instances in App Engine flexible environment.",
941+ "properties": {
942+ "disableHealthCheck": {
943+ "type": "boolean",
944+ "description": "Whether to explicitly disable health checks for this instance."
945+ },
946+ "host": {
947+ "type": "string",
948+ "description": "Host header to send when performing an HTTP health check. Example: \"myapp.appspot.com\""
949+ },
950+ "healthyThreshold": {
951+ "type": "integer",
952+ "description": "Number of consecutive successful health checks required before receiving traffic.",
953+ "format": "uint32"
954+ },
955+ "unhealthyThreshold": {
956+ "type": "integer",
957+ "description": "Number of consecutive failed health checks required before removing traffic.",
958+ "format": "uint32"
959+ },
960+ "restartThreshold": {
961+ "type": "integer",
962+ "description": "Number of consecutive failed health checks required before an instance is restarted.",
963+ "format": "uint32"
964+ },
965+ "checkInterval": {
966+ "type": "string",
967+ "description": "Interval between health checks."
968+ },
969+ "timeout": {
970+ "type": "string",
971+ "description": "Time before the health check is considered failed."
972+ }
973+ }
974+ },
975+ "Deployment": {
976+ "id": "Deployment",
977+ "type": "object",
978+ "description": "Code and application artifacts used to deploy a version to App Engine.",
979+ "properties": {
980+ "files": {
981+ "type": "object",
982+ "description": "Manifest of the files stored in Google Cloud Storage that are included as part of this version. All files must be readable using the credentials supplied with this call.",
983+ "additionalProperties": {
984+ "$ref": "FileInfo"
985+ }
986+ },
987+ "container": {
988+ "$ref": "ContainerInfo",
989+ "description": "A Docker image that App Engine uses to run the version. Only applicable for instances in App Engine flexible environment."
990+ },
991+ "zip": {
992+ "$ref": "ZipInfo",
993+ "description": "The zip file for this deployment, if this is a zip deployment."
994+ }
995+ }
996+ },
997+ "FileInfo": {
998+ "id": "FileInfo",
999+ "type": "object",
1000+ "description": "Single source file that is part of the version to be deployed. Each source file that is deployed must be specified separately.",
1001+ "properties": {
1002+ "sourceUrl": {
1003+ "type": "string",
1004+ "description": "URL source to use to fetch this file. Must be a URL to a resource in Google Cloud Storage in the form 'http(s)://storage.googleapis.com/\\/\\'."
1005+ },
1006+ "sha1Sum": {
1007+ "type": "string",
1008+ "description": "The SHA1 hash of the file, in hex."
1009+ },
1010+ "mimeType": {
1011+ "type": "string",
1012+ "description": "The MIME type of the file. Defaults to the value from Google Cloud Storage."
1013+ }
1014+ }
1015+ },
1016+ "ContainerInfo": {
1017+ "id": "ContainerInfo",
1018+ "type": "object",
1019+ "description": "Docker image that is used to start a VM container for the version you deploy.",
1020+ "properties": {
1021+ "image": {
1022+ "type": "string",
1023+ "description": "URI to the hosted container image in a Docker repository. The URI must be fully qualified and include a tag or digest. Examples: \"gcr.io/my-project/image:tag\" or \"gcr.io/my-project/image@digest\""
1024+ }
1025+ }
1026+ },
1027+ "ZipInfo": {
1028+ "id": "ZipInfo",
1029+ "type": "object",
1030+ "description": "The zip file information for a zip deployment.",
1031+ "properties": {
1032+ "sourceUrl": {
1033+ "type": "string",
1034+ "description": "URL of the zip file to deploy from. Must be a URL to a resource in Google Cloud Storage in the form 'http(s)://storage.googleapis.com/\\/\\'."
1035+ },
1036+ "filesCount": {
1037+ "type": "integer",
1038+ "description": "An estimate of the number of files in a zip for a zip deployment. If set, must be greater than or equal to the actual number of files. Used for optimizing performance; if not provided, deployment may be slow.",
1039+ "format": "int32"
1040+ }
1041+ }
1042+ },
1043+ "ListInstancesResponse": {
1044+ "id": "ListInstancesResponse",
1045+ "type": "object",
1046+ "description": "Response message for `Instances.ListInstances`.",
1047+ "properties": {
1048+ "instances": {
1049+ "type": "array",
1050+ "description": "The instances belonging to the requested version.",
1051+ "items": {
1052+ "$ref": "Instance"
1053+ }
1054+ },
1055+ "nextPageToken": {
1056+ "type": "string",
1057+ "description": "Continuation token for fetching the next page of results."
1058+ }
1059+ }
1060+ },
1061+ "Instance": {
1062+ "id": "Instance",
1063+ "type": "object",
1064+ "description": "An Instance resource is the computing unit that App Engine uses to automatically scale an application.",
1065+ "properties": {
1066+ "name": {
1067+ "type": "string",
1068+ "description": "Full path to the Instance resource in the API. Example: `apps/myapp/services/default/versions/v1/instances/instance-1`. @OutputOnly"
1069+ },
1070+ "id": {
1071+ "type": "string",
1072+ "description": "Relative name of the instance within the version. Example: `instance-1`. @OutputOnly"
1073+ },
1074+ "appEngineRelease": {
1075+ "type": "string",
1076+ "description": "App Engine release this instance is running on. @OutputOnly"
1077+ },
1078+ "availability": {
1079+ "type": "string",
1080+ "description": "Availability of the instance. @OutputOnly",
1081+ "enum": [
1082+ "UNSPECIFIED",
1083+ "RESIDENT",
1084+ "DYNAMIC"
1085+ ]
1086+ },
1087+ "vmName": {
1088+ "type": "string",
1089+ "description": "Name of the virtual machine where this instance lives. Only applicable for instances in App Engine flexible environment. @OutputOnly"
1090+ },
1091+ "vmZoneName": {
1092+ "type": "string",
1093+ "description": "Zone where the virtual machine is located. Only applicable for instances in App Engine flexible environment. @OutputOnly"
1094+ },
1095+ "vmId": {
1096+ "type": "string",
1097+ "description": "Virtual machine ID of this instance. Only applicable for instances in App Engine flexible environment. @OutputOnly"
1098+ },
1099+ "startTime": {
1100+ "type": "string",
1101+ "description": "Time that this instance was started. @OutputOnly"
1102+ },
1103+ "requests": {
1104+ "type": "integer",
1105+ "description": "Number of requests since this instance was started. @OutputOnly",
1106+ "format": "int32"
1107+ },
1108+ "errors": {
1109+ "type": "integer",
1110+ "description": "Number of errors since this instance was started. @OutputOnly",
1111+ "format": "int32"
1112+ },
1113+ "qps": {
1114+ "type": "number",
1115+ "description": "Average queries per second (QPS) over the last minute. @OutputOnly",
1116+ "format": "float"
1117+ },
1118+ "averageLatency": {
1119+ "type": "integer",
1120+ "description": "Average latency (ms) over the last minute. @OutputOnly",
1121+ "format": "int32"
1122+ },
1123+ "memoryUsage": {
1124+ "type": "string",
1125+ "description": "Total memory in use (bytes). @OutputOnly",
1126+ "format": "int64"
1127+ },
1128+ "vmStatus": {
1129+ "type": "string",
1130+ "description": "Status of the virtual machine where this instance lives. Only applicable for instances in App Engine flexible environment. @OutputOnly"
1131+ },
1132+ "vmDebugEnabled": {
1133+ "type": "boolean",
1134+ "description": "Whether this instance is in debug mode. Only applicable for instances in App Engine flexible environment. @OutputOnly"
1135+ }
1136+ }
1137+ },
1138+ "DebugInstanceRequest": {
1139+ "id": "DebugInstanceRequest",
1140+ "type": "object",
1141+ "description": "Request message for `Instances.DebugInstance`."
1142+ },
1143+ "ListLocationsResponse": {
1144+ "id": "ListLocationsResponse",
1145+ "type": "object",
1146+ "description": "The response message for LocationService.ListLocations.",
1147+ "properties": {
1148+ "locations": {
1149+ "type": "array",
1150+ "description": "A list of locations that matches the specified filter in the request.",
1151+ "items": {
1152+ "$ref": "Location"
1153+ }
1154+ },
1155+ "nextPageToken": {
1156+ "type": "string",
1157+ "description": "The standard List next-page token."
1158+ }
1159+ }
1160+ },
1161+ "Location": {
1162+ "id": "Location",
1163+ "type": "object",
1164+ "description": "A resource that represents Google Cloud Platform location.",
1165+ "properties": {
1166+ "name": {
1167+ "type": "string",
1168+ "description": "Resource name for the location, which may vary between implementations. For example: `\"projects/example-project/locations/us-east1\"`"
1169+ },
1170+ "locationId": {
1171+ "type": "string",
1172+ "description": "The canonical id for this location. For example: `\"us-east1\"`."
1173+ },
1174+ "labels": {
1175+ "type": "object",
1176+ "description": "Cross-service attributes for the location. For example {\"cloud.googleapis.com/region\": \"us-east1\"}",
1177+ "additionalProperties": {
1178+ "type": "string"
1179+ }
1180+ },
1181+ "metadata": {
1182+ "type": "object",
1183+ "description": "Service-specific metadata. For example the available capacity at the given location.",
1184+ "additionalProperties": {
1185+ "type": "any",
1186+ "description": "Properties of the object. Contains field @type with type URL."
1187+ }
1188+ }
1189+ }
1190+ },
1191+ "OperationMetadata": {
1192+ "id": "OperationMetadata",
1193+ "type": "object",
1194+ "description": "Metadata for the given google.longrunning.Operation.",
1195+ "properties": {
1196+ "operationType": {
1197+ "type": "string",
1198+ "description": "Type of this operation. Deprecated, use method field instead. Example: \"create_version\". @OutputOnly"
1199+ },
1200+ "insertTime": {
1201+ "type": "string",
1202+ "description": "Timestamp that this operation was created. @OutputOnly"
1203+ },
1204+ "endTime": {
1205+ "type": "string",
1206+ "description": "Timestamp that this operation completed. @OutputOnly"
1207+ },
1208+ "user": {
1209+ "type": "string",
1210+ "description": "User who requested this operation. @OutputOnly"
1211+ },
1212+ "target": {
1213+ "type": "string",
1214+ "description": "Name of the resource that this operation is acting on. Example: `apps/myapp/modules/default`. @OutputOnly"
1215+ },
1216+ "method": {
1217+ "type": "string",
1218+ "description": "API method that initiated this operation. Example: `google.appengine.v1beta4.Version.CreateVersion`. @OutputOnly"
1219+ }
1220+ }
1221+ },
1222+ "OperationMetadataV1Beta5": {
1223+ "id": "OperationMetadataV1Beta5",
1224+ "type": "object",
1225+ "description": "Metadata for the given google.longrunning.Operation.",
1226+ "properties": {
1227+ "method": {
1228+ "type": "string",
1229+ "description": "API method name that initiated this operation. Example: `google.appengine.v1beta5.Version.CreateVersion`. @OutputOnly"
1230+ },
1231+ "insertTime": {
1232+ "type": "string",
1233+ "description": "Timestamp that this operation was created. @OutputOnly"
1234+ },
1235+ "endTime": {
1236+ "type": "string",
1237+ "description": "Timestamp that this operation completed. @OutputOnly"
1238+ },
1239+ "user": {
1240+ "type": "string",
1241+ "description": "User who requested this operation. @OutputOnly"
1242+ },
1243+ "target": {
1244+ "type": "string",
1245+ "description": "Name of the resource that this operation is acting on. Example: `apps/myapp/services/default`. @OutputOnly"
1246+ }
1247+ }
1248+ },
1249+ "OperationMetadataV1": {
1250+ "id": "OperationMetadataV1",
1251+ "type": "object",
1252+ "description": "Metadata for the given google.longrunning.Operation.",
1253+ "properties": {
1254+ "method": {
1255+ "type": "string",
1256+ "description": "API method that initiated this operation. Example: `google.appengine.v1.Versions.CreateVersion`. @OutputOnly"
1257+ },
1258+ "insertTime": {
1259+ "type": "string",
1260+ "description": "Time that this operation was created. @OutputOnly"
1261+ },
1262+ "endTime": {
1263+ "type": "string",
1264+ "description": "Time that this operation completed. @OutputOnly"
1265+ },
1266+ "user": {
1267+ "type": "string",
1268+ "description": "User who requested this operation. @OutputOnly"
1269+ },
1270+ "target": {
1271+ "type": "string",
1272+ "description": "Name of the resource that this operation is acting on. Example: `apps/myapp/services/default`. @OutputOnly"
1273+ }
1274+ }
1275+ },
1276+ "LocationMetadata": {
1277+ "id": "LocationMetadata",
1278+ "type": "object",
1279+ "description": "Metadata for the given google.cloud.location.Location.",
1280+ "properties": {
1281+ "standardEnvironmentAvailable": {
1282+ "type": "boolean",
1283+ "description": "App Engine Standard Environment is available in the given location. @OutputOnly"
1284+ },
1285+ "flexibleEnvironmentAvailable": {
1286+ "type": "boolean",
1287+ "description": "App Engine Flexible Environment is available in the given location. @OutputOnly"
1288+ }
1289+ }
1290+ }
1291+ },
1292+ "resources": {
1293+ "experimental": {
1294+ "resources": {
1295+ "apps": {
1296+ "resources": {
1297+ "operations": {
1298+ "methods": {
1299+ "get": {
1300+ "id": "appengine.experimental.apps.operations.get",
1301+ "path": "experimental/apps/{appsId}/operations/{operationsId}",
1302+ "httpMethod": "GET",
1303+ "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.",
1304+ "parameters": {
1305+ "appsId": {
1306+ "type": "string",
1307+ "description": "Part of `name`. The name of the operation resource.",
1308+ "required": true,
1309+ "location": "path"
1310+ },
1311+ "operationsId": {
1312+ "type": "string",
1313+ "description": "Part of `name`. See documentation of `appsId`.",
1314+ "required": true,
1315+ "location": "path"
1316+ }
1317+ },
1318+ "parameterOrder": [
1319+ "appsId",
1320+ "operationsId"
1321+ ],
1322+ "response": {
1323+ "$ref": "Operation"
1324+ },
1325+ "scopes": [
1326+ "https://www.googleapis.com/auth/cloud-platform"
1327+ ]
1328+ },
1329+ "list": {
1330+ "id": "appengine.experimental.apps.operations.list",
1331+ "path": "experimental/apps/{appsId}/operations",
1332+ "httpMethod": "GET",
1333+ "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name` binding below allows API services to override the binding to use different resource name schemes, such as `users/*/operations`.",
1334+ "parameters": {
1335+ "appsId": {
1336+ "type": "string",
1337+ "description": "Part of `name`. The name of the operation collection.",
1338+ "required": true,
1339+ "location": "path"
1340+ },
1341+ "filter": {
1342+ "type": "string",
1343+ "description": "The standard list filter.",
1344+ "location": "query"
1345+ },
1346+ "pageSize": {
1347+ "type": "integer",
1348+ "description": "The standard list page size.",
1349+ "format": "int32",
1350+ "location": "query"
1351+ },
1352+ "pageToken": {
1353+ "type": "string",
1354+ "description": "The standard list page token.",
1355+ "location": "query"
1356+ }
1357+ },
1358+ "parameterOrder": [
1359+ "appsId"
1360+ ],
1361+ "response": {
1362+ "$ref": "ListOperationsResponse"
1363+ },
1364+ "scopes": [
1365+ "https://www.googleapis.com/auth/cloud-platform"
1366+ ]
1367+ }
1368+ }
1369+ }
1370+ }
1371+ }
1372+ }
1373+ },
1374+ "apps": {
1375+ "methods": {
1376+ "get": {
1377+ "id": "appengine.apps.get",
1378+ "path": "v1/apps/{appsId}",
1379+ "httpMethod": "GET",
1380+ "description": "Gets information about an application.",
1381+ "parameters": {
1382+ "appsId": {
1383+ "type": "string",
1384+ "description": "Part of `name`. Name of the Application resource to get. Example: `apps/myapp`.",
1385+ "required": true,
1386+ "location": "path"
1387+ }
1388+ },
1389+ "parameterOrder": [
1390+ "appsId"
1391+ ],
1392+ "response": {
1393+ "$ref": "Application"
1394+ },
1395+ "scopes": [
1396+ "https://www.googleapis.com/auth/cloud-platform"
1397+ ]
1398+ },
1399+ "patch": {
1400+ "id": "appengine.apps.patch",
1401+ "path": "v1/apps/{appsId}",
1402+ "httpMethod": "PATCH",
1403+ "description": "Updates application parameters.",
1404+ "parameters": {
1405+ "appsId": {
1406+ "type": "string",
1407+ "description": "Part of `name`. Name of the application to update. Example: `apps/myapp`.",
1408+ "required": true,
1409+ "location": "path"
1410+ },
1411+ "updateMask": {
1412+ "type": "string",
1413+ "description": "Standard field mask for the set of fields to be updated.",
1414+ "location": "query"
1415+ }
1416+ },
1417+ "parameterOrder": [
1418+ "appsId"
1419+ ],
1420+ "request": {
1421+ "$ref": "Application"
1422+ },
1423+ "response": {
1424+ "$ref": "Operation"
1425+ },
1426+ "scopes": [
1427+ "https://www.googleapis.com/auth/cloud-platform"
1428+ ]
1429+ },
1430+ "repair": {
1431+ "id": "appengine.apps.repair",
1432+ "path": "v1/apps/{appsId}:repair",
1433+ "httpMethod": "POST",
1434+ "description": "Recreates the required App Engine features for the application in your project, for example a Cloud Storage bucket or App Engine service account. Use this method if you receive an error message about a missing feature, for example \"*Error retrieving the App Engine service account*\".",
1435+ "parameters": {
1436+ "appsId": {
1437+ "type": "string",
1438+ "description": "Part of `name`. Name of the application to repair. Example: `apps/myapp`",
1439+ "required": true,
1440+ "location": "path"
1441+ }
1442+ },
1443+ "parameterOrder": [
1444+ "appsId"
1445+ ],
1446+ "request": {
1447+ "$ref": "RepairApplicationRequest"
1448+ },
1449+ "response": {
1450+ "$ref": "Operation"
1451+ },
1452+ "scopes": [
1453+ "https://www.googleapis.com/auth/cloud-platform"
1454+ ]
1455+ }
1456+ },
1457+ "resources": {
1458+ "operations": {
1459+ "methods": {
1460+ "get": {
1461+ "id": "appengine.apps.operations.get",
1462+ "path": "v1/apps/{appsId}/operations/{operationsId}",
1463+ "httpMethod": "GET",
1464+ "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.",
1465+ "parameters": {
1466+ "appsId": {
1467+ "type": "string",
1468+ "description": "Part of `name`. The name of the operation resource.",
1469+ "required": true,
1470+ "location": "path"
1471+ },
1472+ "operationsId": {
1473+ "type": "string",
1474+ "description": "Part of `name`. See documentation of `appsId`.",
1475+ "required": true,
1476+ "location": "path"
1477+ }
1478+ },
1479+ "parameterOrder": [
1480+ "appsId",
1481+ "operationsId"
1482+ ],
1483+ "response": {
1484+ "$ref": "Operation"
1485+ },
1486+ "scopes": [
1487+ "https://www.googleapis.com/auth/cloud-platform"
1488+ ]
1489+ },
1490+ "list": {
1491+ "id": "appengine.apps.operations.list",
1492+ "path": "v1/apps/{appsId}/operations",
1493+ "httpMethod": "GET",
1494+ "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name` binding below allows API services to override the binding to use different resource name schemes, such as `users/*/operations`.",
1495+ "parameters": {
1496+ "appsId": {
1497+ "type": "string",
1498+ "description": "Part of `name`. The name of the operation collection.",
1499+ "required": true,
1500+ "location": "path"
1501+ },
1502+ "filter": {
1503+ "type": "string",
1504+ "description": "The standard list filter.",
1505+ "location": "query"
1506+ },
1507+ "pageSize": {
1508+ "type": "integer",
1509+ "description": "The standard list page size.",
1510+ "format": "int32",
1511+ "location": "query"
1512+ },
1513+ "pageToken": {
1514+ "type": "string",
1515+ "description": "The standard list page token.",
1516+ "location": "query"
1517+ }
1518+ },
1519+ "parameterOrder": [
1520+ "appsId"
1521+ ],
1522+ "response": {
1523+ "$ref": "ListOperationsResponse"
1524+ },
1525+ "scopes": [
1526+ "https://www.googleapis.com/auth/cloud-platform"
1527+ ]
1528+ }
1529+ }
1530+ },
1531+ "services": {
1532+ "methods": {
1533+ "list": {
1534+ "id": "appengine.apps.services.list",
1535+ "path": "v1/apps/{appsId}/services",
1536+ "httpMethod": "GET",
1537+ "description": "Lists all the services in the application.",
1538+ "parameters": {
1539+ "appsId": {
1540+ "type": "string",
1541+ "description": "Part of `parent`. Name of the parent Application resource. Example: `apps/myapp`.",
1542+ "required": true,
1543+ "location": "path"
1544+ },
1545+ "pageSize": {
1546+ "type": "integer",
1547+ "description": "Maximum results to return per page.",
1548+ "format": "int32",
1549+ "location": "query"
1550+ },
1551+ "pageToken": {
1552+ "type": "string",
1553+ "description": "Continuation token for fetching the next page of results.",
1554+ "location": "query"
1555+ }
1556+ },
1557+ "parameterOrder": [
1558+ "appsId"
1559+ ],
1560+ "response": {
1561+ "$ref": "ListServicesResponse"
1562+ },
1563+ "scopes": [
1564+ "https://www.googleapis.com/auth/cloud-platform"
1565+ ]
1566+ },
1567+ "get": {
1568+ "id": "appengine.apps.services.get",
1569+ "path": "v1/apps/{appsId}/services/{servicesId}",
1570+ "httpMethod": "GET",
1571+ "description": "Gets the current configuration of the specified service.",
1572+ "parameters": {
1573+ "appsId": {
1574+ "type": "string",
1575+ "description": "Part of `name`. Name of the resource requested. Example: `apps/myapp/services/default`.",
1576+ "required": true,
1577+ "location": "path"
1578+ },
1579+ "servicesId": {
1580+ "type": "string",
1581+ "description": "Part of `name`. See documentation of `appsId`.",
1582+ "required": true,
1583+ "location": "path"
1584+ }
1585+ },
1586+ "parameterOrder": [
1587+ "appsId",
1588+ "servicesId"
1589+ ],
1590+ "response": {
1591+ "$ref": "Service"
1592+ },
1593+ "scopes": [
1594+ "https://www.googleapis.com/auth/cloud-platform"
1595+ ]
1596+ },
1597+ "patch": {
1598+ "id": "appengine.apps.services.patch",
1599+ "path": "v1/apps/{appsId}/services/{servicesId}",
1600+ "httpMethod": "PATCH",
1601+ "description": "Updates the configuration of the specified service.",
1602+ "parameters": {
1603+ "appsId": {
1604+ "type": "string",
1605+ "description": "Part of `name`. Name of the resource to update. Example: `apps/myapp/services/default`.",
1606+ "required": true,
1607+ "location": "path"
1608+ },
1609+ "servicesId": {
1610+ "type": "string",
1611+ "description": "Part of `name`. See documentation of `appsId`.",
1612+ "required": true,
1613+ "location": "path"
1614+ },
1615+ "updateMask": {
1616+ "type": "string",
1617+ "description": "Standard field mask for the set of fields to be updated.",
1618+ "location": "query"
1619+ },
1620+ "migrateTraffic": {
1621+ "type": "boolean",
1622+ "description": "Set to `true` to gradually shift traffic from one version to another single version. By default, traffic is shifted immediately. For gradual traffic migration, the target version must be located within instances that are configured for both [warmup requests](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#inboundservicetype) and [automatic scaling](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#automaticscaling). You must specify the [`shardBy`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services#shardby) field in the Service resource. Gradual traffic migration is not supported in the App Engine flexible environment. For examples, see [Migrating and Splitting Traffic](https://cloud.google.com/appengine/docs/admin-api/migrating-splitting-traffic).",
1623+ "location": "query"
1624+ }
1625+ },
1626+ "parameterOrder": [
1627+ "appsId",
1628+ "servicesId"
1629+ ],
1630+ "request": {
1631+ "$ref": "Service"
1632+ },
1633+ "response": {
1634+ "$ref": "Operation"
1635+ },
1636+ "scopes": [
1637+ "https://www.googleapis.com/auth/cloud-platform"
1638+ ]
1639+ },
1640+ "delete": {
1641+ "id": "appengine.apps.services.delete",
1642+ "path": "v1/apps/{appsId}/services/{servicesId}",
1643+ "httpMethod": "DELETE",
1644+ "description": "Deletes the specified service and all enclosed versions.",
1645+ "parameters": {
1646+ "appsId": {
1647+ "type": "string",
1648+ "description": "Part of `name`. Name of the resource requested. Example: `apps/myapp/services/default`.",
1649+ "required": true,
1650+ "location": "path"
1651+ },
1652+ "servicesId": {
1653+ "type": "string",
1654+ "description": "Part of `name`. See documentation of `appsId`.",
1655+ "required": true,
1656+ "location": "path"
1657+ }
1658+ },
1659+ "parameterOrder": [
1660+ "appsId",
1661+ "servicesId"
1662+ ],
1663+ "response": {
1664+ "$ref": "Operation"
1665+ },
1666+ "scopes": [
1667+ "https://www.googleapis.com/auth/cloud-platform"
1668+ ]
1669+ }
1670+ },
1671+ "resources": {
1672+ "versions": {
1673+ "methods": {
1674+ "list": {
1675+ "id": "appengine.apps.services.versions.list",
1676+ "path": "v1/apps/{appsId}/services/{servicesId}/versions",
1677+ "httpMethod": "GET",
1678+ "description": "Lists the versions of a service.",
1679+ "parameters": {
1680+ "appsId": {
1681+ "type": "string",
1682+ "description": "Part of `parent`. Name of the parent Service resource. Example: `apps/myapp/services/default`.",
1683+ "required": true,
1684+ "location": "path"
1685+ },
1686+ "servicesId": {
1687+ "type": "string",
1688+ "description": "Part of `parent`. See documentation of `appsId`.",
1689+ "required": true,
1690+ "location": "path"
1691+ },
1692+ "view": {
1693+ "type": "string",
1694+ "description": "Controls the set of fields returned in the `List` response.",
1695+ "enum": [
1696+ "BASIC",
1697+ "FULL"
1698+ ],
1699+ "location": "query"
1700+ },
1701+ "pageSize": {
1702+ "type": "integer",
1703+ "description": "Maximum results to return per page.",
1704+ "format": "int32",
1705+ "location": "query"
1706+ },
1707+ "pageToken": {
1708+ "type": "string",
1709+ "description": "Continuation token for fetching the next page of results.",
1710+ "location": "query"
1711+ }
1712+ },
1713+ "parameterOrder": [
1714+ "appsId",
1715+ "servicesId"
1716+ ],
1717+ "response": {
1718+ "$ref": "ListVersionsResponse"
1719+ },
1720+ "scopes": [
1721+ "https://www.googleapis.com/auth/cloud-platform"
1722+ ]
1723+ },
1724+ "get": {
1725+ "id": "appengine.apps.services.versions.get",
1726+ "path": "v1/apps/{appsId}/services/{servicesId}/versions/{versionsId}",
1727+ "httpMethod": "GET",
1728+ "description": "Gets the specified Version resource. By default, only a `BASIC_VIEW` will be returned. Specify the `FULL_VIEW` parameter to get the full resource.",
1729+ "parameters": {
1730+ "appsId": {
1731+ "type": "string",
1732+ "description": "Part of `name`. Name of the resource requested. Example: `apps/myapp/services/default/versions/v1`.",
1733+ "required": true,
1734+ "location": "path"
1735+ },
1736+ "servicesId": {
1737+ "type": "string",
1738+ "description": "Part of `name`. See documentation of `appsId`.",
1739+ "required": true,
1740+ "location": "path"
1741+ },
1742+ "versionsId": {
1743+ "type": "string",
1744+ "description": "Part of `name`. See documentation of `appsId`.",
1745+ "required": true,
1746+ "location": "path"
1747+ },
1748+ "view": {
1749+ "type": "string",
1750+ "description": "Controls the set of fields returned in the `Get` response.",
1751+ "enum": [
1752+ "BASIC",
1753+ "FULL"
1754+ ],
1755+ "location": "query"
1756+ }
1757+ },
1758+ "parameterOrder": [
1759+ "appsId",
1760+ "servicesId",
1761+ "versionsId"
1762+ ],
1763+ "response": {
1764+ "$ref": "Version"
1765+ },
1766+ "scopes": [
1767+ "https://www.googleapis.com/auth/cloud-platform"
1768+ ]
1769+ },
1770+ "create": {
1771+ "id": "appengine.apps.services.versions.create",
1772+ "path": "v1/apps/{appsId}/services/{servicesId}/versions",
1773+ "httpMethod": "POST",
1774+ "description": "Deploys code and resource files to a new version.",
1775+ "parameters": {
1776+ "appsId": {
1777+ "type": "string",
1778+ "description": "Part of `parent`. Name of the parent resource to create this version under. Example: `apps/myapp/services/default`.",
1779+ "required": true,
1780+ "location": "path"
1781+ },
1782+ "servicesId": {
1783+ "type": "string",
1784+ "description": "Part of `parent`. See documentation of `appsId`.",
1785+ "required": true,
1786+ "location": "path"
1787+ }
1788+ },
1789+ "parameterOrder": [
1790+ "appsId",
1791+ "servicesId"
1792+ ],
1793+ "request": {
1794+ "$ref": "Version"
1795+ },
1796+ "response": {
1797+ "$ref": "Operation"
1798+ },
1799+ "scopes": [
1800+ "https://www.googleapis.com/auth/cloud-platform"
1801+ ]
1802+ },
1803+ "patch": {
1804+ "id": "appengine.apps.services.versions.patch",
1805+ "path": "v1/apps/{appsId}/services/{servicesId}/versions/{versionsId}",
1806+ "httpMethod": "PATCH",
1807+ "description": "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: * [`serving_status`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.serving_status): For Version resources that use basic scaling, manual scaling, or run in the App Engine flexible environment. * [`instance_class`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.instance_class): For Version resources that run in the App Engine 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): For Version resources that use automatic scaling and run in the App Engine standard environment. * [`automatic_scaling.max_idle_instances`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.automatic_scaling): For Version resources that use automatic scaling and run in the App Engine standard environment.",
1808+ "parameters": {
1809+ "appsId": {
1810+ "type": "string",
1811+ "description": "Part of `name`. Name of the resource to update. Example: `apps/myapp/services/default/versions/1`.",
1812+ "required": true,
1813+ "location": "path"
1814+ },
1815+ "servicesId": {
1816+ "type": "string",
1817+ "description": "Part of `name`. See documentation of `appsId`.",
1818+ "required": true,
1819+ "location": "path"
1820+ },
1821+ "versionsId": {
1822+ "type": "string",
1823+ "description": "Part of `name`. See documentation of `appsId`.",
1824+ "required": true,
1825+ "location": "path"
1826+ },
1827+ "updateMask": {
1828+ "type": "string",
1829+ "description": "Standard field mask for the set of fields to be updated.",
1830+ "location": "query"
1831+ }
1832+ },
1833+ "parameterOrder": [
1834+ "appsId",
1835+ "servicesId",
1836+ "versionsId"
1837+ ],
1838+ "request": {
1839+ "$ref": "Version"
1840+ },
1841+ "response": {
1842+ "$ref": "Operation"
1843+ },
1844+ "scopes": [
1845+ "https://www.googleapis.com/auth/cloud-platform"
1846+ ]
1847+ },
1848+ "delete": {
1849+ "id": "appengine.apps.services.versions.delete",
1850+ "path": "v1/apps/{appsId}/services/{servicesId}/versions/{versionsId}",
1851+ "httpMethod": "DELETE",
1852+ "description": "Deletes an existing Version resource.",
1853+ "parameters": {
1854+ "appsId": {
1855+ "type": "string",
1856+ "description": "Part of `name`. Name of the resource requested. Example: `apps/myapp/services/default/versions/v1`.",
1857+ "required": true,
1858+ "location": "path"
1859+ },
1860+ "servicesId": {
1861+ "type": "string",
1862+ "description": "Part of `name`. See documentation of `appsId`.",
1863+ "required": true,
1864+ "location": "path"
1865+ },
1866+ "versionsId": {
1867+ "type": "string",
1868+ "description": "Part of `name`. See documentation of `appsId`.",
1869+ "required": true,
1870+ "location": "path"
1871+ }
1872+ },
1873+ "parameterOrder": [
1874+ "appsId",
1875+ "servicesId",
1876+ "versionsId"
1877+ ],
1878+ "response": {
1879+ "$ref": "Operation"
1880+ },
1881+ "scopes": [
1882+ "https://www.googleapis.com/auth/cloud-platform"
1883+ ]
1884+ }
1885+ },
1886+ "resources": {
1887+ "instances": {
1888+ "methods": {
1889+ "list": {
1890+ "id": "appengine.apps.services.versions.instances.list",
1891+ "path": "v1/apps/{appsId}/services/{servicesId}/versions/{versionsId}/instances",
1892+ "httpMethod": "GET",
1893+ "description": "Lists the instances of a version.",
1894+ "parameters": {
1895+ "appsId": {
1896+ "type": "string",
1897+ "description": "Part of `parent`. Name of the parent Version resource. Example: `apps/myapp/services/default/versions/v1`.",
1898+ "required": true,
1899+ "location": "path"
1900+ },
1901+ "servicesId": {
1902+ "type": "string",
1903+ "description": "Part of `parent`. See documentation of `appsId`.",
1904+ "required": true,
1905+ "location": "path"
1906+ },
1907+ "versionsId": {
1908+ "type": "string",
1909+ "description": "Part of `parent`. See documentation of `appsId`.",
1910+ "required": true,
1911+ "location": "path"
1912+ },
1913+ "pageSize": {
1914+ "type": "integer",
1915+ "description": "Maximum results to return per page.",
1916+ "format": "int32",
1917+ "location": "query"
1918+ },
1919+ "pageToken": {
1920+ "type": "string",
1921+ "description": "Continuation token for fetching the next page of results.",
1922+ "location": "query"
1923+ }
1924+ },
1925+ "parameterOrder": [
1926+ "appsId",
1927+ "servicesId",
1928+ "versionsId"
1929+ ],
1930+ "response": {
1931+ "$ref": "ListInstancesResponse"
1932+ },
1933+ "scopes": [
1934+ "https://www.googleapis.com/auth/cloud-platform"
1935+ ]
1936+ },
1937+ "get": {
1938+ "id": "appengine.apps.services.versions.instances.get",
1939+ "path": "v1/apps/{appsId}/services/{servicesId}/versions/{versionsId}/instances/{instancesId}",
1940+ "httpMethod": "GET",
1941+ "description": "Gets instance information.",
1942+ "parameters": {
1943+ "appsId": {
1944+ "type": "string",
1945+ "description": "Part of `name`. Name of the resource requested. Example: `apps/myapp/services/default/versions/v1/instances/instance-1`.",
1946+ "required": true,
1947+ "location": "path"
1948+ },
1949+ "servicesId": {
1950+ "type": "string",
1951+ "description": "Part of `name`. See documentation of `appsId`.",
1952+ "required": true,
1953+ "location": "path"
1954+ },
1955+ "versionsId": {
1956+ "type": "string",
1957+ "description": "Part of `name`. See documentation of `appsId`.",
1958+ "required": true,
1959+ "location": "path"
1960+ },
1961+ "instancesId": {
1962+ "type": "string",
1963+ "description": "Part of `name`. See documentation of `appsId`.",
1964+ "required": true,
1965+ "location": "path"
1966+ }
1967+ },
1968+ "parameterOrder": [
1969+ "appsId",
1970+ "servicesId",
1971+ "versionsId",
1972+ "instancesId"
1973+ ],
1974+ "response": {
1975+ "$ref": "Instance"
1976+ },
1977+ "scopes": [
1978+ "https://www.googleapis.com/auth/cloud-platform"
1979+ ]
1980+ },
1981+ "delete": {
1982+ "id": "appengine.apps.services.versions.instances.delete",
1983+ "path": "v1/apps/{appsId}/services/{servicesId}/versions/{versionsId}/instances/{instancesId}",
1984+ "httpMethod": "DELETE",
1985+ "description": "Stops a running instance.",
1986+ "parameters": {
1987+ "appsId": {
1988+ "type": "string",
1989+ "description": "Part of `name`. Name of the resource requested. Example: `apps/myapp/services/default/versions/v1/instances/instance-1`.",
1990+ "required": true,
1991+ "location": "path"
1992+ },
1993+ "servicesId": {
1994+ "type": "string",
1995+ "description": "Part of `name`. See documentation of `appsId`.",
1996+ "required": true,
1997+ "location": "path"
1998+ },
1999+ "versionsId": {
2000+ "type": "string",
2001+ "description": "Part of `name`. See documentation of `appsId`.",
2002+ "required": true,
2003+ "location": "path"
2004+ },
2005+ "instancesId": {
2006+ "type": "string",
2007+ "description": "Part of `name`. See documentation of `appsId`.",
2008+ "required": true,
2009+ "location": "path"
2010+ }
2011+ },
2012+ "parameterOrder": [
2013+ "appsId",
2014+ "servicesId",
2015+ "versionsId",
2016+ "instancesId"
2017+ ],
2018+ "response": {
2019+ "$ref": "Operation"
2020+ },
2021+ "scopes": [
2022+ "https://www.googleapis.com/auth/cloud-platform"
2023+ ]
2024+ },
2025+ "debug": {
2026+ "id": "appengine.apps.services.versions.instances.debug",
2027+ "path": "v1/apps/{appsId}/services/{servicesId}/versions/{versionsId}/instances/{instancesId}:debug",
2028+ "httpMethod": "POST",
2029+ "description": "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.",
2030+ "parameters": {
2031+ "appsId": {
2032+ "type": "string",
2033+ "description": "Part of `name`. Name of the resource requested. Example: `apps/myapp/services/default/versions/v1/instances/instance-1`.",
2034+ "required": true,
2035+ "location": "path"
2036+ },
2037+ "servicesId": {
2038+ "type": "string",
2039+ "description": "Part of `name`. See documentation of `appsId`.",
2040+ "required": true,
2041+ "location": "path"
2042+ },
2043+ "versionsId": {
2044+ "type": "string",
2045+ "description": "Part of `name`. See documentation of `appsId`.",
2046+ "required": true,
2047+ "location": "path"
2048+ },
2049+ "instancesId": {
2050+ "type": "string",
2051+ "description": "Part of `name`. See documentation of `appsId`.",
2052+ "required": true,
2053+ "location": "path"
2054+ }
2055+ },
2056+ "parameterOrder": [
2057+ "appsId",
2058+ "servicesId",
2059+ "versionsId",
2060+ "instancesId"
2061+ ],
2062+ "request": {
2063+ "$ref": "DebugInstanceRequest"
2064+ },
2065+ "response": {
2066+ "$ref": "Operation"
2067+ },
2068+ "scopes": [
2069+ "https://www.googleapis.com/auth/cloud-platform"
2070+ ]
2071+ }
2072+ }
2073+ }
2074+ }
2075+ }
2076+ }
2077+ },
2078+ "locations": {
2079+ "methods": {
2080+ "list": {
2081+ "id": "appengine.apps.locations.list",
2082+ "path": "v1/apps/{appsId}/locations",
2083+ "httpMethod": "GET",
2084+ "description": "Lists information about the supported locations for this service.",
2085+ "parameters": {
2086+ "appsId": {
2087+ "type": "string",
2088+ "description": "Part of `name`. The resource that owns the locations collection, if applicable.",
2089+ "required": true,
2090+ "location": "path"
2091+ },
2092+ "filter": {
2093+ "type": "string",
2094+ "description": "The standard list filter.",
2095+ "location": "query"
2096+ },
2097+ "pageSize": {
2098+ "type": "integer",
2099+ "description": "The standard list page size.",
2100+ "format": "int32",
2101+ "location": "query"
2102+ },
2103+ "pageToken": {
2104+ "type": "string",
2105+ "description": "The standard list page token.",
2106+ "location": "query"
2107+ }
2108+ },
2109+ "parameterOrder": [
2110+ "appsId"
2111+ ],
2112+ "response": {
2113+ "$ref": "ListLocationsResponse"
2114+ },
2115+ "scopes": [
2116+ "https://www.googleapis.com/auth/cloud-platform"
2117+ ]
2118+ },
2119+ "get": {
2120+ "id": "appengine.apps.locations.get",
2121+ "path": "v1/apps/{appsId}/locations/{locationsId}",
2122+ "httpMethod": "GET",
2123+ "description": "Get information about a location.",
2124+ "parameters": {
2125+ "appsId": {
2126+ "type": "string",
2127+ "description": "Part of `name`. Resource name for the location.",
2128+ "required": true,
2129+ "location": "path"
2130+ },
2131+ "locationsId": {
2132+ "type": "string",
2133+ "description": "Part of `name`. See documentation of `appsId`.",
2134+ "required": true,
2135+ "location": "path"
2136+ }
2137+ },
2138+ "parameterOrder": [
2139+ "appsId",
2140+ "locationsId"
2141+ ],
2142+ "response": {
2143+ "$ref": "Location"
2144+ },
2145+ "scopes": [
2146+ "https://www.googleapis.com/auth/cloud-platform"
2147+ ]
2148+ }
2149+ }
2150+ }
2151+ }
2152+ }
2153+ }
2154+}
gen/model/appengine/v1beta4/appengine-api.json+646−297
@@ -1,11 +1,11 @@
11{
22 "kind": "discovery#restDescription",
3− "etag": "\"jQLIOHBVnDZie4rQHGH1WJF-INE/xOhGK-osplEL_ezCgC9eAq4dFhY\"",
3+ "etag": "\"C5oy1hgQsABtYOYIOXWcR3BgYqU/oxqnbHp-xHhVH5Kpw24MjL-SV6E\"",
44 "discoveryVersion": "v1",
55 "id": "appengine:v1beta4",
66 "name": "appengine",
77 "version": "v1beta4",
8− "revision": "20160407",
8+ "revision": "20161012",
99 "title": "Google App Engine Admin API",
1010 "description": "Provisions and manages App Engine applications.",
1111 "ownerDomain": "google.com",
@@ -110,49 +110,129 @@
110110 }
111111 },
112112 "schemas": {
113+ "Operation": {
114+ "id": "Operation",
115+ "type": "object",
116+ "description": "This resource represents a long-running operation that is the result of a network API call.",
117+ "properties": {
118+ "name": {
119+ "type": "string",
120+ "description": "The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`."
121+ },
122+ "metadata": {
123+ "type": "object",
124+ "description": "Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.",
125+ "additionalProperties": {
126+ "type": "any",
127+ "description": "Properties of the object. Contains field @type with type URL."
128+ }
129+ },
130+ "done": {
131+ "type": "boolean",
132+ "description": "If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available."
133+ },
134+ "error": {
135+ "$ref": "Status",
136+ "description": "The error result of the operation in case of failure."
137+ },
138+ "response": {
139+ "type": "object",
140+ "description": "The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.",
141+ "additionalProperties": {
142+ "type": "any",
143+ "description": "Properties of the object. Contains field @type with type URL."
144+ }
145+ }
146+ }
147+ },
148+ "Status": {
149+ "id": "Status",
150+ "type": "object",
151+ "description": "The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons.",
152+ "properties": {
153+ "code": {
154+ "type": "integer",
155+ "description": "The status code, which should be an enum value of google.rpc.Code.",
156+ "format": "int32"
157+ },
158+ "message": {
159+ "type": "string",
160+ "description": "A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client."
161+ },
162+ "details": {
163+ "type": "array",
164+ "description": "A list of messages that carry the error details. There will be a common set of message types for APIs to use.",
165+ "items": {
166+ "type": "object",
167+ "additionalProperties": {
168+ "type": "any",
169+ "description": "Properties of the object. Contains field @type with type URL."
170+ }
171+ }
172+ }
173+ }
174+ },
175+ "ListOperationsResponse": {
176+ "id": "ListOperationsResponse",
177+ "type": "object",
178+ "description": "The response message for Operations.ListOperations.",
179+ "properties": {
180+ "operations": {
181+ "type": "array",
182+ "description": "A list of operations that matches the specified filter in the request.",
183+ "items": {
184+ "$ref": "Operation"
185+ }
186+ },
187+ "nextPageToken": {
188+ "type": "string",
189+ "description": "The standard List next-page token."
190+ }
191+ }
192+ },
113193 "Application": {
114194 "id": "Application",
115195 "type": "object",
116− "description": "An Application contains the top-level configuration of an App Engine application.",
196+ "description": "An Application resource contains the top-level configuration of an App Engine application.",
117197 "properties": {
118198 "name": {
119199 "type": "string",
120− "description": "The full path to the application in the API. Example: \"apps/myapp\". @OutputOnly"
200+ "description": "Full path to the Application resource in the API. Example: `apps/myapp`. @OutputOnly"
121201 },
122202 "id": {
123203 "type": "string",
124− "description": "The relative name/path of the application. Example: \"myapp\"."
204+ "description": "Identifier of the Application resource. This identifier is equivalent to the project ID of the Google Cloud Platform project where you want to deploy your application. Example: `myapp`."
125205 },
126206 "dispatchRules": {
127207 "type": "array",
128− "description": "HTTP path dispatch rules for requests to the app that do not explicitly target a module or version. The rules are order-dependent. @OutputOnly",
208+ "description": "HTTP path dispatch rules for requests to the application that do not explicitly target a module or version. Rules are order-dependent. @OutputOnly",
129209 "items": {
130210 "$ref": "UrlDispatchRule"
131211 }
132212 },
133213 "authDomain": {
134214 "type": "string",
135− "description": "If set, only users from the specified Google Apps authentication domain may access the application. If not set, any Google Account may access the application."
215+ "description": "Google Apps authentication domain that controls which users can access this application. Defaults to open access for any Google Account."
136216 },
137217 "location": {
138218 "type": "string",
139− "description": "The location from which the application will be run. Application instances will run out of data centers in the chosen location and all of the application's End User Content will be stored at rest. The default is \"us-central\". Choices are: \"us-central\" - Central US \"europe-west\" - Western Europe \"us-east1\" - Eastern US"
219+ "description": "Location from which this application will be run. Application instances will run out of data centers in the chosen location, which is also where all of the application's end user content is stored. Defaults to `us-central`. Options are: `us-central` - Central US `europe-west` - Western Europe `us-east1` - Eastern US"
140220 },
141221 "codeBucket": {
142222 "type": "string",
143− "description": "A Google Cloud Storage bucket which can be used for storing files associated with an application. This bucket is associated with the application and can be used by the gcloud deployment commands. @OutputOnly"
223+ "description": "Google Cloud Storage bucket that can be used for storing files associated with this application. This bucket is associated with the application and can be used by the gcloud deployment commands. @OutputOnly"
144224 },
145225 "defaultCookieExpiration": {
146226 "type": "string",
147− "description": "Determines the cookie expiration policy for the application. @OutputOnly"
227+ "description": "Cookie expiration policy for this application. @OutputOnly"
148228 },
149229 "defaultHostname": {
150230 "type": "string",
151− "description": "The hostname used to reach the application, as resolved by App Engine. @OutputOnly"
231+ "description": "Hostname used to reach the application, as resolved by App Engine. @OutputOnly"
152232 },
153233 "defaultBucket": {
154234 "type": "string",
155− "description": "A Google Cloud Storage bucket which can be used by the application to store content. @OutputOnly"
235+ "description": "Google Cloud Storage bucket that can be used by this application to store content. @OutputOnly"
156236 }
157237 }
158238 },
@@ -163,34 +243,34 @@
163243 "properties": {
164244 "domain": {
165245 "type": "string",
166− "description": "The domain name to match on. Supports '*' (glob) wildcarding on the left-hand side of a '.'. If empty, all domains will be matched (the same as '*')."
246+ "description": "Domain name to match against. The wildcard \"`*`\" is supported if specified before a period: \"`*.`\". Defaults to matching all domains: \"`*`\"."
167247 },
168248 "path": {
169249 "type": "string",
170− "description": "The pathname within the host. This must start with a '/'. A single '*' (glob) can be included at the end of the path. The sum of the lengths of the domain and path may not exceed 100 characters."
250+ "description": "Pathname within the host. Must start with a \"`/`\". A single \"`*`\" can be included at the end of the path. The sum of the lengths of the domain and path may not exceed 100 characters."
171251 },
172252 "module": {
173253 "type": "string",
174− "description": "The resource id of a Module in this application that should service the matched request. The Module must already exist. Example: \"default\"."
254+ "description": "Resource ID of a module in this application that should serve the matched request. The module must already exist. Example: `default`."
175255 }
176256 }
177257 },
178258 "Version": {
179259 "id": "Version",
180260 "type": "object",
181− "description": "A Version is a specific set of source code and configuration files deployed to a module.",
261+ "description": "A Version resource is a specific set of source code and configuration files that are deployed into a module.",
182262 "properties": {
183263 "name": {
184264 "type": "string",
185− "description": "The full path to the Version resource in the API. Example: \"apps/myapp/modules/default/versions/v1\". @OutputOnly"
265+ "description": "Full path to the Version resource in the API. Example: `apps/myapp/modules/default/versions/v1`. @OutputOnly"
186266 },
187267 "id": {
188268 "type": "string",
189− "description": "The relative name/path of the Version within the module. Example: \"v1\". Version specifiers can contain lowercase letters, digits, and hyphens. It cannot begin with the prefix `ah-` and the names `default` and `latest` are reserved and cannot be used."
269+ "description": "Relative name of the version within the module. Example: `v1`. Version names can contain only lowercase letters, numbers, or hyphens. Reserved names: \"default\", \"latest\", and any name with the prefix \"ah-\"."
190270 },
191271 "automaticScaling": {
192272 "$ref": "AutomaticScaling",
193− "description": "Automatic scaling is the scaling policy that App Engine has used since its inception. It is based on request rate, response latencies, and other application metrics."
273+ "description": "Automatic scaling is based on request rate, response latencies, and other application metrics."
194274 },
195275 "basicScaling": {
196276 "$ref": "BasicScaling",
@@ -206,7 +286,7 @@
206286 "enumDescriptions": [
207287 "Not specified.",
208288 "Allows an application to receive mail.",
209− "Allows an application receive email bound notifications.",
289+ "Allows an application to receive email-bound notifications.",
210290 "Allows an application to receive error stanzas.",
211291 "Allows an application to receive instant messages.",
212292 "Allows an application to receive user subscription POSTs.",
@@ -231,42 +311,42 @@
231311 },
232312 "instanceClass": {
233313 "type": "string",
234− "description": "The frontend instance class to use to run this app. Valid values are `[F1, F2, F4, F4_1G]`. Default: \"F1\""
314+ "description": "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."
235315 },
236316 "network": {
237317 "$ref": "Network",
238− "description": "Used to specify extra network settings (for VM runtimes only)."
318+ "description": "Extra network settings. Only applicable for VM runtimes."
239319 },
240320 "resources": {
241321 "$ref": "Resources",
242− "description": "Used to specify how many machine resources an app version needs (for VM runtimes only)."
322+ "description": "Machine resources for this version. Only applicable for VM runtimes."
243323 },
244324 "runtime": {
245325 "type": "string",
246− "description": "The desired runtime. Values can include python27, java7, go, etc."
326+ "description": "Desired runtime. Example: `python27`."
247327 },
248328 "threadsafe": {
249329 "type": "boolean",
250− "description": "If true, multiple requests can be dispatched to the app at once."
330+ "description": "Whether multiple requests can be dispatched to this version at once."
251331 },
252332 "vm": {
253333 "type": "boolean",
254− "description": "Whether to deploy this app in a VM container."
334+ "description": "Whether to deploy this version in a container on a virtual machine."
255335 },
256336 "betaSettings": {
257337 "type": "object",
258− "description": "Beta settings supplied to the application via metadata.",
338+ "description": "Metadata settings that are supplied to this version to enable beta runtime features.",
259339 "additionalProperties": {
260340 "type": "string"
261341 }
262342 },
263343 "env": {
264344 "type": "string",
265− "description": "The App Engine execution environment to use for this version. Default: \"1\""
345+ "description": "App Engine execution environment to use for this version. Defaults to `1`."
266346 },
267347 "servingStatus": {
268348 "type": "string",
269− "description": "The current serving status of this version. Only `SERVING` versions will have instances created or billed for. If this field is unset when a version is created, `SERVING` status will be assumed. It is an error to explicitly set this field to `SERVING_STATUS_UNSPECIFIED`.",
349+ "description": "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`.",
270350 "enum": [
271351 "SERVING_STATUS_UNSPECIFIED",
272352 "SERVING",
@@ -275,70 +355,70 @@
275355 },
276356 "deployer": {
277357 "type": "string",
278− "description": "The email address of the user who created this version. @OutputOnly"
358+ "description": "Email address of the user who created this version. @OutputOnly"
279359 },
280360 "creationTime": {
281361 "type": "string",
282− "description": "Creation time of this version. This will be between the start and end times of the operation that creates this version. @OutputOnly"
362+ "description": "Time that this version was created. @OutputOnly"
283363 },
284364 "handlers": {
285365 "type": "array",
286− "description": "An ordered list of URL Matching patterns that should be applied to incoming requests. The first matching URL consumes the request, and subsequent handlers are not attempted. Only returned in `GET` requests if `view=FULL` is set. May only be set on create requests; once created, is immutable.",
366+ "description": "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.",
287367 "items": {
288368 "$ref": "UrlMap"
289369 }
290370 },
291371 "errorHandlers": {
292372 "type": "array",
293− "description": "Custom static error pages instead of these generic error pages, (limit 10 KB/page) Only returned in `GET` requests if `view=FULL` is set. May only be set on create requests; once created, is immutable.",
373+ "description": "Custom static error pages. Limited to 10KB per page. Only returned in `GET` requests if `view=FULL` is set.",
294374 "items": {
295375 "$ref": "ErrorHandler"
296376 }
297377 },
298378 "libraries": {
299379 "type": "array",
300− "description": "Configuration for Python runtime third-party libraries required by the application. Only returned in `GET` requests if `view=FULL` is set. May only be set on create requests; once created, is immutable.",
380+ "description": "Configuration for third-party Python runtime libraries required by the application. Only returned in `GET` requests if `view=FULL` is set.",
301381 "items": {
302382 "$ref": "Library"
303383 }
304384 },
305385 "apiConfig": {
306386 "$ref": "ApiConfigHandler",
307− "description": "Serving configuration for Google Cloud Endpoints. Only returned in `GET` requests if `view=FULL` is set. May only be set on create requests; once created, is immutable."
387+ "description": "Serving configuration for [Google Cloud Endpoints](https://cloud.google.com/appengine/docs/python/endpoints/). Only returned in `GET` requests if `view=FULL` is set."
308388 },
309389 "envVariables": {
310390 "type": "object",
311− "description": "Environment variables made available to the application. Only returned in `GET` requests if `view=FULL` is set. May only be set on create requests; once created, is immutable.",
391+ "description": "Environment variables made available to the application. Only returned in `GET` requests if `view=FULL` is set.",
312392 "additionalProperties": {
313393 "type": "string"
314394 }
315395 },
316396 "defaultExpiration": {
317397 "type": "string",
318− "description": "The length of time a static file served by a static file handler ought to be cached by web proxies and browsers, if the handler does not specify its own expiration. Only returned in `GET` requests if `view=FULL` is set. May only be set on create requests; once created, is immutable."
398+ "description": "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."
319399 },
320400 "healthCheck": {
321401 "$ref": "HealthCheck",
322− "description": "Configure health checking for the VM instances. Unhealthy VM instances will be stopped and replaced with new instances. Only returned in `GET` requests if `view=FULL` is set. May only be set on create requests; once created, is immutable."
402+ "description": "Configures health checking for VM instances. Unhealthy instances are stopped and replaced with new instances. Only applicable for VM runtimes. Only returned in `GET` requests if `view=FULL` is set."
323403 },
324404 "nobuildFilesRegex": {
325405 "type": "string",
326− "description": "Go only. Files that match this pattern will not be built into the app. May only be set on create requests."
406+ "description": "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."
327407 },
328408 "deployment": {
329409 "$ref": "Deployment",
330− "description": "Code and application artifacts that make up this version. Only returned in `GET` requests if `view=FULL` is set. May only be set on create requests; once created, is immutable."
410+ "description": "Code and application artifacts that make up this version. Only returned in `GET` requests if `view=FULL` is set."
331411 }
332412 }
333413 },
334414 "AutomaticScaling": {
335415 "id": "AutomaticScaling",
336416 "type": "object",
337− "description": "Automatic scaling is the scaling policy that App Engine has used since its inception. It is based on request rate, response latencies, and other application metrics.",
417+ "description": "Automatic scaling is based on request rate, response latencies, and other application metrics.",
338418 "properties": {
339419 "coolDownPeriod": {
340420 "type": "string",
341− "description": "The amount of time that the [Autoscaler](https://cloud.google.com/compute/docs/autoscaler/) should wait between changes to the number of virtual machines. Applies only to the VM runtime."
421+ "description": "Amount of time that the [Autoscaler](https://cloud.google.com/compute/docs/autoscaler/) should wait between changes to the number of virtual machines. Only applicable for VM runtimes."
342422 },
343423 "cpuUtilization": {
344424 "$ref": "CpuUtilization",
@@ -346,36 +426,36 @@
346426 },
347427 "maxConcurrentRequests": {
348428 "type": "integer",
349− "description": "The number of concurrent requests an automatic scaling instance can accept before the scheduler spawns a new instance. Default value is chosen based on the runtime.",
429+ "description": "Number of concurrent requests an automatic scaling instance can accept before the scheduler spawns a new instance. Defaults to a runtime-specific value.",
350430 "format": "int32"
351431 },
352432 "maxIdleInstances": {
353433 "type": "integer",
354− "description": "The maximum number of idle instances that App Engine should maintain for this version.",
434+ "description": "Maximum number of idle instances that should be maintained for this version.",
355435 "format": "int32"
356436 },
357437 "maxTotalInstances": {
358438 "type": "integer",
359− "description": "Max number of instances that App Engine should start to handle requests.",
439+ "description": "Maximum number of instances that should be started to handle requests.",
360440 "format": "int32"
361441 },
362442 "maxPendingLatency": {
363443 "type": "string",
364− "description": "The maximum amount of time that App Engine should allow a request to wait in the pending queue before starting a new instance to handle it."
444+ "description": "Maximum amount of time that a request should wait in the pending queue before starting a new instance to handle it."
365445 },
366446 "minIdleInstances": {
367447 "type": "integer",
368− "description": "The minimum number of idle instances that App Engine should maintain for this version. Only applies to the default version of a module, since other versions are not expected to receive significant traffic.",
448+ "description": "Minimum number of idle instances that should be maintained for this version. Only applicable for the default version of a module.",
369449 "format": "int32"
370450 },
371451 "minTotalInstances": {
372452 "type": "integer",
373− "description": "Minimum number of instances that App Engine should maintain.",
453+ "description": "Minimum number of instances that should be maintained for this version.",
374454 "format": "int32"
375455 },
376456 "minPendingLatency": {
377457 "type": "string",
378− "description": "The minimum amount of time that App Engine should allow a request to wait in the pending queue before starting a new instance to handle it."
458+ "description": "Minimum amount of time a request should wait in the pending queue before starting a new instance to handle it."
379459 },
380460 "requestUtilization": {
381461 "$ref": "RequestUtilization",
@@ -398,11 +478,11 @@
398478 "properties": {
399479 "aggregationWindowLength": {
400480 "type": "string",
401− "description": "The period of time over which CPU utilization is calculated."
481+ "description": "Period of time over which CPU utilization is calculated."
402482 },
403483 "targetUtilization": {
404484 "type": "number",
405− "description": "Target (0-1) CPU utilization ratio to maintain when scaling.",
485+ "description": "Target CPU utilization ratio to maintain when scaling. Must be between 0 and 1.",
406486 "format": "double"
407487 }
408488 }
@@ -410,7 +490,7 @@
410490 "RequestUtilization": {
411491 "id": "RequestUtilization",
412492 "type": "object",
413− "description": "Target scaling by request utilization (for VM runtimes only).",
493+ "description": "Target scaling by request utilization. Only applicable for VM runtimes.",
414494 "properties": {
415495 "targetRequestCountPerSec": {
416496 "type": "integer",
@@ -427,26 +507,26 @@
427507 "DiskUtilization": {
428508 "id": "DiskUtilization",
429509 "type": "object",
430− "description": "Target scaling by disk usage (for VM runtimes only).",
510+ "description": "Target scaling by disk usage. Only applicable for VM runtimes.",
431511 "properties": {
432512 "targetWriteBytesPerSec": {
433513 "type": "integer",
434− "description": "Target bytes per second written.",
514+ "description": "Target bytes written per second.",
435515 "format": "int32"
436516 },
437517 "targetWriteOpsPerSec": {
438518 "type": "integer",
439− "description": "Target ops per second written.",
519+ "description": "Target ops written per second.",
440520 "format": "int32"
441521 },
442522 "targetReadBytesPerSec": {
443523 "type": "integer",
444− "description": "Target bytes per second read.",
524+ "description": "Target bytes read per second.",
445525 "format": "int32"
446526 },
447527 "targetReadOpsPerSec": {
448528 "type": "integer",
449− "description": "Target ops per second read.",
529+ "description": "Target ops read per second.",
450530 "format": "int32"
451531 }
452532 }
@@ -454,26 +534,26 @@
454534 "NetworkUtilization": {
455535 "id": "NetworkUtilization",
456536 "type": "object",
457− "description": "Target scaling by network usage (for VM runtimes only).",
537+ "description": "Target scaling by network usage. Only applicable for VM runtimes.",
458538 "properties": {
459539 "targetSentBytesPerSec": {
460540 "type": "integer",
461− "description": "Target bytes per second sent.",
541+ "description": "Target bytes sent per second.",
462542 "format": "int32"
463543 },
464544 "targetSentPacketsPerSec": {
465545 "type": "integer",
466− "description": "Target packets per second sent.",
546+ "description": "Target packets sent per second.",
467547 "format": "int32"
468548 },
469549 "targetReceivedBytesPerSec": {
470550 "type": "integer",
471− "description": "Target bytes per second received.",
551+ "description": "Target bytes received per second.",
472552 "format": "int32"
473553 },
474554 "targetReceivedPacketsPerSec": {
475555 "type": "integer",
476− "description": "Target packets per second received.",
556+ "description": "Target packets received per second.",
477557 "format": "int32"
478558 }
479559 }
@@ -485,11 +565,11 @@
485565 "properties": {
486566 "idleTimeout": {
487567 "type": "string",
488− "description": "The instance will be shut down this amount of time after receiving its last request."
568+ "description": "Duration of time after the last request that an instance must wait before the instance is shut down."
489569 },
490570 "maxInstances": {
491571 "type": "integer",
492− "description": "The maximum number of instances for App Engine to create for this version.",
572+ "description": "Maximum number of instances to create for this version.",
493573 "format": "int32"
494574 }
495575 }
@@ -501,7 +581,7 @@
501581 "properties": {
502582 "instances": {
503583 "type": "integer",
504− "description": "The number of instances to assign to the module at the start. This number can later be altered by using the [Modules API](https://cloud.google.com/appengine/docs/python/modules/functions) `set_num_instances()` function.",
584+ "description": "Number of instances to assign to the module at the start. This number can later be altered by using the [Modules API](https://cloud.google.com/appengine/docs/python/modules/functions) `set_num_instances()` function.",
505585 "format": "int32"
506586 }
507587 }
@@ -509,43 +589,43 @@
509589 "Network": {
510590 "id": "Network",
511591 "type": "object",
512− "description": "Used to specify extra network settings (for VM runtimes only).",
592+ "description": "Extra network settings. Only applicable for VM runtimes.",
513593 "properties": {
514594 "forwardedPorts": {
515595 "type": "array",
516− "description": "A list of ports (or port pairs) to forward from the VM into the app container.",
596+ "description": "List of ports, or port pairs, to forward from the virtual machine to the application container.",
517597 "items": {
518598 "type": "string"
519599 }
520600 },
521601 "instanceTag": {
522602 "type": "string",
523− "description": "A tag to apply to the VM instance during creation."
603+ "description": "Tag to apply to the VM instance during creation."
524604 },
525605 "name": {
526606 "type": "string",
527− "description": "The Google Compute Engine network where the VMs will be created. If not specified, or empty, the network named \"default\" will be used. (The short name should be specified, not the resource path.)"
607+ "description": "Google Cloud Platform network where the virtual machines are created. Specify the short name, not the resource path. Defaults to `default`."
528608 }
529609 }
530610 },
531611 "Resources": {
532612 "id": "Resources",
533613 "type": "object",
534− "description": "Used to specify how many machine resources an app version needs.",
614+ "description": "Machine resources for a version.",
535615 "properties": {
536616 "cpu": {
537617 "type": "number",
538− "description": "How many CPU cores an app version needs.",
618+ "description": "Number of CPU cores needed.",
539619 "format": "double"
540620 },
541621 "diskGb": {
542622 "type": "number",
543− "description": "How much disk size, in GB, an app version needs.",
623+ "description": "Disk size (GB) needed.",
544624 "format": "double"
545625 },
546626 "memoryGb": {
547627 "type": "number",
548− "description": "How much memory, in GB, an app version needs.",
628+ "description": "Memory (GB) needed.",
549629 "format": "double"
550630 }
551631 }
@@ -553,11 +633,11 @@
553633 "UrlMap": {
554634 "id": "UrlMap",
555635 "type": "object",
556− "description": "A URL pattern and description of how it should be handled. App Engine can handle URLs by executing application code, or by serving static files uploaded with the code, such as images, CSS or JavaScript.",
636+ "description": "URL pattern and description of how the URL should be handled. App Engine can handle URLs by executing application code, or by serving static files uploaded with the version, such as images, CSS, or JavaScript.",
557637 "properties": {
558638 "urlRegex": {
559639 "type": "string",
560− "description": "A URL prefix. This value uses regular expression syntax (and so regexp special characters must be escaped), but it should not contain groupings. All URLs that begin with this prefix are handled by this handler, using the portion of the URL after the prefix as part of the file path. This is always required."
640+ "description": "A URL prefix. Uses regular expression syntax, which means regexp special characters must be escaped, but should not contain groupings. All URLs that begin with this prefix are handled by this handler, using the portion of the URL after the prefix as part of the file path."
561641 },
562642 "staticFiles": {
563643 "$ref": "StaticFilesHandler",
@@ -569,15 +649,15 @@
569649 },
570650 "script": {
571651 "$ref": "ScriptHandler",
572− "description": "Executes a script to handle the request that matches the URL pattern."
652+ "description": "Executes a script to handle the request that matches this URL pattern."
573653 },
574654 "apiEndpoint": {
575655 "$ref": "ApiEndpointHandler",
576− "description": "Use API Endpoints to handle requests."
656+ "description": "Uses API Endpoints to handle requests."
577657 },
578658 "securityLevel": {
579659 "type": "string",
580− "description": "Configures whether security (HTTPS) should be enforced for this URL.",
660+ "description": "Security (HTTPS) enforcement for this URL.",
581661 "enum": [
582662 "SECURE_UNSPECIFIED",
583663 "SECURE_DEFAULT",
@@ -588,7 +668,7 @@
588668 },
589669 "login": {
590670 "type": "string",
591− "description": "What level of login is required to access this resource.",
671+ "description": "Level of login required to access this resource.",
592672 "enum": [
593673 "LOGIN_UNSPECIFIED",
594674 "LOGIN_OPTIONAL",
@@ -598,7 +678,7 @@
598678 },
599679 "authFailAction": {
600680 "type": "string",
601− "description": "For users not logged in, how to handle access to resources with required login. Defaults to \"redirect\".",
681+ "description": "Action to take when users access resources that require authentication. Defaults to `redirect`.",
602682 "enum": [
603683 "AUTH_FAIL_ACTION_UNSPECIFIED",
604684 "AUTH_FAIL_ACTION_REDIRECT",
@@ -607,7 +687,7 @@
607687 },
608688 "redirectHttpResponseCode": {
609689 "type": "string",
610− "description": "`30x` code to use when performing redirects for the `secure` field. A `302` is used by default.",
690+ "description": "`30x` code to use when performing redirects for the `secure` field. Defaults to `302`.",
611691 "enum": [
612692 "REDIRECT_HTTP_RESPONSE_CODE_UNSPECIFIED",
613693 "REDIRECT_HTTP_RESPONSE_CODE_301",
@@ -625,11 +705,11 @@
625705 "properties": {
626706 "path": {
627707 "type": "string",
628− "description": "The path to the static files matched by the URL pattern, from the application root directory. The path can refer to text matched in groupings in the URL pattern."
708+ "description": "Path to the static files matched by the URL pattern, from the application root directory. The path can refer to text matched in groupings in the URL pattern."
629709 },
630710 "uploadPathRegex": {
631711 "type": "string",
632− "description": "A regular expression that matches the file paths for all files that will be referenced by this handler."
712+ "description": "Regular expression that matches the file paths for all files that should be referenced by this handler."
633713 },
634714 "httpHeaders": {
635715 "type": "object",
@@ -640,19 +720,19 @@
640720 },
641721 "mimeType": {
642722 "type": "string",
643− "description": "If specified, all files served by this handler will be served using the specified MIME type. If not specified, the MIME type for a file will be derived from the file's filename extension."
723+ "description": "MIME type used to serve all files served by this handler. Defaults to file-specific MIME types, which are derived from each file's filename extension."
644724 },
645725 "expiration": {
646726 "type": "string",
647− "description": "The length of time a static file served by this handler ought to be cached by web proxies and browsers."
727+ "description": "Time a static file served by this handler should be cached."
648728 },
649729 "requireMatchingFile": {
650730 "type": "boolean",
651− "description": "If true, this UrlMap entry does not match the request unless the file referenced by the handler also exists. If no such file exists, processing will continue with the next UrlMap that matches the requested URL."
731+ "description": "Whether this handler should match the request if the file referenced by the handler does not exist."
652732 },
653733 "applicationReadable": {
654734 "type": "boolean",
655− "description": "By default, files declared in static file handlers are uploaded as static data and are only served to end users, they cannot be read by an application. If this field is set to true, the files are also uploaded as code data so your application can read them. Both uploads are charged against your code and static data storage resource quotas."
735+ "description": "Whether files should also be uploaded as code data. By default, files declared in static file handlers are uploaded as static data and are only served to end users; they cannot be read by the application. If enabled, uploads are charged against both your code and static data storage resource quotas."
656736 }
657737 }
658738 },
@@ -663,7 +743,7 @@
663743 "properties": {
664744 "directory": {
665745 "type": "string",
666− "description": "The path to the directory containing the static files, from the application root directory. Everything after the end of the matched url pattern is appended to static_dir to form the full path to the requested file."
746+ "description": "Path to the directory containing the static files from the application root directory. Everything after the end of the matched URL pattern is appended to `static_dir` to form the full path to the requested file."
667747 },
668748 "httpHeaders": {
669749 "type": "object",
@@ -674,19 +754,19 @@
674754 },
675755 "mimeType": {
676756 "type": "string",
677− "description": "If specified, all files served by this handler will be served using the specified MIME type. If not specified, the MIME type for a file will be derived from the file's filename extension."
757+ "description": "MIME type used to serve all files served by this handler. Defaults to file-specific MIME types, which are direved from each file's filename extension."
678758 },
679759 "expiration": {
680760 "type": "string",
681− "description": "The length of time a static file served by this handler ought to be cached by web proxies and browsers."
761+ "description": "Time a static file served by this handler should be cached."
682762 },
683763 "requireMatchingFile": {
684764 "type": "boolean",
685− "description": "If true, this UrlMap entry does not match the request unless the file referenced by the handler also exists. If no such file exists, processing will continue with the next UrlMap that matches the requested URL."
765+ "description": "Whether this handler should match the request if the file referenced by the handler does not exist."
686766 },
687767 "applicationReadable": {
688768 "type": "boolean",
689− "description": "By default, files declared in static file handlers are uploaded as static data and are only served to end users, they cannot be read by an application. If this field is set to true, the files are also uploaded as code data so your application can read them. Both uploads are charged against your code and static data storage resource quotas."
769+ "description": "Whether files should also be uploaded as code data. By default, files declared in static directory handlers are uploaded as static data and are only served to end users; they cannot be read by the application. If enabled, uploads are charged against both your code and static data storage resource quotas."
690770 }
691771 }
692772 },
@@ -697,29 +777,29 @@
697777 "properties": {
698778 "scriptPath": {
699779 "type": "string",
700− "description": "Specifies the path to the script from the application root directory."
780+ "description": "Path to the script from the application root directory."
701781 }
702782 }
703783 },
704784 "ApiEndpointHandler": {
705785 "id": "ApiEndpointHandler",
706786 "type": "object",
707− "description": "Use Google Cloud Endpoints to handle requests.",
787+ "description": "Uses Google Cloud Endpoints to handle requests.",
708788 "properties": {
709789 "scriptPath": {
710790 "type": "string",
711− "description": "Specifies the path to the script from the application root directory."
791+ "description": "Path to the script from the application root directory."
712792 }
713793 }
714794 },
715795 "ErrorHandler": {
716796 "id": "ErrorHandler",
717797 "type": "object",
718− "description": "A custom static error page to be served when an error occurs.",
798+ "description": "Custom static error page to be served when an error occurs.",
719799 "properties": {
720800 "errorCode": {
721801 "type": "string",
722− "description": "The error condition this handler applies to.",
802+ "description": "Error condition this handler applies to.",
723803 "enum": [
724804 "ERROR_CODE_UNSPECIFIED",
725805 "ERROR_CODE_DEFAULT",
@@ -734,33 +814,33 @@
734814 },
735815 "mimeType": {
736816 "type": "string",
737− "description": "MIME type of file. If unspecified, \"text/html\" is assumed."
817+ "description": "MIME type of file. Defaults to `text/html`."
738818 }
739819 }
740820 },
741821 "Library": {
742822 "id": "Library",
743823 "type": "object",
744− "description": "A Python runtime third-party library required by the application.",
824+ "description": "Third-party Python runtime library that is required by the application.",
745825 "properties": {
746826 "name": {
747827 "type": "string",
748− "description": "The name of the library, e.g. \"PIL\" or \"django\"."
828+ "description": "Name of the library. Example: \"django\"."
749829 },
750830 "version": {
751831 "type": "string",
752− "description": "The version of the library to select, or \"latest\"."
832+ "description": "Version of the library to select, or \"latest\"."
753833 }
754834 }
755835 },
756836 "ApiConfigHandler": {
757837 "id": "ApiConfigHandler",
758838 "type": "object",
759− "description": "API Serving configuration for Cloud Endpoints.",
839+ "description": "[Google Cloud Endpoints](https://cloud.google.com/appengine/docs/python/endpoints/) configuration for API handlers.",
760840 "properties": {
761841 "authFailAction": {
762842 "type": "string",
763− "description": "For users not logged in, how to handle access to resources with required login. Defaults to \"redirect\".",
843+ "description": "Action to take when users access resources that require authentication. Defaults to `redirect`.",
764844 "enum": [
765845 "AUTH_FAIL_ACTION_UNSPECIFIED",
766846 "AUTH_FAIL_ACTION_REDIRECT",
@@ -769,7 +849,7 @@
769849 },
770850 "login": {
771851 "type": "string",
772− "description": "What level of login is required to access this resource. Default is \"optional\".",
852+ "description": "Level of login required to access this resource. Defaults to `optional`.",
773853 "enum": [
774854 "LOGIN_UNSPECIFIED",
775855 "LOGIN_OPTIONAL",
@@ -779,11 +859,11 @@
779859 },
780860 "script": {
781861 "type": "string",
782− "description": "Specifies the path to the script from the application root directory."
862+ "description": "Path to the script from the application root directory."
783863 },
784864 "securityLevel": {
785865 "type": "string",
786− "description": "Configures whether security (HTTPS) should be enforced for this URL.",
866+ "description": "Security (HTTPS) enforcement for this URL.",
787867 "enum": [
788868 "SECURE_UNSPECIFIED",
789869 "SECURE_DEFAULT",
@@ -801,7 +881,7 @@
801881 "HealthCheck": {
802882 "id": "HealthCheck",
803883 "type": "object",
804− "description": "Configure health checking for the VM instances. Unhealthy VM instances will be killed and replaced with new instances.",
884+ "description": "Health checking configuration for VM instances. Unhealthy instances are killed and replaced with new instances. Only applicable for instances in App Engine flexible environment.",
805885 "properties": {
806886 "disableHealthCheck": {
807887 "type": "boolean",
@@ -809,30 +889,30 @@
809889 },
810890 "host": {
811891 "type": "string",
812− "description": "The host header to send when performing an HTTP health check (e.g. myapp.appspot.com)"
892+ "description": "Host header to send when performing an HTTP health check. Example: \"myapp.appspot.com\""
813893 },
814894 "healthyThreshold": {
815895 "type": "integer",
816− "description": "The number of consecutive successful health checks before receiving traffic.",
896+ "description": "Number of consecutive successful health checks required before receiving traffic.",
817897 "format": "uint32"
818898 },
819899 "unhealthyThreshold": {
820900 "type": "integer",
821− "description": "The number of consecutive failed health checks before removing traffic.",
901+ "description": "Number of consecutive failed health checks required before removing traffic.",
822902 "format": "uint32"
823903 },
824904 "restartThreshold": {
825905 "type": "integer",
826− "description": "The number of consecutive failed health checks before an instance is restarted.",
906+ "description": "Number of consecutive failed health checks required before an instance is restarted.",
827907 "format": "uint32"
828908 },
829909 "checkInterval": {
830910 "type": "string",
831− "description": "The interval between health checks."
911+ "description": "Interval between health checks."
832912 },
833913 "timeout": {
834914 "type": "string",
835− "description": "The amount of time before the health check is considered failed."
915+ "description": "Time before the health check is considered failed."
836916 }
837917 }
838918 },
@@ -843,18 +923,18 @@
843923 "properties": {
844924 "files": {
845925 "type": "object",
846− "description": "A manifest of files stored in Google Cloud Storage which should be included as part of this application. All files must be readable using the credentials supplied with this call.",
926+ "description": "Manifest of the files stored in Google Cloud Storage that are included as part of this version. All files must be readable using the credentials supplied with this call.",
847927 "additionalProperties": {
848928 "$ref": "FileInfo"
849929 }
850930 },
851931 "container": {
852932 "$ref": "ContainerInfo",
853− "description": "If supplied, a docker (container) image which should be used to start the application. Only applicable to the 'vm' runtime."
933+ "description": "A Docker image that App Engine uses the run the version. Only applicable for instances in App Engine flexible environment."
854934 },
855935 "sourceReferences": {
856936 "type": "array",
857− "description": "The origin of the source code for this deployment. There can be more than one source reference per Version if source code is distributed among multiple repositories.",
937+ "description": "Origin of the source code for this deployment. There can be more than one source reference per version if source code is distributed among multiple repositories.",
858938 "items": {
859939 "$ref": "SourceReference"
860940 }
@@ -864,107 +944,45 @@
864944 "FileInfo": {
865945 "id": "FileInfo",
866946 "type": "object",
867− "description": "A single source file which is part of the application to be deployed.",
947+ "description": "Single source file that is part of the version to be deployed. Each source file that is deployed must be specified separately.",
868948 "properties": {
869949 "sourceUrl": {
870950 "type": "string",
871− "description": "The URL source to use to fetch this file. Must be a URL to a resource in Google Cloud Storage in the form 'http(s)://storage.googleapis.com/\\/\\'."
951+ "description": "URL source to use to fetch this file. Must be a URL to a resource in Google Cloud Storage in the form 'http(s)://storage.googleapis.com/\\/\\'."
872952 },
873953 "sha1Sum": {
874954 "type": "string",
875− "description": "The SHA1 (160 bits) hash of the file in hex."
955+ "description": "The SHA1 hash of the file, in hex."
876956 },
877957 "mimeType": {
878958 "type": "string",
879− "description": "The MIME type of the file; if unspecified, the value from Google Cloud Storage will be used."
959+ "description": "The MIME type of the file. Defaults to the value from Google Cloud Storage."
880960 }
881961 }
882962 },
883963 "ContainerInfo": {
884964 "id": "ContainerInfo",
885965 "type": "object",
886− "description": "A Docker (container) image which should be used to start the application.",
966+ "description": "Docker image that is used to start a VM container for the version you deploy.",
887967 "properties": {
888968 "image": {
889969 "type": "string",
890− "description": "Reference to a hosted container image. Must be a URI to a resource in a Docker repository. Must be fully qualified, including tag or digest. e.g. gcr.io/my-project/image:tag or gcr.io/my-project/image@digest"
970+ "description": "URI to the hosted container image in a Docker repository. The URI must be fully qualified and include a tag or digest. Examples: \"gcr.io/my-project/image:tag\" or \"gcr.io/my-project/image@digest\""
891971 }
892972 }
893973 },
894974 "SourceReference": {
895975 "id": "SourceReference",
896976 "type": "object",
897− "description": "A reference to a particular snapshot of the source tree used to build and deploy the application.",
977+ "description": "Reference to a particular snapshot of the source tree used to build and deploy the application.",
898978 "properties": {
899979 "repository": {
900980 "type": "string",
901− "description": "Optional. A URI string identifying the repository. Example: \"https://source.developers.google.com/p/app-123/r/default\""
981+ "description": "URI string identifying the repository. Example: \"https://source.developers.google.com/p/app-123/r/default\""
902982 },
903983 "revisionId": {
904984 "type": "string",
905− "description": "The canonical (and persistent) identifier of the deployed revision, i.e. any kind of aliases including tags or branch names are not allowed. Example (git): \"2198322f89e0bb2e25021667c2ed489d1fd34e6b\""
906− }
907− }
908− },
909− "Operation": {
910− "id": "Operation",
911− "type": "object",
912− "description": "This resource represents a long-running operation that is the result of a network API call.",
913− "properties": {
914− "name": {
915− "type": "string",
916− "description": "The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should have the format of `operations/some/unique/name`."
917− },
918− "metadata": {
919− "type": "object",
920− "description": "Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.",
921− "additionalProperties": {
922− "type": "any",
923− "description": "Properties of the object. Contains field @ype with type URL."
924− }
925− },
926− "done": {
927− "type": "boolean",
928− "description": "If the value is `false`, it means the operation is still in progress. If true, the operation is completed, and either `error` or `response` is available."
929− },
930− "error": {
931− "$ref": "Status",
932− "description": "The error result of the operation in case of failure."
933− },
934− "response": {
935− "type": "object",
936− "description": "The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.",
937− "additionalProperties": {
938− "type": "any",
939− "description": "Properties of the object. Contains field @ype with type URL."
940− }
941− }
942− }
943− },
944− "Status": {
945− "id": "Status",
946− "type": "object",
947− "description": "The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). The error model is designed to be: - Simple to use and understand for most users - Flexible enough to meet unexpected needs # Overview The `Status` message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers *understand* and *resolve* the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package `google.rpc` which can be used for common error conditions. # Language mapping The `Status` message is the logical representation of the error model, but it is not necessarily the actual wire format. When the `Status` message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C. # Other uses The error model and the `Status` message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments. Example uses of this error model include: - Partial errors. If a service needs to return partial errors to the client, it may embed the `Status` in the normal response to indicate the partial errors. - Workflow errors. A typical workflow has multiple steps. Each step may have a `Status` message for error reporting purpose. - Batch operations. If a client uses batch request and batch response, the `Status` message should be used directly inside batch response, one for each error sub-response. - Asynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the `Status` message. - Logging. If some API errors are stored in logs, the message `Status` could be used directly after any stripping needed for security/privacy reasons.",
948− "properties": {
949− "code": {
950− "type": "integer",
951− "description": "The status code, which should be an enum value of google.rpc.Code.",
952− "format": "int32"
953− },
954− "message": {
955− "type": "string",
956− "description": "A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client."
957− },
958− "details": {
959− "type": "array",
960− "description": "A list of messages that carry the error details. There will be a common set of message types for APIs to use.",
961− "items": {
962− "type": "object",
963− "additionalProperties": {
964− "type": "any",
965− "description": "Properties of the object. Contains field @ype with type URL."
966− }
967− }
985+ "description": "The canonical, persistent identifier of the deployed revision. Aliases that include tags or branch names are not allowed. Example (git): \"2198322f89e0bb2e25021667c2ed489d1fd34e6b\""
968986 }
969987 }
970988 },
@@ -975,7 +993,7 @@
975993 "properties": {
976994 "versions": {
977995 "type": "array",
978− "description": "The versions belonging to the requested application module.",
996+ "description": "The versions belonging to the requested module.",
979997 "items": {
980998 "$ref": "Version"
981999 }
@@ -989,30 +1007,30 @@
9891007 "Module": {
9901008 "id": "Module",
9911009 "type": "object",
992− "description": "A module is a component of an application that provides a single service or configuration. A module has a collection of versions that define a specific set of code used to implement the functionality of that module.",
1010+ "description": "A Module resource is a logical component of an application that can share state and communicate in a secure fashion with other modules. For example, an application that handles customer requests might include separate modules to handle tasks such as backend data analysis or API requests from mobile devices. Each module has a collection of versions that define a specific set of code used to implement the functionality of that module.",
9931011 "properties": {
9941012 "name": {
9951013 "type": "string",
996− "description": "The full path to the Module resource in the API. Example: \"apps/myapp/modules/default\" @OutputOnly"
1014+ "description": "Full path to the Module resource in the API. Example: `apps/myapp/modules/default`. @OutputOnly"
9971015 },
9981016 "id": {
9991017 "type": "string",
1000− "description": "The relative name/path of the module within the application. Example: \"default\" @OutputOnly"
1018+ "description": "Relative name of the module within the application. Example: `default`. @OutputOnly"
10011019 },
10021020 "split": {
10031021 "$ref": "TrafficSplit",
1004− "description": "A mapping that defines fractional HTTP traffic diversion to different versions within the module."
1022+ "description": "Mapping that defines fractional HTTP traffic diversion to different versions within the module."
10051023 }
10061024 }
10071025 },
10081026 "TrafficSplit": {
10091027 "id": "TrafficSplit",
10101028 "type": "object",
1011− "description": "Configuration for traffic splitting for versions within a single module. Traffic splitting allows traffic directed to the module to be assigned to one of several versions in a fractional way, enabling experiments and canarying new builds, for example.",
1029+ "description": "Traffic routing configuration for versions within a single module. Traffic splits define how traffic directed to the module is assigned to versions.",
10121030 "properties": {
10131031 "shardBy": {
10141032 "type": "string",
1015− "description": "Which mechanism should be used as a selector when choosing a version to send a request to. The traffic selection algorithm will be stable for either type until allocations are changed.",
1033+ "description": "Mechanism used to determine which version a request is sent to. The traffic selection algorithm will be stable for either type until allocations are changed.",
10161034 "enum": [
10171035 "UNSPECIFIED",
10181036 "COOKIE",
@@ -1021,7 +1039,7 @@
10211039 },
10221040 "allocations": {
10231041 "type": "object",
1024− "description": "Mapping from module version IDs within the module to fractional (0.000, 1] allocations of traffic for that version. Each version may only be specified once, but some versions in the module may not have any traffic allocation. Modules that have traffic allocated in this field may not be deleted until the module is deleted, or their traffic allocation is removed. Allocations must sum to 1. Supports precision up to two decimal places for IP-based splits and up to three decimal places for cookie-based splits.",
1042+ "description": "Mapping from version IDs within the module to fractional (0.000, 1] allocations of traffic for that version. Each version can be specified only once, but some versions in the module may not have any traffic allocation. Modules that have traffic allocated cannot be deleted until either the module is deleted or their traffic allocation is removed. Allocations must sum to 1. Up to two decimal place precision is supported for IP-based splits and up to three decimal places is supported for cookie-based splits.",
10251043 "additionalProperties": {
10261044 "type": "number",
10271045 "format": "double"
@@ -1047,44 +1065,26 @@
10471065 }
10481066 }
10491067 },
1050− "ListInstancesResponse": {
1051− "id": "ListInstancesResponse",
1052− "type": "object",
1053− "description": "Response message for `Instances.ListInstances`.",
1054− "properties": {
1055− "instances": {
1056− "type": "array",
1057− "description": "The instances belonging to the requested version.",
1058− "items": {
1059− "$ref": "Instance"
1060− }
1061− },
1062− "nextPageToken": {
1063− "type": "string",
1064− "description": "Continuation token for fetching the next page of results."
1065− }
1066− }
1067− },
10681068 "Instance": {
10691069 "id": "Instance",
10701070 "type": "object",
1071− "description": "Instances are the computing units that App Engine uses to automatically scale an application.",
1071+ "description": "An Instance resource is the computing unit that App Engine uses to automatically scale an application.",
10721072 "properties": {
10731073 "name": {
10741074 "type": "string",
1075− "description": "The full path to the Instance resource in the API. Example: \"apps/myapp/modules/default/versions/v1/instances/instance-1\" @OutputOnly"
1075+ "description": "Full path to the Instance resource in the API. Example: `apps/myapp/modules/default/versions/v1/instances/instance-1`. @OutputOnly"
10761076 },
10771077 "id": {
10781078 "type": "string",
1079− "description": "The relative name/path of the instance within the version. Example: \"instance-1\" @OutputOnly"
1079+ "description": "Relative name of the instance within the version. Example: `instance-1`. @OutputOnly"
10801080 },
10811081 "appEngineRelease": {
10821082 "type": "string",
1083− "description": "The App Engine release the instance is running on. @OutputOnly"
1083+ "description": "App Engine release this instance is running on. @OutputOnly"
10841084 },
10851085 "availability": {
10861086 "type": "string",
1087− "description": "Availability of instance. @OutputOnly",
1087+ "description": "Availability of the instance. @OutputOnly",
10881088 "enum": [
10891089 "UNSPECIFIED",
10901090 "RESIDENT",
@@ -1093,65 +1093,88 @@
10931093 },
10941094 "vmName": {
10951095 "type": "string",
1096− "description": "For VMEngines instances, the name of GCE VM where the instance lives. @OutputOnly"
1096+ "description": "Name of the virtual machine where this instance lives. Only applicable for instances in App Engine flexible environment. @OutputOnly"
10971097 },
10981098 "vmZoneName": {
10991099 "type": "string",
1100− "description": "For VMEngines instances, the zone where the GCE VM is located. @OutputOnly"
1100+ "description": "Zone where the virtual machine is located. Only applicable for instances in App Engine flexible environment. @OutputOnly"
11011101 },
11021102 "vmId": {
11031103 "type": "string",
1104− "description": "For VMEngines instances, the GCE VM ID of the instance. @OutputOnly"
1104+ "description": "Virtual machine ID of this instance. Only applicable for instances in App Engine flexible environment. @OutputOnly"
11051105 },
11061106 "startTimestamp": {
11071107 "type": "string",
1108− "description": "Time when instance was started. @OutputOnly"
1108+ "description": "Time that this instance was started. @OutputOnly"
11091109 },
11101110 "requests": {
11111111 "type": "integer",
1112− "description": "Number of requests (since the clone was started). @OutputOnly",
1112+ "description": "Number of requests since this instance was started. @OutputOnly",
11131113 "format": "int32"
11141114 },
11151115 "errors": {
11161116 "type": "integer",
1117− "description": "Number of errors since the instance was started. @OutputOnly",
1117+ "description": "Number of errors since this instance was started. @OutputOnly",
11181118 "format": "uint32"
11191119 },
11201120 "qps": {
11211121 "type": "number",
1122− "description": "QPS for this instance (averaged over the last minute). @OutputOnly",
1122+ "description": "Average queries per second (QPS) over the last minute. @OutputOnly",
11231123 "format": "float"
11241124 },
11251125 "averageLatency": {
11261126 "type": "integer",
1127− "description": "Latency in milliseconds (averaged over the last minute). @OutputOnly",
1127+ "description": "Average latency (ms) over the last minute. @OutputOnly",
11281128 "format": "int32"
11291129 },
11301130 "memoryUsage": {
11311131 "type": "string",
1132− "description": "Memory usage (in bytes). @OutputOnly",
1132+ "description": "Total memory in use (bytes). @OutputOnly",
11331133 "format": "int64"
11341134 },
11351135 "vmStatus": {
11361136 "type": "string",
1137− "description": "For VMEngines instances, the status of GCE VM where the instance lives. @OutputOnly"
1137+ "description": "Status of the virtual machine where this instance lives. Only applicable for instances in App Engine flexible environment. @OutputOnly"
11381138 },
11391139 "vmUnlocked": {
11401140 "type": "boolean",
1141− "description": "For VMEngines instances, whether the instance has been unlocked. @OutputOnly"
1141+ "description": "Whether this instance is in debug mode. Only applicable for instances in App Engine flexible environment. @OutputOnly"
11421142 }
11431143 }
11441144 },
1145− "ListOperationsResponse": {
1146− "id": "ListOperationsResponse",
1145+ "ListInstancesResponse": {
1146+ "id": "ListInstancesResponse",
11471147 "type": "object",
1148− "description": "The response message for Operations.ListOperations.",
1148+ "description": "Response message for `Instances.ListInstances`.",
11491149 "properties": {
1150− "operations": {
1150+ "instances": {
11511151 "type": "array",
1152− "description": "A list of operations that matches the specified filter in the request.",
1152+ "description": "The instances belonging to the requested version.",
11531153 "items": {
1154− "$ref": "Operation"
1154+ "$ref": "Instance"
1155+ }
1156+ },
1157+ "nextPageToken": {
1158+ "type": "string",
1159+ "description": "Continuation token for fetching the next page of results."
1160+ }
1161+ }
1162+ },
1163+ "DebugInstanceRequest": {
1164+ "id": "DebugInstanceRequest",
1165+ "type": "object",
1166+ "description": "Request message for `Instances.DebugInstance`."
1167+ },
1168+ "ListLocationsResponse": {
1169+ "id": "ListLocationsResponse",
1170+ "type": "object",
1171+ "description": "The response message for LocationService.ListLocations.",
1172+ "properties": {
1173+ "locations": {
1174+ "type": "array",
1175+ "description": "A list of locations that matches the specified filter in the request.",
1176+ "items": {
1177+ "$ref": "Location"
11551178 }
11561179 },
11571180 "nextPageToken": {
@@ -1160,6 +1183,36 @@
11601183 }
11611184 }
11621185 },
1186+ "Location": {
1187+ "id": "Location",
1188+ "type": "object",
1189+ "description": "A resource that represents Google Cloud Platform location.",
1190+ "properties": {
1191+ "name": {
1192+ "type": "string",
1193+ "description": "Resource name for the location, which may vary between implementations. For example: `\"projects/example-project/locations/us-east1\"`"
1194+ },
1195+ "locationId": {
1196+ "type": "string",
1197+ "description": "The canonical id for this location. For example: `\"us-east1\"`."
1198+ },
1199+ "labels": {
1200+ "type": "object",
1201+ "description": "Cross-service attributes for the location. For example {\"cloud.googleapis.com/region\": \"us-east1\"}",
1202+ "additionalProperties": {
1203+ "type": "string"
1204+ }
1205+ },
1206+ "metadata": {
1207+ "type": "object",
1208+ "description": "Service-specific metadata. For example the available capacity at the given location.",
1209+ "additionalProperties": {
1210+ "type": "any",
1211+ "description": "Properties of the object. Contains field @type with type URL."
1212+ }
1213+ }
1214+ }
1215+ },
11631216 "OperationMetadata": {
11641217 "id": "OperationMetadata",
11651218 "type": "object",
@@ -1167,27 +1220,27 @@
11671220 "properties": {
11681221 "operationType": {
11691222 "type": "string",
1170− "description": "The type of the operation (deprecated, use method field instead). Example: \"create_version\". @OutputOnly"
1223+ "description": "Type of this operation. Deprecated, use method field instead. Example: \"create_version\". @OutputOnly"
11711224 },
11721225 "insertTime": {
11731226 "type": "string",
1174− "description": "Timestamp that this operation was received. @OutputOnly"
1227+ "description": "Timestamp that this operation was created. @OutputOnly"
11751228 },
11761229 "endTime": {
11771230 "type": "string",
1178− "description": "Timestamp that this operation was completed. (Not present if the operation is still in progress.) @OutputOnly"
1231+ "description": "Timestamp that this operation completed. @OutputOnly"
11791232 },
11801233 "user": {
11811234 "type": "string",
1182− "description": "The user who requested this operation. @OutputOnly"
1235+ "description": "User who requested this operation. @OutputOnly"
11831236 },
11841237 "target": {
11851238 "type": "string",
1186− "description": "Resource that this operation is acting on. Example: \"apps/myapp/modules/default\". @OutputOnly"
1239+ "description": "Name of the resource that this operation is acting on. Example: `apps/myapp/modules/default`. @OutputOnly"
11871240 },
11881241 "method": {
11891242 "type": "string",
1190− "description": "API method name that initiated the operation. Example: \"google.appengine.v1beta4.Version.CreateVersion\". @OutputOnly"
1243+ "description": "API method that initiated this operation. Example: `google.appengine.v1beta4.Version.CreateVersion`. @OutputOnly"
11911244 }
11921245 }
11931246 },
@@ -1198,23 +1251,65 @@
11981251 "properties": {
11991252 "method": {
12001253 "type": "string",
1201− "description": "API method name that initiated the operation. Example: \"google.appengine.v1beta5.Version.CreateVersion\". @OutputOnly"
1254+ "description": "API method name that initiated this operation. Example: `google.appengine.v1beta5.Version.CreateVersion`. @OutputOnly"
12021255 },
12031256 "insertTime": {
12041257 "type": "string",
1205− "description": "Timestamp that this operation was received. @OutputOnly"
1258+ "description": "Timestamp that this operation was created. @OutputOnly"
12061259 },
12071260 "endTime": {
12081261 "type": "string",
1209− "description": "Timestamp that this operation was completed. (Not present if the operation is still in progress.) @OutputOnly"
1262+ "description": "Timestamp that this operation completed. @OutputOnly"
12101263 },
12111264 "user": {
12121265 "type": "string",
1213− "description": "The user who requested this operation. @OutputOnly"
1266+ "description": "User who requested this operation. @OutputOnly"
12141267 },
12151268 "target": {
12161269 "type": "string",
1217− "description": "Resource that this operation is acting on. Example: \"apps/myapp/services/default\". @OutputOnly"
1270+ "description": "Name of the resource that this operation is acting on. Example: `apps/myapp/services/default`. @OutputOnly"
1271+ }
1272+ }
1273+ },
1274+ "OperationMetadataV1": {
1275+ "id": "OperationMetadataV1",
1276+ "type": "object",
1277+ "description": "Metadata for the given google.longrunning.Operation.",
1278+ "properties": {
1279+ "method": {
1280+ "type": "string",
1281+ "description": "API method that initiated this operation. Example: `google.appengine.v1.Versions.CreateVersion`. @OutputOnly"
1282+ },
1283+ "insertTime": {
1284+ "type": "string",
1285+ "description": "Time that this operation was created. @OutputOnly"
1286+ },
1287+ "endTime": {
1288+ "type": "string",
1289+ "description": "Time that this operation completed. @OutputOnly"
1290+ },
1291+ "user": {
1292+ "type": "string",
1293+ "description": "User who requested this operation. @OutputOnly"
1294+ },
1295+ "target": {
1296+ "type": "string",
1297+ "description": "Name of the resource that this operation is acting on. Example: `apps/myapp/services/default`. @OutputOnly"
1298+ }
1299+ }
1300+ },
1301+ "LocationMetadata": {
1302+ "id": "LocationMetadata",
1303+ "type": "object",
1304+ "description": "Metadata for the given google.cloud.location.Location.",
1305+ "properties": {
1306+ "standardEnvironmentAvailable": {
1307+ "type": "boolean",
1308+ "description": "App Engine Standard Environment is available in the given location. @OutputOnly"
1309+ },
1310+ "flexibleEnvironmentAvailable": {
1311+ "type": "boolean",
1312+ "description": "App Engine Flexible Environment is available in the given location. @OutputOnly"
12181313 }
12191314 }
12201315 }
@@ -1222,6 +1317,21 @@
12221317 "resources": {
12231318 "apps": {
12241319 "methods": {
1320+ "create": {
1321+ "id": "appengine.apps.create",
1322+ "path": "v1beta4/apps",
1323+ "httpMethod": "POST",
1324+ "description": "Creates an App Engine application for a Google Cloud Platform project. This requires a project that excludes an App Engine application. For details about creating a project without an application, see the [Google Cloud Resource Manager create project topic](https://cloud.google.com/resource-manager/docs/creating-project).",
1325+ "request": {
1326+ "$ref": "Application"
1327+ },
1328+ "response": {
1329+ "$ref": "Operation"
1330+ },
1331+ "scopes": [
1332+ "https://www.googleapis.com/auth/cloud-platform"
1333+ ]
1334+ },
12251335 "get": {
12261336 "id": "appengine.apps.get",
12271337 "path": "v1beta4/apps/{appsId}",
@@ -1230,7 +1340,7 @@
12301340 "parameters": {
12311341 "appsId": {
12321342 "type": "string",
1233− "description": "Part of `name`. Name of the application to get. For example: \"apps/myapp\".",
1343+ "description": "Part of `name`. Name of the application to get. Example: `apps/myapp`.",
12341344 "required": true,
12351345 "location": "path"
12361346 },
@@ -1249,20 +1359,124 @@
12491359 "scopes": [
12501360 "https://www.googleapis.com/auth/cloud-platform"
12511361 ]
1362+ },
1363+ "patch": {
1364+ "id": "appengine.apps.patch",
1365+ "path": "v1beta4/apps/{appsId}",
1366+ "httpMethod": "PATCH",
1367+ "description": "Updates application parameters.",
1368+ "parameters": {
1369+ "appsId": {
1370+ "type": "string",
1371+ "description": "Part of `name`. Name of the application to update. For example: \"apps/myapp\".",
1372+ "required": true,
1373+ "location": "path"
1374+ },
1375+ "mask": {
1376+ "type": "string",
1377+ "description": "Standard field mask for the set of fields to be updated.",
1378+ "location": "query"
1379+ }
1380+ },
1381+ "parameterOrder": [
1382+ "appsId"
1383+ ],
1384+ "request": {
1385+ "$ref": "Application"
1386+ },
1387+ "response": {
1388+ "$ref": "Operation"
1389+ },
1390+ "scopes": [
1391+ "https://www.googleapis.com/auth/cloud-platform"
1392+ ]
12521393 }
12531394 },
12541395 "resources": {
1396+ "operations": {
1397+ "methods": {
1398+ "get": {
1399+ "id": "appengine.apps.operations.get",
1400+ "path": "v1beta4/apps/{appsId}/operations/{operationsId}",
1401+ "httpMethod": "GET",
1402+ "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.",
1403+ "parameters": {
1404+ "appsId": {
1405+ "type": "string",
1406+ "description": "Part of `name`. The name of the operation resource.",
1407+ "required": true,
1408+ "location": "path"
1409+ },
1410+ "operationsId": {
1411+ "type": "string",
1412+ "description": "Part of `name`. See documentation of `appsId`.",
1413+ "required": true,
1414+ "location": "path"
1415+ }
1416+ },
1417+ "parameterOrder": [
1418+ "appsId",
1419+ "operationsId"
1420+ ],
1421+ "response": {
1422+ "$ref": "Operation"
1423+ },
1424+ "scopes": [
1425+ "https://www.googleapis.com/auth/cloud-platform"
1426+ ]
1427+ },
1428+ "list": {
1429+ "id": "appengine.apps.operations.list",
1430+ "path": "v1beta4/apps/{appsId}/operations",
1431+ "httpMethod": "GET",
1432+ "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name` binding below allows API services to override the binding to use different resource name schemes, such as `users/*/operations`.",
1433+ "parameters": {
1434+ "appsId": {
1435+ "type": "string",
1436+ "description": "Part of `name`. The name of the operation collection.",
1437+ "required": true,
1438+ "location": "path"
1439+ },
1440+ "filter": {
1441+ "type": "string",
1442+ "description": "The standard list filter.",
1443+ "location": "query"
1444+ },
1445+ "pageSize": {
1446+ "type": "integer",
1447+ "description": "The standard list page size.",
1448+ "format": "int32",
1449+ "location": "query"
1450+ },
1451+ "pageToken": {
1452+ "type": "string",
1453+ "description": "The standard list page token.",
1454+ "location": "query"
1455+ }
1456+ },
1457+ "parameterOrder": [
1458+ "appsId"
1459+ ],
1460+ "response": {
1461+ "$ref": "ListOperationsResponse"
1462+ },
1463+ "scopes": [
1464+ "https://www.googleapis.com/auth/cloud-platform"
1465+ ]
1466+ }
1467+ }
1468+ },
12551469 "modules": {
12561470 "methods": {
12571471 "delete": {
12581472 "id": "appengine.apps.modules.delete",
12591473 "path": "v1beta4/apps/{appsId}/modules/{modulesId}",
12601474 "httpMethod": "DELETE",
1261− "description": "Deletes a module and all enclosed versions.",
1475+ "description": "Deletes the specified module and all enclosed versions.",
12621476 "parameters": {
12631477 "appsId": {
12641478 "type": "string",
1265− "description": "Part of `name`. Name of the resource requested. For example: \"apps/myapp/modules/default\".",
1479+ "description": "Part of `name`. Name of the resource requested. Example: `apps/myapp/modules/default`.",
12661480 "required": true,
12671481 "location": "path"
12681482 },
@@ -1288,11 +1502,11 @@
12881502 "id": "appengine.apps.modules.get",
12891503 "path": "v1beta4/apps/{appsId}/modules/{modulesId}",
12901504 "httpMethod": "GET",
1291− "description": "Gets the current configuration of the module.",
1505+ "description": "Gets the current configuration of the specified module.",
12921506 "parameters": {
12931507 "appsId": {
12941508 "type": "string",
1295− "description": "Part of `name`. Name of the resource requested. For example: \"apps/myapp/modules/default\".",
1509+ "description": "Part of `name`. Name of the resource requested. Example: `apps/myapp/modules/default`.",
12961510 "required": true,
12971511 "location": "path"
12981512 },
@@ -1322,7 +1536,7 @@
13221536 "parameters": {
13231537 "appsId": {
13241538 "type": "string",
1325− "description": "Part of `name`. Name of the resource requested. For example: \"apps/myapp\".",
1539+ "description": "Part of `name`. Name of the resource requested. Example: `apps/myapp`.",
13261540 "required": true,
13271541 "location": "path"
13281542 },
@@ -1356,7 +1570,7 @@
13561570 "parameters": {
13571571 "appsId": {
13581572 "type": "string",
1359− "description": "Part of `name`. Name of the resource to update. For example: \"apps/myapp/modules/default\".",
1573+ "description": "Part of `name`. Name of the resource to update. Example: `apps/myapp/modules/default`.",
13601574 "required": true,
13611575 "location": "path"
13621576 },
@@ -1373,7 +1587,7 @@
13731587 },
13741588 "migrateTraffic": {
13751589 "type": "boolean",
1376− "description": "Whether to use Traffic Migration to shift traffic gradually. Traffic can only be migrated from a single version to another single version.",
1590+ "description": "Set to `true` to gradually shift traffic from one version to another single version. By default, traffic is shifted immediately. For gradual traffic migration, the target version must be located within instances that are configured for both [warmup requests](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta4/apps.modules.versions#inboundservicetype) and [automatic scaling](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta4/apps.modules.versions#automaticscaling). You must specify the [`shardBy`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta4/apps.modules#shardby) field in the Module resource. Gradual traffic migration is not supported in the App Engine flexible environment. For examples, see [Migrating and Splitting Traffic](https://cloud.google.com/appengine/docs/admin-api/migrating-splitting-traffic).",
13771591 "location": "query"
13781592 }
13791593 },
@@ -1399,11 +1613,11 @@
13991613 "id": "appengine.apps.modules.versions.create",
14001614 "path": "v1beta4/apps/{appsId}/modules/{modulesId}/versions",
14011615 "httpMethod": "POST",
1402− "description": "Deploys new code and resource files to a version.",
1616+ "description": "Deploys code and resource files to a new version.",
14031617 "parameters": {
14041618 "appsId": {
14051619 "type": "string",
1406− "description": "Part of `name`. Name of the resource to update. For example: \"apps/myapp/modules/default\".",
1620+ "description": "Part of `name`. Name of the resource to update. Example: `apps/myapp/modules/default`.",
14071621 "required": true,
14081622 "location": "path"
14091623 },
@@ -1436,7 +1650,7 @@
14361650 "parameters": {
14371651 "appsId": {
14381652 "type": "string",
1439− "description": "Part of `name`. Name of the resource requested. For example: \"apps/myapp/modules/default/versions/v1\".",
1653+ "description": "Part of `name`. Name of the resource requested. Example: `apps/myapp/modules/default/versions/v1`.",
14401654 "required": true,
14411655 "location": "path"
14421656 },
@@ -1469,11 +1683,11 @@
14691683 "id": "appengine.apps.modules.versions.get",
14701684 "path": "v1beta4/apps/{appsId}/modules/{modulesId}/versions/{versionsId}",
14711685 "httpMethod": "GET",
1472− "description": "Gets application deployment information.",
1686+ "description": "Gets the specified Version resource. By default, only a `BASIC_VIEW` will be returned. Specify the `FULL_VIEW` parameter to get the full resource.",
14731687 "parameters": {
14741688 "appsId": {
14751689 "type": "string",
1476− "description": "Part of `name`. Name of the resource requested. For example: \"apps/myapp/modules/default/versions/v1\".",
1690+ "description": "Part of `name`. Name of the resource requested. Example: `apps/myapp/modules/default/versions/v1`.",
14771691 "required": true,
14781692 "location": "path"
14791693 },
@@ -1519,7 +1733,7 @@
15191733 "parameters": {
15201734 "appsId": {
15211735 "type": "string",
1522− "description": "Part of `name`. Name of the resource requested. For example: \"apps/myapp/modules/default\".",
1736+ "description": "Part of `name`. Name of the resource requested. Example: `apps/myapp/modules/default`.",
15231737 "required": true,
15241738 "location": "path"
15251739 },
@@ -1565,11 +1779,11 @@
15651779 "id": "appengine.apps.modules.versions.patch",
15661780 "path": "v1beta4/apps/{appsId}/modules/{modulesId}/versions/{versionsId}",
15671781 "httpMethod": "PATCH",
1568− "description": "Updates an existing version. Note: UNIMPLEMENTED.",
1782+ "description": "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: * [`serving_status`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta4/apps.modules.versions#Version.FIELDS.serving_status): For Version resources that use basic scaling, manual scaling, or run in the App Engine flexible environment. * [`instance_class`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta4/apps.modules.versions#Version.FIELDS.instance_class): For Version resources that run in the App Engine standard environment. * [`automatic_scaling.min_idle_instances`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta4/apps.modules.versions#Version.FIELDS.automatic_scaling): For Version resources that use automatic scaling and run in the App Engine standard environment. * [`automatic_scaling.max_idle_instances`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta4/apps.modules.versions#Version.FIELDS.automatic_scaling): For Version resources that use automatic scaling and run in the App Engine standard environment.",
15691783 "parameters": {
15701784 "appsId": {
15711785 "type": "string",
1572− "description": "Part of `name`. Name of the resource to update. For example: \"apps/myapp/modules/default/versions/1\".",
1786+ "description": "Part of `name`. Name of the resource to update. Example: `apps/myapp/modules/default/versions/1`.",
15731787 "required": true,
15741788 "location": "path"
15751789 },
@@ -1610,6 +1824,94 @@
16101824 "resources": {
16111825 "instances": {
16121826 "methods": {
1827+ "delete": {
1828+ "id": "appengine.apps.modules.versions.instances.delete",
1829+ "path": "v1beta4/apps/{appsId}/modules/{modulesId}/versions/{versionsId}/instances/{instancesId}",
1830+ "httpMethod": "DELETE",
1831+ "description": "Stops a running instance.",
1832+ "parameters": {
1833+ "appsId": {
1834+ "type": "string",
1835+ "description": "Part of `name`. Name of the resource requested. Example: `apps/myapp/modules/default/versions/v1/instances/instance-1`.",
1836+ "required": true,
1837+ "location": "path"
1838+ },
1839+ "modulesId": {
1840+ "type": "string",
1841+ "description": "Part of `name`. See documentation of `appsId`.",
1842+ "required": true,
1843+ "location": "path"
1844+ },
1845+ "versionsId": {
1846+ "type": "string",
1847+ "description": "Part of `name`. See documentation of `appsId`.",
1848+ "required": true,
1849+ "location": "path"
1850+ },
1851+ "instancesId": {
1852+ "type": "string",
1853+ "description": "Part of `name`. See documentation of `appsId`.",
1854+ "required": true,
1855+ "location": "path"
1856+ }
1857+ },
1858+ "parameterOrder": [
1859+ "appsId",
1860+ "modulesId",
1861+ "versionsId",
1862+ "instancesId"
1863+ ],
1864+ "response": {
1865+ "$ref": "Operation"
1866+ },
1867+ "scopes": [
1868+ "https://www.googleapis.com/auth/cloud-platform"
1869+ ]
1870+ },
1871+ "get": {
1872+ "id": "appengine.apps.modules.versions.instances.get",
1873+ "path": "v1beta4/apps/{appsId}/modules/{modulesId}/versions/{versionsId}/instances/{instancesId}",
1874+ "httpMethod": "GET",
1875+ "description": "Gets instance information.",
1876+ "parameters": {
1877+ "appsId": {
1878+ "type": "string",
1879+ "description": "Part of `name`. Name of the resource requested. Example: `apps/myapp/modules/default/versions/v1/instances/instance-1`.",
1880+ "required": true,
1881+ "location": "path"
1882+ },
1883+ "modulesId": {
1884+ "type": "string",
1885+ "description": "Part of `name`. See documentation of `appsId`.",
1886+ "required": true,
1887+ "location": "path"
1888+ },
1889+ "versionsId": {
1890+ "type": "string",
1891+ "description": "Part of `name`. See documentation of `appsId`.",
1892+ "required": true,
1893+ "location": "path"
1894+ },
1895+ "instancesId": {
1896+ "type": "string",
1897+ "description": "Part of `name`. See documentation of `appsId`.",
1898+ "required": true,
1899+ "location": "path"
1900+ }
1901+ },
1902+ "parameterOrder": [
1903+ "appsId",
1904+ "modulesId",
1905+ "versionsId",
1906+ "instancesId"
1907+ ],
1908+ "response": {
1909+ "$ref": "Instance"
1910+ },
1911+ "scopes": [
1912+ "https://www.googleapis.com/auth/cloud-platform"
1913+ ]
1914+ },
16131915 "list": {
16141916 "id": "appengine.apps.modules.versions.instances.list",
16151917 "path": "v1beta4/apps/{appsId}/modules/{modulesId}/versions/{versionsId}/instances",
@@ -1618,7 +1920,7 @@
16181920 "parameters": {
16191921 "appsId": {
16201922 "type": "string",
1621− "description": "Part of `name`. Name of the resource requested. For example: \"apps/myapp/modules/default/versions/v1\".",
1923+ "description": "Part of `name`. Name of the resource requested. Example: `apps/myapp/modules/default/versions/v1`.",
16221924 "required": true,
16231925 "location": "path"
16241926 },
@@ -1657,6 +1959,53 @@
16571959 "scopes": [
16581960 "https://www.googleapis.com/auth/cloud-platform"
16591961 ]
1962+ },
1963+ "debug": {
1964+ "id": "appengine.apps.modules.versions.instances.debug",
1965+ "path": "v1beta4/apps/{appsId}/modules/{modulesId}/versions/{versionsId}/instances/{instancesId}:debug",
1966+ "httpMethod": "POST",
1967+ "description": "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.",
1968+ "parameters": {
1969+ "appsId": {
1970+ "type": "string",
1971+ "description": "Part of `name`. Name of the resource requested. Example: `apps/myapp/modules/default/versions/v1/instances/instance-1`.",
1972+ "required": true,
1973+ "location": "path"
1974+ },
1975+ "modulesId": {
1976+ "type": "string",
1977+ "description": "Part of `name`. See documentation of `appsId`.",
1978+ "required": true,
1979+ "location": "path"
1980+ },
1981+ "versionsId": {
1982+ "type": "string",
1983+ "description": "Part of `name`. See documentation of `appsId`.",
1984+ "required": true,
1985+ "location": "path"
1986+ },
1987+ "instancesId": {
1988+ "type": "string",
1989+ "description": "Part of `name`. See documentation of `appsId`.",
1990+ "required": true,
1991+ "location": "path"
1992+ }
1993+ },
1994+ "parameterOrder": [
1995+ "appsId",
1996+ "modulesId",
1997+ "versionsId",
1998+ "instancesId"
1999+ ],
2000+ "request": {
2001+ "$ref": "DebugInstanceRequest"
2002+ },
2003+ "response": {
2004+ "$ref": "Operation"
2005+ },
2006+ "scopes": [
2007+ "https://www.googleapis.com/auth/cloud-platform"
2008+ ]
16602009 }
16612010 }
16622011 }
@@ -1664,72 +2013,72 @@
16642013 }
16652014 }
16662015 },
1667− "operations": {
2016+ "locations": {
16682017 "methods": {
1669− "get": {
1670− "id": "appengine.apps.operations.get",
1671− "path": "v1beta4/apps/{appsId}/operations/{operationsId}",
2018+ "list": {
2019+ "id": "appengine.apps.locations.list",
2020+ "path": "v1beta4/apps/{appsId}/locations",
16722021 "httpMethod": "GET",
1673− "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.",
2022+ "description": "Lists information about the supported locations for this service.",
16742023 "parameters": {
16752024 "appsId": {
16762025 "type": "string",
1677− "description": "Part of `name`. The name of the operation resource.",
2026+ "description": "Part of `name`. The resource that owns the locations collection, if applicable.",
16782027 "required": true,
16792028 "location": "path"
16802029 },
1681− "operationsId": {
2030+ "filter": {
16822031 "type": "string",
1683− "description": "Part of `name`. See documentation of `appsId`.",
1684− "required": true,
1685− "location": "path"
2032+ "description": "The standard list filter.",
2033+ "location": "query"
2034+ },
2035+ "pageSize": {
2036+ "type": "integer",
2037+ "description": "The standard list page size.",
2038+ "format": "int32",
2039+ "location": "query"
2040+ },
2041+ "pageToken": {
2042+ "type": "string",
2043+ "description": "The standard list page token.",
2044+ "location": "query"
16862045 }
16872046 },
16882047 "parameterOrder": [
1689− "appsId",
1690− "operationsId"
2048+ "appsId"
16912049 ],
16922050 "response": {
1693− "$ref": "Operation"
2051+ "$ref": "ListLocationsResponse"
16942052 },
16952053 "scopes": [
16962054 "https://www.googleapis.com/auth/cloud-platform"
16972055 ]
16982056 },
1699− "list": {
1700− "id": "appengine.apps.operations.list",
1701− "path": "v1beta4/apps/{appsId}/operations",
2057+ "get": {
2058+ "id": "appengine.apps.locations.get",
2059+ "path": "v1beta4/apps/{appsId}/locations/{locationsId}",
17022060 "httpMethod": "GET",
1703− "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name` binding below allows API services to override the binding to use different resource name schemes, such as `users/*/operations`.",
2061+ "description": "Get information about a location.",
17042062 "parameters": {
17052063 "appsId": {
17062064 "type": "string",
1707− "description": "Part of `name`. The name of the operation collection.",
2065+ "description": "Part of `name`. Resource name for the location.",
17082066 "required": true,
17092067 "location": "path"
17102068 },
1711− "filter": {
1712− "type": "string",
1713− "description": "The standard list filter.",
1714− "location": "query"
1715− },
1716− "pageSize": {
1717− "type": "integer",
1718− "description": "The standard list page size.",
1719− "format": "int32",
1720− "location": "query"
1721− },
1722− "pageToken": {
2069+ "locationsId": {
17232070 "type": "string",
1724− "description": "The standard list page token.",
1725− "location": "query"
2071+ "description": "Part of `name`. See documentation of `appsId`.",
2072+ "required": true,
2073+ "location": "path"
17262074 }
17272075 },
17282076 "parameterOrder": [
1729− "appsId"
2077+ "appsId",
2078+ "locationsId"
17302079 ],
17312080 "response": {
1732− "$ref": "ListOperationsResponse"
2081+ "$ref": "Location"
17332082 },
17342083 "scopes": [
17352084 "https://www.googleapis.com/auth/cloud-platform"
gen/model/appengine/v1beta5/appengine-api.json+541−192
@@ -1,11 +1,11 @@
11{
22 "kind": "discovery#restDescription",
3− "etag": "\"jQLIOHBVnDZie4rQHGH1WJF-INE/uGRAIMczbUMx-blIXv0SXiGStRQ\"",
3+ "etag": "\"C5oy1hgQsABtYOYIOXWcR3BgYqU/0qciQsoN0Vvlij82hTLNL1WfFOU\"",
44 "discoveryVersion": "v1",
55 "id": "appengine:v1beta5",
66 "name": "appengine",
77 "version": "v1beta5",
8− "revision": "20160407",
8+ "revision": "20161012",
99 "title": "Google App Engine Admin API",
1010 "description": "Provisions and manages App Engine applications.",
1111 "ownerDomain": "google.com",
@@ -124,7 +124,7 @@
124124 "description": "Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.",
125125 "additionalProperties": {
126126 "type": "any",
127− "description": "Properties of the object. Contains field @ype with type URL."
127+ "description": "Properties of the object. Contains field @type with type URL."
128128 }
129129 },
130130 "done": {
@@ -140,7 +140,7 @@
140140 "description": "The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.",
141141 "additionalProperties": {
142142 "type": "any",
143− "description": "Properties of the object. Contains field @ype with type URL."
143+ "description": "Properties of the object. Contains field @type with type URL."
144144 }
145145 }
146146 }
@@ -166,7 +166,7 @@
166166 "type": "object",
167167 "additionalProperties": {
168168 "type": "any",
169− "description": "Properties of the object. Contains field @ype with type URL."
169+ "description": "Properties of the object. Contains field @type with type URL."
170170 }
171171 }
172172 }
@@ -193,46 +193,46 @@
193193 "Application": {
194194 "id": "Application",
195195 "type": "object",
196− "description": "An Application contains the top-level configuration of an App Engine application.",
196+ "description": "An Application resource contains the top-level configuration of an App Engine application.",
197197 "properties": {
198198 "name": {
199199 "type": "string",
200− "description": "The full path to the application in the API. Example: \"apps/myapp\". @OutputOnly"
200+ "description": "Full path to the Application resource in the API. Example: `apps/myapp`. @OutputOnly"
201201 },
202202 "id": {
203203 "type": "string",
204− "description": "The relative name/path of the application. Example: \"myapp\"."
204+ "description": "Identifier of the Application resource. This identifier is equivalent to the project ID of the Google Cloud Platform project where you want to deploy your application. Example: `myapp`."
205205 },
206206 "dispatchRules": {
207207 "type": "array",
208− "description": "HTTP path dispatch rules for requests to the app that do not explicitly target a service or version. The rules are order-dependent. @OutputOnly",
208+ "description": "HTTP path dispatch rules for requests to the application that do not explicitly target a service or version. Rules are order-dependent. @OutputOnly",
209209 "items": {
210210 "$ref": "UrlDispatchRule"
211211 }
212212 },
213213 "authDomain": {
214214 "type": "string",
215− "description": "If set, only users from the specified Google Apps authentication domain may access the application. If not set, any Google Account may access the application."
215+ "description": "Google Apps authentication domain that controls which users can access this application. Defaults to open access for any Google Account."
216216 },
217217 "location": {
218218 "type": "string",
219− "description": "The location from which the application will be run. Application instances will run out of data centers in the chosen location and all of the application's End User Content will be stored at rest. The default is \"us-central\". Choices are: \"us-central\" - Central US \"europe-west\" - Western Europe \"us-east1\" - Eastern US"
219+ "description": "Location from which this application will be run. Application instances will run out of data centers in the chosen location, which is also where all of the application's end user content is stored. Defaults to `us-central`. Options are: `us-central` - Central US `europe-west` - Western Europe `us-east1` - Eastern US"
220220 },
221221 "codeBucket": {
222222 "type": "string",
223− "description": "A Google Cloud Storage bucket which can be used for storing files associated with an application. This bucket is associated with the application and can be used by the gcloud deployment commands. @OutputOnly"
223+ "description": "A Google Cloud Storage bucket that can be used for storing files associated with this application. This bucket is associated with the application and can be used by the gcloud deployment commands. @OutputOnly"
224224 },
225225 "defaultCookieExpiration": {
226226 "type": "string",
227− "description": "Determines the cookie expiration policy for the application. @OutputOnly"
227+ "description": "Cookie expiration policy for this application. @OutputOnly"
228228 },
229229 "defaultHostname": {
230230 "type": "string",
231− "description": "The hostname used to reach the application, as resolved by App Engine. @OutputOnly"
231+ "description": "Hostname used to reach the application, as resolved by App Engine. @OutputOnly"
232232 },
233233 "defaultBucket": {
234234 "type": "string",
235− "description": "A Google Cloud Storage bucket which can be used by the application to store content. @OutputOnly"
235+ "description": "A Google Cloud Storage bucket that can be used by the application to store content. @OutputOnly"
236236 }
237237 }
238238 },
@@ -243,34 +243,34 @@
243243 "properties": {
244244 "domain": {
245245 "type": "string",
246− "description": "The domain name to match on. Supports '*' (glob) wildcarding on the left-hand side of a '.'. If empty, all domains will be matched (the same as '*')."
246+ "description": "Domain name to match against. The wildcard \"`*`\" is supported if specified before a period: \"`*.`\". Defaults to matching all domains: \"`*`\"."
247247 },
248248 "path": {
249249 "type": "string",
250− "description": "The pathname within the host. This must start with a '/'. A single '*' (glob) can be included at the end of the path. The sum of the lengths of the domain and path may not exceed 100 characters."
250+ "description": "Pathname within the host. Must start with a \"`/`\". A single \"`*`\" can be included at the end of the path. The sum of the lengths of the domain and path may not exceed 100 characters."
251251 },
252252 "service": {
253253 "type": "string",
254− "description": "The resource id of a Service in this application that should service the matched request. The Service must already exist. Example: \"default\"."
254+ "description": "Resource id of a service in this application that should serve the matched request. The service must already exist. Example: `default`."
255255 }
256256 }
257257 },
258258 "Version": {
259259 "id": "Version",
260260 "type": "object",
261− "description": "A Version is a specific set of source code and configuration files deployed to a service.",
261+ "description": "A Version resource is a specific set of source code and configuration files that are deployed into a service.",
262262 "properties": {
263263 "name": {
264264 "type": "string",
265− "description": "The full path to the Version resource in the API. Example: \"apps/myapp/services/default/versions/v1\". @OutputOnly"
265+ "description": "Full path to the Version resource in the API. Example: `apps/myapp/services/default/versions/v1`. @OutputOnly"
266266 },
267267 "id": {
268268 "type": "string",
269− "description": "The relative name/path of the Version within the service. Example: \"v1\". Version specifiers can contain lowercase letters, digits, and hyphens. It cannot begin with the prefix `ah-` and the names `default` and `latest` are reserved and cannot be used."
269+ "description": "Relative name of the version within the module. Example: `v1`. Version names can contain only lowercase letters, numbers, or hyphens. Reserved names: \"default\", \"latest\", and any name with the prefix \"ah-\"."
270270 },
271271 "automaticScaling": {
272272 "$ref": "AutomaticScaling",
273− "description": "Automatic scaling is the scaling policy that App Engine has used since its inception. It is based on request rate, response latencies, and other application metrics."
273+ "description": "Automatic scaling is based on request rate, response latencies, and other application metrics."
274274 },
275275 "basicScaling": {
276276 "$ref": "BasicScaling",
@@ -286,7 +286,7 @@
286286 "enumDescriptions": [
287287 "Not specified.",
288288 "Allows an application to receive mail.",
289− "Allows an application receive email bound notifications.",
289+ "Allows an application to receive email-bound notifications.",
290290 "Allows an application to receive error stanzas.",
291291 "Allows an application to receive instant messages.",
292292 "Allows an application to receive user subscription POSTs.",
@@ -311,42 +311,42 @@
311311 },
312312 "instanceClass": {
313313 "type": "string",
314− "description": "The instance class to use to run this app. Valid values for AutomaticScaling are `[F1, F2, F4, F4_1G]`. Valid values for ManualScaling and BasicScaling are `[B1, B2, B4, B8, B4_1G]`. Default: \"F1\" for AutomaticScaling, \"B1\" for ManualScaling and BasicScaling"
314+ "description": "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."
315315 },
316316 "network": {
317317 "$ref": "Network",
318− "description": "Used to specify extra network settings (for VM runtimes only)."
318+ "description": "Extra network settings. Only applicable for VM runtimes."
319319 },
320320 "resources": {
321321 "$ref": "Resources",
322− "description": "Used to specify how many machine resources an app version needs (for VM runtimes only)."
322+ "description": "Machine resources for this version. Only applicable for VM runtimes."
323323 },
324324 "runtime": {
325325 "type": "string",
326− "description": "The desired runtime. Values can include python27, java7, go, etc."
326+ "description": "Desired runtime. Example: `python27`."
327327 },
328328 "threadsafe": {
329329 "type": "boolean",
330− "description": "If true, multiple requests can be dispatched to the app at once."
330+ "description": "Whether multiple requests can be dispatched to this version at once."
331331 },
332332 "vm": {
333333 "type": "boolean",
334− "description": "Whether to deploy this app in a VM container."
334+ "description": "Whether to deploy this version in a container on a virtual machine."
335335 },
336336 "betaSettings": {
337337 "type": "object",
338− "description": "Beta settings supplied to the application via metadata.",
338+ "description": "Metadata settings that are supplied to this version to enable beta runtime features.",
339339 "additionalProperties": {
340340 "type": "string"
341341 }
342342 },
343343 "env": {
344344 "type": "string",
345− "description": "The App Engine execution environment to use for this version. Default: \"1\""
345+ "description": "App Engine execution environment to use for this version. Defaults to `1`."
346346 },
347347 "servingStatus": {
348348 "type": "string",
349− "description": "The current serving status of this version. Only `SERVING` versions will have instances created or billed for. If this field is unset when a version is created, `SERVING` status will be assumed. It is an error to explicitly set this field to `SERVING_STATUS_UNSPECIFIED`.",
349+ "description": "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`.",
350350 "enum": [
351351 "SERVING_STATUS_UNSPECIFIED",
352352 "SERVING",
@@ -355,11 +355,11 @@
355355 },
356356 "deployer": {
357357 "type": "string",
358− "description": "The email address of the user who created this version. @OutputOnly"
358+ "description": "Email address of the user who created this version. @OutputOnly"
359359 },
360360 "creationTime": {
361361 "type": "string",
362− "description": "Creation time of this version. This will be between the start and end times of the operation that creates this version. @OutputOnly"
362+ "description": "Time that this version was created. @OutputOnly"
363363 },
364364 "diskUsageBytes": {
365365 "type": "string",
@@ -368,62 +368,62 @@
368368 },
369369 "handlers": {
370370 "type": "array",
371− "description": "An ordered list of URL Matching patterns that should be applied to incoming requests. The first matching URL consumes the request, and subsequent handlers are not attempted. Only returned in `GET` requests if `view=FULL` is set. May only be set on create requests; once created, is immutable.",
371+ "description": "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.",
372372 "items": {
373373 "$ref": "UrlMap"
374374 }
375375 },
376376 "errorHandlers": {
377377 "type": "array",
378− "description": "Custom static error pages instead of these generic error pages, (limit 10 KB/page) Only returned in `GET` requests if `view=FULL` is set. May only be set on create requests; once created, is immutable.",
378+ "description": "Custom static error pages. Limited to 10KB per page. Only returned in `GET` requests if `view=FULL` is set.",
379379 "items": {
380380 "$ref": "ErrorHandler"
381381 }
382382 },
383383 "libraries": {
384384 "type": "array",
385− "description": "Configuration for Python runtime third-party libraries required by the application. Only returned in `GET` requests if `view=FULL` is set. May only be set on create requests; once created, is immutable.",
385+ "description": "Configuration for third-party Python runtime libraries required by the application. Only returned in `GET` requests if `view=FULL` is set.",
386386 "items": {
387387 "$ref": "Library"
388388 }
389389 },
390390 "apiConfig": {
391391 "$ref": "ApiConfigHandler",
392− "description": "Serving configuration for Google Cloud Endpoints. Only returned in `GET` requests if `view=FULL` is set. May only be set on create requests; once created, is immutable."
392+ "description": "Serving configuration for [Google Cloud Endpoints](https://cloud.google.com/appengine/docs/python/endpoints/). Only returned in `GET` requests if `view=FULL` is set."
393393 },
394394 "envVariables": {
395395 "type": "object",
396− "description": "Environment variables made available to the application. Only returned in `GET` requests if `view=FULL` is set. May only be set on create requests; once created, is immutable.",
396+ "description": "Environment variables made available to the application. Only returned in `GET` requests if `view=FULL` is set.",
397397 "additionalProperties": {
398398 "type": "string"
399399 }
400400 },
401401 "defaultExpiration": {
402402 "type": "string",
403− "description": "The length of time a static file served by a static file handler ought to be cached by web proxies and browsers, if the handler does not specify its own expiration. Only returned in `GET` requests if `view=FULL` is set. May only be set on create requests; once created, is immutable."
403+ "description": "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."
404404 },
405405 "healthCheck": {
406406 "$ref": "HealthCheck",
407− "description": "Configure health checking for the VM instances. Unhealthy VM instances will be stopped and replaced with new instances. Only returned in `GET` requests if `view=FULL` is set. May only be set on create requests; once created, is immutable."
407+ "description": "Configures health checking for VM instances. Unhealthy instances are be stopped and replaced with new instances. Only applicable for VM runtimes. Only returned in `GET` requests if `view=FULL` is set."
408408 },
409409 "nobuildFilesRegex": {
410410 "type": "string",
411− "description": "Go only. Files that match this pattern will not be built into the app. May only be set on create requests."
411+ "description": "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."
412412 },
413413 "deployment": {
414414 "$ref": "Deployment",
415− "description": "Code and application artifacts that make up this version. Only returned in `GET` requests if `view=FULL` is set. May only be set on create requests; once created, is immutable."
415+ "description": "Code and application artifacts that make up this version. Only returned in `GET` requests if `view=FULL` is set."
416416 }
417417 }
418418 },
419419 "AutomaticScaling": {
420420 "id": "AutomaticScaling",
421421 "type": "object",
422− "description": "Automatic scaling is the scaling policy that App Engine has used since its inception. It is based on request rate, response latencies, and other application metrics.",
422+ "description": "Automatic scaling is based on request rate, response latencies, and other application metrics.",
423423 "properties": {
424424 "coolDownPeriod": {
425425 "type": "string",
426− "description": "The amount of time that the [Autoscaler](https://cloud.google.com/compute/docs/autoscaler/) should wait between changes to the number of virtual machines. Applies only to the VM runtime."
426+ "description": "Amount of time that the [Autoscaler](https://cloud.google.com/compute/docs/autoscaler/) should wait between changes to the number of virtual machines. Only applicable for VM runtimes."
427427 },
428428 "cpuUtilization": {
429429 "$ref": "CpuUtilization",
@@ -431,36 +431,36 @@
431431 },
432432 "maxConcurrentRequests": {
433433 "type": "integer",
434− "description": "The number of concurrent requests an automatic scaling instance can accept before the scheduler spawns a new instance. Default value is chosen based on the runtime.",
434+ "description": "Number of concurrent requests an automatic scaling instance can accept before the scheduler spawns a new instance. Defaults to a runtime-specific value.",
435435 "format": "int32"
436436 },
437437 "maxIdleInstances": {
438438 "type": "integer",
439− "description": "The maximum number of idle instances that App Engine should maintain for this version.",
439+ "description": "Maximum number of idle instances that should be maintained for this version.",
440440 "format": "int32"
441441 },
442442 "maxTotalInstances": {
443443 "type": "integer",
444− "description": "Max number of instances that App Engine should start to handle requests.",
444+ "description": "Maximum number of instances that should be started to handle requests.",
445445 "format": "int32"
446446 },
447447 "maxPendingLatency": {
448448 "type": "string",
449− "description": "The maximum amount of time that App Engine should allow a request to wait in the pending queue before starting a new instance to handle it."
449+ "description": "Maximum amount of time that a request should wait in the pending queue before starting a new instance to handle it."
450450 },
451451 "minIdleInstances": {
452452 "type": "integer",
453− "description": "The minimum number of idle instances that App Engine should maintain for this version. Only applies to the default version of a service, since other versions are not expected to receive significant traffic.",
453+ "description": "Minimum number of idle instances that should be maintained for this version. Only applicable for the default version of a module.",
454454 "format": "int32"
455455 },
456456 "minTotalInstances": {
457457 "type": "integer",
458− "description": "Minimum number of instances that App Engine should maintain.",
458+ "description": "Minimum number of instances that should be maintained for this version.",
459459 "format": "int32"
460460 },
461461 "minPendingLatency": {
462462 "type": "string",
463− "description": "The minimum amount of time that App Engine should allow a request to wait in the pending queue before starting a new instance to handle it."
463+ "description": "Minimum amount of time a request should wait in the pending queue before starting a new instance to handle it."
464464 },
465465 "requestUtilization": {
466466 "$ref": "RequestUtilization",
@@ -483,11 +483,11 @@
483483 "properties": {
484484 "aggregationWindowLength": {
485485 "type": "string",
486− "description": "The period of time over which CPU utilization is calculated."
486+ "description": "Period of time over which CPU utilization is calculated."
487487 },
488488 "targetUtilization": {
489489 "type": "number",
490− "description": "Target (0-1) CPU utilization ratio to maintain when scaling.",
490+ "description": "Target CPU utilization ratio to maintain when scaling. Must be between 0 and 1.",
491491 "format": "double"
492492 }
493493 }
@@ -495,7 +495,7 @@
495495 "RequestUtilization": {
496496 "id": "RequestUtilization",
497497 "type": "object",
498− "description": "Target scaling by request utilization (for VM runtimes only).",
498+ "description": "Target scaling by request utilization. Only applicable for VM runtimes.",
499499 "properties": {
500500 "targetRequestCountPerSec": {
501501 "type": "integer",
@@ -512,26 +512,26 @@
512512 "DiskUtilization": {
513513 "id": "DiskUtilization",
514514 "type": "object",
515− "description": "Target scaling by disk usage (for VM runtimes only).",
515+ "description": "Target scaling by disk usage. Only applicable for VM runtimes.",
516516 "properties": {
517517 "targetWriteBytesPerSec": {
518518 "type": "integer",
519− "description": "Target bytes per second written.",
519+ "description": "Target bytes written per second.",
520520 "format": "int32"
521521 },
522522 "targetWriteOpsPerSec": {
523523 "type": "integer",
524− "description": "Target ops per second written.",
524+ "description": "Target ops written per second.",
525525 "format": "int32"
526526 },
527527 "targetReadBytesPerSec": {
528528 "type": "integer",
529− "description": "Target bytes per second read.",
529+ "description": "Target bytes read per second.",
530530 "format": "int32"
531531 },
532532 "targetReadOpsPerSec": {
533533 "type": "integer",
534− "description": "Target ops per second read.",
534+ "description": "Target ops read per second.",
535535 "format": "int32"
536536 }
537537 }
@@ -539,26 +539,26 @@
539539 "NetworkUtilization": {
540540 "id": "NetworkUtilization",
541541 "type": "object",
542− "description": "Target scaling by network usage (for VM runtimes only).",
542+ "description": "Target scaling by network usage. Only applicable for VM runtimes.",
543543 "properties": {
544544 "targetSentBytesPerSec": {
545545 "type": "integer",
546− "description": "Target bytes per second sent.",
546+ "description": "Target bytes sent per second.",
547547 "format": "int32"
548548 },
549549 "targetSentPacketsPerSec": {
550550 "type": "integer",
551− "description": "Target packets per second sent.",
551+ "description": "Target packets sent per second.",
552552 "format": "int32"
553553 },
554554 "targetReceivedBytesPerSec": {
555555 "type": "integer",
556− "description": "Target bytes per second received.",
556+ "description": "Target bytes received per second.",
557557 "format": "int32"
558558 },
559559 "targetReceivedPacketsPerSec": {
560560 "type": "integer",
561− "description": "Target packets per second received.",
561+ "description": "Target packets received per second.",
562562 "format": "int32"
563563 }
564564 }
@@ -570,11 +570,11 @@
570570 "properties": {
571571 "idleTimeout": {
572572 "type": "string",
573− "description": "The instance will be shut down this amount of time after receiving its last request."
573+ "description": "Duration of time after the last request that an instance must wait before the instance is shut down."
574574 },
575575 "maxInstances": {
576576 "type": "integer",
577− "description": "The maximum number of instances for App Engine to create for this version.",
577+ "description": "Maximum number of instances to create for this version.",
578578 "format": "int32"
579579 }
580580 }
@@ -586,7 +586,7 @@
586586 "properties": {
587587 "instances": {
588588 "type": "integer",
589− "description": "The number of instances to assign to the service at the start. This number can later be altered by using the [Modules API](https://cloud.google.com/appengine/docs/python/modules/functions) `set_num_instances()` function.",
589+ "description": "Number of instances to assign to the service at the start. This number can later be altered by using the [Modules API](https://cloud.google.com/appengine/docs/python/modules/functions) `set_num_instances()` function.",
590590 "format": "int32"
591591 }
592592 }
@@ -594,43 +594,43 @@
594594 "Network": {
595595 "id": "Network",
596596 "type": "object",
597− "description": "Used to specify extra network settings (for VM runtimes only).",
597+ "description": "Extra network settings. Only applicable for VM runtimes.",
598598 "properties": {
599599 "forwardedPorts": {
600600 "type": "array",
601− "description": "A list of ports (or port pairs) to forward from the VM into the app container.",
601+ "description": "List of ports, or port pairs, to forward from the virtual machine to the application container.",
602602 "items": {
603603 "type": "string"
604604 }
605605 },
606606 "instanceTag": {
607607 "type": "string",
608− "description": "A tag to apply to the VM instance during creation."
608+ "description": "Tag to apply to the VM instance during creation."
609609 },
610610 "name": {
611611 "type": "string",
612− "description": "The Google Compute Engine network where the VMs will be created. If not specified, or empty, the network named \"default\" will be used. (The short name should be specified, not the resource path.)"
612+ "description": "Google Cloud Platform network where the virtual machines are created. Specify the short name, not the resource path. Defaults to `default`."
613613 }
614614 }
615615 },
616616 "Resources": {
617617 "id": "Resources",
618618 "type": "object",
619− "description": "Used to specify how many machine resources an app version needs.",
619+ "description": "Machine resources for a version.",
620620 "properties": {
621621 "cpu": {
622622 "type": "number",
623− "description": "How many CPU cores an app version needs.",
623+ "description": "Number of CPU cores needed.",
624624 "format": "double"
625625 },
626626 "diskGb": {
627627 "type": "number",
628− "description": "How much disk size, in GB, an app version needs.",
628+ "description": "Disk size (GB) needed.",
629629 "format": "double"
630630 },
631631 "memoryGb": {
632632 "type": "number",
633− "description": "How much memory, in GB, an app version needs.",
633+ "description": "Memory (GB) needed.",
634634 "format": "double"
635635 }
636636 }
@@ -638,11 +638,11 @@
638638 "UrlMap": {
639639 "id": "UrlMap",
640640 "type": "object",
641− "description": "A URL pattern and description of how it should be handled. App Engine can handle URLs by executing application code, or by serving static files uploaded with the code, such as images, CSS or JavaScript.",
641+ "description": "URL pattern and description of how the URL should be handled. App Engine can handle URLs by executing application code, or by serving static files uploaded with the version, such as images, CSS, or JavaScript.",
642642 "properties": {
643643 "urlRegex": {
644644 "type": "string",
645− "description": "A URL prefix. This value uses regular expression syntax (and so regexp special characters must be escaped), but it should not contain groupings. All URLs that begin with this prefix are handled by this handler, using the portion of the URL after the prefix as part of the file path. This is always required."
645+ "description": "A URL prefix. Uses regular expression syntax, which means regexp special characters must be escaped, but should not contain groupings. All URLs that begin with this prefix are handled by this handler, using the portion of the URL after the prefix as part of the file path."
646646 },
647647 "staticFiles": {
648648 "$ref": "StaticFilesHandler",
@@ -650,15 +650,15 @@
650650 },
651651 "script": {
652652 "$ref": "ScriptHandler",
653− "description": "Executes a script to handle the request that matches the URL pattern."
653+ "description": "Executes a script to handle the request that matches this URL pattern."
654654 },
655655 "apiEndpoint": {
656656 "$ref": "ApiEndpointHandler",
657− "description": "Use API Endpoints to handle requests."
657+ "description": "Uses API Endpoints to handle requests."
658658 },
659659 "securityLevel": {
660660 "type": "string",
661− "description": "Configures whether security (HTTPS) should be enforced for this URL.",
661+ "description": "Security (HTTPS) enforcement for this URL.",
662662 "enum": [
663663 "SECURE_UNSPECIFIED",
664664 "SECURE_DEFAULT",
@@ -669,7 +669,7 @@
669669 },
670670 "login": {
671671 "type": "string",
672− "description": "What level of login is required to access this resource.",
672+ "description": "Level of login required to access this resource.",
673673 "enum": [
674674 "LOGIN_UNSPECIFIED",
675675 "LOGIN_OPTIONAL",
@@ -679,7 +679,7 @@
679679 },
680680 "authFailAction": {
681681 "type": "string",
682− "description": "For users not logged in, how to handle access to resources with required login. Defaults to \"redirect\".",
682+ "description": "Action to take when users access resources that require authentication. Defaults to `redirect`.",
683683 "enum": [
684684 "AUTH_FAIL_ACTION_UNSPECIFIED",
685685 "AUTH_FAIL_ACTION_REDIRECT",
@@ -688,7 +688,7 @@
688688 },
689689 "redirectHttpResponseCode": {
690690 "type": "string",
691− "description": "`30x` code to use when performing redirects for the `secure` field. A `302` is used by default.",
691+ "description": "`30x` code to use when performing redirects for the `secure` field. Defaults to `302`.",
692692 "enum": [
693693 "REDIRECT_HTTP_RESPONSE_CODE_UNSPECIFIED",
694694 "REDIRECT_HTTP_RESPONSE_CODE_301",
@@ -706,11 +706,11 @@
706706 "properties": {
707707 "path": {
708708 "type": "string",
709− "description": "The path to the static files matched by the URL pattern, from the application root directory. The path can refer to text matched in groupings in the URL pattern."
709+ "description": "Path to the static files matched by the URL pattern, from the application root directory. The path can refer to text matched in groupings in the URL pattern."
710710 },
711711 "uploadPathRegex": {
712712 "type": "string",
713− "description": "A regular expression that matches the file paths for all files that will be referenced by this handler."
713+ "description": "Regular expression that matches the file paths for all files that should be referenced by this handler."
714714 },
715715 "httpHeaders": {
716716 "type": "object",
@@ -721,19 +721,19 @@
721721 },
722722 "mimeType": {
723723 "type": "string",
724− "description": "If specified, all files served by this handler will be served using the specified MIME type. If not specified, the MIME type for a file will be derived from the file's filename extension."
724+ "description": "MIME type used to serve all files served by this handler. Defaults to file-specific MIME types, which are derived from each file's filename extension."
725725 },
726726 "expiration": {
727727 "type": "string",
728− "description": "The length of time a static file served by this handler ought to be cached by web proxies and browsers."
728+ "description": "Time a static file served by this handler should be cached."
729729 },
730730 "requireMatchingFile": {
731731 "type": "boolean",
732− "description": "If true, this UrlMap entry does not match the request unless the file referenced by the handler also exists. If no such file exists, processing will continue with the next UrlMap that matches the requested URL."
732+ "description": "Whether this handler should match the request if the file referenced by the handler does not exist."
733733 },
734734 "applicationReadable": {
735735 "type": "boolean",
736− "description": "By default, files declared in static file handlers are uploaded as static data and are only served to end users, they cannot be read by an application. If this field is set to true, the files are also uploaded as code data so your application can read them. Both uploads are charged against your code and static data storage resource quotas."
736+ "description": "Whether files should also be uploaded as code data. By default, files declared in static file handlers are uploaded as static data and are only served to end users; they cannot be read by the application. If enabled, uploads are charged against both your code and static data storage resource quotas."
737737 }
738738 }
739739 },
@@ -744,29 +744,29 @@
744744 "properties": {
745745 "scriptPath": {
746746 "type": "string",
747− "description": "Specifies the path to the script from the application root directory."
747+ "description": "Path to the script from the application root directory."
748748 }
749749 }
750750 },
751751 "ApiEndpointHandler": {
752752 "id": "ApiEndpointHandler",
753753 "type": "object",
754− "description": "Use Google Cloud Endpoints to handle requests.",
754+ "description": "Uses Google Cloud Endpoints to handle requests.",
755755 "properties": {
756756 "scriptPath": {
757757 "type": "string",
758− "description": "Specifies the path to the script from the application root directory."
758+ "description": "Path to the script from the application root directory."
759759 }
760760 }
761761 },
762762 "ErrorHandler": {
763763 "id": "ErrorHandler",
764764 "type": "object",
765− "description": "A custom static error page to be served when an error occurs.",
765+ "description": "Custom static error page to be served when an error occurs.",
766766 "properties": {
767767 "errorCode": {
768768 "type": "string",
769− "description": "The error condition this handler applies to.",
769+ "description": "Error condition this handler applies to.",
770770 "enum": [
771771 "ERROR_CODE_UNSPECIFIED",
772772 "ERROR_CODE_DEFAULT",
@@ -781,33 +781,33 @@
781781 },
782782 "mimeType": {
783783 "type": "string",
784− "description": "MIME type of file. If unspecified, \"text/html\" is assumed."
784+ "description": "MIME type of file. Defaults to `text/html`."
785785 }
786786 }
787787 },
788788 "Library": {
789789 "id": "Library",
790790 "type": "object",
791− "description": "A Python runtime third-party library required by the application.",
791+ "description": "Third-party Python runtime library that is required by the application.",
792792 "properties": {
793793 "name": {
794794 "type": "string",
795− "description": "The name of the library, e.g. \"PIL\" or \"django\"."
795+ "description": "Name of the library. Example: \"django\"."
796796 },
797797 "version": {
798798 "type": "string",
799− "description": "The version of the library to select, or \"latest\"."
799+ "description": "Version of the library to select, or \"latest\"."
800800 }
801801 }
802802 },
803803 "ApiConfigHandler": {
804804 "id": "ApiConfigHandler",
805805 "type": "object",
806− "description": "API Serving configuration for Cloud Endpoints.",
806+ "description": "[Google Cloud Endpoints](https://cloud.google.com/appengine/docs/python/endpoints/) configuration for API handlers.",
807807 "properties": {
808808 "authFailAction": {
809809 "type": "string",
810− "description": "For users not logged in, how to handle access to resources with required login. Defaults to \"redirect\".",
810+ "description": "Action to take when users access resources that require authentication. Defaults to `redirect`.",
811811 "enum": [
812812 "AUTH_FAIL_ACTION_UNSPECIFIED",
813813 "AUTH_FAIL_ACTION_REDIRECT",
@@ -816,7 +816,7 @@
816816 },
817817 "login": {
818818 "type": "string",
819− "description": "What level of login is required to access this resource. Default is \"optional\".",
819+ "description": "Level of login required to access this resource. Defaults to `optional`.",
820820 "enum": [
821821 "LOGIN_UNSPECIFIED",
822822 "LOGIN_OPTIONAL",
@@ -826,11 +826,11 @@
826826 },
827827 "script": {
828828 "type": "string",
829− "description": "Specifies the path to the script from the application root directory."
829+ "description": "Path to the script from the application root directory."
830830 },
831831 "securityLevel": {
832832 "type": "string",
833− "description": "Configures whether security (HTTPS) should be enforced for this URL.",
833+ "description": "Security (HTTPS) enforcement for this URL.",
834834 "enum": [
835835 "SECURE_UNSPECIFIED",
836836 "SECURE_DEFAULT",
@@ -848,7 +848,7 @@
848848 "HealthCheck": {
849849 "id": "HealthCheck",
850850 "type": "object",
851− "description": "Configure health checking for the VM instances. Unhealthy VM instances will be killed and replaced with new instances.",
851+ "description": "Health checking configuration for VM instances. Unhealthy instances are killed and replaced with new instances. Only applicable for instances in App Engine flexible environment.",
852852 "properties": {
853853 "disableHealthCheck": {
854854 "type": "boolean",
@@ -856,30 +856,30 @@
856856 },
857857 "host": {
858858 "type": "string",
859− "description": "The host header to send when performing an HTTP health check (e.g. myapp.appspot.com)"
859+ "description": "Host header to send when performing an HTTP health check. Example: \"myapp.appspot.com\""
860860 },
861861 "healthyThreshold": {
862862 "type": "integer",
863− "description": "The number of consecutive successful health checks before receiving traffic.",
863+ "description": "Number of consecutive successful health checks required before receiving traffic.",
864864 "format": "uint32"
865865 },
866866 "unhealthyThreshold": {
867867 "type": "integer",
868− "description": "The number of consecutive failed health checks before removing traffic.",
868+ "description": "Number of consecutive failed health checks required before removing traffic.",
869869 "format": "uint32"
870870 },
871871 "restartThreshold": {
872872 "type": "integer",
873− "description": "The number of consecutive failed health checks before an instance is restarted.",
873+ "description": "Number of consecutive failed health checks required before an instance is restarted.",
874874 "format": "uint32"
875875 },
876876 "checkInterval": {
877877 "type": "string",
878− "description": "The interval between health checks."
878+ "description": "Interval between health checks."
879879 },
880880 "timeout": {
881881 "type": "string",
882− "description": "The amount of time before the health check is considered failed."
882+ "description": "Time before the health check is considered failed."
883883 }
884884 }
885885 },
@@ -890,18 +890,18 @@
890890 "properties": {
891891 "files": {
892892 "type": "object",
893− "description": "A manifest of files stored in Google Cloud Storage which should be included as part of this application. All files must be readable using the credentials supplied with this call.",
893+ "description": "Manifest of the files stored in Google Cloud Storage that are included as part of this version. All files must be readable using the credentials supplied with this call.",
894894 "additionalProperties": {
895895 "$ref": "FileInfo"
896896 }
897897 },
898898 "container": {
899899 "$ref": "ContainerInfo",
900− "description": "If supplied, a docker (container) image which should be used to start the application. Only applicable to the 'vm' runtime."
900+ "description": "A Docker image that App Engine uses the run the version. Only applicable for instances in App Engine flexible environment."
901901 },
902902 "sourceReferences": {
903903 "type": "array",
904− "description": "The origin of the source code for this deployment. There can be more than one source reference per Version if source code is distributed among multiple repositories.",
904+ "description": "Origin of the source code for this deployment. There can be more than one source reference per version if source code is distributed among multiple repositories.",
905905 "items": {
906906 "$ref": "SourceReference"
907907 }
@@ -911,45 +911,45 @@
911911 "FileInfo": {
912912 "id": "FileInfo",
913913 "type": "object",
914− "description": "A single source file which is part of the application to be deployed.",
914+ "description": "Single source file that is part of the version to be deployed. Each source file that is deployed must be specified separately.",
915915 "properties": {
916916 "sourceUrl": {
917917 "type": "string",
918− "description": "The URL source to use to fetch this file. Must be a URL to a resource in Google Cloud Storage in the form 'http(s)://storage.googleapis.com/\\/\\'."
918+ "description": "URL source to use to fetch this file. Must be a URL to a resource in Google Cloud Storage in the form 'http(s)://storage.googleapis.com/\\/\\'."
919919 },
920920 "sha1Sum": {
921921 "type": "string",
922− "description": "The SHA1 (160 bits) hash of the file in hex."
922+ "description": "The SHA1 hash of the file, in hex."
923923 },
924924 "mimeType": {
925925 "type": "string",
926− "description": "The MIME type of the file; if unspecified, the value from Google Cloud Storage will be used."
926+ "description": "The MIME type of the file. Defaults to the value from Google Cloud Storage."
927927 }
928928 }
929929 },
930930 "ContainerInfo": {
931931 "id": "ContainerInfo",
932932 "type": "object",
933− "description": "A Docker (container) image which should be used to start the application.",
933+ "description": "Docker image that is used to start a VM container for the version you deploy.",
934934 "properties": {
935935 "image": {
936936 "type": "string",
937− "description": "Reference to a hosted container image. Must be a URI to a resource in a Docker repository. Must be fully qualified, including tag or digest. e.g. gcr.io/my-project/image:tag or gcr.io/my-project/image@digest"
937+ "description": "URI to the hosted container image in a Docker repository. The URI must be fully qualified and include a tag or digest. Examples: \"gcr.io/my-project/image:tag\" or \"gcr.io/my-project/image@digest\""
938938 }
939939 }
940940 },
941941 "SourceReference": {
942942 "id": "SourceReference",
943943 "type": "object",
944− "description": "A reference to a particular snapshot of the source tree used to build and deploy the application.",
944+ "description": "Reference to a particular snapshot of the source tree used to build and deploy the application.",
945945 "properties": {
946946 "repository": {
947947 "type": "string",
948− "description": "Optional. A URI string identifying the repository. Example: \"https://source.developers.google.com/p/app-123/r/default\""
948+ "description": "URI string identifying the repository. Example: \"https://source.developers.google.com/p/app-123/r/default\""
949949 },
950950 "revisionId": {
951951 "type": "string",
952− "description": "The canonical (and persistent) identifier of the deployed revision, i.e. any kind of aliases including tags or branch names are not allowed. Example (git): \"2198322f89e0bb2e25021667c2ed489d1fd34e6b\""
952+ "description": "The canonical, persistent identifier of the deployed revision. Aliases that include tags or branch names are not allowed. Example (git): \"2198322f89e0bb2e25021667c2ed489d1fd34e6b\""
953953 }
954954 }
955955 },
@@ -960,7 +960,7 @@
960960 "properties": {
961961 "versions": {
962962 "type": "array",
963− "description": "The versions belonging to the requested application service.",
963+ "description": "The versions belonging to the requested service.",
964964 "items": {
965965 "$ref": "Version"
966966 }
@@ -974,30 +974,30 @@
974974 "Service": {
975975 "id": "Service",
976976 "type": "object",
977− "description": "A service is a logical component of an application that can share state and communicate in a secure fashion with other services. For example, an application that handles customer requests might include separate services to handle other tasks such as API requests from mobile devices or backend data analysis. Each service has a collection of versions that define a specific set of code used to implement the functionality of that service.",
977+ "description": "A Service resource is a logical component of an application that can share state and communicate in a secure fashion with other services. For example, an application that handles customer requests might include separate services to handle other tasks such as API requests from mobile devices or backend data analysis. Each service has a collection of versions that define a specific set of code used to implement the functionality of that service.",
978978 "properties": {
979979 "name": {
980980 "type": "string",
981− "description": "The full path to the Service resource in the API. Example: \"apps/myapp/services/default\" @OutputOnly"
981+ "description": "Full path to the Service resource in the API. Example: `apps/myapp/services/default`. @OutputOnly"
982982 },
983983 "id": {
984984 "type": "string",
985− "description": "The relative name/path of the service within the application. Example: \"default\" @OutputOnly"
985+ "description": "Relative name of the service within the application. Example: `default`. @OutputOnly"
986986 },
987987 "split": {
988988 "$ref": "TrafficSplit",
989− "description": "A mapping that defines fractional HTTP traffic diversion to different versions within the service."
989+ "description": "Mapping that defines fractional HTTP traffic diversion to different versions within the service."
990990 }
991991 }
992992 },
993993 "TrafficSplit": {
994994 "id": "TrafficSplit",
995995 "type": "object",
996− "description": "Configuration for traffic splitting for versions within a single service. Traffic splitting allows traffic directed to the service to be assigned to one of several versions in a fractional way, enabling experiments and canarying new builds, for example.",
996+ "description": "Traffic routing configuration for versions within a single service. Traffic splits define how traffic directed to the service is assigned to versions.",
997997 "properties": {
998998 "shardBy": {
999999 "type": "string",
1000− "description": "Which mechanism should be used as a selector when choosing a version to send a request to. The traffic selection algorithm will be stable for either type until allocations are changed.",
1000+ "description": "Mechanism used to determine which version a request is sent to. The traffic selection algorithm will be stable for either type until allocations are changed.",
10011001 "enum": [
10021002 "UNSPECIFIED",
10031003 "COOKIE",
@@ -1006,7 +1006,7 @@
10061006 },
10071007 "allocations": {
10081008 "type": "object",
1009− "description": "Mapping from service version IDs within the service to fractional (0.000, 1] allocations of traffic for that version. Each version may only be specified once, but some versions in the service may not have any traffic allocation. Services that have traffic allocated in this field may not be deleted until the service is deleted, or their traffic allocation is removed. Allocations must sum to 1. Supports precision up to two decimal places for IP-based splits and up to three decimal places for cookie-based splits.",
1009+ "description": "Mapping from version IDs within the service to fractional (0.000, 1] allocations of traffic for that version. Each version can be specified only once, but some versions in the service may not have any traffic allocation. Services that have traffic allocated cannot be deleted until either the service is deleted or their traffic allocation is removed. Allocations must sum to 1. Up to two decimal place precision is supported for IP-based splits and up to three decimal places is supported for cookie-based splits.",
10101010 "additionalProperties": {
10111011 "type": "number",
10121012 "format": "double"
@@ -1032,44 +1032,26 @@
10321032 }
10331033 }
10341034 },
1035− "ListInstancesResponse": {
1036− "id": "ListInstancesResponse",
1037− "type": "object",
1038− "description": "Response message for `Instances.ListInstances`.",
1039− "properties": {
1040− "instances": {
1041− "type": "array",
1042− "description": "The instances belonging to the requested version.",
1043− "items": {
1044− "$ref": "Instance"
1045− }
1046− },
1047− "nextPageToken": {
1048− "type": "string",
1049− "description": "Continuation token for fetching the next page of results."
1050− }
1051− }
1052− },
10531035 "Instance": {
10541036 "id": "Instance",
10551037 "type": "object",
1056− "description": "Instances are the computing units that App Engine uses to automatically scale an application.",
1038+ "description": "An Instance resource is the computing unit that App Engine uses to automatically scale an application.",
10571039 "properties": {
10581040 "name": {
10591041 "type": "string",
1060− "description": "The full path to the Instance resource in the API. Example: \"apps/myapp/services/default/versions/v1/instances/instance-1\" @OutputOnly"
1042+ "description": "Full path to the Instance resource in the API. Example: `apps/myapp/services/default/versions/v1/instances/instance-1`. @OutputOnly"
10611043 },
10621044 "id": {
10631045 "type": "string",
1064− "description": "The relative name/path of the instance within the version. Example: \"instance-1\" @OutputOnly"
1046+ "description": "Relative name of the instance within the version. Example: `instance-1`. @OutputOnly"
10651047 },
10661048 "appEngineRelease": {
10671049 "type": "string",
1068− "description": "The App Engine release the instance is running on. @OutputOnly"
1050+ "description": "App Engine release this instance is running on. @OutputOnly"
10691051 },
10701052 "availability": {
10711053 "type": "string",
1072− "description": "Availability of instance. @OutputOnly",
1054+ "description": "Availability of the instance. @OutputOnly",
10731055 "enum": [
10741056 "UNSPECIFIED",
10751057 "RESIDENT",
@@ -1078,52 +1060,123 @@
10781060 },
10791061 "vmName": {
10801062 "type": "string",
1081− "description": "For VMEngines instances, the name of GCE VM where the instance lives. @OutputOnly"
1063+ "description": "Name of the virtual machine where this instance lives. Only applicable for instances in App Engine flexible environment. @OutputOnly"
10821064 },
10831065 "vmZoneName": {
10841066 "type": "string",
1085− "description": "For VMEngines instances, the zone where the GCE VM is located. @OutputOnly"
1067+ "description": "Zone where the virtual machine is located. Only applicable for instances in App Engine flexible environment. @OutputOnly"
10861068 },
10871069 "vmId": {
10881070 "type": "string",
1089− "description": "For VMEngines instances, the GCE VM ID of the instance. @OutputOnly"
1071+ "description": "Virtual machine ID of this instance. Only applicable for instances in App Engine flexible environment. @OutputOnly"
10901072 },
10911073 "startTimestamp": {
10921074 "type": "string",
1093− "description": "Time when instance was started. @OutputOnly"
1075+ "description": "Time that this instance was started. @OutputOnly"
10941076 },
10951077 "requests": {
10961078 "type": "integer",
1097− "description": "Number of requests (since the clone was started). @OutputOnly",
1079+ "description": "Number of requests since this instance was started. @OutputOnly",
10981080 "format": "int32"
10991081 },
11001082 "errors": {
11011083 "type": "integer",
1102− "description": "Number of errors since the instance was started. @OutputOnly",
1084+ "description": "Number of errors since this instance was started. @OutputOnly",
11031085 "format": "uint32"
11041086 },
11051087 "qps": {
11061088 "type": "number",
1107− "description": "QPS for this instance (averaged over the last minute). @OutputOnly",
1089+ "description": "Average queries per second (QPS) over the last minute. @OutputOnly",
11081090 "format": "float"
11091091 },
11101092 "averageLatency": {
11111093 "type": "integer",
1112− "description": "Latency in milliseconds (averaged over the last minute). @OutputOnly",
1094+ "description": "Average latency (ms) over the last minute. @OutputOnly",
11131095 "format": "int32"
11141096 },
11151097 "memoryUsage": {
11161098 "type": "string",
1117− "description": "Memory usage (in bytes). @OutputOnly",
1099+ "description": "Total memory in use (bytes). @OutputOnly",
11181100 "format": "int64"
11191101 },
11201102 "vmStatus": {
11211103 "type": "string",
1122− "description": "For VMEngines instances, the status of GCE VM where the instance lives. @OutputOnly"
1104+ "description": "Status of the virtual machine where this instance lives. Only applicable for instances in App Engine flexible environment. @OutputOnly"
11231105 },
11241106 "vmUnlocked": {
11251107 "type": "boolean",
1126− "description": "For VMEngines instances, whether the instance has been unlocked. @OutputOnly"
1108+ "description": "Whether this instance is in debug mode. Only applicable for instances in App Engine flexible environment. @OutputOnly"
1109+ }
1110+ }
1111+ },
1112+ "ListInstancesResponse": {
1113+ "id": "ListInstancesResponse",
1114+ "type": "object",
1115+ "description": "Response message for `Instances.ListInstances`.",
1116+ "properties": {
1117+ "instances": {
1118+ "type": "array",
1119+ "description": "The instances belonging to the requested version.",
1120+ "items": {
1121+ "$ref": "Instance"
1122+ }
1123+ },
1124+ "nextPageToken": {
1125+ "type": "string",
1126+ "description": "Continuation token for fetching the next page of results."
1127+ }
1128+ }
1129+ },
1130+ "DebugInstanceRequest": {
1131+ "id": "DebugInstanceRequest",
1132+ "type": "object",
1133+ "description": "Request message for `Instances.DebugInstance`."
1134+ },
1135+ "ListLocationsResponse": {
1136+ "id": "ListLocationsResponse",
1137+ "type": "object",
1138+ "description": "The response message for LocationService.ListLocations.",
1139+ "properties": {
1140+ "locations": {
1141+ "type": "array",
1142+ "description": "A list of locations that matches the specified filter in the request.",
1143+ "items": {
1144+ "$ref": "Location"
1145+ }
1146+ },
1147+ "nextPageToken": {
1148+ "type": "string",
1149+ "description": "The standard List next-page token."
1150+ }
1151+ }
1152+ },
1153+ "Location": {
1154+ "id": "Location",
1155+ "type": "object",
1156+ "description": "A resource that represents Google Cloud Platform location.",
1157+ "properties": {
1158+ "name": {
1159+ "type": "string",
1160+ "description": "Resource name for the location, which may vary between implementations. For example: `\"projects/example-project/locations/us-east1\"`"
1161+ },
1162+ "locationId": {
1163+ "type": "string",
1164+ "description": "The canonical id for this location. For example: `\"us-east1\"`."
1165+ },
1166+ "labels": {
1167+ "type": "object",
1168+ "description": "Cross-service attributes for the location. For example {\"cloud.googleapis.com/region\": \"us-east1\"}",
1169+ "additionalProperties": {
1170+ "type": "string"
1171+ }
1172+ },
1173+ "metadata": {
1174+ "type": "object",
1175+ "description": "Service-specific metadata. For example the available capacity at the given location.",
1176+ "additionalProperties": {
1177+ "type": "any",
1178+ "description": "Properties of the object. Contains field @type with type URL."
1179+ }
11271180 }
11281181 }
11291182 },
@@ -1134,27 +1187,27 @@
11341187 "properties": {
11351188 "operationType": {
11361189 "type": "string",
1137− "description": "The type of the operation (deprecated, use method field instead). Example: \"create_version\". @OutputOnly"
1190+ "description": "Type of this operation. Deprecated, use method field instead. Example: \"create_version\". @OutputOnly"
11381191 },
11391192 "insertTime": {
11401193 "type": "string",
1141− "description": "Timestamp that this operation was received. @OutputOnly"
1194+ "description": "Timestamp that this operation was created. @OutputOnly"
11421195 },
11431196 "endTime": {
11441197 "type": "string",
1145− "description": "Timestamp that this operation was completed. (Not present if the operation is still in progress.) @OutputOnly"
1198+ "description": "Timestamp that this operation completed. @OutputOnly"
11461199 },
11471200 "user": {
11481201 "type": "string",
1149− "description": "The user who requested this operation. @OutputOnly"
1202+ "description": "User who requested this operation. @OutputOnly"
11501203 },
11511204 "target": {
11521205 "type": "string",
1153− "description": "Resource that this operation is acting on. Example: \"apps/myapp/modules/default\". @OutputOnly"
1206+ "description": "Name of the resource that this operation is acting on. Example: `apps/myapp/modules/default`. @OutputOnly"
11541207 },
11551208 "method": {
11561209 "type": "string",
1157− "description": "API method name that initiated the operation. Example: \"google.appengine.v1beta4.Version.CreateVersion\". @OutputOnly"
1210+ "description": "API method that initiated this operation. Example: `google.appengine.v1beta4.Version.CreateVersion`. @OutputOnly"
11581211 }
11591212 }
11601213 },
@@ -1165,23 +1218,65 @@
11651218 "properties": {
11661219 "method": {
11671220 "type": "string",
1168− "description": "API method name that initiated the operation. Example: \"google.appengine.v1beta5.Version.CreateVersion\". @OutputOnly"
1221+ "description": "API method name that initiated this operation. Example: `google.appengine.v1beta5.Version.CreateVersion`. @OutputOnly"
11691222 },
11701223 "insertTime": {
11711224 "type": "string",
1172− "description": "Timestamp that this operation was received. @OutputOnly"
1225+ "description": "Timestamp that this operation was created. @OutputOnly"
11731226 },
11741227 "endTime": {
11751228 "type": "string",
1176− "description": "Timestamp that this operation was completed. (Not present if the operation is still in progress.) @OutputOnly"
1229+ "description": "Timestamp that this operation completed. @OutputOnly"
11771230 },
11781231 "user": {
11791232 "type": "string",
1180− "description": "The user who requested this operation. @OutputOnly"
1233+ "description": "User who requested this operation. @OutputOnly"
11811234 },
11821235 "target": {
11831236 "type": "string",
1184− "description": "Resource that this operation is acting on. Example: \"apps/myapp/services/default\". @OutputOnly"
1237+ "description": "Name of the resource that this operation is acting on. Example: `apps/myapp/services/default`. @OutputOnly"
1238+ }
1239+ }
1240+ },
1241+ "OperationMetadataV1": {
1242+ "id": "OperationMetadataV1",
1243+ "type": "object",
1244+ "description": "Metadata for the given google.longrunning.Operation.",
1245+ "properties": {
1246+ "method": {
1247+ "type": "string",
1248+ "description": "API method that initiated this operation. Example: `google.appengine.v1.Versions.CreateVersion`. @OutputOnly"
1249+ },
1250+ "insertTime": {
1251+ "type": "string",
1252+ "description": "Time that this operation was created. @OutputOnly"
1253+ },
1254+ "endTime": {
1255+ "type": "string",
1256+ "description": "Time that this operation completed. @OutputOnly"
1257+ },
1258+ "user": {
1259+ "type": "string",
1260+ "description": "User who requested this operation. @OutputOnly"
1261+ },
1262+ "target": {
1263+ "type": "string",
1264+ "description": "Name of the resource that this operation is acting on. Example: `apps/myapp/services/default`. @OutputOnly"
1265+ }
1266+ }
1267+ },
1268+ "LocationMetadata": {
1269+ "id": "LocationMetadata",
1270+ "type": "object",
1271+ "description": "Metadata for the given google.cloud.location.Location.",
1272+ "properties": {
1273+ "standardEnvironmentAvailable": {
1274+ "type": "boolean",
1275+ "description": "App Engine Standard Environment is available in the given location. @OutputOnly"
1276+ },
1277+ "flexibleEnvironmentAvailable": {
1278+ "type": "boolean",
1279+ "description": "App Engine Flexible Environment is available in the given location. @OutputOnly"
11851280 }
11861281 }
11871282 }
@@ -1189,6 +1284,21 @@
11891284 "resources": {
11901285 "apps": {
11911286 "methods": {
1287+ "create": {
1288+ "id": "appengine.apps.create",
1289+ "path": "v1beta5/apps",
1290+ "httpMethod": "POST",
1291+ "description": "Creates an App Engine application for a Google Cloud Platform project. This requires a project that excludes an App Engine application. For details about creating a project without an application, see the [Google Cloud Resource Manager create project topic](https://cloud.google.com/resource-manager/docs/creating-project).",
1292+ "request": {
1293+ "$ref": "Application"
1294+ },
1295+ "response": {
1296+ "$ref": "Operation"
1297+ },
1298+ "scopes": [
1299+ "https://www.googleapis.com/auth/cloud-platform"
1300+ ]
1301+ },
11921302 "get": {
11931303 "id": "appengine.apps.get",
11941304 "path": "v1beta5/apps/{appsId}",
@@ -1197,7 +1307,7 @@
11971307 "parameters": {
11981308 "appsId": {
11991309 "type": "string",
1200− "description": "Part of `name`. Name of the application to get. For example: \"apps/myapp\".",
1310+ "description": "Part of `name`. Name of the application to get. Example: `apps/myapp`.",
12011311 "required": true,
12021312 "location": "path"
12031313 },
@@ -1216,6 +1326,37 @@
12161326 "scopes": [
12171327 "https://www.googleapis.com/auth/cloud-platform"
12181328 ]
1329+ },
1330+ "patch": {
1331+ "id": "appengine.apps.patch",
1332+ "path": "v1beta5/apps/{appsId}",
1333+ "httpMethod": "PATCH",
1334+ "description": "Updates application parameters.",
1335+ "parameters": {
1336+ "appsId": {
1337+ "type": "string",
1338+ "description": "Part of `name`. Name of the application to update. Example: `apps/myapp`.",
1339+ "required": true,
1340+ "location": "path"
1341+ },
1342+ "mask": {
1343+ "type": "string",
1344+ "description": "Standard field mask for the set of fields to be updated.",
1345+ "location": "query"
1346+ }
1347+ },
1348+ "parameterOrder": [
1349+ "appsId"
1350+ ],
1351+ "request": {
1352+ "$ref": "Application"
1353+ },
1354+ "response": {
1355+ "$ref": "Operation"
1356+ },
1357+ "scopes": [
1358+ "https://www.googleapis.com/auth/cloud-platform"
1359+ ]
12191360 }
12201361 },
12211362 "resources": {
@@ -1298,11 +1439,11 @@
12981439 "id": "appengine.apps.services.delete",
12991440 "path": "v1beta5/apps/{appsId}/services/{servicesId}",
13001441 "httpMethod": "DELETE",
1301− "description": "Deletes a service and all enclosed versions.",
1442+ "description": "Deletes the specified service and all enclosed versions.",
13021443 "parameters": {
13031444 "appsId": {
13041445 "type": "string",
1305− "description": "Part of `name`. Name of the resource requested. For example: \"apps/myapp/services/default\".",
1446+ "description": "Part of `name`. Name of the resource requested. Example: `apps/myapp/services/default`.",
13061447 "required": true,
13071448 "location": "path"
13081449 },
@@ -1328,11 +1469,11 @@
13281469 "id": "appengine.apps.services.get",
13291470 "path": "v1beta5/apps/{appsId}/services/{servicesId}",
13301471 "httpMethod": "GET",
1331− "description": "Gets the current configuration of the service.",
1472+ "description": "Gets the current configuration of the specified service.",
13321473 "parameters": {
13331474 "appsId": {
13341475 "type": "string",
1335− "description": "Part of `name`. Name of the resource requested. For example: \"apps/myapp/services/default\".",
1476+ "description": "Part of `name`. Name of the resource requested. Example: `apps/myapp/services/default`.",
13361477 "required": true,
13371478 "location": "path"
13381479 },
@@ -1362,7 +1503,7 @@
13621503 "parameters": {
13631504 "appsId": {
13641505 "type": "string",
1365− "description": "Part of `name`. Name of the resource requested. For example: \"apps/myapp\".",
1506+ "description": "Part of `name`. Name of the resource requested. Example: `apps/myapp`.",
13661507 "required": true,
13671508 "location": "path"
13681509 },
@@ -1396,7 +1537,7 @@
13961537 "parameters": {
13971538 "appsId": {
13981539 "type": "string",
1399− "description": "Part of `name`. Name of the resource to update. For example: \"apps/myapp/services/default\".",
1540+ "description": "Part of `name`. Name of the resource to update. Example: `apps/myapp/services/default`.",
14001541 "required": true,
14011542 "location": "path"
14021543 },
@@ -1413,7 +1554,7 @@
14131554 },
14141555 "migrateTraffic": {
14151556 "type": "boolean",
1416− "description": "Whether to use Traffic Migration to shift traffic gradually. Traffic can only be migrated from a single version to another single version.",
1557+ "description": "Set to `true` to gradually shift traffic from one version to another single version. By default, traffic is shifted immediately. For gradual traffic migration, the target version must be located within instances that are configured for both [warmup requests](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.versions#inboundservicetype) and [automatic scaling](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.versions#automaticscaling). You must specify the [`shardBy`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services#shardby) field in the Service resource. Gradual traffic migration is not supported in the App Engine flexible environment. For examples, see [Migrating and Splitting Traffic](https://cloud.google.com/appengine/docs/admin-api/migrating-splitting-traffic).",
14171558 "location": "query"
14181559 }
14191560 },
@@ -1439,7 +1580,7 @@
14391580 "id": "appengine.apps.services.versions.create",
14401581 "path": "v1beta5/apps/{appsId}/services/{servicesId}/versions",
14411582 "httpMethod": "POST",
1442− "description": "Deploys new code and resource files to a version.",
1583+ "description": "Deploys new code and resource files to a new version.",
14431584 "parameters": {
14441585 "appsId": {
14451586 "type": "string",
@@ -1476,7 +1617,7 @@
14761617 "parameters": {
14771618 "appsId": {
14781619 "type": "string",
1479− "description": "Part of `name`. Name of the resource requested. For example: \"apps/myapp/services/default/versions/v1\".",
1620+ "description": "Part of `name`. Name of the resource requested. Example: `apps/myapp/services/default/versions/v1`.",
14801621 "required": true,
14811622 "location": "path"
14821623 },
@@ -1509,11 +1650,11 @@
15091650 "id": "appengine.apps.services.versions.get",
15101651 "path": "v1beta5/apps/{appsId}/services/{servicesId}/versions/{versionsId}",
15111652 "httpMethod": "GET",
1512− "description": "Gets application deployment information.",
1653+ "description": "Gets the specified Version resource. By default, only a `BASIC_VIEW` will be returned. Specify the `FULL_VIEW` parameter to get the full resource.",
15131654 "parameters": {
15141655 "appsId": {
15151656 "type": "string",
1516− "description": "Part of `name`. Name of the resource requested. For example: \"apps/myapp/services/default/versions/v1\".",
1657+ "description": "Part of `name`. Name of the resource requested. Example: `apps/myapp/services/default/versions/v1`.",
15171658 "required": true,
15181659 "location": "path"
15191660 },
@@ -1559,7 +1700,7 @@
15591700 "parameters": {
15601701 "appsId": {
15611702 "type": "string",
1562− "description": "Part of `name`. Name of the resource requested. For example: \"apps/myapp/services/default\".",
1703+ "description": "Part of `name`. Name of the resource requested. Example: `apps/myapp/services/default`.",
15631704 "required": true,
15641705 "location": "path"
15651706 },
@@ -1605,11 +1746,11 @@
16051746 "id": "appengine.apps.services.versions.patch",
16061747 "path": "v1beta5/apps/{appsId}/services/{servicesId}/versions/{versionsId}",
16071748 "httpMethod": "PATCH",
1608− "description": "Updates an existing version. Note: UNIMPLEMENTED.",
1749+ "description": "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: * [`serving_status`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.versions#Version.FIELDS.serving_status): For Version resources that use basic scaling, manual scaling, or run in the App Engine flexible environment. * [`instance_class`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.versions#Version.FIELDS.instance_class): For Version resources that run in the App Engine standard environment. * [`automatic_scaling.min_idle_instances`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.versions#Version.FIELDS.automatic_scaling): For Version resources that use automatic scaling and run in the App Engine standard environment. * [`automatic_scaling.max_idle_instances`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.versions#Version.FIELDS.automatic_scaling): For Version resources that use automatic scaling and run in the App Engine standard environment.",
16091750 "parameters": {
16101751 "appsId": {
16111752 "type": "string",
1612− "description": "Part of `name`. Name of the resource to update. For example: \"apps/myapp/services/default/versions/1\".",
1753+ "description": "Part of `name`. Name of the resource to update. Example: `apps/myapp/services/default/versions/1`.",
16131754 "required": true,
16141755 "location": "path"
16151756 },
@@ -1650,6 +1791,94 @@
16501791 "resources": {
16511792 "instances": {
16521793 "methods": {
1794+ "delete": {
1795+ "id": "appengine.apps.services.versions.instances.delete",
1796+ "path": "v1beta5/apps/{appsId}/services/{servicesId}/versions/{versionsId}/instances/{instancesId}",
1797+ "httpMethod": "DELETE",
1798+ "description": "Stops a running instance.",
1799+ "parameters": {
1800+ "appsId": {
1801+ "type": "string",
1802+ "description": "Part of `name`. Name of the resource requested. For example: \"apps/myapp/services/default/versions/v1/instances/instance-1\".",
1803+ "required": true,
1804+ "location": "path"
1805+ },
1806+ "servicesId": {
1807+ "type": "string",
1808+ "description": "Part of `name`. See documentation of `appsId`.",
1809+ "required": true,
1810+ "location": "path"
1811+ },
1812+ "versionsId": {
1813+ "type": "string",
1814+ "description": "Part of `name`. See documentation of `appsId`.",
1815+ "required": true,
1816+ "location": "path"
1817+ },
1818+ "instancesId": {
1819+ "type": "string",
1820+ "description": "Part of `name`. See documentation of `appsId`.",
1821+ "required": true,
1822+ "location": "path"
1823+ }
1824+ },
1825+ "parameterOrder": [
1826+ "appsId",
1827+ "servicesId",
1828+ "versionsId",
1829+ "instancesId"
1830+ ],
1831+ "response": {
1832+ "$ref": "Operation"
1833+ },
1834+ "scopes": [
1835+ "https://www.googleapis.com/auth/cloud-platform"
1836+ ]
1837+ },
1838+ "get": {
1839+ "id": "appengine.apps.services.versions.instances.get",
1840+ "path": "v1beta5/apps/{appsId}/services/{servicesId}/versions/{versionsId}/instances/{instancesId}",
1841+ "httpMethod": "GET",
1842+ "description": "Gets instance information.",
1843+ "parameters": {
1844+ "appsId": {
1845+ "type": "string",
1846+ "description": "Part of `name`. Name of the resource requested. Example: `apps/myapp/services/default/versions/v1/instances/instance-1`.",
1847+ "required": true,
1848+ "location": "path"
1849+ },
1850+ "servicesId": {
1851+ "type": "string",
1852+ "description": "Part of `name`. See documentation of `appsId`.",
1853+ "required": true,
1854+ "location": "path"
1855+ },
1856+ "versionsId": {
1857+ "type": "string",
1858+ "description": "Part of `name`. See documentation of `appsId`.",
1859+ "required": true,
1860+ "location": "path"
1861+ },
1862+ "instancesId": {
1863+ "type": "string",
1864+ "description": "Part of `name`. See documentation of `appsId`.",
1865+ "required": true,
1866+ "location": "path"
1867+ }
1868+ },
1869+ "parameterOrder": [
1870+ "appsId",
1871+ "servicesId",
1872+ "versionsId",
1873+ "instancesId"
1874+ ],
1875+ "response": {
1876+ "$ref": "Instance"
1877+ },
1878+ "scopes": [
1879+ "https://www.googleapis.com/auth/cloud-platform"
1880+ ]
1881+ },
16531882 "list": {
16541883 "id": "appengine.apps.services.versions.instances.list",
16551884 "path": "v1beta5/apps/{appsId}/services/{servicesId}/versions/{versionsId}/instances",
@@ -1658,7 +1887,7 @@
16581887 "parameters": {
16591888 "appsId": {
16601889 "type": "string",
1661− "description": "Part of `name`. Name of the resource requested. For example: \"apps/myapp/services/default/versions/v1\".",
1890+ "description": "Part of `name`. Name of the resource requested. Example: `apps/myapp/services/default/versions/v1`.",
16621891 "required": true,
16631892 "location": "path"
16641893 },
@@ -1697,12 +1926,132 @@
16971926 "scopes": [
16981927 "https://www.googleapis.com/auth/cloud-platform"
16991928 ]
1929+ },
1930+ "debug": {
1931+ "id": "appengine.apps.services.versions.instances.debug",
1932+ "path": "v1beta5/apps/{appsId}/services/{servicesId}/versions/{versionsId}/instances/{instancesId}:debug",
1933+ "httpMethod": "POST",
1934+ "description": "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.",
1935+ "parameters": {
1936+ "appsId": {
1937+ "type": "string",
1938+ "description": "Part of `name`. Name of the resource requested. Example: `apps/myapp/services/default/versions/v1/instances/instance-1`.",
1939+ "required": true,
1940+ "location": "path"
1941+ },
1942+ "servicesId": {
1943+ "type": "string",
1944+ "description": "Part of `name`. See documentation of `appsId`.",
1945+ "required": true,
1946+ "location": "path"
1947+ },
1948+ "versionsId": {
1949+ "type": "string",
1950+ "description": "Part of `name`. See documentation of `appsId`.",
1951+ "required": true,
1952+ "location": "path"
1953+ },
1954+ "instancesId": {
1955+ "type": "string",
1956+ "description": "Part of `name`. See documentation of `appsId`.",
1957+ "required": true,
1958+ "location": "path"
1959+ }
1960+ },
1961+ "parameterOrder": [
1962+ "appsId",
1963+ "servicesId",
1964+ "versionsId",
1965+ "instancesId"
1966+ ],
1967+ "request": {
1968+ "$ref": "DebugInstanceRequest"
1969+ },
1970+ "response": {
1971+ "$ref": "Operation"
1972+ },
1973+ "scopes": [
1974+ "https://www.googleapis.com/auth/cloud-platform"
1975+ ]
17001976 }
17011977 }
17021978 }
17031979 }
17041980 }
17051981 }
1982+ },
1983+ "locations": {
1984+ "methods": {
1985+ "list": {
1986+ "id": "appengine.apps.locations.list",
1987+ "path": "v1beta5/apps/{appsId}/locations",
1988+ "httpMethod": "GET",
1989+ "description": "Lists information about the supported locations for this service.",
1990+ "parameters": {
1991+ "appsId": {
1992+ "type": "string",
1993+ "description": "Part of `name`. The resource that owns the locations collection, if applicable.",
1994+ "required": true,
1995+ "location": "path"
1996+ },
1997+ "filter": {
1998+ "type": "string",
1999+ "description": "The standard list filter.",
2000+ "location": "query"
2001+ },
2002+ "pageSize": {
2003+ "type": "integer",
2004+ "description": "The standard list page size.",
2005+ "format": "int32",
2006+ "location": "query"
2007+ },
2008+ "pageToken": {
2009+ "type": "string",
2010+ "description": "The standard list page token.",
2011+ "location": "query"
2012+ }
2013+ },
2014+ "parameterOrder": [
2015+ "appsId"
2016+ ],
2017+ "response": {
2018+ "$ref": "ListLocationsResponse"
2019+ },
2020+ "scopes": [
2021+ "https://www.googleapis.com/auth/cloud-platform"
2022+ ]
2023+ },
2024+ "get": {
2025+ "id": "appengine.apps.locations.get",
2026+ "path": "v1beta5/apps/{appsId}/locations/{locationsId}",
2027+ "httpMethod": "GET",
2028+ "description": "Get information about a location.",
2029+ "parameters": {
2030+ "appsId": {
2031+ "type": "string",
2032+ "description": "Part of `name`. Resource name for the location.",
2033+ "required": true,
2034+ "location": "path"
2035+ },
2036+ "locationsId": {
2037+ "type": "string",
2038+ "description": "Part of `name`. See documentation of `appsId`.",
2039+ "required": true,
2040+ "location": "path"
2041+ }
2042+ },
2043+ "parameterOrder": [
2044+ "appsId",
2045+ "locationsId"
2046+ ],
2047+ "response": {
2048+ "$ref": "Location"
2049+ },
2050+ "scopes": [
2051+ "https://www.googleapis.com/auth/cloud-platform"
2052+ ]
2053+ }
2054+ }
17062055 }
17072056 }
17082057 }
gogol-appengine/gen/Network/Google/AppEngine.hs+113−20
@@ -32,12 +32,24 @@ module Network.Google.AppEngine
3232 -- ** appengine.apps.get
3333 , module Network.Google.Resource.AppEngine.Apps.Get
3434
35+ -- ** appengine.apps.locations.get
36+ , module Network.Google.Resource.AppEngine.Apps.Locations.Get
37+
38+ -- ** appengine.apps.locations.list
39+ , module Network.Google.Resource.AppEngine.Apps.Locations.List
40+
3541 -- ** appengine.apps.operations.get
3642 , module Network.Google.Resource.AppEngine.Apps.Operations.Get
3743
3844 -- ** appengine.apps.operations.list
3945 , module Network.Google.Resource.AppEngine.Apps.Operations.List
4046
47+ -- ** appengine.apps.patch
48+ , module Network.Google.Resource.AppEngine.Apps.Patch
49+
50+ -- ** appengine.apps.repair
51+ , module Network.Google.Resource.AppEngine.Apps.Repair
52+
4153 -- ** appengine.apps.services.delete
4254 , module Network.Google.Resource.AppEngine.Apps.Services.Delete
4355
@@ -59,6 +71,15 @@ module Network.Google.AppEngine
5971 -- ** appengine.apps.services.versions.get
6072 , module Network.Google.Resource.AppEngine.Apps.Services.Versions.Get
6173
74+ -- ** appengine.apps.services.versions.instances.debug
75+ , module Network.Google.Resource.AppEngine.Apps.Services.Versions.Instances.Debug
76+
77+ -- ** appengine.apps.services.versions.instances.delete
78+ , module Network.Google.Resource.AppEngine.Apps.Services.Versions.Instances.Delete
79+
80+ -- ** appengine.apps.services.versions.instances.get
81+ , module Network.Google.Resource.AppEngine.Apps.Services.Versions.Instances.Get
82+
6283 -- ** appengine.apps.services.versions.instances.list
6384 , module Network.Google.Resource.AppEngine.Apps.Services.Versions.Instances.List
6485
@@ -68,15 +89,21 @@ module Network.Google.AppEngine
6889 -- ** appengine.apps.services.versions.patch
6990 , module Network.Google.Resource.AppEngine.Apps.Services.Versions.Patch
7091
92+ -- ** appengine.experimental.apps.operations.get
93+ , module Network.Google.Resource.AppEngine.Experimental.Apps.Operations.Get
94+
95+ -- ** appengine.experimental.apps.operations.list
96+ , module Network.Google.Resource.AppEngine.Experimental.Apps.Operations.List
97+
7198 -- * Types
7299
73100 -- ** NetworkUtilization
74101 , NetworkUtilization
75102 , networkUtilization
76− , nuTargetReceivedBytesPerSec
77− , nuTargetSentPacketsPerSec
78− , nuTargetReceivedPacketsPerSec
79− , nuTargetSentBytesPerSec
103+ , nuTargetReceivedBytesPerSecond
104+ , nuTargetSentPacketsPerSecond
105+ , nuTargetReceivedPacketsPerSecond
106+ , nuTargetSentBytesPerSecond
80107
81108 -- ** Status
82109 , Status
@@ -90,6 +117,11 @@ module Network.Google.AppEngine
90117 , operationSchema
91118 , osAddtional
92119
120+ -- ** LocationSchema
121+ , LocationSchema
122+ , locationSchema
123+ , lsAddtional
124+
93125 -- ** TrafficSplit
94126 , TrafficSplit
95127 , trafficSplit
@@ -125,13 +157,19 @@ module Network.Google.AppEngine
125157 , lName
126158 , lVersion
127159
160+ -- ** ListLocationsResponse
161+ , ListLocationsResponse
162+ , listLocationsResponse
163+ , llrNextPageToken
164+ , llrLocations
165+
128166 -- ** DiskUtilization
129167 , DiskUtilization
130168 , diskUtilization
131− , duTargetWriteOpsPerSec
132− , duTargetReadOpsPerSec
133− , duTargetWriteBytesPerSec
134− , duTargetReadBytesPerSec
169+ , duTargetReadBytesPerSecond
170+ , duTargetReadOpsPerSecond
171+ , duTargetWriteOpsPerSecond
172+ , duTargetWriteBytesPerSecond
135173
136174 -- ** ListOperationsResponse
137175 , ListOperationsResponse
@@ -169,13 +207,13 @@ module Network.Google.AppEngine
169207 , application
170208 , aDefaultHostname
171209 , aDefaultCookieExpiration
172− , aLocation
173210 , aAuthDomain
174211 , aCodeBucket
175212 , aName
176213 , aDispatchRules
177214 , aDefaultBucket
178215 , aId
216+ , aLocationId
179217
180218 -- ** VersionBetaSettings
181219 , VersionBetaSettings
@@ -189,6 +227,14 @@ module Network.Google.AppEngine
189227 , sName
190228 , sId
191229
230+ -- ** Location
231+ , Location
232+ , location
233+ , locName
234+ , locMetadata
235+ , locLabels
236+ , locLocationId
237+
192238 -- ** Operation
193239 , Operation
194240 , operation
@@ -198,6 +244,12 @@ module Network.Google.AppEngine
198244 , oName
199245 , oMetadata
200246
247+ -- ** ZipInfo
248+ , ZipInfo
249+ , zipInfo
250+ , ziFilesCount
251+ , ziSourceURL
252+
201253 -- ** URLDispatchRule
202254 , URLDispatchRule
203255 , urlDispatchRule
@@ -260,6 +312,10 @@ module Network.Google.AppEngine
260312 , nInstanceTag
261313 , nName
262314
315+ -- ** DebugInstanceRequest
316+ , DebugInstanceRequest
317+ , debugInstanceRequest
318+
263319 -- ** StaticFilesHandlerHTTPHeaders
264320 , StaticFilesHandlerHTTPHeaders
265321 , staticFilesHandlerHTTPHeaders
@@ -299,12 +355,19 @@ module Network.Google.AppEngine
299355 , bsMaxInstances
300356 , bsIdleTimeout
301357
358+ -- ** OperationMetadataV1
359+ , OperationMetadataV1
360+ , operationMetadataV1
361+ , omvInsertTime
362+ , omvUser
363+ , omvMethod
364+ , omvEndTime
365+ , omvTarget
366+
302367 -- ** Version
303368 , Version
304369 , version
305− , vCreationTime
306370 , vRuntime
307− , vDeployer
308371 , vNobuildFilesRegex
309372 , vInstanceClass
310373 , vHealthCheck
@@ -312,6 +375,7 @@ module Network.Google.AppEngine
312375 , vDefaultExpiration
313376 , vAutomaticScaling
314377 , vErrorHandlers
378+ , vCreatedBy
315379 , vVM
316380 , vHandlers
317381 , vInboundServices
@@ -327,7 +391,9 @@ module Network.Google.AppEngine
327391 , vEnvVariables
328392 , vServingStatus
329393 , vDiskUsageBytes
394+ , vCreateTime
330395 , vLibraries
396+ , vVersionURL
331397 , vDeployment
332398
333399 -- ** StaticFilesHandler
@@ -348,6 +414,17 @@ module Network.Google.AppEngine
348414 , ehErrorCode
349415 , ehStaticFile
350416
417+ -- ** LocationLabels
418+ , LocationLabels
419+ , locationLabels
420+ , llAddtional
421+
422+ -- ** LocationMetadata
423+ , LocationMetadata
424+ , locationMetadata
425+ , lmStandardEnvironmentAvailable
426+ , lmFlexibleEnvironmentAvailable
427+
351428 -- ** OperationMetadata
352429 , OperationMetadata
353430 , operationMetadata
@@ -368,13 +445,11 @@ module Network.Google.AppEngine
368445 , RequestUtilization
369446 , requestUtilization
370447 , ruTargetConcurrentRequests
371− , ruTargetRequestCountPerSec
448+ , ruTargetRequestCountPerSecond
372449
373− -- ** SourceReference
374− , SourceReference
375− , sourceReference
376− , srRepository
377− , srRevisionId
450+ -- ** RepairApplicationRequest
451+ , RepairApplicationRequest
452+ , repairApplicationRequest
378453
379454 -- ** OperationResponse
380455 , OperationResponse
@@ -392,32 +467,36 @@ module Network.Google.AppEngine
392467 , iMemoryUsage
393468 , iVMStatus
394469 , iVMZoneName
470+ , iStartTime
395471 , iVMId
396472 , iAvailability
397473 , iVMName
398474 , iName
399− , iVMUnlocked
475+ , iVMDebugEnabled
400476 , iRequests
401477 , iQps
402478 , iId
403479 , iErrors
404480 , iAverageLatency
405− , iStartTimestamp
406481 , iAppEngineRelease
407482
408483 -- ** Deployment
409484 , Deployment
410485 , deployment
486+ , dZip
411487 , dContainer
412488 , dFiles
413− , dSourceReferences
414489 ) where
415490
416491import Network.Google.AppEngine.Types
417492import Network.Google.Prelude
418493import Network.Google.Resource.AppEngine.Apps.Get
494+import Network.Google.Resource.AppEngine.Apps.Locations.Get
495+import Network.Google.Resource.AppEngine.Apps.Locations.List
419496import Network.Google.Resource.AppEngine.Apps.Operations.Get
420497import Network.Google.Resource.AppEngine.Apps.Operations.List
498+import Network.Google.Resource.AppEngine.Apps.Patch
499+import Network.Google.Resource.AppEngine.Apps.Repair
421500import Network.Google.Resource.AppEngine.Apps.Services.Delete
422501import Network.Google.Resource.AppEngine.Apps.Services.Get
423502import Network.Google.Resource.AppEngine.Apps.Services.List
@@ -425,9 +504,14 @@ import Network.Google.Resource.AppEngine.Apps.Services.Patch
425504import Network.Google.Resource.AppEngine.Apps.Services.Versions.Create
426505import Network.Google.Resource.AppEngine.Apps.Services.Versions.Delete
427506import Network.Google.Resource.AppEngine.Apps.Services.Versions.Get
507+import Network.Google.Resource.AppEngine.Apps.Services.Versions.Instances.Debug
508+import Network.Google.Resource.AppEngine.Apps.Services.Versions.Instances.Delete
509+import Network.Google.Resource.AppEngine.Apps.Services.Versions.Instances.Get
428510import Network.Google.Resource.AppEngine.Apps.Services.Versions.Instances.List
429511import Network.Google.Resource.AppEngine.Apps.Services.Versions.List
430512import Network.Google.Resource.AppEngine.Apps.Services.Versions.Patch
513+import Network.Google.Resource.AppEngine.Experimental.Apps.Operations.Get
514+import Network.Google.Resource.AppEngine.Experimental.Apps.Operations.List
431515
432516{- $resources
433517TODO
@@ -437,7 +521,12 @@ TODO
437521type AppEngineAPI =
438522 AppsOperationsListResource :<|>
439523 AppsOperationsGetResource
524+ :<|> AppsLocationsListResource
525+ :<|> AppsLocationsGetResource
440526 :<|> AppsServicesVersionsInstancesListResource
527+ :<|> AppsServicesVersionsInstancesGetResource
528+ :<|> AppsServicesVersionsInstancesDebugResource
529+ :<|> AppsServicesVersionsInstancesDeleteResource
441530 :<|> AppsServicesVersionsListResource
442531 :<|> AppsServicesVersionsPatchResource
443532 :<|> AppsServicesVersionsGetResource
@@ -447,4 +536,8 @@ type AppEngineAPI =
447536 :<|> AppsServicesPatchResource
448537 :<|> AppsServicesGetResource
449538 :<|> AppsServicesDeleteResource
539+ :<|> AppsPatchResource
450540 :<|> AppsGetResource
541+ :<|> AppsRepairResource
542+ :<|> ExperimentalAppsOperationsListResource
543+ :<|> ExperimentalAppsOperationsGetResource
gogol-appengine/gen/Network/Google/AppEngine/Types.hs+70−22
@@ -25,10 +25,10 @@ module Network.Google.AppEngine.Types
2525 -- * NetworkUtilization
2626 , NetworkUtilization
2727 , networkUtilization
28− , nuTargetReceivedBytesPerSec
29− , nuTargetSentPacketsPerSec
30− , nuTargetReceivedPacketsPerSec
31− , nuTargetSentBytesPerSec
28+ , nuTargetReceivedBytesPerSecond
29+ , nuTargetSentPacketsPerSecond
30+ , nuTargetReceivedPacketsPerSecond
31+ , nuTargetSentBytesPerSecond
3232
3333 -- * Status
3434 , Status
@@ -42,6 +42,11 @@ module Network.Google.AppEngine.Types
4242 , operationSchema
4343 , osAddtional
4444
45+ -- * LocationSchema
46+ , LocationSchema
47+ , locationSchema
48+ , lsAddtional
49+
4550 -- * TrafficSplit
4651 , TrafficSplit
4752 , trafficSplit
@@ -77,13 +82,19 @@ module Network.Google.AppEngine.Types
7782 , lName
7883 , lVersion
7984
85+ -- * ListLocationsResponse
86+ , ListLocationsResponse
87+ , listLocationsResponse
88+ , llrNextPageToken
89+ , llrLocations
90+
8091 -- * DiskUtilization
8192 , DiskUtilization
8293 , diskUtilization
83− , duTargetWriteOpsPerSec
84− , duTargetReadOpsPerSec
85− , duTargetWriteBytesPerSec
86− , duTargetReadBytesPerSec
94+ , duTargetReadBytesPerSecond
95+ , duTargetReadOpsPerSecond
96+ , duTargetWriteOpsPerSecond
97+ , duTargetWriteBytesPerSecond
8798
8899 -- * ListOperationsResponse
89100 , ListOperationsResponse
@@ -121,13 +132,13 @@ module Network.Google.AppEngine.Types
121132 , application
122133 , aDefaultHostname
123134 , aDefaultCookieExpiration
124− , aLocation
125135 , aAuthDomain
126136 , aCodeBucket
127137 , aName
128138 , aDispatchRules
129139 , aDefaultBucket
130140 , aId
141+ , aLocationId
131142
132143 -- * VersionBetaSettings
133144 , VersionBetaSettings
@@ -141,6 +152,14 @@ module Network.Google.AppEngine.Types
141152 , sName
142153 , sId
143154
155+ -- * Location
156+ , Location
157+ , location
158+ , locName
159+ , locMetadata
160+ , locLabels
161+ , locLocationId
162+
144163 -- * Operation
145164 , Operation
146165 , operation
@@ -150,6 +169,12 @@ module Network.Google.AppEngine.Types
150169 , oName
151170 , oMetadata
152171
172+ -- * ZipInfo
173+ , ZipInfo
174+ , zipInfo
175+ , ziFilesCount
176+ , ziSourceURL
177+
153178 -- * URLDispatchRule
154179 , URLDispatchRule
155180 , urlDispatchRule
@@ -212,6 +237,10 @@ module Network.Google.AppEngine.Types
212237 , nInstanceTag
213238 , nName
214239
240+ -- * DebugInstanceRequest
241+ , DebugInstanceRequest
242+ , debugInstanceRequest
243+
215244 -- * StaticFilesHandlerHTTPHeaders
216245 , StaticFilesHandlerHTTPHeaders
217246 , staticFilesHandlerHTTPHeaders
@@ -251,12 +280,19 @@ module Network.Google.AppEngine.Types
251280 , bsMaxInstances
252281 , bsIdleTimeout
253282
283+ -- * OperationMetadataV1
284+ , OperationMetadataV1
285+ , operationMetadataV1
286+ , omvInsertTime
287+ , omvUser
288+ , omvMethod
289+ , omvEndTime
290+ , omvTarget
291+
254292 -- * Version
255293 , Version
256294 , version
257− , vCreationTime
258295 , vRuntime
259− , vDeployer
260296 , vNobuildFilesRegex
261297 , vInstanceClass
262298 , vHealthCheck
@@ -264,6 +300,7 @@ module Network.Google.AppEngine.Types
264300 , vDefaultExpiration
265301 , vAutomaticScaling
266302 , vErrorHandlers
303+ , vCreatedBy
267304 , vVM
268305 , vHandlers
269306 , vInboundServices
@@ -279,7 +316,9 @@ module Network.Google.AppEngine.Types
279316 , vEnvVariables
280317 , vServingStatus
281318 , vDiskUsageBytes
319+ , vCreateTime
282320 , vLibraries
321+ , vVersionURL
283322 , vDeployment
284323
285324 -- * StaticFilesHandler
@@ -300,6 +339,17 @@ module Network.Google.AppEngine.Types
300339 , ehErrorCode
301340 , ehStaticFile
302341
342+ -- * LocationLabels
343+ , LocationLabels
344+ , locationLabels
345+ , llAddtional
346+
347+ -- * LocationMetadata
348+ , LocationMetadata
349+ , locationMetadata
350+ , lmStandardEnvironmentAvailable
351+ , lmFlexibleEnvironmentAvailable
352+
303353 -- * OperationMetadata
304354 , OperationMetadata
305355 , operationMetadata
@@ -320,13 +370,11 @@ module Network.Google.AppEngine.Types
320370 , RequestUtilization
321371 , requestUtilization
322372 , ruTargetConcurrentRequests
323− , ruTargetRequestCountPerSec
373+ , ruTargetRequestCountPerSecond
324374
325− -- * SourceReference
326− , SourceReference
327− , sourceReference
328− , srRepository
329− , srRevisionId
375+ -- * RepairApplicationRequest
376+ , RepairApplicationRequest
377+ , repairApplicationRequest
330378
331379 -- * OperationResponse
332380 , OperationResponse
@@ -344,35 +392,35 @@ module Network.Google.AppEngine.Types
344392 , iMemoryUsage
345393 , iVMStatus
346394 , iVMZoneName
395+ , iStartTime
347396 , iVMId
348397 , iAvailability
349398 , iVMName
350399 , iName
351− , iVMUnlocked
400+ , iVMDebugEnabled
352401 , iRequests
353402 , iQps
354403 , iId
355404 , iErrors
356405 , iAverageLatency
357− , iStartTimestamp
358406 , iAppEngineRelease
359407
360408 -- * Deployment
361409 , Deployment
362410 , deployment
411+ , dZip
363412 , dContainer
364413 , dFiles
365− , dSourceReferences
366414 ) where
367415
368416import Network.Google.AppEngine.Types.Product
369417import Network.Google.AppEngine.Types.Sum
370418import Network.Google.Prelude
371419
372−-- | Default request referring to version 'v1beta5' of the Google App Engine Admin API. This contains the host and root path used as a starting point for constructing service requests.
420+-- | Default request referring to version 'v1' of the Google App Engine Admin API. This contains the host and root path used as a starting point for constructing service requests.
373421appEngineService :: ServiceConfig
374422appEngineService
375− = defaultService (ServiceId "appengine:v1beta5")
423+ = defaultService (ServiceId "appengine:v1")
376424 "appengine.googleapis.com"
377425
378426-- | View and manage your data across Google Cloud Platform services
gogol-appengine/gen/Network/Google/AppEngine/Types/Product.hs+886−516
@@ -20,63 +20,63 @@ module Network.Google.AppEngine.Types.Product where
2020import Network.Google.AppEngine.Types.Sum
2121import Network.Google.Prelude
2222
23−-- | Target scaling by network usage (for VM runtimes only).
23+-- | Target scaling by network usage. Only applicable for VM runtimes.
2424--
2525-- /See:/ 'networkUtilization' smart constructor.
2626data NetworkUtilization = NetworkUtilization'
27− { _nuTargetReceivedBytesPerSec :: !(Maybe (Textual Int32))
28− , _nuTargetSentPacketsPerSec :: !(Maybe (Textual Int32))
29− , _nuTargetReceivedPacketsPerSec :: !(Maybe (Textual Int32))
30− , _nuTargetSentBytesPerSec :: !(Maybe (Textual Int32))
27+ { _nuTargetReceivedBytesPerSecond :: !(Maybe (Textual Int32))
28+ , _nuTargetSentPacketsPerSecond :: !(Maybe (Textual Int32))
29+ , _nuTargetReceivedPacketsPerSecond :: !(Maybe (Textual Int32))
30+ , _nuTargetSentBytesPerSecond :: !(Maybe (Textual Int32))
3131 } deriving (Eq,Show,Data,Typeable,Generic)
3232
3333-- | Creates a value of 'NetworkUtilization' with the minimum fields required to make a request.
3434--
3535-- Use one of the following lenses to modify other fields as desired:
3636--
37−-- * 'nuTargetReceivedBytesPerSec'
37+-- * 'nuTargetReceivedBytesPerSecond'
3838--
39−-- * 'nuTargetSentPacketsPerSec'
39+-- * 'nuTargetSentPacketsPerSecond'
4040--
41−-- * 'nuTargetReceivedPacketsPerSec'
41+-- * 'nuTargetReceivedPacketsPerSecond'
4242--
43−-- * 'nuTargetSentBytesPerSec'
43+-- * 'nuTargetSentBytesPerSecond'
4444networkUtilization
4545 :: NetworkUtilization
4646networkUtilization =
4747 NetworkUtilization'
48− { _nuTargetReceivedBytesPerSec = Nothing
49− , _nuTargetSentPacketsPerSec = Nothing
50− , _nuTargetReceivedPacketsPerSec = Nothing
51− , _nuTargetSentBytesPerSec = Nothing
48+ { _nuTargetReceivedBytesPerSecond = Nothing
49+ , _nuTargetSentPacketsPerSecond = Nothing
50+ , _nuTargetReceivedPacketsPerSecond = Nothing
51+ , _nuTargetSentBytesPerSecond = Nothing
5252 }
5353
54−-- | Target bytes per second received.
55−nuTargetReceivedBytesPerSec :: Lens' NetworkUtilization (Maybe Int32)
56−nuTargetReceivedBytesPerSec
57− = lens _nuTargetReceivedBytesPerSec
58− (\ s a -> s{_nuTargetReceivedBytesPerSec = a})
54+-- | Target bytes received per second.
55+nuTargetReceivedBytesPerSecond :: Lens' NetworkUtilization (Maybe Int32)
56+nuTargetReceivedBytesPerSecond
57+ = lens _nuTargetReceivedBytesPerSecond
58+ (\ s a -> s{_nuTargetReceivedBytesPerSecond = a})
5959 . mapping _Coerce
6060
61−-- | Target packets per second sent.
62−nuTargetSentPacketsPerSec :: Lens' NetworkUtilization (Maybe Int32)
63−nuTargetSentPacketsPerSec
64− = lens _nuTargetSentPacketsPerSec
65− (\ s a -> s{_nuTargetSentPacketsPerSec = a})
61+-- | Target packets sent per second.
62+nuTargetSentPacketsPerSecond :: Lens' NetworkUtilization (Maybe Int32)
63+nuTargetSentPacketsPerSecond
64+ = lens _nuTargetSentPacketsPerSecond
65+ (\ s a -> s{_nuTargetSentPacketsPerSecond = a})
6666 . mapping _Coerce
6767
68−-- | Target packets per second received.
69−nuTargetReceivedPacketsPerSec :: Lens' NetworkUtilization (Maybe Int32)
70−nuTargetReceivedPacketsPerSec
71− = lens _nuTargetReceivedPacketsPerSec
72− (\ s a -> s{_nuTargetReceivedPacketsPerSec = a})
68+-- | Target packets received per second.
69+nuTargetReceivedPacketsPerSecond :: Lens' NetworkUtilization (Maybe Int32)
70+nuTargetReceivedPacketsPerSecond
71+ = lens _nuTargetReceivedPacketsPerSecond
72+ (\ s a -> s{_nuTargetReceivedPacketsPerSecond = a})
7373 . mapping _Coerce
7474
75−-- | Target bytes per second sent.
76−nuTargetSentBytesPerSec :: Lens' NetworkUtilization (Maybe Int32)
77−nuTargetSentBytesPerSec
78− = lens _nuTargetSentBytesPerSec
79− (\ s a -> s{_nuTargetSentBytesPerSec = a})
75+-- | Target bytes sent per second.
76+nuTargetSentBytesPerSecond :: Lens' NetworkUtilization (Maybe Int32)
77+nuTargetSentBytesPerSecond
78+ = lens _nuTargetSentBytesPerSecond
79+ (\ s a -> s{_nuTargetSentBytesPerSecond = a})
8080 . mapping _Coerce
8181
8282instance FromJSON NetworkUtilization where
@@ -84,23 +84,23 @@ instance FromJSON NetworkUtilization where
8484 = withObject "NetworkUtilization"
8585 (\ o ->
8686 NetworkUtilization' <$>
87− (o .:? "targetReceivedBytesPerSec") <*>
88− (o .:? "targetSentPacketsPerSec")
89− <*> (o .:? "targetReceivedPacketsPerSec")
90− <*> (o .:? "targetSentBytesPerSec"))
87+ (o .:? "targetReceivedBytesPerSecond") <*>
88+ (o .:? "targetSentPacketsPerSecond")
89+ <*> (o .:? "targetReceivedPacketsPerSecond")
90+ <*> (o .:? "targetSentBytesPerSecond"))
9191
9292instance ToJSON NetworkUtilization where
9393 toJSON NetworkUtilization'{..}
9494 = object
9595 (catMaybes
96− [("targetReceivedBytesPerSec" .=) <$>
97− _nuTargetReceivedBytesPerSec,
98− ("targetSentPacketsPerSec" .=) <$>
99− _nuTargetSentPacketsPerSec,
100− ("targetReceivedPacketsPerSec" .=) <$>
101− _nuTargetReceivedPacketsPerSec,
102− ("targetSentBytesPerSec" .=) <$>
103− _nuTargetSentBytesPerSec])
96+ [("targetReceivedBytesPerSecond" .=) <$>
97+ _nuTargetReceivedBytesPerSecond,
98+ ("targetSentPacketsPerSecond" .=) <$>
99+ _nuTargetSentPacketsPerSecond,
100+ ("targetReceivedPacketsPerSecond" .=) <$>
101+ _nuTargetReceivedPacketsPerSecond,
102+ ("targetSentBytesPerSecond" .=) <$>
103+ _nuTargetSentBytesPerSecond])
104104
105105-- | The \`Status\` type defines a logical error model that is suitable for
106106-- different programming environments, including REST APIs and RPC APIs. It
@@ -222,7 +222,7 @@ operationSchema pOsAddtional_ =
222222 { _osAddtional = _Coerce # pOsAddtional_
223223 }
224224
225−-- | Properties of the object. Contains field \'ype with type URL.
225+-- | Properties of the object. Contains field \'type with type URL.
226226osAddtional :: Lens' OperationSchema (HashMap Text JSONValue)
227227osAddtional
228228 = lens _osAddtional (\ s a -> s{_osAddtional = a}) .
@@ -236,10 +236,44 @@ instance FromJSON OperationSchema where
236236instance ToJSON OperationSchema where
237237 toJSON = toJSON . _osAddtional
238238
239−-- | Configuration for traffic splitting for versions within a single
240−-- service. Traffic splitting allows traffic directed to the service to be
241−-- assigned to one of several versions in a fractional way, enabling
242−-- experiments and canarying new builds, for example.
239+-- | Service-specific metadata. For example the available capacity at the
240+-- given location.
241+--
242+-- /See:/ 'locationSchema' smart constructor.
243+newtype LocationSchema = LocationSchema'
244+ { _lsAddtional :: HashMap Text JSONValue
245+ } deriving (Eq,Show,Data,Typeable,Generic)
246+
247+-- | Creates a value of 'LocationSchema' with the minimum fields required to make a request.
248+--
249+-- Use one of the following lenses to modify other fields as desired:
250+--
251+-- * 'lsAddtional'
252+locationSchema
253+ :: HashMap Text JSONValue -- ^ 'lsAddtional'
254+ -> LocationSchema
255+locationSchema pLsAddtional_ =
256+ LocationSchema'
257+ { _lsAddtional = _Coerce # pLsAddtional_
258+ }
259+
260+-- | Properties of the object. Contains field \'type with type URL.
261+lsAddtional :: Lens' LocationSchema (HashMap Text JSONValue)
262+lsAddtional
263+ = lens _lsAddtional (\ s a -> s{_lsAddtional = a}) .
264+ _Coerce
265+
266+instance FromJSON LocationSchema where
267+ parseJSON
268+ = withObject "LocationSchema"
269+ (\ o -> LocationSchema' <$> (parseJSONObject o))
270+
271+instance ToJSON LocationSchema where
272+ toJSON = toJSON . _lsAddtional
273+
274+-- | Traffic routing configuration for versions within a single service.
275+-- Traffic splits define how traffic directed to the service is assigned to
276+-- versions.
243277--
244278-- /See:/ 'trafficSplit' smart constructor.
245279data TrafficSplit = TrafficSplit'
@@ -262,21 +296,21 @@ trafficSplit =
262296 , _tsAllocations = Nothing
263297 }
264298
265−-- | Which mechanism should be used as a selector when choosing a version to
266−-- send a request to. The traffic selection algorithm will be stable for
267−-- either type until allocations are changed.
299+-- | Mechanism used to determine which version a request is sent to. The
300+-- traffic selection algorithm will be stable for either type until
301+-- allocations are changed.
268302tsShardBy :: Lens' TrafficSplit (Maybe Text)
269303tsShardBy
270304 = lens _tsShardBy (\ s a -> s{_tsShardBy = a})
271305
272−-- | Mapping from service version IDs within the service to fractional
273−-- (0.000, 1] allocations of traffic for that version. Each version may
274−-- only be specified once, but some versions in the service may not have
275−-- any traffic allocation. Services that have traffic allocated in this
276−-- field may not be deleted until the service is deleted, or their traffic
277−-- allocation is removed. Allocations must sum to 1. Supports precision up
278−-- to two decimal places for IP-based splits and up to three decimal places
279−-- for cookie-based splits.
306+-- | Mapping from version IDs within the service to fractional (0.000, 1]
307+-- allocations of traffic for that version. Each version can be specified
308+-- only once, but some versions in the service may not have any traffic
309+-- allocation. Services that have traffic allocated cannot be deleted until
310+-- either the service is deleted or their traffic allocation is removed.
311+-- Allocations must sum to 1. Up to two decimal place precision is
312+-- supported for IP-based splits and up to three decimal places is
313+-- supported for cookie-based splits.
280314tsAllocations :: Lens' TrafficSplit (Maybe TrafficSplitAllocations)
281315tsAllocations
282316 = lens _tsAllocations
@@ -315,7 +349,7 @@ scriptHandler =
315349 { _shScriptPath = Nothing
316350 }
317351
318−-- | Specifies the path to the script from the application root directory.
352+-- | Path to the script from the application root directory.
319353shScriptPath :: Lens' ScriptHandler (Maybe Text)
320354shScriptPath
321355 = lens _shScriptPath (\ s a -> s{_shScriptPath = a})
@@ -381,9 +415,9 @@ instance ToJSON ListServicesResponse where
381415 [("nextPageToken" .=) <$> _lsrNextPageToken,
382416 ("services" .=) <$> _lsrServices])
383417
384−-- | A URL pattern and description of how it should be handled. App Engine
385−-- can handle URLs by executing application code, or by serving static
386−-- files uploaded with the code, such as images, CSS or JavaScript.
418+-- | URL pattern and description of how the URL should be handled. App Engine
419+-- can handle URLs by executing application code or by serving static files
420+-- uploaded with the version, such as images, CSS, or JavaScript.
387421--
388422-- /See:/ 'urlMap' smart constructor.
389423data URLMap = URLMap'
@@ -430,40 +464,39 @@ urlMap =
430464 , _umLogin = Nothing
431465 }
432466
433−-- | Executes a script to handle the request that matches the URL pattern.
467+-- | Executes a script to handle the request that matches this URL pattern.
434468umScript :: Lens' URLMap (Maybe ScriptHandler)
435469umScript = lens _umScript (\ s a -> s{_umScript = a})
436470
437−-- | Configures whether security (HTTPS) should be enforced for this URL.
471+-- | Security (HTTPS) enforcement for this URL.
438472umSecurityLevel :: Lens' URLMap (Maybe Text)
439473umSecurityLevel
440474 = lens _umSecurityLevel
441475 (\ s a -> s{_umSecurityLevel = a})
442476
443−-- | Use API Endpoints to handle requests.
477+-- | Uses API Endpoints to handle requests.
444478umAPIEndpoint :: Lens' URLMap (Maybe APIEndpointHandler)
445479umAPIEndpoint
446480 = lens _umAPIEndpoint
447481 (\ s a -> s{_umAPIEndpoint = a})
448482
449−-- | A URL prefix. This value uses regular expression syntax (and so regexp
450−-- special characters must be escaped), but it should not contain
451−-- groupings. All URLs that begin with this prefix are handled by this
452−-- handler, using the portion of the URL after the prefix as part of the
453−-- file path. This is always required.
483+-- | URL prefix. Uses regular expression syntax, which means regexp special
484+-- characters must be escaped, but should not contain groupings. All URLs
485+-- that begin with this prefix are handled by this handler, using the
486+-- portion of the URL after the prefix as part of the file path.
454487umURLRegex :: Lens' URLMap (Maybe Text)
455488umURLRegex
456489 = lens _umURLRegex (\ s a -> s{_umURLRegex = a})
457490
458491-- | \`30x\` code to use when performing redirects for the \`secure\` field.
459−-- A \`302\` is used by default.
492+-- Defaults to \`302\`.
460493umRedirectHTTPResponseCode :: Lens' URLMap (Maybe Text)
461494umRedirectHTTPResponseCode
462495 = lens _umRedirectHTTPResponseCode
463496 (\ s a -> s{_umRedirectHTTPResponseCode = a})
464497
465−-- | For users not logged in, how to handle access to resources with required
466−-- login. Defaults to \"redirect\".
498+-- | Action to take when users access resources that require authentication.
499+-- Defaults to \`redirect\`.
467500umAuthFailAction :: Lens' URLMap (Maybe Text)
468501umAuthFailAction
469502 = lens _umAuthFailAction
@@ -475,7 +508,7 @@ umStaticFiles
475508 = lens _umStaticFiles
476509 (\ s a -> s{_umStaticFiles = a})
477510
478−-- | What level of login is required to access this resource.
511+-- | Level of login required to access this resource.
479512umLogin :: Lens' URLMap (Maybe Text)
480513umLogin = lens _umLogin (\ s a -> s{_umLogin = a})
481514
@@ -506,7 +539,7 @@ instance ToJSON URLMap where
506539 ("staticFiles" .=) <$> _umStaticFiles,
507540 ("login" .=) <$> _umLogin])
508541
509−-- | A Python runtime third-party library required by the application.
542+-- | Third-party Python runtime library that is required by the application.
510543--
511544-- /See:/ 'library' smart constructor.
512545data Library = Library'
@@ -529,11 +562,11 @@ library =
529562 , _lVersion = Nothing
530563 }
531564
532−-- | The name of the library, e.g. \"PIL\" or \"django\".
565+-- | Name of the library. Example: \"django\".
533566lName :: Lens' Library (Maybe Text)
534567lName = lens _lName (\ s a -> s{_lName = a})
535568
536−-- | The version of the library to select, or \"latest\".
569+-- | Version of the library to select, or \"latest\".
537570lVersion :: Lens' Library (Maybe Text)
538571lVersion = lens _lVersion (\ s a -> s{_lVersion = a})
539572
@@ -550,63 +583,114 @@ instance ToJSON Library where
550583 [("name" .=) <$> _lName,
551584 ("version" .=) <$> _lVersion])
552585
553−-- | Target scaling by disk usage (for VM runtimes only).
586+-- | The response message for LocationService.ListLocations.
587+--
588+-- /See:/ 'listLocationsResponse' smart constructor.
589+data ListLocationsResponse = ListLocationsResponse'
590+ { _llrNextPageToken :: !(Maybe Text)
591+ , _llrLocations :: !(Maybe [Location])
592+ } deriving (Eq,Show,Data,Typeable,Generic)
593+
594+-- | Creates a value of 'ListLocationsResponse' with the minimum fields required to make a request.
595+--
596+-- Use one of the following lenses to modify other fields as desired:
597+--
598+-- * 'llrNextPageToken'
599+--
600+-- * 'llrLocations'
601+listLocationsResponse
602+ :: ListLocationsResponse
603+listLocationsResponse =
604+ ListLocationsResponse'
605+ { _llrNextPageToken = Nothing
606+ , _llrLocations = Nothing
607+ }
608+
609+-- | The standard List next-page token.
610+llrNextPageToken :: Lens' ListLocationsResponse (Maybe Text)
611+llrNextPageToken
612+ = lens _llrNextPageToken
613+ (\ s a -> s{_llrNextPageToken = a})
614+
615+-- | A list of locations that matches the specified filter in the request.
616+llrLocations :: Lens' ListLocationsResponse [Location]
617+llrLocations
618+ = lens _llrLocations (\ s a -> s{_llrLocations = a})
619+ . _Default
620+ . _Coerce
621+
622+instance FromJSON ListLocationsResponse where
623+ parseJSON
624+ = withObject "ListLocationsResponse"
625+ (\ o ->
626+ ListLocationsResponse' <$>
627+ (o .:? "nextPageToken") <*>
628+ (o .:? "locations" .!= mempty))
629+
630+instance ToJSON ListLocationsResponse where
631+ toJSON ListLocationsResponse'{..}
632+ = object
633+ (catMaybes
634+ [("nextPageToken" .=) <$> _llrNextPageToken,
635+ ("locations" .=) <$> _llrLocations])
636+
637+-- | Target scaling by disk usage. Only applicable for VM runtimes.
554638--
555639-- /See:/ 'diskUtilization' smart constructor.
556640data DiskUtilization = DiskUtilization'
557− { _duTargetWriteOpsPerSec :: !(Maybe (Textual Int32))
558− , _duTargetReadOpsPerSec :: !(Maybe (Textual Int32))
559− , _duTargetWriteBytesPerSec :: !(Maybe (Textual Int32))
560− , _duTargetReadBytesPerSec :: !(Maybe (Textual Int32))
641+ { _duTargetReadBytesPerSecond :: !(Maybe (Textual Int32))
642+ , _duTargetReadOpsPerSecond :: !(Maybe (Textual Int32))
643+ , _duTargetWriteOpsPerSecond :: !(Maybe (Textual Int32))
644+ , _duTargetWriteBytesPerSecond :: !(Maybe (Textual Int32))
561645 } deriving (Eq,Show,Data,Typeable,Generic)
562646
563647-- | Creates a value of 'DiskUtilization' with the minimum fields required to make a request.
564648--
565649-- Use one of the following lenses to modify other fields as desired:
566650--
567−-- * 'duTargetWriteOpsPerSec'
651+-- * 'duTargetReadBytesPerSecond'
568652--
569−-- * 'duTargetReadOpsPerSec'
653+-- * 'duTargetReadOpsPerSecond'
570654--
571−-- * 'duTargetWriteBytesPerSec'
655+-- * 'duTargetWriteOpsPerSecond'
572656--
573−-- * 'duTargetReadBytesPerSec'
657+-- * 'duTargetWriteBytesPerSecond'
574658diskUtilization
575659 :: DiskUtilization
576660diskUtilization =
577661 DiskUtilization'
578− { _duTargetWriteOpsPerSec = Nothing
579− , _duTargetReadOpsPerSec = Nothing
580− , _duTargetWriteBytesPerSec = Nothing
581− , _duTargetReadBytesPerSec = Nothing
662+ { _duTargetReadBytesPerSecond = Nothing
663+ , _duTargetReadOpsPerSecond = Nothing
664+ , _duTargetWriteOpsPerSecond = Nothing
665+ , _duTargetWriteBytesPerSecond = Nothing
582666 }
583667
584−-- | Target ops per second written.
585−duTargetWriteOpsPerSec :: Lens' DiskUtilization (Maybe Int32)
586−duTargetWriteOpsPerSec
587− = lens _duTargetWriteOpsPerSec
588− (\ s a -> s{_duTargetWriteOpsPerSec = a})
668+-- | Target bytes read per second.
669+duTargetReadBytesPerSecond :: Lens' DiskUtilization (Maybe Int32)
670+duTargetReadBytesPerSecond
671+ = lens _duTargetReadBytesPerSecond
672+ (\ s a -> s{_duTargetReadBytesPerSecond = a})
589673 . mapping _Coerce
590674
591−-- | Target ops per second read.
592−duTargetReadOpsPerSec :: Lens' DiskUtilization (Maybe Int32)
593−duTargetReadOpsPerSec
594− = lens _duTargetReadOpsPerSec
595− (\ s a -> s{_duTargetReadOpsPerSec = a})
675+-- | Target ops read per seconds.
676+duTargetReadOpsPerSecond :: Lens' DiskUtilization (Maybe Int32)
677+duTargetReadOpsPerSecond
678+ = lens _duTargetReadOpsPerSecond
679+ (\ s a -> s{_duTargetReadOpsPerSecond = a})
596680 . mapping _Coerce
597681
598−-- | Target bytes per second written.
599−duTargetWriteBytesPerSec :: Lens' DiskUtilization (Maybe Int32)
600−duTargetWriteBytesPerSec
601− = lens _duTargetWriteBytesPerSec
602− (\ s a -> s{_duTargetWriteBytesPerSec = a})
682+-- | Target ops written per second.
683+duTargetWriteOpsPerSecond :: Lens' DiskUtilization (Maybe Int32)
684+duTargetWriteOpsPerSecond
685+ = lens _duTargetWriteOpsPerSecond
686+ (\ s a -> s{_duTargetWriteOpsPerSecond = a})
603687 . mapping _Coerce
604688
605−-- | Target bytes per second read.
606−duTargetReadBytesPerSec :: Lens' DiskUtilization (Maybe Int32)
607−duTargetReadBytesPerSec
608− = lens _duTargetReadBytesPerSec
609− (\ s a -> s{_duTargetReadBytesPerSec = a})
689+-- | Target bytes written per second.
690+duTargetWriteBytesPerSecond :: Lens' DiskUtilization (Maybe Int32)
691+duTargetWriteBytesPerSecond
692+ = lens _duTargetWriteBytesPerSecond
693+ (\ s a -> s{_duTargetWriteBytesPerSecond = a})
610694 . mapping _Coerce
611695
612696instance FromJSON DiskUtilization where
@@ -614,23 +698,23 @@ instance FromJSON DiskUtilization where
614698 = withObject "DiskUtilization"
615699 (\ o ->
616700 DiskUtilization' <$>
617− (o .:? "targetWriteOpsPerSec") <*>
618− (o .:? "targetReadOpsPerSec")
619− <*> (o .:? "targetWriteBytesPerSec")
620− <*> (o .:? "targetReadBytesPerSec"))
701+ (o .:? "targetReadBytesPerSecond") <*>
702+ (o .:? "targetReadOpsPerSecond")
703+ <*> (o .:? "targetWriteOpsPerSecond")
704+ <*> (o .:? "targetWriteBytesPerSecond"))
621705
622706instance ToJSON DiskUtilization where
623707 toJSON DiskUtilization'{..}
624708 = object
625709 (catMaybes
626− [("targetWriteOpsPerSec" .=) <$>
627− _duTargetWriteOpsPerSec,
628− ("targetReadOpsPerSec" .=) <$>
629− _duTargetReadOpsPerSec,
630− ("targetWriteBytesPerSec" .=) <$>
631− _duTargetWriteBytesPerSec,
632− ("targetReadBytesPerSec" .=) <$>
633− _duTargetReadBytesPerSec])
710+ [("targetReadBytesPerSecond" .=) <$>
711+ _duTargetReadBytesPerSecond,
712+ ("targetReadOpsPerSecond" .=) <$>
713+ _duTargetReadOpsPerSecond,
714+ ("targetWriteOpsPerSecond" .=) <$>
715+ _duTargetWriteOpsPerSecond,
716+ ("targetWriteBytesPerSecond" .=) <$>
717+ _duTargetWriteBytesPerSecond])
634718
635719-- | The response message for Operations.ListOperations.
636720--
@@ -684,8 +768,9 @@ instance ToJSON ListOperationsResponse where
684768 [("nextPageToken" .=) <$> _lorNextPageToken,
685769 ("operations" .=) <$> _lorOperations])
686770
687−-- | Configure health checking for the VM instances. Unhealthy VM instances
688−-- will be killed and replaced with new instances.
771+-- | Health checking configuration for VM instances. Unhealthy instances are
772+-- killed and replaced with new instances. Only applicable for instances in
773+-- App Engine flexible environment.
689774--
690775-- /See:/ 'healthCheck' smart constructor.
691776data HealthCheck = HealthCheck'
@@ -728,7 +813,7 @@ healthCheck =
728813 , _hcUnhealthyThreshold = Nothing
729814 }
730815
731−-- | The number of consecutive successful health checks before receiving
816+-- | Number of consecutive successful health checks required before receiving
732817-- traffic.
733818hcHealthyThreshold :: Lens' HealthCheck (Maybe Word32)
734819hcHealthyThreshold
@@ -742,31 +827,32 @@ hcDisableHealthCheck
742827 = lens _hcDisableHealthCheck
743828 (\ s a -> s{_hcDisableHealthCheck = a})
744829
745−-- | The interval between health checks.
830+-- | Interval between health checks.
746831hcCheckInterval :: Lens' HealthCheck (Maybe Text)
747832hcCheckInterval
748833 = lens _hcCheckInterval
749834 (\ s a -> s{_hcCheckInterval = a})
750835
751−-- | The number of consecutive failed health checks before an instance is
752−-- restarted.
836+-- | Number of consecutive failed health checks required before an instance
837+-- is restarted.
753838hcRestartThreshold :: Lens' HealthCheck (Maybe Word32)
754839hcRestartThreshold
755840 = lens _hcRestartThreshold
756841 (\ s a -> s{_hcRestartThreshold = a})
757842 . mapping _Coerce
758843
759−-- | The host header to send when performing an HTTP health check (e.g.
760−-- myapp.appspot.com)
844+-- | Host header to send when performing an HTTP health check. Example:
845+-- \"myapp.appspot.com\"
761846hcHost :: Lens' HealthCheck (Maybe Text)
762847hcHost = lens _hcHost (\ s a -> s{_hcHost = a})
763848
764−-- | The amount of time before the health check is considered failed.
849+-- | Time before the health check is considered failed.
765850hcTimeout :: Lens' HealthCheck (Maybe Text)
766851hcTimeout
767852 = lens _hcTimeout (\ s a -> s{_hcTimeout = a})
768853
769−-- | The number of consecutive failed health checks before removing traffic.
854+-- | Number of consecutive failed health checks required before removing
855+-- traffic.
770856hcUnhealthyThreshold :: Lens' HealthCheck (Maybe Word32)
771857hcUnhealthyThreshold
772858 = lens _hcUnhealthyThreshold
@@ -798,7 +884,9 @@ instance ToJSON HealthCheck where
798884 ("timeout" .=) <$> _hcTimeout,
799885 ("unhealthyThreshold" .=) <$> _hcUnhealthyThreshold])
800886
801−-- | API Serving configuration for Cloud Endpoints.
887+-- | [Google Cloud
888+-- Endpoints](https:\/\/cloud.google.com\/appengine\/docs\/python\/endpoints\/)
889+-- configuration for API handlers.
802890--
803891-- /See:/ 'apiConfigHandler' smart constructor.
804892data APIConfigHandler = APIConfigHandler'
@@ -833,12 +921,12 @@ apiConfigHandler =
833921 , _achLogin = Nothing
834922 }
835923
836−-- | Specifies the path to the script from the application root directory.
924+-- | Path to the script from the application root directory.
837925achScript :: Lens' APIConfigHandler (Maybe Text)
838926achScript
839927 = lens _achScript (\ s a -> s{_achScript = a})
840928
841−-- | Configures whether security (HTTPS) should be enforced for this URL.
929+-- | Security (HTTPS) enforcement for this URL.
842930achSecurityLevel :: Lens' APIConfigHandler (Maybe Text)
843931achSecurityLevel
844932 = lens _achSecurityLevel
@@ -848,15 +936,15 @@ achSecurityLevel
848936achURL :: Lens' APIConfigHandler (Maybe Text)
849937achURL = lens _achURL (\ s a -> s{_achURL = a})
850938
851−-- | For users not logged in, how to handle access to resources with required
852−-- login. Defaults to \"redirect\".
939+-- | Action to take when users access resources that require authentication.
940+-- Defaults to \`redirect\`.
853941achAuthFailAction :: Lens' APIConfigHandler (Maybe Text)
854942achAuthFailAction
855943 = lens _achAuthFailAction
856944 (\ s a -> s{_achAuthFailAction = a})
857945
858−-- | What level of login is required to access this resource. Default is
859−-- \"optional\".
946+-- | Level of login required to access this resource. Defaults to
947+-- \`optional\`.
860948achLogin :: Lens' APIConfigHandler (Maybe Text)
861949achLogin = lens _achLogin (\ s a -> s{_achLogin = a})
862950
@@ -880,9 +968,8 @@ instance ToJSON APIConfigHandler where
880968 ("authFailAction" .=) <$> _achAuthFailAction,
881969 ("login" .=) <$> _achLogin])
882970
883−-- | Environment variables made available to the application. Only returned
884−-- in \`GET\` requests if \`view=FULL\` is set. May only be set on create
885−-- requests; once created, is immutable.
971+-- | Environment variables available to the application. Only returned in
972+-- \`GET\` requests if \`view=FULL\` is set.
886973--
887974-- /See:/ 'versionEnvVariables' smart constructor.
888975newtype VersionEnvVariables = VersionEnvVariables'
@@ -915,20 +1002,20 @@ instance FromJSON VersionEnvVariables where
9151002instance ToJSON VersionEnvVariables where
9161003 toJSON = toJSON . _vevAddtional
9171004
918−-- | An Application contains the top-level configuration of an App Engine
919−-- application.
1005+-- | An Application resource contains the top-level configuration of an App
1006+-- Engine application.
9201007--
9211008-- /See:/ 'application' smart constructor.
9221009data Application = Application'
9231010 { _aDefaultHostname :: !(Maybe Text)
9241011 , _aDefaultCookieExpiration :: !(Maybe Text)
925− , _aLocation :: !(Maybe Text)
9261012 , _aAuthDomain :: !(Maybe Text)
9271013 , _aCodeBucket :: !(Maybe Text)
9281014 , _aName :: !(Maybe Text)
9291015 , _aDispatchRules :: !(Maybe [URLDispatchRule])
9301016 , _aDefaultBucket :: !(Maybe Text)
9311017 , _aId :: !(Maybe Text)
1018+ , _aLocationId :: !(Maybe Text)
9321019 } deriving (Eq,Show,Data,Typeable,Generic)
9331020
9341021-- | Creates a value of 'Application' with the minimum fields required to make a request.
@@ -939,8 +1026,6 @@ data Application = Application'
9391026--
9401027-- * 'aDefaultCookieExpiration'
9411028--
942−-- * 'aLocation'
943−--
9441029-- * 'aAuthDomain'
9451030--
9461031-- * 'aCodeBucket'
@@ -952,66 +1037,58 @@ data Application = Application'
9521037-- * 'aDefaultBucket'
9531038--
9541039-- * 'aId'
1040+--
1041+-- * 'aLocationId'
9551042application
9561043 :: Application
9571044application =
9581045 Application'
9591046 { _aDefaultHostname = Nothing
9601047 , _aDefaultCookieExpiration = Nothing
961− , _aLocation = Nothing
9621048 , _aAuthDomain = Nothing
9631049 , _aCodeBucket = Nothing
9641050 , _aName = Nothing
9651051 , _aDispatchRules = Nothing
9661052 , _aDefaultBucket = Nothing
9671053 , _aId = Nothing
1054+ , _aLocationId = Nothing
9681055 }
9691056
970−-- | The hostname used to reach the application, as resolved by App Engine.
1057+-- | Hostname used to reach this application, as resolved by App Engine.
9711058-- \'OutputOnly
9721059aDefaultHostname :: Lens' Application (Maybe Text)
9731060aDefaultHostname
9741061 = lens _aDefaultHostname
9751062 (\ s a -> s{_aDefaultHostname = a})
9761063
977−-- | Determines the cookie expiration policy for the application.
978−-- \'OutputOnly
1064+-- | Cookie expiration policy for this application. \'OutputOnly
9791065aDefaultCookieExpiration :: Lens' Application (Maybe Text)
9801066aDefaultCookieExpiration
9811067 = lens _aDefaultCookieExpiration
9821068 (\ s a -> s{_aDefaultCookieExpiration = a})
9831069
984−-- | The location from which the application will be run. Application
985−-- instances will run out of data centers in the chosen location and all of
986−-- the application\'s End User Content will be stored at rest. The default
987−-- is \"us-central\". Choices are: \"us-central\" - Central US
988−-- \"europe-west\" - Western Europe \"us-east1\" - Eastern US
989−aLocation :: Lens' Application (Maybe Text)
990−aLocation
991− = lens _aLocation (\ s a -> s{_aLocation = a})
992−
993−-- | If set, only users from the specified Google Apps authentication domain
994−-- may access the application. If not set, any Google Account may access
995−-- the application.
1070+-- | Google Apps authentication domain that controls which users can access
1071+-- this application. Defaults to open access for any Google Account.
9961072aAuthDomain :: Lens' Application (Maybe Text)
9971073aAuthDomain
9981074 = lens _aAuthDomain (\ s a -> s{_aAuthDomain = a})
9991075
1000−-- | A Google Cloud Storage bucket which can be used for storing files
1001−-- associated with an application. This bucket is associated with the
1076+-- | Google Cloud Storage bucket that can be used for storing files
1077+-- associated with this application. This bucket is associated with the
10021078-- application and can be used by the gcloud deployment commands.
10031079-- \'OutputOnly
10041080aCodeBucket :: Lens' Application (Maybe Text)
10051081aCodeBucket
10061082 = lens _aCodeBucket (\ s a -> s{_aCodeBucket = a})
10071083
1008−-- | The full path to the application in the API. Example: \"apps\/myapp\".
1009−-- \'OutputOnly
1084+-- | Full path to the Application resource in the API. Example:
1085+-- \`apps\/myapp\`. \'OutputOnly
10101086aName :: Lens' Application (Maybe Text)
10111087aName = lens _aName (\ s a -> s{_aName = a})
10121088
1013−-- | HTTP path dispatch rules for requests to the app that do not explicitly
1014−-- target a service or version. The rules are order-dependent. \'OutputOnly
1089+-- | HTTP path dispatch rules for requests to the application that do not
1090+-- explicitly target a service or version. Rules are order-dependent.
1091+-- \'OutputOnly
10151092aDispatchRules :: Lens' Application [URLDispatchRule]
10161093aDispatchRules
10171094 = lens _aDispatchRules
@@ -1019,17 +1096,28 @@ aDispatchRules
10191096 . _Default
10201097 . _Coerce
10211098
1022−-- | A Google Cloud Storage bucket which can be used by the application to
1099+-- | Google Cloud Storage bucket that can be used by this application to
10231100-- store content. \'OutputOnly
10241101aDefaultBucket :: Lens' Application (Maybe Text)
10251102aDefaultBucket
10261103 = lens _aDefaultBucket
10271104 (\ s a -> s{_aDefaultBucket = a})
10281105
1029−-- | The relative name\/path of the application. Example: \"myapp\".
1106+-- | Identifier of the Application resource. This identifier is equivalent to
1107+-- the project ID of the Google Cloud Platform project where you want to
1108+-- deploy your application. Example: \`myapp\`.
10301109aId :: Lens' Application (Maybe Text)
10311110aId = lens _aId (\ s a -> s{_aId = a})
10321111
1112+-- | Location from which this application will be run. Application instances
1113+-- will run out of data centers in the chosen location, which is also where
1114+-- all of the application\'s end user content is stored. Defaults to
1115+-- \`us-central\`. Options are: \`us-central\` - Central US \`europe-west\`
1116+-- - Western Europe \`us-east1\` - Eastern US
1117+aLocationId :: Lens' Application (Maybe Text)
1118+aLocationId
1119+ = lens _aLocationId (\ s a -> s{_aLocationId = a})
1120+
10331121instance FromJSON Application where
10341122 parseJSON
10351123 = withObject "Application"
@@ -1037,13 +1125,13 @@ instance FromJSON Application where
10371125 Application' <$>
10381126 (o .:? "defaultHostname") <*>
10391127 (o .:? "defaultCookieExpiration")
1040− <*> (o .:? "location")
10411128 <*> (o .:? "authDomain")
10421129 <*> (o .:? "codeBucket")
10431130 <*> (o .:? "name")
10441131 <*> (o .:? "dispatchRules" .!= mempty)
10451132 <*> (o .:? "defaultBucket")
1046− <*> (o .:? "id"))
1133+ <*> (o .:? "id")
1134+ <*> (o .:? "locationId"))
10471135
10481136instance ToJSON Application where
10491137 toJSON Application'{..}
@@ -1052,15 +1140,16 @@ instance ToJSON Application where
10521140 [("defaultHostname" .=) <$> _aDefaultHostname,
10531141 ("defaultCookieExpiration" .=) <$>
10541142 _aDefaultCookieExpiration,
1055− ("location" .=) <$> _aLocation,
10561143 ("authDomain" .=) <$> _aAuthDomain,
10571144 ("codeBucket" .=) <$> _aCodeBucket,
10581145 ("name" .=) <$> _aName,
10591146 ("dispatchRules" .=) <$> _aDispatchRules,
10601147 ("defaultBucket" .=) <$> _aDefaultBucket,
1061− ("id" .=) <$> _aId])
1148+ ("id" .=) <$> _aId,
1149+ ("locationId" .=) <$> _aLocationId])
10621150
1063−-- | Beta settings supplied to the application via metadata.
1151+-- | Metadata settings that are supplied to this version to enable beta
1152+-- runtime features.
10641153--
10651154-- /See:/ 'versionBetaSettings' smart constructor.
10661155newtype VersionBetaSettings = VersionBetaSettings'
@@ -1093,13 +1182,13 @@ instance FromJSON VersionBetaSettings where
10931182instance ToJSON VersionBetaSettings where
10941183 toJSON = toJSON . _vbsAddtional
10951184
1096−-- | A service is a logical component of an application that can share state
1097−-- and communicate in a secure fashion with other services. For example, an
1098−-- application that handles customer requests might include separate
1099−-- services to handle other tasks such as API requests from mobile devices
1100−-- or backend data analysis. Each service has a collection of versions that
1101−-- define a specific set of code used to implement the functionality of
1102−-- that service.
1185+-- | A Service resource is a logical component of an application that can
1186+-- share state and communicate in a secure fashion with other services. For
1187+-- example, an application that handles customer requests might include
1188+-- separate services to handle tasks such as backend data analysis or API
1189+-- requests from mobile devices. Each service has a collection of versions
1190+-- that define a specific set of code used to implement the functionality
1191+-- of that service.
11031192--
11041193-- /See:/ 'service' smart constructor.
11051194data Service = Service'
@@ -1126,18 +1215,18 @@ service =
11261215 , _sId = Nothing
11271216 }
11281217
1129−-- | A mapping that defines fractional HTTP traffic diversion to different
1218+-- | Mapping that defines fractional HTTP traffic diversion to different
11301219-- versions within the service.
11311220sSplit :: Lens' Service (Maybe TrafficSplit)
11321221sSplit = lens _sSplit (\ s a -> s{_sSplit = a})
11331222
1134−-- | The full path to the Service resource in the API. Example:
1135−-- \"apps\/myapp\/services\/default\" \'OutputOnly
1223+-- | Full path to the Service resource in the API. Example:
1224+-- \`apps\/myapp\/services\/default\`. \'OutputOnly
11361225sName :: Lens' Service (Maybe Text)
11371226sName = lens _sName (\ s a -> s{_sName = a})
11381227
1139−-- | The relative name\/path of the service within the application. Example:
1140−-- \"default\" \'OutputOnly
1228+-- | Relative name of the service within the application. Example:
1229+-- \`default\`. \'OutputOnly
11411230sId :: Lens' Service (Maybe Text)
11421231sId = lens _sId (\ s a -> s{_sId = a})
11431232
@@ -1155,6 +1244,78 @@ instance ToJSON Service where
11551244 [("split" .=) <$> _sSplit, ("name" .=) <$> _sName,
11561245 ("id" .=) <$> _sId])
11571246
1247+-- | A resource that represents Google Cloud Platform location.
1248+--
1249+-- /See:/ 'location' smart constructor.
1250+data Location = Location'
1251+ { _locName :: !(Maybe Text)
1252+ , _locMetadata :: !(Maybe LocationSchema)
1253+ , _locLabels :: !(Maybe LocationLabels)
1254+ , _locLocationId :: !(Maybe Text)
1255+ } deriving (Eq,Show,Data,Typeable,Generic)
1256+
1257+-- | Creates a value of 'Location' with the minimum fields required to make a request.
1258+--
1259+-- Use one of the following lenses to modify other fields as desired:
1260+--
1261+-- * 'locName'
1262+--
1263+-- * 'locMetadata'
1264+--
1265+-- * 'locLabels'
1266+--
1267+-- * 'locLocationId'
1268+location
1269+ :: Location
1270+location =
1271+ Location'
1272+ { _locName = Nothing
1273+ , _locMetadata = Nothing
1274+ , _locLabels = Nothing
1275+ , _locLocationId = Nothing
1276+ }
1277+
1278+-- | Resource name for the location, which may vary between implementations.
1279+-- For example: \`\"projects\/example-project\/locations\/us-east1\"\`
1280+locName :: Lens' Location (Maybe Text)
1281+locName = lens _locName (\ s a -> s{_locName = a})
1282+
1283+-- | Service-specific metadata. For example the available capacity at the
1284+-- given location.
1285+locMetadata :: Lens' Location (Maybe LocationSchema)
1286+locMetadata
1287+ = lens _locMetadata (\ s a -> s{_locMetadata = a})
1288+
1289+-- | Cross-service attributes for the location. For example
1290+-- {\"cloud.googleapis.com\/region\": \"us-east1\"}
1291+locLabels :: Lens' Location (Maybe LocationLabels)
1292+locLabels
1293+ = lens _locLabels (\ s a -> s{_locLabels = a})
1294+
1295+-- | The canonical id for this location. For example: \`\"us-east1\"\`.
1296+locLocationId :: Lens' Location (Maybe Text)
1297+locLocationId
1298+ = lens _locLocationId
1299+ (\ s a -> s{_locLocationId = a})
1300+
1301+instance FromJSON Location where
1302+ parseJSON
1303+ = withObject "Location"
1304+ (\ o ->
1305+ Location' <$>
1306+ (o .:? "name") <*> (o .:? "metadata") <*>
1307+ (o .:? "labels")
1308+ <*> (o .:? "locationId"))
1309+
1310+instance ToJSON Location where
1311+ toJSON Location'{..}
1312+ = object
1313+ (catMaybes
1314+ [("name" .=) <$> _locName,
1315+ ("metadata" .=) <$> _locMetadata,
1316+ ("labels" .=) <$> _locLabels,
1317+ ("locationId" .=) <$> _locLocationId])
1318+
11581319-- | This resource represents a long-running operation that is the result of
11591320-- a network API call.
11601321--
@@ -1246,6 +1407,58 @@ instance ToJSON Operation where
12461407 ("name" .=) <$> _oName,
12471408 ("metadata" .=) <$> _oMetadata])
12481409
1410+-- | The zip file information for a zip deployment.
1411+--
1412+-- /See:/ 'zipInfo' smart constructor.
1413+data ZipInfo = ZipInfo'
1414+ { _ziFilesCount :: !(Maybe (Textual Int32))
1415+ , _ziSourceURL :: !(Maybe Text)
1416+ } deriving (Eq,Show,Data,Typeable,Generic)
1417+
1418+-- | Creates a value of 'ZipInfo' with the minimum fields required to make a request.
1419+--
1420+-- Use one of the following lenses to modify other fields as desired:
1421+--
1422+-- * 'ziFilesCount'
1423+--
1424+-- * 'ziSourceURL'
1425+zipInfo
1426+ :: ZipInfo
1427+zipInfo =
1428+ ZipInfo'
1429+ { _ziFilesCount = Nothing
1430+ , _ziSourceURL = Nothing
1431+ }
1432+
1433+-- | An estimate of the number of files in a zip for a zip deployment. If
1434+-- set, must be greater than or equal to the actual number of files. Used
1435+-- for optimizing performance; if not provided, deployment may be slow.
1436+ziFilesCount :: Lens' ZipInfo (Maybe Int32)
1437+ziFilesCount
1438+ = lens _ziFilesCount (\ s a -> s{_ziFilesCount = a})
1439+ . mapping _Coerce
1440+
1441+-- | URL of the zip file to deploy from. Must be a URL to a resource in
1442+-- Google Cloud Storage in the form
1443+-- \'http(s):\/\/storage.googleapis.com\/\\\/\\\'.
1444+ziSourceURL :: Lens' ZipInfo (Maybe Text)
1445+ziSourceURL
1446+ = lens _ziSourceURL (\ s a -> s{_ziSourceURL = a})
1447+
1448+instance FromJSON ZipInfo where
1449+ parseJSON
1450+ = withObject "ZipInfo"
1451+ (\ o ->
1452+ ZipInfo' <$>
1453+ (o .:? "filesCount") <*> (o .:? "sourceUrl"))
1454+
1455+instance ToJSON ZipInfo where
1456+ toJSON ZipInfo'{..}
1457+ = object
1458+ (catMaybes
1459+ [("filesCount" .=) <$> _ziFilesCount,
1460+ ("sourceUrl" .=) <$> _ziSourceURL])
1461+
12491462-- | Rules to match an HTTP request and dispatch that request to a service.
12501463--
12511464-- /See:/ 'urlDispatchRule' smart constructor.
@@ -1273,21 +1486,21 @@ urlDispatchRule =
12731486 , _udrDomain = Nothing
12741487 }
12751488
1276−-- | The pathname within the host. This must start with a \'\/\'. A single
1277−-- \'*\' (glob) can be included at the end of the path. The sum of the
1278−-- lengths of the domain and path may not exceed 100 characters.
1489+-- | Pathname within the host. Must start with a \"\`\/\`\". A single
1490+-- \"\`*\`\" can be included at the end of the path. The sum of the lengths
1491+-- of the domain and path may not exceed 100 characters.
12791492udrPath :: Lens' URLDispatchRule (Maybe Text)
12801493udrPath = lens _udrPath (\ s a -> s{_udrPath = a})
12811494
1282−-- | The resource id of a Service in this application that should service the
1283−-- matched request. The Service must already exist. Example: \"default\".
1495+-- | Resource ID of a service in this application that should serve the
1496+-- matched request. The service must already exist. Example: \`default\`.
12841497udrService :: Lens' URLDispatchRule (Maybe Text)
12851498udrService
12861499 = lens _udrService (\ s a -> s{_udrService = a})
12871500
1288−-- | The domain name to match on. Supports \'*\' (glob) wildcarding on the
1289−-- left-hand side of a \'.\'. If empty, all domains will be matched (the
1290−-- same as \'*\').
1501+-- | Domain name to match against. The wildcard \"\`*\`\" is supported if
1502+-- specified before a period: \"\`*.\`\". Defaults to matching all domains:
1503+-- \"\`*\`\".
12911504udrDomain :: Lens' URLDispatchRule (Maybe Text)
12921505udrDomain
12931506 = lens _udrDomain (\ s a -> s{_udrDomain = a})
@@ -1337,7 +1550,7 @@ lvrNextPageToken
13371550 = lens _lvrNextPageToken
13381551 (\ s a -> s{_lvrNextPageToken = a})
13391552
1340−-- | The versions belonging to the requested application service.
1553+-- | The versions belonging to the requested service.
13411554lvrVersions :: Lens' ListVersionsResponse [Version]
13421555lvrVersions
13431556 = lens _lvrVersions (\ s a -> s{_lvrVersions = a}) .
@@ -1359,7 +1572,8 @@ instance ToJSON ListVersionsResponse where
13591572 [("nextPageToken" .=) <$> _lvrNextPageToken,
13601573 ("versions" .=) <$> _lvrVersions])
13611574
1362−-- | A single source file which is part of the application to be deployed.
1575+-- | Single source file that is part of the version to be deployed. Each
1576+-- source file that is deployed must be specified separately.
13631577--
13641578-- /See:/ 'fileInfo' smart constructor.
13651579data FileInfo = FileInfo'
@@ -1386,18 +1600,18 @@ fileInfo =
13861600 , _fiSourceURL = Nothing
13871601 }
13881602
1389−-- | The SHA1 (160 bits) hash of the file in hex.
1603+-- | The SHA1 hash of the file, in hex.
13901604fiSha1Sum :: Lens' FileInfo (Maybe Text)
13911605fiSha1Sum
13921606 = lens _fiSha1Sum (\ s a -> s{_fiSha1Sum = a})
13931607
1394−-- | The MIME type of the file; if unspecified, the value from Google Cloud
1395−-- Storage will be used.
1608+-- | The MIME type of the file. Defaults to the value from Google Cloud
1609+-- Storage.
13961610fiMimeType :: Lens' FileInfo (Maybe Text)
13971611fiMimeType
13981612 = lens _fiMimeType (\ s a -> s{_fiMimeType = a})
13991613
1400−-- | The URL source to use to fetch this file. Must be a URL to a resource in
1614+-- | URL source to use to fetch this file. Must be a URL to a resource in
14011615-- Google Cloud Storage in the form
14021616-- \'http(s):\/\/storage.googleapis.com\/\\\/\\\'.
14031617fiSourceURL :: Lens' FileInfo (Maybe Text)
@@ -1420,8 +1634,7 @@ instance ToJSON FileInfo where
14201634 ("mimeType" .=) <$> _fiMimeType,
14211635 ("sourceUrl" .=) <$> _fiSourceURL])
14221636
1423−-- | Automatic scaling is the scaling policy that App Engine has used since
1424−-- its inception. It is based on request rate, response latencies, and
1637+-- | Automatic scaling is based on request rate, response latencies, and
14251638-- other application metrics.
14261639--
14271640-- /See:/ 'automaticScaling' smart constructor.
@@ -1491,16 +1704,15 @@ asNetworkUtilization
14911704 = lens _asNetworkUtilization
14921705 (\ s a -> s{_asNetworkUtilization = a})
14931706
1494−-- | Max number of instances that App Engine should start to handle requests.
1707+-- | Maximum number of instances that should be started to handle requests.
14951708asMaxTotalInstances :: Lens' AutomaticScaling (Maybe Int32)
14961709asMaxTotalInstances
14971710 = lens _asMaxTotalInstances
14981711 (\ s a -> s{_asMaxTotalInstances = a})
14991712 . mapping _Coerce
15001713
1501−-- | The minimum number of idle instances that App Engine should maintain for
1502−-- this version. Only applies to the default version of a service, since
1503−-- other versions are not expected to receive significant traffic.
1714+-- | Minimum number of idle instances that should be maintained for this
1715+-- version. Only applicable for the default version of a service.
15041716asMinIdleInstances :: Lens' AutomaticScaling (Maybe Int32)
15051717asMinIdleInstances
15061718 = lens _asMinIdleInstances
@@ -1513,8 +1725,8 @@ asDiskUtilization
15131725 = lens _asDiskUtilization
15141726 (\ s a -> s{_asDiskUtilization = a})
15151727
1516−-- | The minimum amount of time that App Engine should allow a request to
1517−-- wait in the pending queue before starting a new instance to handle it.
1728+-- | Minimum amount of time a request should wait in the pending queue before
1729+-- starting a new instance to handle it.
15181730asMinPendingLatency :: Lens' AutomaticScaling (Maybe Text)
15191731asMinPendingLatency
15201732 = lens _asMinPendingLatency
@@ -1526,34 +1738,34 @@ asCPUUtilization
15261738 = lens _asCPUUtilization
15271739 (\ s a -> s{_asCPUUtilization = a})
15281740
1529−-- | The maximum number of idle instances that App Engine should maintain for
1530−-- this version.
1741+-- | Maximum number of idle instances that should be maintained for this
1742+-- version.
15311743asMaxIdleInstances :: Lens' AutomaticScaling (Maybe Int32)
15321744asMaxIdleInstances
15331745 = lens _asMaxIdleInstances
15341746 (\ s a -> s{_asMaxIdleInstances = a})
15351747 . mapping _Coerce
15361748
1537−-- | Minimum number of instances that App Engine should maintain.
1749+-- | Minimum number of instances that should be maintained for this version.
15381750asMinTotalInstances :: Lens' AutomaticScaling (Maybe Int32)
15391751asMinTotalInstances
15401752 = lens _asMinTotalInstances
15411753 (\ s a -> s{_asMinTotalInstances = a})
15421754 . mapping _Coerce
15431755
1544−-- | The number of concurrent requests an automatic scaling instance can
1545−-- accept before the scheduler spawns a new instance. Default value is
1546−-- chosen based on the runtime.
1756+-- | Number of concurrent requests an automatic scaling instance can accept
1757+-- before the scheduler spawns a new instance. Defaults to a
1758+-- runtime-specific value.
15471759asMaxConcurrentRequests :: Lens' AutomaticScaling (Maybe Int32)
15481760asMaxConcurrentRequests
15491761 = lens _asMaxConcurrentRequests
15501762 (\ s a -> s{_asMaxConcurrentRequests = a})
15511763 . mapping _Coerce
15521764
1553−-- | The amount of time that the
1765+-- | Amount of time that the
15541766-- [Autoscaler](https:\/\/cloud.google.com\/compute\/docs\/autoscaler\/)
1555−-- should wait between changes to the number of virtual machines. Applies
1556−-- only to the VM runtime.
1767+-- should wait between changes to the number of virtual machines. Only
1768+-- applicable for VM runtimes.
15571769asCoolDownPeriod :: Lens' AutomaticScaling (Maybe Text)
15581770asCoolDownPeriod
15591771 = lens _asCoolDownPeriod
@@ -1565,8 +1777,8 @@ asRequestUtilization
15651777 = lens _asRequestUtilization
15661778 (\ s a -> s{_asRequestUtilization = a})
15671779
1568−-- | The maximum amount of time that App Engine should allow a request to
1569−-- wait in the pending queue before starting a new instance to handle it.
1780+-- | Maximum amount of time that a request should wait in the pending queue
1781+-- before starting a new instance to handle it.
15701782asMaxPendingLatency :: Lens' AutomaticScaling (Maybe Text)
15711783asMaxPendingLatency
15721784 = lens _asMaxPendingLatency
@@ -1643,30 +1855,29 @@ operationMetadataV1Beta5 =
16431855 , _omvbTarget = Nothing
16441856 }
16451857
1646−-- | Timestamp that this operation was received. \'OutputOnly
1858+-- | Timestamp that this operation was created. \'OutputOnly
16471859omvbInsertTime :: Lens' OperationMetadataV1Beta5 (Maybe Text)
16481860omvbInsertTime
16491861 = lens _omvbInsertTime
16501862 (\ s a -> s{_omvbInsertTime = a})
16511863
1652−-- | The user who requested this operation. \'OutputOnly
1864+-- | User who requested this operation. \'OutputOnly
16531865omvbUser :: Lens' OperationMetadataV1Beta5 (Maybe Text)
16541866omvbUser = lens _omvbUser (\ s a -> s{_omvbUser = a})
16551867
1656−-- | API method name that initiated the operation. Example:
1657−-- \"google.appengine.v1beta5.Version.CreateVersion\". \'OutputOnly
1868+-- | API method name that initiated this operation. Example:
1869+-- \`google.appengine.v1beta5.Version.CreateVersion\`. \'OutputOnly
16581870omvbMethod :: Lens' OperationMetadataV1Beta5 (Maybe Text)
16591871omvbMethod
16601872 = lens _omvbMethod (\ s a -> s{_omvbMethod = a})
16611873
1662−-- | Timestamp that this operation was completed. (Not present if the
1663−-- operation is still in progress.) \'OutputOnly
1874+-- | Timestamp that this operation completed. \'OutputOnly
16641875omvbEndTime :: Lens' OperationMetadataV1Beta5 (Maybe Text)
16651876omvbEndTime
16661877 = lens _omvbEndTime (\ s a -> s{_omvbEndTime = a})
16671878
1668−-- | Resource that this operation is acting on. Example:
1669−-- \"apps\/myapp\/services\/default\". \'OutputOnly
1879+-- | Name of the resource that this operation is acting on. Example:
1880+-- \`apps\/myapp\/services\/default\`. \'OutputOnly
16701881omvbTarget :: Lens' OperationMetadataV1Beta5 (Maybe Text)
16711882omvbTarget
16721883 = lens _omvbTarget (\ s a -> s{_omvbTarget = a})
@@ -1691,7 +1902,7 @@ instance ToJSON OperationMetadataV1Beta5 where
16911902 ("endTime" .=) <$> _omvbEndTime,
16921903 ("target" .=) <$> _omvbTarget])
16931904
1694−-- | Use Google Cloud Endpoints to handle requests.
1905+-- | Uses Google Cloud Endpoints to handle requests.
16951906--
16961907-- /See:/ 'apiEndpointHandler' smart constructor.
16971908newtype APIEndpointHandler = APIEndpointHandler'
@@ -1710,7 +1921,7 @@ apiEndpointHandler =
17101921 { _aehScriptPath = Nothing
17111922 }
17121923
1713−-- | Specifies the path to the script from the application root directory.
1924+-- | Path to the script from the application root directory.
17141925aehScriptPath :: Lens' APIEndpointHandler (Maybe Text)
17151926aehScriptPath
17161927 = lens _aehScriptPath
@@ -1745,7 +1956,7 @@ statusDetailsItem pSdiAddtional_ =
17451956 { _sdiAddtional = _Coerce # pSdiAddtional_
17461957 }
17471958
1748−-- | Properties of the object. Contains field \'ype with type URL.
1959+-- | Properties of the object. Contains field \'type with type URL.
17491960sdiAddtional :: Lens' StatusDetailsItem (HashMap Text JSONValue)
17501961sdiAddtional
17511962 = lens _sdiAddtional (\ s a -> s{_sdiAddtional = a})
@@ -1759,7 +1970,7 @@ instance FromJSON StatusDetailsItem where
17591970instance ToJSON StatusDetailsItem where
17601971 toJSON = toJSON . _sdiAddtional
17611972
1762−-- | Used to specify extra network settings (for VM runtimes only).
1973+-- | Extra network settings. Only applicable for VM runtimes.
17631974--
17641975-- /See:/ 'network' smart constructor.
17651976data Network = Network'
@@ -1786,8 +1997,8 @@ network =
17861997 , _nName = Nothing
17871998 }
17881999
1789−-- | A list of ports (or port pairs) to forward from the VM into the app
1790−-- container.
2000+-- | List of ports, or port pairs, to forward from the virtual machine to the
2001+-- application container.
17912002nForwardedPorts :: Lens' Network [Text]
17922003nForwardedPorts
17932004 = lens _nForwardedPorts
@@ -1795,14 +2006,13 @@ nForwardedPorts
17952006 . _Default
17962007 . _Coerce
17972008
1798−-- | A tag to apply to the VM instance during creation.
2009+-- | Tag to apply to the VM instance during creation.
17992010nInstanceTag :: Lens' Network (Maybe Text)
18002011nInstanceTag
18012012 = lens _nInstanceTag (\ s a -> s{_nInstanceTag = a})
18022013
1803−-- | The Google Compute Engine network where the VMs will be created. If not
1804−-- specified, or empty, the network named \"default\" will be used. (The
1805−-- short name should be specified, not the resource path.)
2014+-- | Google Cloud Platform network where the virtual machines are created.
2015+-- Specify the short name, not the resource path. Defaults to \`default\`.
18062016nName :: Lens' Network (Maybe Text)
18072017nName = lens _nName (\ s a -> s{_nName = a})
18082018
@@ -1823,6 +2033,27 @@ instance ToJSON Network where
18232033 ("instanceTag" .=) <$> _nInstanceTag,
18242034 ("name" .=) <$> _nName])
18252035
2036+-- | Request message for \`Instances.DebugInstance\`.
2037+--
2038+-- /See:/ 'debugInstanceRequest' smart constructor.
2039+data DebugInstanceRequest =
2040+ DebugInstanceRequest'
2041+ deriving (Eq,Show,Data,Typeable,Generic)
2042+
2043+-- | Creates a value of 'DebugInstanceRequest' with the minimum fields required to make a request.
2044+--
2045+debugInstanceRequest
2046+ :: DebugInstanceRequest
2047+debugInstanceRequest = DebugInstanceRequest'
2048+
2049+instance FromJSON DebugInstanceRequest where
2050+ parseJSON
2051+ = withObject "DebugInstanceRequest"
2052+ (\ o -> pure DebugInstanceRequest')
2053+
2054+instance ToJSON DebugInstanceRequest where
2055+ toJSON = const emptyObject
2056+
18262057-- | HTTP headers to use for all responses from these URLs.
18272058--
18282059-- /See:/ 'staticFilesHandlerHTTPHeaders' smart constructor.
@@ -1859,7 +2090,7 @@ instance FromJSON StaticFilesHandlerHTTPHeaders where
18592090instance ToJSON StaticFilesHandlerHTTPHeaders where
18602091 toJSON = toJSON . _sfhhttphAddtional
18612092
1862−-- | Used to specify how many machine resources an app version needs.
2093+-- | Machine resources for a version.
18632094--
18642095-- /See:/ 'resources' smart constructor.
18652096data Resources = Resources'
@@ -1886,19 +2117,19 @@ resources =
18862117 , _rCPU = Nothing
18872118 }
18882119
1889−-- | How much memory, in GB, an app version needs.
2120+-- | Memory (GB) needed.
18902121rMemoryGb :: Lens' Resources (Maybe Double)
18912122rMemoryGb
18922123 = lens _rMemoryGb (\ s a -> s{_rMemoryGb = a}) .
18932124 mapping _Coerce
18942125
1895−-- | How much disk size, in GB, an app version needs.
2126+-- | Disk size (GB) needed.
18962127rDiskGb :: Lens' Resources (Maybe Double)
18972128rDiskGb
18982129 = lens _rDiskGb (\ s a -> s{_rDiskGb = a}) .
18992130 mapping _Coerce
19002131
1901−-- | How many CPU cores an app version needs.
2132+-- | Number of CPU cores needed.
19022133rCPU :: Lens' Resources (Maybe Double)
19032134rCPU
19042135 = lens _rCPU (\ s a -> s{_rCPU = a}) .
@@ -1919,9 +2150,9 @@ instance ToJSON Resources where
19192150 [("memoryGb" .=) <$> _rMemoryGb,
19202151 ("diskGb" .=) <$> _rDiskGb, ("cpu" .=) <$> _rCPU])
19212152
1922−-- | A manifest of files stored in Google Cloud Storage which should be
1923−-- included as part of this application. All files must be readable using
1924−-- the credentials supplied with this call.
2153+-- | Manifest of the files stored in Google Cloud Storage that are included
2154+-- as part of this version. All files must be readable using the
2155+-- credentials supplied with this call.
19252156--
19262157-- /See:/ 'deploymentFiles' smart constructor.
19272158newtype DeploymentFiles = DeploymentFiles'
@@ -1977,13 +2208,14 @@ cpuUtilization =
19772208 , _cuTargetUtilization = Nothing
19782209 }
19792210
1980−-- | The period of time over which CPU utilization is calculated.
2211+-- | Period of time over which CPU utilization is calculated.
19812212cuAggregationWindowLength :: Lens' CPUUtilization (Maybe Text)
19822213cuAggregationWindowLength
19832214 = lens _cuAggregationWindowLength
19842215 (\ s a -> s{_cuAggregationWindowLength = a})
19852216
1986−-- | Target (0-1) CPU utilization ratio to maintain when scaling.
2217+-- | Target CPU utilization ratio to maintain when scaling. Must be between 0
2218+-- and 1.
19872219cuTargetUtilization :: Lens' CPUUtilization (Maybe Double)
19882220cuTargetUtilization
19892221 = lens _cuTargetUtilization
@@ -2006,14 +2238,14 @@ instance ToJSON CPUUtilization where
20062238 _cuAggregationWindowLength,
20072239 ("targetUtilization" .=) <$> _cuTargetUtilization])
20082240
2009−-- | Mapping from service version IDs within the service to fractional
2010−-- (0.000, 1] allocations of traffic for that version. Each version may
2011−-- only be specified once, but some versions in the service may not have
2012−-- any traffic allocation. Services that have traffic allocated in this
2013−-- field may not be deleted until the service is deleted, or their traffic
2014−-- allocation is removed. Allocations must sum to 1. Supports precision up
2015−-- to two decimal places for IP-based splits and up to three decimal places
2016−-- for cookie-based splits.
2241+-- | Mapping from version IDs within the service to fractional (0.000, 1]
2242+-- allocations of traffic for that version. Each version can be specified
2243+-- only once, but some versions in the service may not have any traffic
2244+-- allocation. Services that have traffic allocated cannot be deleted until
2245+-- either the service is deleted or their traffic allocation is removed.
2246+-- Allocations must sum to 1. Up to two decimal place precision is
2247+-- supported for IP-based splits and up to three decimal places is
2248+-- supported for cookie-based splits.
20172249--
20182250-- /See:/ 'trafficSplitAllocations' smart constructor.
20192251newtype TrafficSplitAllocations = TrafficSplitAllocations'
@@ -2067,8 +2299,8 @@ manualScaling =
20672299 { _msInstances = Nothing
20682300 }
20692301
2070−-- | The number of instances to assign to the service at the start. This
2071−-- number can later be altered by using the [Modules
2302+-- | Number of instances to assign to the service at the start. This number
2303+-- can later be altered by using the [Modules
20722304-- API](https:\/\/cloud.google.com\/appengine\/docs\/python\/modules\/functions)
20732305-- \`set_num_instances()\` function.
20742306msInstances :: Lens' ManualScaling (Maybe Int32)
@@ -2112,16 +2344,15 @@ basicScaling =
21122344 , _bsIdleTimeout = Nothing
21132345 }
21142346
2115−-- | The maximum number of instances for App Engine to create for this
2116−-- version.
2347+-- | Maximum number of instances to create for this version.
21172348bsMaxInstances :: Lens' BasicScaling (Maybe Int32)
21182349bsMaxInstances
21192350 = lens _bsMaxInstances
21202351 (\ s a -> s{_bsMaxInstances = a})
21212352 . mapping _Coerce
21222353
2123−-- | The instance will be shut down this amount of time after receiving its
2124−-- last request.
2354+-- | Duration of time after the last request that an instance must wait
2355+-- before the instance is shut down.
21252356bsIdleTimeout :: Lens' BasicScaling (Maybe Text)
21262357bsIdleTimeout
21272358 = lens _bsIdleTimeout
@@ -2141,14 +2372,94 @@ instance ToJSON BasicScaling where
21412372 [("maxInstances" .=) <$> _bsMaxInstances,
21422373 ("idleTimeout" .=) <$> _bsIdleTimeout])
21432374
2144−-- | A Version is a specific set of source code and configuration files
2145−-- deployed to a service.
2375+-- | Metadata for the given google.longrunning.Operation.
2376+--
2377+-- /See:/ 'operationMetadataV1' smart constructor.
2378+data OperationMetadataV1 = OperationMetadataV1'
2379+ { _omvInsertTime :: !(Maybe Text)
2380+ , _omvUser :: !(Maybe Text)
2381+ , _omvMethod :: !(Maybe Text)
2382+ , _omvEndTime :: !(Maybe Text)
2383+ , _omvTarget :: !(Maybe Text)
2384+ } deriving (Eq,Show,Data,Typeable,Generic)
2385+
2386+-- | Creates a value of 'OperationMetadataV1' with the minimum fields required to make a request.
2387+--
2388+-- Use one of the following lenses to modify other fields as desired:
2389+--
2390+-- * 'omvInsertTime'
2391+--
2392+-- * 'omvUser'
2393+--
2394+-- * 'omvMethod'
2395+--
2396+-- * 'omvEndTime'
2397+--
2398+-- * 'omvTarget'
2399+operationMetadataV1
2400+ :: OperationMetadataV1
2401+operationMetadataV1 =
2402+ OperationMetadataV1'
2403+ { _omvInsertTime = Nothing
2404+ , _omvUser = Nothing
2405+ , _omvMethod = Nothing
2406+ , _omvEndTime = Nothing
2407+ , _omvTarget = Nothing
2408+ }
2409+
2410+-- | Time that this operation was created. \'OutputOnly
2411+omvInsertTime :: Lens' OperationMetadataV1 (Maybe Text)
2412+omvInsertTime
2413+ = lens _omvInsertTime
2414+ (\ s a -> s{_omvInsertTime = a})
2415+
2416+-- | User who requested this operation. \'OutputOnly
2417+omvUser :: Lens' OperationMetadataV1 (Maybe Text)
2418+omvUser = lens _omvUser (\ s a -> s{_omvUser = a})
2419+
2420+-- | API method that initiated this operation. Example:
2421+-- \`google.appengine.v1.Versions.CreateVersion\`. \'OutputOnly
2422+omvMethod :: Lens' OperationMetadataV1 (Maybe Text)
2423+omvMethod
2424+ = lens _omvMethod (\ s a -> s{_omvMethod = a})
2425+
2426+-- | Time that this operation completed. \'OutputOnly
2427+omvEndTime :: Lens' OperationMetadataV1 (Maybe Text)
2428+omvEndTime
2429+ = lens _omvEndTime (\ s a -> s{_omvEndTime = a})
2430+
2431+-- | Name of the resource that this operation is acting on. Example:
2432+-- \`apps\/myapp\/services\/default\`. \'OutputOnly
2433+omvTarget :: Lens' OperationMetadataV1 (Maybe Text)
2434+omvTarget
2435+ = lens _omvTarget (\ s a -> s{_omvTarget = a})
2436+
2437+instance FromJSON OperationMetadataV1 where
2438+ parseJSON
2439+ = withObject "OperationMetadataV1"
2440+ (\ o ->
2441+ OperationMetadataV1' <$>
2442+ (o .:? "insertTime") <*> (o .:? "user") <*>
2443+ (o .:? "method")
2444+ <*> (o .:? "endTime")
2445+ <*> (o .:? "target"))
2446+
2447+instance ToJSON OperationMetadataV1 where
2448+ toJSON OperationMetadataV1'{..}
2449+ = object
2450+ (catMaybes
2451+ [("insertTime" .=) <$> _omvInsertTime,
2452+ ("user" .=) <$> _omvUser,
2453+ ("method" .=) <$> _omvMethod,
2454+ ("endTime" .=) <$> _omvEndTime,
2455+ ("target" .=) <$> _omvTarget])
2456+
2457+-- | A Version resource is a specific set of source code and configuration
2458+-- files that are deployed into a service.
21462459--
21472460-- /See:/ 'version' smart constructor.
21482461data Version = Version'
2149− { _vCreationTime :: !(Maybe Text)
2150− , _vRuntime :: !(Maybe Text)
2151− , _vDeployer :: !(Maybe Text)
2462+ { _vRuntime :: !(Maybe Text)
21522463 , _vNobuildFilesRegex :: !(Maybe Text)
21532464 , _vInstanceClass :: !(Maybe Text)
21542465 , _vHealthCheck :: !(Maybe HealthCheck)
@@ -2156,6 +2467,7 @@ data Version = Version'
21562467 , _vDefaultExpiration :: !(Maybe Text)
21572468 , _vAutomaticScaling :: !(Maybe AutomaticScaling)
21582469 , _vErrorHandlers :: !(Maybe [ErrorHandler])
2470+ , _vCreatedBy :: !(Maybe Text)
21592471 , _vVM :: !(Maybe Bool)
21602472 , _vHandlers :: !(Maybe [URLMap])
21612473 , _vInboundServices :: !(Maybe [Text])
@@ -2171,7 +2483,9 @@ data Version = Version'
21712483 , _vEnvVariables :: !(Maybe VersionEnvVariables)
21722484 , _vServingStatus :: !(Maybe Text)
21732485 , _vDiskUsageBytes :: !(Maybe (Textual Int64))
2486+ , _vCreateTime :: !(Maybe Text)
21742487 , _vLibraries :: !(Maybe [Library])
2488+ , _vVersionURL :: !(Maybe Text)
21752489 , _vDeployment :: !(Maybe Deployment)
21762490 } deriving (Eq,Show,Data,Typeable,Generic)
21772491
@@ -2179,12 +2493,8 @@ data Version = Version'
21792493--
21802494-- Use one of the following lenses to modify other fields as desired:
21812495--
2182−-- * 'vCreationTime'
2183−--
21842496-- * 'vRuntime'
21852497--
2186−-- * 'vDeployer'
2187−--
21882498-- * 'vNobuildFilesRegex'
21892499--
21902500-- * 'vInstanceClass'
@@ -2199,6 +2509,8 @@ data Version = Version'
21992509--
22002510-- * 'vErrorHandlers'
22012511--
2512+-- * 'vCreatedBy'
2513+--
22022514-- * 'vVM'
22032515--
22042516-- * 'vHandlers'
@@ -2229,16 +2541,18 @@ data Version = Version'
22292541--
22302542-- * 'vDiskUsageBytes'
22312543--
2544+-- * 'vCreateTime'
2545+--
22322546-- * 'vLibraries'
22332547--
2548+-- * 'vVersionURL'
2549+--
22342550-- * 'vDeployment'
22352551version
22362552 :: Version
22372553version =
22382554 Version'
2239− { _vCreationTime = Nothing
2240− , _vRuntime = Nothing
2241− , _vDeployer = Nothing
2555+ { _vRuntime = Nothing
22422556 , _vNobuildFilesRegex = Nothing
22432557 , _vInstanceClass = Nothing
22442558 , _vHealthCheck = Nothing
@@ -2246,6 +2560,7 @@ version =
22462560 , _vDefaultExpiration = Nothing
22472561 , _vAutomaticScaling = Nothing
22482562 , _vErrorHandlers = Nothing
2563+ , _vCreatedBy = Nothing
22492564 , _vVM = Nothing
22502565 , _vHandlers = Nothing
22512566 , _vInboundServices = Nothing
@@ -2261,76 +2576,65 @@ version =
22612576 , _vEnvVariables = Nothing
22622577 , _vServingStatus = Nothing
22632578 , _vDiskUsageBytes = Nothing
2579+ , _vCreateTime = Nothing
22642580 , _vLibraries = Nothing
2581+ , _vVersionURL = Nothing
22652582 , _vDeployment = Nothing
22662583 }
22672584
2268−-- | Creation time of this version. This will be between the start and end
2269−-- times of the operation that creates this version. \'OutputOnly
2270−vCreationTime :: Lens' Version (Maybe Text)
2271−vCreationTime
2272− = lens _vCreationTime
2273− (\ s a -> s{_vCreationTime = a})
2274−
2275−-- | The desired runtime. Values can include python27, java7, go, etc.
2585+-- | Desired runtime. Example: \`python27\`.
22762586vRuntime :: Lens' Version (Maybe Text)
22772587vRuntime = lens _vRuntime (\ s a -> s{_vRuntime = a})
22782588
2279−-- | The email address of the user who created this version. \'OutputOnly
2280−vDeployer :: Lens' Version (Maybe Text)
2281−vDeployer
2282− = lens _vDeployer (\ s a -> s{_vDeployer = a})
2283−
2284−-- | Go only. Files that match this pattern will not be built into the app.
2285−-- May only be set on create requests.
2589+-- | Files that match this pattern will not be built into this version. Only
2590+-- applicable for Go runtimes. Only returned in \`GET\` requests if
2591+-- \`view=FULL\` is set.
22862592vNobuildFilesRegex :: Lens' Version (Maybe Text)
22872593vNobuildFilesRegex
22882594 = lens _vNobuildFilesRegex
22892595 (\ s a -> s{_vNobuildFilesRegex = a})
22902596
2291−-- | The instance class to use to run this app. Valid values for
2292−-- AutomaticScaling are \`[F1, F2, F4, F4_1G]\`. Valid values for
2293−-- ManualScaling and BasicScaling are \`[B1, B2, B4, B8, B4_1G]\`. Default:
2294−-- \"F1\" for AutomaticScaling, \"B1\" for ManualScaling and BasicScaling
2597+-- | Instance class that is used to run this version. Valid values are: *
2598+-- AutomaticScaling: \`F1\`, \`F2\`, \`F4\`, \`F4_1G\` * ManualScaling or
2599+-- BasicScaling: \`B1\`, \`B2\`, \`B4\`, \`B8\`, \`B4_1G\` Defaults to
2600+-- \`F1\` for AutomaticScaling and \`B1\` for ManualScaling or
2601+-- BasicScaling.
22952602vInstanceClass :: Lens' Version (Maybe Text)
22962603vInstanceClass
22972604 = lens _vInstanceClass
22982605 (\ s a -> s{_vInstanceClass = a})
22992606
2300−-- | Configure health checking for the VM instances. Unhealthy VM instances
2301−-- will be stopped and replaced with new instances. Only returned in
2302−-- \`GET\` requests if \`view=FULL\` is set. May only be set on create
2303−-- requests; once created, is immutable.
2607+-- | Configures health checking for VM instances. Unhealthy instances are
2608+-- stopped and replaced with new instances. Only applicable for VM
2609+-- runtimes. Only returned in \`GET\` requests if \`view=FULL\` is set.
23042610vHealthCheck :: Lens' Version (Maybe HealthCheck)
23052611vHealthCheck
23062612 = lens _vHealthCheck (\ s a -> s{_vHealthCheck = a})
23072613
2308−-- | The App Engine execution environment to use for this version. Default:
2309−-- \"1\"
2614+-- | App Engine execution environment for this version. Defaults to
2615+-- \`standard\`.
23102616vEnv :: Lens' Version (Maybe Text)
23112617vEnv = lens _vEnv (\ s a -> s{_vEnv = a})
23122618
2313−-- | The length of time a static file served by a static file handler ought
2314−-- to be cached by web proxies and browsers, if the handler does not
2315−-- specify its own expiration. Only returned in \`GET\` requests if
2316−-- \`view=FULL\` is set. May only be set on create requests; once created,
2317−-- is immutable.
2619+-- | Duration that static files should be cached by web proxies and browsers.
2620+-- Only applicable if the corresponding
2621+-- [StaticFilesHandler](https:\/\/cloud.google.com\/appengine\/docs\/admin-api\/reference\/rest\/v1\/apps.services.versions#staticfileshandler)
2622+-- does not specify its own expiration time. Only returned in \`GET\`
2623+-- requests if \`view=FULL\` is set.
23182624vDefaultExpiration :: Lens' Version (Maybe Text)
23192625vDefaultExpiration
23202626 = lens _vDefaultExpiration
23212627 (\ s a -> s{_vDefaultExpiration = a})
23222628
2323−-- | Automatic scaling is the scaling policy that App Engine has used since
2324−-- its inception. It is based on request rate, response latencies, and
2629+-- | Automatic scaling is based on request rate, response latencies, and
23252630-- other application metrics.
23262631vAutomaticScaling :: Lens' Version (Maybe AutomaticScaling)
23272632vAutomaticScaling
23282633 = lens _vAutomaticScaling
23292634 (\ s a -> s{_vAutomaticScaling = a})
23302635
2331−-- | Custom static error pages instead of these generic error pages, (limit
2332−-- 10 KB\/page) Only returned in \`GET\` requests if \`view=FULL\` is set.
2333−-- May only be set on create requests; once created, is immutable.
2636+-- | Custom static error pages. Limited to 10KB per page. Only returned in
2637+-- \`GET\` requests if \`view=FULL\` is set.
23342638vErrorHandlers :: Lens' Version [ErrorHandler]
23352639vErrorHandlers
23362640 = lens _vErrorHandlers
@@ -2338,15 +2642,19 @@ vErrorHandlers
23382642 . _Default
23392643 . _Coerce
23402644
2341−-- | Whether to deploy this app in a VM container.
2645+-- | Email address of the user who created this version. \'OutputOnly
2646+vCreatedBy :: Lens' Version (Maybe Text)
2647+vCreatedBy
2648+ = lens _vCreatedBy (\ s a -> s{_vCreatedBy = a})
2649+
2650+-- | Whether to deploy this version in a container on a virtual machine.
23422651vVM :: Lens' Version (Maybe Bool)
23432652vVM = lens _vVM (\ s a -> s{_vVM = a})
23442653
2345−-- | An ordered list of URL Matching patterns that should be applied to
2346−-- incoming requests. The first matching URL consumes the request, and
2347−-- subsequent handlers are not attempted. Only returned in \`GET\` requests
2348−-- if \`view=FULL\` is set. May only be set on create requests; once
2349−-- created, is immutable.
2654+-- | An ordered list of URL-matching patterns that should be applied to
2655+-- incoming requests. The first matching URL handles the request and other
2656+-- request handlers are not attempted. Only returned in \`GET\` requests if
2657+-- \`view=FULL\` is set.
23502658vHandlers :: Lens' Version [URLMap]
23512659vHandlers
23522660 = lens _vHandlers (\ s a -> s{_vHandlers = a}) .
@@ -2362,27 +2670,27 @@ vInboundServices
23622670 . _Default
23632671 . _Coerce
23642672
2365−-- | Used to specify extra network settings (for VM runtimes only).
2673+-- | Extra network settings. Only applicable for VM runtimes.
23662674vNetwork :: Lens' Version (Maybe Network)
23672675vNetwork = lens _vNetwork (\ s a -> s{_vNetwork = a})
23682676
2369−-- | Used to specify how many machine resources an app version needs (for VM
2370−-- runtimes only).
2677+-- | Machine resources for this version. Only applicable for VM runtimes.
23712678vResources :: Lens' Version (Maybe Resources)
23722679vResources
23732680 = lens _vResources (\ s a -> s{_vResources = a})
23742681
2375−-- | The full path to the Version resource in the API. Example:
2376−-- \"apps\/myapp\/services\/default\/versions\/v1\". \'OutputOnly
2682+-- | Full path to the Version resource in the API. Example:
2683+-- \`apps\/myapp\/services\/default\/versions\/v1\`. \'OutputOnly
23772684vName :: Lens' Version (Maybe Text)
23782685vName = lens _vName (\ s a -> s{_vName = a})
23792686
2380−-- | If true, multiple requests can be dispatched to the app at once.
2687+-- | Whether multiple requests can be dispatched to this version at once.
23812688vThreadsafe :: Lens' Version (Maybe Bool)
23822689vThreadsafe
23832690 = lens _vThreadsafe (\ s a -> s{_vThreadsafe = a})
23842691
2385−-- | Beta settings supplied to the application via metadata.
2692+-- | Metadata settings that are supplied to this version to enable beta
2693+-- runtime features.
23862694vBetaSettings :: Lens' Version (Maybe VersionBetaSettings)
23872695vBetaSettings
23882696 = lens _vBetaSettings
@@ -2404,57 +2712,66 @@ vManualScaling
24042712 = lens _vManualScaling
24052713 (\ s a -> s{_vManualScaling = a})
24062714
2407−-- | Serving configuration for Google Cloud Endpoints. Only returned in
2408−-- \`GET\` requests if \`view=FULL\` is set. May only be set on create
2409−-- requests; once created, is immutable.
2715+-- | Serving configuration for [Google Cloud
2716+-- Endpoints](https:\/\/cloud.google.com\/appengine\/docs\/python\/endpoints\/).
2717+-- Only returned in \`GET\` requests if \`view=FULL\` is set.
24102718vAPIConfig :: Lens' Version (Maybe APIConfigHandler)
24112719vAPIConfig
24122720 = lens _vAPIConfig (\ s a -> s{_vAPIConfig = a})
24132721
2414−-- | The relative name\/path of the Version within the service. Example:
2415−-- \"v1\". Version specifiers can contain lowercase letters, digits, and
2416−-- hyphens. It cannot begin with the prefix \`ah-\` and the names
2417−-- \`default\` and \`latest\` are reserved and cannot be used.
2722+-- | Relative name of the version within the service. Example: \`v1\`.
2723+-- Version names can contain only lowercase letters, numbers, or hyphens.
2724+-- Reserved names: \"default\", \"latest\", and any name with the prefix
2725+-- \"ah-\".
24182726vId :: Lens' Version (Maybe Text)
24192727vId = lens _vId (\ s a -> s{_vId = a})
24202728
2421−-- | Environment variables made available to the application. Only returned
2422−-- in \`GET\` requests if \`view=FULL\` is set. May only be set on create
2423−-- requests; once created, is immutable.
2729+-- | Environment variables available to the application. Only returned in
2730+-- \`GET\` requests if \`view=FULL\` is set.
24242731vEnvVariables :: Lens' Version (Maybe VersionEnvVariables)
24252732vEnvVariables
24262733 = lens _vEnvVariables
24272734 (\ s a -> s{_vEnvVariables = a})
24282735
2429−-- | The current serving status of this version. Only \`SERVING\` versions
2430−-- will have instances created or billed for. If this field is unset when a
2431−-- version is created, \`SERVING\` status will be assumed. It is an error
2432−-- to explicitly set this field to \`SERVING_STATUS_UNSPECIFIED\`.
2736+-- | Current serving status of this version. Only the versions with a
2737+-- \`SERVING\` status create instances and can be billed.
2738+-- \`SERVING_STATUS_UNSPECIFIED\` is an invalid value. Defaults to
2739+-- \`SERVING\`.
24332740vServingStatus :: Lens' Version (Maybe Text)
24342741vServingStatus
24352742 = lens _vServingStatus
24362743 (\ s a -> s{_vServingStatus = a})
24372744
2438−-- | Total size of version files hosted on App Engine disk in bytes.
2439−-- \'OutputOnly
2745+-- | Total size in bytes of all the files that are included in this version
2746+-- and curerntly hosted on the App Engine disk. \'OutputOnly
24402747vDiskUsageBytes :: Lens' Version (Maybe Int64)
24412748vDiskUsageBytes
24422749 = lens _vDiskUsageBytes
24432750 (\ s a -> s{_vDiskUsageBytes = a})
24442751 . mapping _Coerce
24452752
2446−-- | Configuration for Python runtime third-party libraries required by the
2447−-- application. Only returned in \`GET\` requests if \`view=FULL\` is set.
2448−-- May only be set on create requests; once created, is immutable.
2753+-- | Time that this version was created. \'OutputOnly
2754+vCreateTime :: Lens' Version (Maybe Text)
2755+vCreateTime
2756+ = lens _vCreateTime (\ s a -> s{_vCreateTime = a})
2757+
2758+-- | Configuration for third-party Python runtime libraries that are required
2759+-- by the application. Only returned in \`GET\` requests if \`view=FULL\`
2760+-- is set.
24492761vLibraries :: Lens' Version [Library]
24502762vLibraries
24512763 = lens _vLibraries (\ s a -> s{_vLibraries = a}) .
24522764 _Default
24532765 . _Coerce
24542766
2767+-- | Serving URL for this version. Example:
2768+-- \"https:\/\/myversion-dot-myservice-dot-myapp.appspot.com\" \'OutputOnly
2769+vVersionURL :: Lens' Version (Maybe Text)
2770+vVersionURL
2771+ = lens _vVersionURL (\ s a -> s{_vVersionURL = a})
2772+
24552773-- | Code and application artifacts that make up this version. Only returned
2456−-- in \`GET\` requests if \`view=FULL\` is set. May only be set on create
2457−-- requests; once created, is immutable.
2774+-- in \`GET\` requests if \`view=FULL\` is set.
24582775vDeployment :: Lens' Version (Maybe Deployment)
24592776vDeployment
24602777 = lens _vDeployment (\ s a -> s{_vDeployment = a})
@@ -2464,15 +2781,14 @@ instance FromJSON Version where
24642781 = withObject "Version"
24652782 (\ o ->
24662783 Version' <$>
2467− (o .:? "creationTime") <*> (o .:? "runtime") <*>
2468− (o .:? "deployer")
2469− <*> (o .:? "nobuildFilesRegex")
2470− <*> (o .:? "instanceClass")
2784+ (o .:? "runtime") <*> (o .:? "nobuildFilesRegex") <*>
2785+ (o .:? "instanceClass")
24712786 <*> (o .:? "healthCheck")
24722787 <*> (o .:? "env")
24732788 <*> (o .:? "defaultExpiration")
24742789 <*> (o .:? "automaticScaling")
24752790 <*> (o .:? "errorHandlers" .!= mempty)
2791+ <*> (o .:? "createdBy")
24762792 <*> (o .:? "vm")
24772793 <*> (o .:? "handlers" .!= mempty)
24782794 <*> (o .:? "inboundServices" .!= mempty)
@@ -2488,16 +2804,16 @@ instance FromJSON Version where
24882804 <*> (o .:? "envVariables")
24892805 <*> (o .:? "servingStatus")
24902806 <*> (o .:? "diskUsageBytes")
2807+ <*> (o .:? "createTime")
24912808 <*> (o .:? "libraries" .!= mempty)
2809+ <*> (o .:? "versionUrl")
24922810 <*> (o .:? "deployment"))
24932811
24942812instance ToJSON Version where
24952813 toJSON Version'{..}
24962814 = object
24972815 (catMaybes
2498− [("creationTime" .=) <$> _vCreationTime,
2499− ("runtime" .=) <$> _vRuntime,
2500− ("deployer" .=) <$> _vDeployer,
2816+ [("runtime" .=) <$> _vRuntime,
25012817 ("nobuildFilesRegex" .=) <$> _vNobuildFilesRegex,
25022818 ("instanceClass" .=) <$> _vInstanceClass,
25032819 ("healthCheck" .=) <$> _vHealthCheck,
@@ -2505,7 +2821,8 @@ instance ToJSON Version where
25052821 ("defaultExpiration" .=) <$> _vDefaultExpiration,
25062822 ("automaticScaling" .=) <$> _vAutomaticScaling,
25072823 ("errorHandlers" .=) <$> _vErrorHandlers,
2508− ("vm" .=) <$> _vVM, ("handlers" .=) <$> _vHandlers,
2824+ ("createdBy" .=) <$> _vCreatedBy, ("vm" .=) <$> _vVM,
2825+ ("handlers" .=) <$> _vHandlers,
25092826 ("inboundServices" .=) <$> _vInboundServices,
25102827 ("network" .=) <$> _vNetwork,
25112828 ("resources" .=) <$> _vResources,
@@ -2518,7 +2835,9 @@ instance ToJSON Version where
25182835 ("envVariables" .=) <$> _vEnvVariables,
25192836 ("servingStatus" .=) <$> _vServingStatus,
25202837 ("diskUsageBytes" .=) <$> _vDiskUsageBytes,
2838+ ("createTime" .=) <$> _vCreateTime,
25212839 ("libraries" .=) <$> _vLibraries,
2840+ ("versionUrl" .=) <$> _vVersionURL,
25222841 ("deployment" .=) <$> _vDeployment])
25232842
25242843-- | Files served directly to the user for a given URL, such as images, CSS
@@ -2573,46 +2892,44 @@ sfhHTTPHeaders
25732892 = lens _sfhHTTPHeaders
25742893 (\ s a -> s{_sfhHTTPHeaders = a})
25752894
2576−-- | The path to the static files matched by the URL pattern, from the
2895+-- | Path to the static files matched by the URL pattern, from the
25772896-- application root directory. The path can refer to text matched in
25782897-- groupings in the URL pattern.
25792898sfhPath :: Lens' StaticFilesHandler (Maybe Text)
25802899sfhPath = lens _sfhPath (\ s a -> s{_sfhPath = a})
25812900
2582−-- | If true, this UrlMap entry does not match the request unless the file
2583−-- referenced by the handler also exists. If no such file exists,
2584−-- processing will continue with the next UrlMap that matches the requested
2585−-- URL.
2901+-- | Whether this handler should match the request if the file referenced by
2902+-- the handler does not exist.
25862903sfhRequireMatchingFile :: Lens' StaticFilesHandler (Maybe Bool)
25872904sfhRequireMatchingFile
25882905 = lens _sfhRequireMatchingFile
25892906 (\ s a -> s{_sfhRequireMatchingFile = a})
25902907
2591−-- | The length of time a static file served by this handler ought to be
2592−-- cached by web proxies and browsers.
2908+-- | Time a static file served by this handler should be cached by web
2909+-- proxies and browsers.
25932910sfhExpiration :: Lens' StaticFilesHandler (Maybe Text)
25942911sfhExpiration
25952912 = lens _sfhExpiration
25962913 (\ s a -> s{_sfhExpiration = a})
25972914
2598−-- | If specified, all files served by this handler will be served using the
2599−-- specified MIME type. If not specified, the MIME type for a file will be
2600−-- derived from the file\'s filename extension.
2915+-- | MIME type used to serve all files served by this handler. Defaults to
2916+-- file-specific MIME types, which are derived from each file\'s filename
2917+-- extension.
26012918sfhMimeType :: Lens' StaticFilesHandler (Maybe Text)
26022919sfhMimeType
26032920 = lens _sfhMimeType (\ s a -> s{_sfhMimeType = a})
26042921
2605−-- | By default, files declared in static file handlers are uploaded as
2606−-- static data and are only served to end users, they cannot be read by an
2607−-- application. If this field is set to true, the files are also uploaded
2608−-- as code data so your application can read them. Both uploads are charged
2609−-- against your code and static data storage resource quotas.
2922+-- | Whether files should also be uploaded as code data. By default, files
2923+-- declared in static file handlers are uploaded as static data and are
2924+-- only served to end users; they cannot be read by the application. If
2925+-- enabled, uploads are charged against both your code and static data
2926+-- storage resource quotas.
26102927sfhApplicationReadable :: Lens' StaticFilesHandler (Maybe Bool)
26112928sfhApplicationReadable
26122929 = lens _sfhApplicationReadable
26132930 (\ s a -> s{_sfhApplicationReadable = a})
26142931
2615−-- | A regular expression that matches the file paths for all files that will
2932+-- | Regular expression that matches the file paths for all files that should
26162933-- be referenced by this handler.
26172934sfhUploadPathRegex :: Lens' StaticFilesHandler (Maybe Text)
26182935sfhUploadPathRegex
@@ -2645,7 +2962,7 @@ instance ToJSON StaticFilesHandler where
26452962 _sfhApplicationReadable,
26462963 ("uploadPathRegex" .=) <$> _sfhUploadPathRegex])
26472964
2648−-- | A custom static error page to be served when an error occurs.
2965+-- | Custom static error page to be served when an error occurs.
26492966--
26502967-- /See:/ 'errorHandler' smart constructor.
26512968data ErrorHandler = ErrorHandler'
@@ -2672,12 +2989,12 @@ errorHandler =
26722989 , _ehStaticFile = Nothing
26732990 }
26742991
2675−-- | MIME type of file. If unspecified, \"text\/html\" is assumed.
2992+-- | MIME type of file. Defaults to \`text\/html\`.
26762993ehMimeType :: Lens' ErrorHandler (Maybe Text)
26772994ehMimeType
26782995 = lens _ehMimeType (\ s a -> s{_ehMimeType = a})
26792996
2680−-- | The error condition this handler applies to.
2997+-- | Error condition this handler applies to.
26812998ehErrorCode :: Lens' ErrorHandler (Maybe Text)
26822999ehErrorCode
26833000 = lens _ehErrorCode (\ s a -> s{_ehErrorCode = a})
@@ -2703,6 +3020,94 @@ instance ToJSON ErrorHandler where
27033020 ("errorCode" .=) <$> _ehErrorCode,
27043021 ("staticFile" .=) <$> _ehStaticFile])
27053022
3023+-- | Cross-service attributes for the location. For example
3024+-- {\"cloud.googleapis.com\/region\": \"us-east1\"}
3025+--
3026+-- /See:/ 'locationLabels' smart constructor.
3027+newtype LocationLabels = LocationLabels'
3028+ { _llAddtional :: HashMap Text Text
3029+ } deriving (Eq,Show,Data,Typeable,Generic)
3030+
3031+-- | Creates a value of 'LocationLabels' with the minimum fields required to make a request.
3032+--
3033+-- Use one of the following lenses to modify other fields as desired:
3034+--
3035+-- * 'llAddtional'
3036+locationLabels
3037+ :: HashMap Text Text -- ^ 'llAddtional'
3038+ -> LocationLabels
3039+locationLabels pLlAddtional_ =
3040+ LocationLabels'
3041+ { _llAddtional = _Coerce # pLlAddtional_
3042+ }
3043+
3044+llAddtional :: Lens' LocationLabels (HashMap Text Text)
3045+llAddtional
3046+ = lens _llAddtional (\ s a -> s{_llAddtional = a}) .
3047+ _Coerce
3048+
3049+instance FromJSON LocationLabels where
3050+ parseJSON
3051+ = withObject "LocationLabels"
3052+ (\ o -> LocationLabels' <$> (parseJSONObject o))
3053+
3054+instance ToJSON LocationLabels where
3055+ toJSON = toJSON . _llAddtional
3056+
3057+-- | Metadata for the given google.cloud.location.Location.
3058+--
3059+-- /See:/ 'locationMetadata' smart constructor.
3060+data LocationMetadata = LocationMetadata'
3061+ { _lmStandardEnvironmentAvailable :: !(Maybe Bool)
3062+ , _lmFlexibleEnvironmentAvailable :: !(Maybe Bool)
3063+ } deriving (Eq,Show,Data,Typeable,Generic)
3064+
3065+-- | Creates a value of 'LocationMetadata' with the minimum fields required to make a request.
3066+--
3067+-- Use one of the following lenses to modify other fields as desired:
3068+--
3069+-- * 'lmStandardEnvironmentAvailable'
3070+--
3071+-- * 'lmFlexibleEnvironmentAvailable'
3072+locationMetadata
3073+ :: LocationMetadata
3074+locationMetadata =
3075+ LocationMetadata'
3076+ { _lmStandardEnvironmentAvailable = Nothing
3077+ , _lmFlexibleEnvironmentAvailable = Nothing
3078+ }
3079+
3080+-- | App Engine Standard Environment is available in the given location.
3081+-- \'OutputOnly
3082+lmStandardEnvironmentAvailable :: Lens' LocationMetadata (Maybe Bool)
3083+lmStandardEnvironmentAvailable
3084+ = lens _lmStandardEnvironmentAvailable
3085+ (\ s a -> s{_lmStandardEnvironmentAvailable = a})
3086+
3087+-- | App Engine Flexible Environment is available in the given location.
3088+-- \'OutputOnly
3089+lmFlexibleEnvironmentAvailable :: Lens' LocationMetadata (Maybe Bool)
3090+lmFlexibleEnvironmentAvailable
3091+ = lens _lmFlexibleEnvironmentAvailable
3092+ (\ s a -> s{_lmFlexibleEnvironmentAvailable = a})
3093+
3094+instance FromJSON LocationMetadata where
3095+ parseJSON
3096+ = withObject "LocationMetadata"
3097+ (\ o ->
3098+ LocationMetadata' <$>
3099+ (o .:? "standardEnvironmentAvailable") <*>
3100+ (o .:? "flexibleEnvironmentAvailable"))
3101+
3102+instance ToJSON LocationMetadata where
3103+ toJSON LocationMetadata'{..}
3104+ = object
3105+ (catMaybes
3106+ [("standardEnvironmentAvailable" .=) <$>
3107+ _lmStandardEnvironmentAvailable,
3108+ ("flexibleEnvironmentAvailable" .=) <$>
3109+ _lmFlexibleEnvironmentAvailable])
3110+
27063111-- | Metadata for the given google.longrunning.Operation.
27073112--
27083113-- /See:/ 'operationMetadata' smart constructor.
@@ -2742,35 +3147,34 @@ operationMetadata =
27423147 , _omTarget = Nothing
27433148 }
27443149
2745−-- | Timestamp that this operation was received. \'OutputOnly
3150+-- | Timestamp that this operation was created. \'OutputOnly
27463151omInsertTime :: Lens' OperationMetadata (Maybe Text)
27473152omInsertTime
27483153 = lens _omInsertTime (\ s a -> s{_omInsertTime = a})
27493154
2750−-- | The user who requested this operation. \'OutputOnly
3155+-- | User who requested this operation. \'OutputOnly
27513156omUser :: Lens' OperationMetadata (Maybe Text)
27523157omUser = lens _omUser (\ s a -> s{_omUser = a})
27533158
2754−-- | API method name that initiated the operation. Example:
2755−-- \"google.appengine.v1beta4.Version.CreateVersion\". \'OutputOnly
3159+-- | API method that initiated this operation. Example:
3160+-- \`google.appengine.v1beta4.Version.CreateVersion\`. \'OutputOnly
27563161omMethod :: Lens' OperationMetadata (Maybe Text)
27573162omMethod = lens _omMethod (\ s a -> s{_omMethod = a})
27583163
2759−-- | Timestamp that this operation was completed. (Not present if the
2760−-- operation is still in progress.) \'OutputOnly
3164+-- | Timestamp that this operation completed. \'OutputOnly
27613165omEndTime :: Lens' OperationMetadata (Maybe Text)
27623166omEndTime
27633167 = lens _omEndTime (\ s a -> s{_omEndTime = a})
27643168
2765−-- | The type of the operation (deprecated, use method field instead).
2766−-- Example: \"create_version\". \'OutputOnly
3169+-- | Type of this operation. Deprecated, use method field instead. Example:
3170+-- \"create_version\". \'OutputOnly
27673171omOperationType :: Lens' OperationMetadata (Maybe Text)
27683172omOperationType
27693173 = lens _omOperationType
27703174 (\ s a -> s{_omOperationType = a})
27713175
2772−-- | Resource that this operation is acting on. Example:
2773−-- \"apps\/myapp\/modules\/default\". \'OutputOnly
3176+-- | Name of the resource that this operation is acting on. Example:
3177+-- \`apps\/myapp\/modules\/default\`. \'OutputOnly
27743178omTarget :: Lens' OperationMetadata (Maybe Text)
27753179omTarget = lens _omTarget (\ s a -> s{_omTarget = a})
27763180
@@ -2846,12 +3250,12 @@ instance ToJSON ListInstancesResponse where
28463250 [("nextPageToken" .=) <$> _lirNextPageToken,
28473251 ("instances" .=) <$> _lirInstances])
28483252
2849−-- | Target scaling by request utilization (for VM runtimes only).
3253+-- | Target scaling by request utilization. Only applicable for VM runtimes.
28503254--
28513255-- /See:/ 'requestUtilization' smart constructor.
28523256data RequestUtilization = RequestUtilization'
2853− { _ruTargetConcurrentRequests :: !(Maybe (Textual Int32))
2854− , _ruTargetRequestCountPerSec :: !(Maybe (Textual Int32))
3257+ { _ruTargetConcurrentRequests :: !(Maybe (Textual Int32))
3258+ , _ruTargetRequestCountPerSecond :: !(Maybe (Textual Int32))
28553259 } deriving (Eq,Show,Data,Typeable,Generic)
28563260
28573261-- | Creates a value of 'RequestUtilization' with the minimum fields required to make a request.
@@ -2860,13 +3264,13 @@ data RequestUtilization = RequestUtilization'
28603264--
28613265-- * 'ruTargetConcurrentRequests'
28623266--
2863−-- * 'ruTargetRequestCountPerSec'
3267+-- * 'ruTargetRequestCountPerSecond'
28643268requestUtilization
28653269 :: RequestUtilization
28663270requestUtilization =
28673271 RequestUtilization'
28683272 { _ruTargetConcurrentRequests = Nothing
2869− , _ruTargetRequestCountPerSec = Nothing
3273+ , _ruTargetRequestCountPerSecond = Nothing
28703274 }
28713275
28723276-- | Target number of concurrent requests.
@@ -2877,10 +3281,10 @@ ruTargetConcurrentRequests
28773281 . mapping _Coerce
28783282
28793283-- | Target requests per second.
2880−ruTargetRequestCountPerSec :: Lens' RequestUtilization (Maybe Int32)
2881−ruTargetRequestCountPerSec
2882− = lens _ruTargetRequestCountPerSec
2883− (\ s a -> s{_ruTargetRequestCountPerSec = a})
3284+ruTargetRequestCountPerSecond :: Lens' RequestUtilization (Maybe Int32)
3285+ruTargetRequestCountPerSecond
3286+ = lens _ruTargetRequestCountPerSecond
3287+ (\ s a -> s{_ruTargetRequestCountPerSecond = a})
28843288 . mapping _Coerce
28853289
28863290instance FromJSON RequestUtilization where
@@ -2889,7 +3293,7 @@ instance FromJSON RequestUtilization where
28893293 (\ o ->
28903294 RequestUtilization' <$>
28913295 (o .:? "targetConcurrentRequests") <*>
2892− (o .:? "targetRequestCountPerSec"))
3296+ (o .:? "targetRequestCountPerSecond"))
28933297
28943298instance ToJSON RequestUtilization where
28953299 toJSON RequestUtilization'{..}
@@ -2897,59 +3301,29 @@ instance ToJSON RequestUtilization where
28973301 (catMaybes
28983302 [("targetConcurrentRequests" .=) <$>
28993303 _ruTargetConcurrentRequests,
2900− ("targetRequestCountPerSec" .=) <$>
2901− _ruTargetRequestCountPerSec])
3304+ ("targetRequestCountPerSecond" .=) <$>
3305+ _ruTargetRequestCountPerSecond])
29023306
2903−-- | A reference to a particular snapshot of the source tree used to build
2904−-- and deploy the application.
3307+-- | Request message for \'Applications.RepairApplication\'.
29053308--
2906−-- /See:/ 'sourceReference' smart constructor.
2907−data SourceReference = SourceReference'
2908− { _srRepository :: !(Maybe Text)
2909− , _srRevisionId :: !(Maybe Text)
2910− } deriving (Eq,Show,Data,Typeable,Generic)
3309+-- /See:/ 'repairApplicationRequest' smart constructor.
3310+data RepairApplicationRequest =
3311+ RepairApplicationRequest'
3312+ deriving (Eq,Show,Data,Typeable,Generic)
29113313
2912−-- | Creates a value of 'SourceReference' with the minimum fields required to make a request.
2913−--
2914−-- Use one of the following lenses to modify other fields as desired:
2915−--
2916−-- * 'srRepository'
3314+-- | Creates a value of 'RepairApplicationRequest' with the minimum fields required to make a request.
29173315--
2918−-- * 'srRevisionId'
2919−sourceReference
2920− :: SourceReference
2921−sourceReference =
2922− SourceReference'
2923− { _srRepository = Nothing
2924− , _srRevisionId = Nothing
2925− }
3316+repairApplicationRequest
3317+ :: RepairApplicationRequest
3318+repairApplicationRequest = RepairApplicationRequest'
29263319
2927−-- | Optional. A URI string identifying the repository. Example:
2928−-- \"https:\/\/source.developers.google.com\/p\/app-123\/r\/default\"
2929−srRepository :: Lens' SourceReference (Maybe Text)
2930−srRepository
2931− = lens _srRepository (\ s a -> s{_srRepository = a})
2932−
2933−-- | The canonical (and persistent) identifier of the deployed revision, i.e.
2934−-- any kind of aliases including tags or branch names are not allowed.
2935−-- Example (git): \"2198322f89e0bb2e25021667c2ed489d1fd34e6b\"
2936−srRevisionId :: Lens' SourceReference (Maybe Text)
2937−srRevisionId
2938− = lens _srRevisionId (\ s a -> s{_srRevisionId = a})
2939−
2940−instance FromJSON SourceReference where
3320+instance FromJSON RepairApplicationRequest where
29413321 parseJSON
2942− = withObject "SourceReference"
2943− (\ o ->
2944− SourceReference' <$>
2945− (o .:? "repository") <*> (o .:? "revisionId"))
3322+ = withObject "RepairApplicationRequest"
3323+ (\ o -> pure RepairApplicationRequest')
29463324
2947−instance ToJSON SourceReference where
2948− toJSON SourceReference'{..}
2949− = object
2950− (catMaybes
2951− [("repository" .=) <$> _srRepository,
2952− ("revisionId" .=) <$> _srRevisionId])
3325+instance ToJSON RepairApplicationRequest where
3326+ toJSON = const emptyObject
29533327
29543328-- | The normal response of the operation in case of success. If the original
29553329-- method returns no data on success, such as \`Delete\`, the response is
@@ -2978,7 +3352,7 @@ operationResponse pOrAddtional_ =
29783352 { _orAddtional = _Coerce # pOrAddtional_
29793353 }
29803354
2981−-- | Properties of the object. Contains field \'ype with type URL.
3355+-- | Properties of the object. Contains field \'type with type URL.
29823356orAddtional :: Lens' OperationResponse (HashMap Text JSONValue)
29833357orAddtional
29843358 = lens _orAddtional (\ s a -> s{_orAddtional = a}) .
@@ -2992,8 +3366,8 @@ instance FromJSON OperationResponse where
29923366instance ToJSON OperationResponse where
29933367 toJSON = toJSON . _orAddtional
29943368
2995−-- | A Docker (container) image which should be used to start the
2996−-- application.
3369+-- | Docker image that is used to start a VM container for the version you
3370+-- deploy.
29973371--
29983372-- /See:/ 'containerInfo' smart constructor.
29993373newtype ContainerInfo = ContainerInfo'
@@ -3012,9 +3386,10 @@ containerInfo =
30123386 { _ciImage = Nothing
30133387 }
30143388
3015−-- | Reference to a hosted container image. Must be a URI to a resource in a
3016−-- Docker repository. Must be fully qualified, including tag or digest.
3017−-- e.g. gcr.io\/my-project\/image:tag or gcr.io\/my-project\/image\'digest
3389+-- | URI to the hosted container image in a Docker repository. The URI must
3390+-- be fully qualified and include a tag or digest. Examples:
3391+-- \"gcr.io\/my-project\/image:tag\" or
3392+-- \"gcr.io\/my-project\/image\'digest\"
30183393ciImage :: Lens' ContainerInfo (Maybe Text)
30193394ciImage = lens _ciImage (\ s a -> s{_ciImage = a})
30203395
@@ -3027,25 +3402,25 @@ instance ToJSON ContainerInfo where
30273402 toJSON ContainerInfo'{..}
30283403 = object (catMaybes [("image" .=) <$> _ciImage])
30293404
3030−-- | Instances are the computing units that App Engine uses to automatically
3031−-- scale an application.
3405+-- | An Instance resource is the computing unit that App Engine uses to
3406+-- automatically scale an application.
30323407--
30333408-- /See:/ 'instance'' smart constructor.
30343409data Instance = Instance'
30353410 { _iMemoryUsage :: !(Maybe (Textual Int64))
30363411 , _iVMStatus :: !(Maybe Text)
30373412 , _iVMZoneName :: !(Maybe Text)
3413+ , _iStartTime :: !(Maybe Text)
30383414 , _iVMId :: !(Maybe Text)
30393415 , _iAvailability :: !(Maybe Text)
30403416 , _iVMName :: !(Maybe Text)
30413417 , _iName :: !(Maybe Text)
3042− , _iVMUnlocked :: !(Maybe Bool)
3418+ , _iVMDebugEnabled :: !(Maybe Bool)
30433419 , _iRequests :: !(Maybe (Textual Int32))
30443420 , _iQps :: !(Maybe (Textual Double))
30453421 , _iId :: !(Maybe Text)
3046− , _iErrors :: !(Maybe (Textual Word32))
3422+ , _iErrors :: !(Maybe (Textual Int32))
30473423 , _iAverageLatency :: !(Maybe (Textual Int32))
3048− , _iStartTimestamp :: !(Maybe Text)
30493424 , _iAppEngineRelease :: !(Maybe Text)
30503425 } deriving (Eq,Show,Data,Typeable,Generic)
30513426
@@ -3059,6 +3434,8 @@ data Instance = Instance'
30593434--
30603435-- * 'iVMZoneName'
30613436--
3437+-- * 'iStartTime'
3438+--
30623439-- * 'iVMId'
30633440--
30643441-- * 'iAvailability'
@@ -3067,7 +3444,7 @@ data Instance = Instance'
30673444--
30683445-- * 'iName'
30693446--
3070−-- * 'iVMUnlocked'
3447+-- * 'iVMDebugEnabled'
30713448--
30723449-- * 'iRequests'
30733450--
@@ -3079,8 +3456,6 @@ data Instance = Instance'
30793456--
30803457-- * 'iAverageLatency'
30813458--
3082−-- * 'iStartTimestamp'
3083−--
30843459-- * 'iAppEngineRelease'
30853460instance'
30863461 :: Instance
@@ -3089,102 +3464,103 @@ instance' =
30893464 { _iMemoryUsage = Nothing
30903465 , _iVMStatus = Nothing
30913466 , _iVMZoneName = Nothing
3467+ , _iStartTime = Nothing
30923468 , _iVMId = Nothing
30933469 , _iAvailability = Nothing
30943470 , _iVMName = Nothing
30953471 , _iName = Nothing
3096− , _iVMUnlocked = Nothing
3472+ , _iVMDebugEnabled = Nothing
30973473 , _iRequests = Nothing
30983474 , _iQps = Nothing
30993475 , _iId = Nothing
31003476 , _iErrors = Nothing
31013477 , _iAverageLatency = Nothing
3102− , _iStartTimestamp = Nothing
31033478 , _iAppEngineRelease = Nothing
31043479 }
31053480
3106−-- | Memory usage (in bytes). \'OutputOnly
3481+-- | Total memory in use (bytes). \'OutputOnly
31073482iMemoryUsage :: Lens' Instance (Maybe Int64)
31083483iMemoryUsage
31093484 = lens _iMemoryUsage (\ s a -> s{_iMemoryUsage = a})
31103485 . mapping _Coerce
31113486
3112−-- | For VMEngines instances, the status of GCE VM where the instance lives.
3113−-- \'OutputOnly
3487+-- | Status of the virtual machine where this instance lives. Only applicable
3488+-- for instances in App Engine flexible environment. \'OutputOnly
31143489iVMStatus :: Lens' Instance (Maybe Text)
31153490iVMStatus
31163491 = lens _iVMStatus (\ s a -> s{_iVMStatus = a})
31173492
3118−-- | For VMEngines instances, the zone where the GCE VM is located.
3119−-- \'OutputOnly
3493+-- | Zone where the virtual machine is located. Only applicable for instances
3494+-- in App Engine flexible environment. \'OutputOnly
31203495iVMZoneName :: Lens' Instance (Maybe Text)
31213496iVMZoneName
31223497 = lens _iVMZoneName (\ s a -> s{_iVMZoneName = a})
31233498
3124−-- | For VMEngines instances, the GCE VM ID of the instance. \'OutputOnly
3499+-- | Time that this instance was started. \'OutputOnly
3500+iStartTime :: Lens' Instance (Maybe Text)
3501+iStartTime
3502+ = lens _iStartTime (\ s a -> s{_iStartTime = a})
3503+
3504+-- | Virtual machine ID of this instance. Only applicable for instances in
3505+-- App Engine flexible environment. \'OutputOnly
31253506iVMId :: Lens' Instance (Maybe Text)
31263507iVMId = lens _iVMId (\ s a -> s{_iVMId = a})
31273508
3128−-- | Availability of instance. \'OutputOnly
3509+-- | Availability of the instance. \'OutputOnly
31293510iAvailability :: Lens' Instance (Maybe Text)
31303511iAvailability
31313512 = lens _iAvailability
31323513 (\ s a -> s{_iAvailability = a})
31333514
3134−-- | For VMEngines instances, the name of GCE VM where the instance lives.
3135−-- \'OutputOnly
3515+-- | Name of the virtual machine where this instance lives. Only applicable
3516+-- for instances in App Engine flexible environment. \'OutputOnly
31363517iVMName :: Lens' Instance (Maybe Text)
31373518iVMName = lens _iVMName (\ s a -> s{_iVMName = a})
31383519
3139−-- | The full path to the Instance resource in the API. Example:
3140−-- \"apps\/myapp\/services\/default\/versions\/v1\/instances\/instance-1\"
3520+-- | Full path to the Instance resource in the API. Example:
3521+-- \`apps\/myapp\/services\/default\/versions\/v1\/instances\/instance-1\`.
31413522-- \'OutputOnly
31423523iName :: Lens' Instance (Maybe Text)
31433524iName = lens _iName (\ s a -> s{_iName = a})
31443525
3145−-- | For VMEngines instances, whether the instance has been unlocked.
3146−-- \'OutputOnly
3147−iVMUnlocked :: Lens' Instance (Maybe Bool)
3148−iVMUnlocked
3149− = lens _iVMUnlocked (\ s a -> s{_iVMUnlocked = a})
3526+-- | Whether this instance is in debug mode. Only applicable for instances in
3527+-- App Engine flexible environment. \'OutputOnly
3528+iVMDebugEnabled :: Lens' Instance (Maybe Bool)
3529+iVMDebugEnabled
3530+ = lens _iVMDebugEnabled
3531+ (\ s a -> s{_iVMDebugEnabled = a})
31503532
3151−-- | Number of requests (since the clone was started). \'OutputOnly
3533+-- | Number of requests since this instance was started. \'OutputOnly
31523534iRequests :: Lens' Instance (Maybe Int32)
31533535iRequests
31543536 = lens _iRequests (\ s a -> s{_iRequests = a}) .
31553537 mapping _Coerce
31563538
3157−-- | QPS for this instance (averaged over the last minute). \'OutputOnly
3539+-- | Average queries per second (QPS) over the last minute. \'OutputOnly
31583540iQps :: Lens' Instance (Maybe Double)
31593541iQps
31603542 = lens _iQps (\ s a -> s{_iQps = a}) .
31613543 mapping _Coerce
31623544
3163−-- | The relative name\/path of the instance within the version. Example:
3164−-- \"instance-1\" \'OutputOnly
3545+-- | Relative name of the instance within the version. Example:
3546+-- \`instance-1\`. \'OutputOnly
31653547iId :: Lens' Instance (Maybe Text)
31663548iId = lens _iId (\ s a -> s{_iId = a})
31673549
3168−-- | Number of errors since the instance was started. \'OutputOnly
3169−iErrors :: Lens' Instance (Maybe Word32)
3550+-- | Number of errors since this instance was started. \'OutputOnly
3551+iErrors :: Lens' Instance (Maybe Int32)
31703552iErrors
31713553 = lens _iErrors (\ s a -> s{_iErrors = a}) .
31723554 mapping _Coerce
31733555
3174−-- | Latency in milliseconds (averaged over the last minute). \'OutputOnly
3556+-- | Average latency (ms) over the last minute. \'OutputOnly
31753557iAverageLatency :: Lens' Instance (Maybe Int32)
31763558iAverageLatency
31773559 = lens _iAverageLatency
31783560 (\ s a -> s{_iAverageLatency = a})
31793561 . mapping _Coerce
31803562
3181−-- | Time when instance was started. \'OutputOnly
3182−iStartTimestamp :: Lens' Instance (Maybe Text)
3183−iStartTimestamp
3184− = lens _iStartTimestamp
3185− (\ s a -> s{_iStartTimestamp = a})
3186−
3187−-- | The App Engine release the instance is running on. \'OutputOnly
3563+-- | App Engine release this instance is running on. \'OutputOnly
31883564iAppEngineRelease :: Lens' Instance (Maybe Text)
31893565iAppEngineRelease
31903566 = lens _iAppEngineRelease
@@ -3197,17 +3573,17 @@ instance FromJSON Instance where
31973573 Instance' <$>
31983574 (o .:? "memoryUsage") <*> (o .:? "vmStatus") <*>
31993575 (o .:? "vmZoneName")
3576+ <*> (o .:? "startTime")
32003577 <*> (o .:? "vmId")
32013578 <*> (o .:? "availability")
32023579 <*> (o .:? "vmName")
32033580 <*> (o .:? "name")
3204− <*> (o .:? "vmUnlocked")
3581+ <*> (o .:? "vmDebugEnabled")
32053582 <*> (o .:? "requests")
32063583 <*> (o .:? "qps")
32073584 <*> (o .:? "id")
32083585 <*> (o .:? "errors")
32093586 <*> (o .:? "averageLatency")
3210− <*> (o .:? "startTimestamp")
32113587 <*> (o .:? "appEngineRelease"))
32123588
32133589instance ToJSON Instance where
@@ -3217,77 +3593,71 @@ instance ToJSON Instance where
32173593 [("memoryUsage" .=) <$> _iMemoryUsage,
32183594 ("vmStatus" .=) <$> _iVMStatus,
32193595 ("vmZoneName" .=) <$> _iVMZoneName,
3596+ ("startTime" .=) <$> _iStartTime,
32203597 ("vmId" .=) <$> _iVMId,
32213598 ("availability" .=) <$> _iAvailability,
32223599 ("vmName" .=) <$> _iVMName, ("name" .=) <$> _iName,
3223− ("vmUnlocked" .=) <$> _iVMUnlocked,
3600+ ("vmDebugEnabled" .=) <$> _iVMDebugEnabled,
32243601 ("requests" .=) <$> _iRequests, ("qps" .=) <$> _iQps,
32253602 ("id" .=) <$> _iId, ("errors" .=) <$> _iErrors,
32263603 ("averageLatency" .=) <$> _iAverageLatency,
3227− ("startTimestamp" .=) <$> _iStartTimestamp,
32283604 ("appEngineRelease" .=) <$> _iAppEngineRelease])
32293605
32303606-- | Code and application artifacts used to deploy a version to App Engine.
32313607--
32323608-- /See:/ 'deployment' smart constructor.
32333609data Deployment = Deployment'
3234− { _dContainer :: !(Maybe ContainerInfo)
3235− , _dFiles :: !(Maybe DeploymentFiles)
3236− , _dSourceReferences :: !(Maybe [SourceReference])
3610+ { _dZip :: !(Maybe ZipInfo)
3611+ , _dContainer :: !(Maybe ContainerInfo)
3612+ , _dFiles :: !(Maybe DeploymentFiles)
32373613 } deriving (Eq,Show,Data,Typeable,Generic)
32383614
32393615-- | Creates a value of 'Deployment' with the minimum fields required to make a request.
32403616--
32413617-- Use one of the following lenses to modify other fields as desired:
32423618--
3619+-- * 'dZip'
3620+--
32433621-- * 'dContainer'
32443622--
32453623-- * 'dFiles'
3246−--
3247−-- * 'dSourceReferences'
32483624deployment
32493625 :: Deployment
32503626deployment =
32513627 Deployment'
3252− { _dContainer = Nothing
3628+ { _dZip = Nothing
3629+ , _dContainer = Nothing
32533630 , _dFiles = Nothing
3254− , _dSourceReferences = Nothing
32553631 }
32563632
3257−-- | If supplied, a docker (container) image which should be used to start
3258−-- the application. Only applicable to the \'vm\' runtime.
3633+-- | The zip file for this deployment, if this is a zip deployment.
3634+dZip :: Lens' Deployment (Maybe ZipInfo)
3635+dZip = lens _dZip (\ s a -> s{_dZip = a})
3636+
3637+-- | A Docker image that App Engine uses to run the version. Only applicable
3638+-- for instances in App Engine flexible environment.
32593639dContainer :: Lens' Deployment (Maybe ContainerInfo)
32603640dContainer
32613641 = lens _dContainer (\ s a -> s{_dContainer = a})
32623642
3263−-- | A manifest of files stored in Google Cloud Storage which should be
3264−-- included as part of this application. All files must be readable using
3265−-- the credentials supplied with this call.
3643+-- | Manifest of the files stored in Google Cloud Storage that are included
3644+-- as part of this version. All files must be readable using the
3645+-- credentials supplied with this call.
32663646dFiles :: Lens' Deployment (Maybe DeploymentFiles)
32673647dFiles = lens _dFiles (\ s a -> s{_dFiles = a})
32683648
3269−-- | The origin of the source code for this deployment. There can be more
3270−-- than one source reference per Version if source code is distributed
3271−-- among multiple repositories.
3272−dSourceReferences :: Lens' Deployment [SourceReference]
3273−dSourceReferences
3274− = lens _dSourceReferences
3275− (\ s a -> s{_dSourceReferences = a})
3276− . _Default
3277− . _Coerce
3278−
32793649instance FromJSON Deployment where
32803650 parseJSON
32813651 = withObject "Deployment"
32823652 (\ o ->
32833653 Deployment' <$>
3284− (o .:? "container") <*> (o .:? "files") <*>
3285− (o .:? "sourceReferences" .!= mempty))
3654+ (o .:? "zip") <*> (o .:? "container") <*>
3655+ (o .:? "files"))
32863656
32873657instance ToJSON Deployment where
32883658 toJSON Deployment'{..}
32893659 = object
32903660 (catMaybes
3291− [("container" .=) <$> _dContainer,
3292− ("files" .=) <$> _dFiles,
3293− ("sourceReferences" .=) <$> _dSourceReferences])
3661+ [("zip" .=) <$> _dZip,
3662+ ("container" .=) <$> _dContainer,
3663+ ("files" .=) <$> _dFiles])
gogol-appengine/gen/Network/Google/Resource/AppEngine/Apps/Get.hs+13−31
@@ -40,7 +40,6 @@ module Network.Google.Resource.AppEngine.Apps.Get
4040 , agUploadType
4141 , agBearerToken
4242 , agAppsId
43− , agEnsureResourcesExist
4443 , agCallback
4544 ) where
4645
@@ -50,7 +49,7 @@ import Network.Google.Prelude
5049-- | A resource alias for @appengine.apps.get@ method which the
5150-- 'AppsGet' request conforms to.
5251type AppsGetResource =
53− "v1beta5" :>
52+ "v1" :>
5453 "apps" :>
5554 Capture "appsId" Text :>
5655 QueryParam "$.xgafv" Text :>
@@ -59,23 +58,21 @@ type AppsGetResource =
5958 QueryParam "access_token" Text :>
6059 QueryParam "uploadType" Text :>
6160 QueryParam "bearer_token" Text :>
62− QueryParam "ensureResourcesExist" Bool :>
63− QueryParam "callback" Text :>
64− QueryParam "alt" AltJSON :> Get '[JSON] Application
61+ QueryParam "callback" Text :>
62+ QueryParam "alt" AltJSON :> Get '[JSON] Application
6563
6664-- | Gets information about an application.
6765--
6866-- /See:/ 'appsGet' smart constructor.
6967data AppsGet = AppsGet'
70− { _agXgafv :: !(Maybe Text)
71− , _agUploadProtocol :: !(Maybe Text)
72− , _agPp :: !Bool
73− , _agAccessToken :: !(Maybe Text)
74− , _agUploadType :: !(Maybe Text)
75− , _agBearerToken :: !(Maybe Text)
76− , _agAppsId :: !Text
77− , _agEnsureResourcesExist :: !(Maybe Bool)
78− , _agCallback :: !(Maybe Text)
68+ { _agXgafv :: !(Maybe Text)
69+ , _agUploadProtocol :: !(Maybe Text)
70+ , _agPp :: !Bool
71+ , _agAccessToken :: !(Maybe Text)
72+ , _agUploadType :: !(Maybe Text)
73+ , _agBearerToken :: !(Maybe Text)
74+ , _agAppsId :: !Text
75+ , _agCallback :: !(Maybe Text)
7976 } deriving (Eq,Show,Data,Typeable,Generic)
8077
8178-- | Creates a value of 'AppsGet' with the minimum fields required to make a request.
@@ -96,8 +93,6 @@ data AppsGet = AppsGet'
9693--
9794-- * 'agAppsId'
9895--
99−-- * 'agEnsureResourcesExist'
100−--
10196-- * 'agCallback'
10297appsGet
10398 :: Text -- ^ 'agAppsId'
@@ -111,7 +106,6 @@ appsGet pAgAppsId_ =
111106 , _agUploadType = Nothing
112107 , _agBearerToken = Nothing
113108 , _agAppsId = pAgAppsId_
114− , _agEnsureResourcesExist = Nothing
115109 , _agCallback = Nothing
116110 }
117111
@@ -146,22 +140,11 @@ agBearerToken
146140 = lens _agBearerToken
147141 (\ s a -> s{_agBearerToken = a})
148142
149−-- | Part of \`name\`. Name of the application to get. For example:
150−-- \"apps\/myapp\".
143+-- | Part of \`name\`. Name of the Application resource to get. Example:
144+-- \`apps\/myapp\`.
151145agAppsId :: Lens' AppsGet Text
152146agAppsId = lens _agAppsId (\ s a -> s{_agAppsId = a})
153147
154−-- | Certain resources associated with an application are created on-demand.
155−-- Controls whether these resources should be created when performing the
156−-- \`GET\` operation. If specified and any resources could not be created,
157−-- the request will fail with an error code. Additionally, this parameter
158−-- can cause the request to take longer to complete. Note: This parameter
159−-- will be deprecated in a future version of the API.
160−agEnsureResourcesExist :: Lens' AppsGet (Maybe Bool)
161−agEnsureResourcesExist
162− = lens _agEnsureResourcesExist
163− (\ s a -> s{_agEnsureResourcesExist = a})
164−
165148-- | JSONP
166149agCallback :: Lens' AppsGet (Maybe Text)
167150agCallback
@@ -177,7 +160,6 @@ instance GoogleRequest AppsGet where
177160 _agAccessToken
178161 _agUploadType
179162 _agBearerToken
180− _agEnsureResourcesExist
181163 _agCallback
182164 (Just AltJSON)
183165 appEngineService
gogol-appengine/gen/Network/Google/Resource/AppEngine/Apps/Locations/Get.hsnew file+185
@@ -0,0 +1,185 @@
1+{-# LANGUAGE DataKinds #-}
2+{-# LANGUAGE DeriveDataTypeable #-}
3+{-# LANGUAGE DeriveGeneric #-}
4+{-# LANGUAGE FlexibleInstances #-}
5+{-# LANGUAGE NoImplicitPrelude #-}
6+{-# LANGUAGE OverloadedStrings #-}
7+{-# LANGUAGE RecordWildCards #-}
8+{-# LANGUAGE TypeFamilies #-}
9+{-# LANGUAGE TypeOperators #-}
10+
11+{-# OPTIONS_GHC -fno-warn-duplicate-exports #-}
12+{-# OPTIONS_GHC -fno-warn-unused-binds #-}
13+{-# OPTIONS_GHC -fno-warn-unused-imports #-}
14+
15+-- |
16+-- Module : Network.Google.Resource.AppEngine.Apps.Locations.Get
17+-- Copyright : (c) 2015-2016 Brendan Hay
18+-- License : Mozilla Public License, v. 2.0.
19+-- Maintainer : Brendan Hay <brendan.g.hay@gmail.com>
20+-- Stability : auto-generated
21+-- Portability : non-portable (GHC extensions)
22+--
23+-- Get information about a location.
24+--
25+-- /See:/ <https://cloud.google.com/appengine/docs/admin-api/ Google App Engine Admin API Reference> for @appengine.apps.locations.get@.
26+module Network.Google.Resource.AppEngine.Apps.Locations.Get
27+ (
28+ -- * REST Resource
29+ AppsLocationsGetResource
30+
31+ -- * Creating a Request
32+ , appsLocationsGet
33+ , AppsLocationsGet
34+
35+ -- * Request Lenses
36+ , algXgafv
37+ , algUploadProtocol
38+ , algPp
39+ , algAccessToken
40+ , algUploadType
41+ , algBearerToken
42+ , algAppsId
43+ , algLocationsId
44+ , algCallback
45+ ) where
46+
47+import Network.Google.AppEngine.Types
48+import Network.Google.Prelude
49+
50+-- | A resource alias for @appengine.apps.locations.get@ method which the
51+-- 'AppsLocationsGet' request conforms to.
52+type AppsLocationsGetResource =
53+ "v1" :>
54+ "apps" :>
55+ Capture "appsId" Text :>
56+ "locations" :>
57+ Capture "locationsId" Text :>
58+ QueryParam "$.xgafv" Text :>
59+ QueryParam "upload_protocol" Text :>
60+ QueryParam "pp" Bool :>
61+ QueryParam "access_token" Text :>
62+ QueryParam "uploadType" Text :>
63+ QueryParam "bearer_token" Text :>
64+ QueryParam "callback" Text :>
65+ QueryParam "alt" AltJSON :> Get '[JSON] Location
66+
67+-- | Get information about a location.
68+--
69+-- /See:/ 'appsLocationsGet' smart constructor.
70+data AppsLocationsGet = AppsLocationsGet'
71+ { _algXgafv :: !(Maybe Text)
72+ , _algUploadProtocol :: !(Maybe Text)
73+ , _algPp :: !Bool
74+ , _algAccessToken :: !(Maybe Text)
75+ , _algUploadType :: !(Maybe Text)
76+ , _algBearerToken :: !(Maybe Text)
77+ , _algAppsId :: !Text
78+ , _algLocationsId :: !Text
79+ , _algCallback :: !(Maybe Text)
80+ } deriving (Eq,Show,Data,Typeable,Generic)
81+
82+-- | Creates a value of 'AppsLocationsGet' with the minimum fields required to make a request.
83+--
84+-- Use one of the following lenses to modify other fields as desired:
85+--
86+-- * 'algXgafv'
87+--
88+-- * 'algUploadProtocol'
89+--
90+-- * 'algPp'
91+--
92+-- * 'algAccessToken'
93+--
94+-- * 'algUploadType'
95+--
96+-- * 'algBearerToken'
97+--
98+-- * 'algAppsId'
99+--
100+-- * 'algLocationsId'
101+--
102+-- * 'algCallback'
103+appsLocationsGet
104+ :: Text -- ^ 'algAppsId'
105+ -> Text -- ^ 'algLocationsId'
106+ -> AppsLocationsGet
107+appsLocationsGet pAlgAppsId_ pAlgLocationsId_ =
108+ AppsLocationsGet'
109+ { _algXgafv = Nothing
110+ , _algUploadProtocol = Nothing
111+ , _algPp = True
112+ , _algAccessToken = Nothing
113+ , _algUploadType = Nothing
114+ , _algBearerToken = Nothing
115+ , _algAppsId = pAlgAppsId_
116+ , _algLocationsId = pAlgLocationsId_
117+ , _algCallback = Nothing
118+ }
119+
120+-- | V1 error format.
121+algXgafv :: Lens' AppsLocationsGet (Maybe Text)
122+algXgafv = lens _algXgafv (\ s a -> s{_algXgafv = a})
123+
124+-- | Upload protocol for media (e.g. \"raw\", \"multipart\").
125+algUploadProtocol :: Lens' AppsLocationsGet (Maybe Text)
126+algUploadProtocol
127+ = lens _algUploadProtocol
128+ (\ s a -> s{_algUploadProtocol = a})
129+
130+-- | Pretty-print response.
131+algPp :: Lens' AppsLocationsGet Bool
132+algPp = lens _algPp (\ s a -> s{_algPp = a})
133+
134+-- | OAuth access token.
135+algAccessToken :: Lens' AppsLocationsGet (Maybe Text)
136+algAccessToken
137+ = lens _algAccessToken
138+ (\ s a -> s{_algAccessToken = a})
139+
140+-- | Legacy upload protocol for media (e.g. \"media\", \"multipart\").
141+algUploadType :: Lens' AppsLocationsGet (Maybe Text)
142+algUploadType
143+ = lens _algUploadType
144+ (\ s a -> s{_algUploadType = a})
145+
146+-- | OAuth bearer token.
147+algBearerToken :: Lens' AppsLocationsGet (Maybe Text)
148+algBearerToken
149+ = lens _algBearerToken
150+ (\ s a -> s{_algBearerToken = a})
151+
152+-- | Part of \`name\`. Resource name for the location.
153+algAppsId :: Lens' AppsLocationsGet Text
154+algAppsId
155+ = lens _algAppsId (\ s a -> s{_algAppsId = a})
156+
157+-- | Part of \`name\`. See documentation of \`appsId\`.
158+algLocationsId :: Lens' AppsLocationsGet Text
159+algLocationsId
160+ = lens _algLocationsId
161+ (\ s a -> s{_algLocationsId = a})
162+
163+-- | JSONP
164+algCallback :: Lens' AppsLocationsGet (Maybe Text)
165+algCallback
166+ = lens _algCallback (\ s a -> s{_algCallback = a})
167+
168+instance GoogleRequest AppsLocationsGet where
169+ type Rs AppsLocationsGet = Location
170+ type Scopes AppsLocationsGet =
171+ '["https://www.googleapis.com/auth/cloud-platform"]
172+ requestClient AppsLocationsGet'{..}
173+ = go _algAppsId _algLocationsId _algXgafv
174+ _algUploadProtocol
175+ (Just _algPp)
176+ _algAccessToken
177+ _algUploadType
178+ _algBearerToken
179+ _algCallback
180+ (Just AltJSON)
181+ appEngineService
182+ where go
183+ = buildClient
184+ (Proxy :: Proxy AppsLocationsGetResource)
185+ mempty
gogol-appengine/gen/Network/Google/Resource/AppEngine/Apps/Locations/List.hsnew file+210
@@ -0,0 +1,210 @@
1+{-# LANGUAGE DataKinds #-}
2+{-# LANGUAGE DeriveDataTypeable #-}
3+{-# LANGUAGE DeriveGeneric #-}
4+{-# LANGUAGE FlexibleInstances #-}
5+{-# LANGUAGE NoImplicitPrelude #-}
6+{-# LANGUAGE OverloadedStrings #-}
7+{-# LANGUAGE RecordWildCards #-}
8+{-# LANGUAGE TypeFamilies #-}
9+{-# LANGUAGE TypeOperators #-}
10+
11+{-# OPTIONS_GHC -fno-warn-duplicate-exports #-}
12+{-# OPTIONS_GHC -fno-warn-unused-binds #-}
13+{-# OPTIONS_GHC -fno-warn-unused-imports #-}
14+
15+-- |
16+-- Module : Network.Google.Resource.AppEngine.Apps.Locations.List
17+-- Copyright : (c) 2015-2016 Brendan Hay
18+-- License : Mozilla Public License, v. 2.0.
19+-- Maintainer : Brendan Hay <brendan.g.hay@gmail.com>
20+-- Stability : auto-generated
21+-- Portability : non-portable (GHC extensions)
22+--
23+-- Lists information about the supported locations for this service.
24+--
25+-- /See:/ <https://cloud.google.com/appengine/docs/admin-api/ Google App Engine Admin API Reference> for @appengine.apps.locations.list@.
26+module Network.Google.Resource.AppEngine.Apps.Locations.List
27+ (
28+ -- * REST Resource
29+ AppsLocationsListResource
30+
31+ -- * Creating a Request
32+ , appsLocationsList
33+ , AppsLocationsList
34+
35+ -- * Request Lenses
36+ , allXgafv
37+ , allUploadProtocol
38+ , allPp
39+ , allAccessToken
40+ , allUploadType
41+ , allBearerToken
42+ , allAppsId
43+ , allFilter
44+ , allPageToken
45+ , allPageSize
46+ , allCallback
47+ ) where
48+
49+import Network.Google.AppEngine.Types
50+import Network.Google.Prelude
51+
52+-- | A resource alias for @appengine.apps.locations.list@ method which the
53+-- 'AppsLocationsList' request conforms to.
54+type AppsLocationsListResource =
55+ "v1" :>
56+ "apps" :>
57+ Capture "appsId" Text :>
58+ "locations" :>
59+ QueryParam "$.xgafv" Text :>
60+ QueryParam "upload_protocol" Text :>
61+ QueryParam "pp" Bool :>
62+ QueryParam "access_token" Text :>
63+ QueryParam "uploadType" Text :>
64+ QueryParam "bearer_token" Text :>
65+ QueryParam "filter" Text :>
66+ QueryParam "pageToken" Text :>
67+ QueryParam "pageSize" (Textual Int32) :>
68+ QueryParam "callback" Text :>
69+ QueryParam "alt" AltJSON :>
70+ Get '[JSON] ListLocationsResponse
71+
72+-- | Lists information about the supported locations for this service.
73+--
74+-- /See:/ 'appsLocationsList' smart constructor.
75+data AppsLocationsList = AppsLocationsList'
76+ { _allXgafv :: !(Maybe Text)
77+ , _allUploadProtocol :: !(Maybe Text)
78+ , _allPp :: !Bool
79+ , _allAccessToken :: !(Maybe Text)
80+ , _allUploadType :: !(Maybe Text)
81+ , _allBearerToken :: !(Maybe Text)
82+ , _allAppsId :: !Text
83+ , _allFilter :: !(Maybe Text)
84+ , _allPageToken :: !(Maybe Text)
85+ , _allPageSize :: !(Maybe (Textual Int32))
86+ , _allCallback :: !(Maybe Text)
87+ } deriving (Eq,Show,Data,Typeable,Generic)
88+
89+-- | Creates a value of 'AppsLocationsList' with the minimum fields required to make a request.
90+--
91+-- Use one of the following lenses to modify other fields as desired:
92+--
93+-- * 'allXgafv'
94+--
95+-- * 'allUploadProtocol'
96+--
97+-- * 'allPp'
98+--
99+-- * 'allAccessToken'
100+--
101+-- * 'allUploadType'
102+--
103+-- * 'allBearerToken'
104+--
105+-- * 'allAppsId'
106+--
107+-- * 'allFilter'
108+--
109+-- * 'allPageToken'
110+--
111+-- * 'allPageSize'
112+--
113+-- * 'allCallback'
114+appsLocationsList
115+ :: Text -- ^ 'allAppsId'
116+ -> AppsLocationsList
117+appsLocationsList pAllAppsId_ =
118+ AppsLocationsList'
119+ { _allXgafv = Nothing
120+ , _allUploadProtocol = Nothing
121+ , _allPp = True
122+ , _allAccessToken = Nothing
123+ , _allUploadType = Nothing
124+ , _allBearerToken = Nothing
125+ , _allAppsId = pAllAppsId_
126+ , _allFilter = Nothing
127+ , _allPageToken = Nothing
128+ , _allPageSize = Nothing
129+ , _allCallback = Nothing
130+ }
131+
132+-- | V1 error format.
133+allXgafv :: Lens' AppsLocationsList (Maybe Text)
134+allXgafv = lens _allXgafv (\ s a -> s{_allXgafv = a})
135+
136+-- | Upload protocol for media (e.g. \"raw\", \"multipart\").
137+allUploadProtocol :: Lens' AppsLocationsList (Maybe Text)
138+allUploadProtocol
139+ = lens _allUploadProtocol
140+ (\ s a -> s{_allUploadProtocol = a})
141+
142+-- | Pretty-print response.
143+allPp :: Lens' AppsLocationsList Bool
144+allPp = lens _allPp (\ s a -> s{_allPp = a})
145+
146+-- | OAuth access token.
147+allAccessToken :: Lens' AppsLocationsList (Maybe Text)
148+allAccessToken
149+ = lens _allAccessToken
150+ (\ s a -> s{_allAccessToken = a})
151+
152+-- | Legacy upload protocol for media (e.g. \"media\", \"multipart\").
153+allUploadType :: Lens' AppsLocationsList (Maybe Text)
154+allUploadType
155+ = lens _allUploadType
156+ (\ s a -> s{_allUploadType = a})
157+
158+-- | OAuth bearer token.
159+allBearerToken :: Lens' AppsLocationsList (Maybe Text)
160+allBearerToken
161+ = lens _allBearerToken
162+ (\ s a -> s{_allBearerToken = a})
163+
164+-- | Part of \`name\`. The resource that owns the locations collection, if
165+-- applicable.
166+allAppsId :: Lens' AppsLocationsList Text
167+allAppsId
168+ = lens _allAppsId (\ s a -> s{_allAppsId = a})
169+
170+-- | The standard list filter.
171+allFilter :: Lens' AppsLocationsList (Maybe Text)
172+allFilter
173+ = lens _allFilter (\ s a -> s{_allFilter = a})
174+
175+-- | The standard list page token.
176+allPageToken :: Lens' AppsLocationsList (Maybe Text)
177+allPageToken
178+ = lens _allPageToken (\ s a -> s{_allPageToken = a})
179+
180+-- | The standard list page size.
181+allPageSize :: Lens' AppsLocationsList (Maybe Int32)
182+allPageSize
183+ = lens _allPageSize (\ s a -> s{_allPageSize = a}) .
184+ mapping _Coerce
185+
186+-- | JSONP
187+allCallback :: Lens' AppsLocationsList (Maybe Text)
188+allCallback
189+ = lens _allCallback (\ s a -> s{_allCallback = a})
190+
191+instance GoogleRequest AppsLocationsList where
192+ type Rs AppsLocationsList = ListLocationsResponse
193+ type Scopes AppsLocationsList =
194+ '["https://www.googleapis.com/auth/cloud-platform"]
195+ requestClient AppsLocationsList'{..}
196+ = go _allAppsId _allXgafv _allUploadProtocol
197+ (Just _allPp)
198+ _allAccessToken
199+ _allUploadType
200+ _allBearerToken
201+ _allFilter
202+ _allPageToken
203+ _allPageSize
204+ _allCallback
205+ (Just AltJSON)
206+ appEngineService
207+ where go
208+ = buildClient
209+ (Proxy :: Proxy AppsLocationsListResource)
210+ mempty
gogol-appengine/gen/Network/Google/Resource/AppEngine/Apps/Operations/Get.hs+1−1
@@ -52,7 +52,7 @@ import Network.Google.Prelude
5252-- | A resource alias for @appengine.apps.operations.get@ method which the
5353-- 'AppsOperationsGet' request conforms to.
5454type AppsOperationsGetResource =
55− "v1beta5" :>
55+ "v1" :>
5656 "apps" :>
5757 Capture "appsId" Text :>
5858 "operations" :>
gogol-appengine/gen/Network/Google/Resource/AppEngine/Apps/Operations/List.hs+1−1
@@ -56,7 +56,7 @@ import Network.Google.Prelude
5656-- | A resource alias for @appengine.apps.operations.list@ method which the
5757-- 'AppsOperationsList' request conforms to.
5858type AppsOperationsListResource =
59− "v1beta5" :>
59+ "v1" :>
6060 "apps" :>
6161 Capture "appsId" Text :>
6262 "operations" :>
gogol-appengine/gen/Network/Google/Resource/AppEngine/Apps/Patch.hsnew file+194
@@ -0,0 +1,194 @@
1+{-# LANGUAGE DataKinds #-}
2+{-# LANGUAGE DeriveDataTypeable #-}
3+{-# LANGUAGE DeriveGeneric #-}
4+{-# LANGUAGE FlexibleInstances #-}
5+{-# LANGUAGE NoImplicitPrelude #-}
6+{-# LANGUAGE OverloadedStrings #-}
7+{-# LANGUAGE RecordWildCards #-}
8+{-# LANGUAGE TypeFamilies #-}
9+{-# LANGUAGE TypeOperators #-}
10+
11+{-# OPTIONS_GHC -fno-warn-duplicate-exports #-}
12+{-# OPTIONS_GHC -fno-warn-unused-binds #-}
13+{-# OPTIONS_GHC -fno-warn-unused-imports #-}
14+
15+-- |
16+-- Module : Network.Google.Resource.AppEngine.Apps.Patch
17+-- Copyright : (c) 2015-2016 Brendan Hay
18+-- License : Mozilla Public License, v. 2.0.
19+-- Maintainer : Brendan Hay <brendan.g.hay@gmail.com>
20+-- Stability : auto-generated
21+-- Portability : non-portable (GHC extensions)
22+--
23+-- Updates application parameters.
24+--
25+-- /See:/ <https://cloud.google.com/appengine/docs/admin-api/ Google App Engine Admin API Reference> for @appengine.apps.patch@.
26+module Network.Google.Resource.AppEngine.Apps.Patch
27+ (
28+ -- * REST Resource
29+ AppsPatchResource
30+
31+ -- * Creating a Request
32+ , appsPatch
33+ , AppsPatch
34+
35+ -- * Request Lenses
36+ , apXgafv
37+ , apUploadProtocol
38+ , apUpdateMask
39+ , apPp
40+ , apAccessToken
41+ , apUploadType
42+ , apPayload
43+ , apBearerToken
44+ , apAppsId
45+ , apCallback
46+ ) where
47+
48+import Network.Google.AppEngine.Types
49+import Network.Google.Prelude
50+
51+-- | A resource alias for @appengine.apps.patch@ method which the
52+-- 'AppsPatch' request conforms to.
53+type AppsPatchResource =
54+ "v1" :>
55+ "apps" :>
56+ Capture "appsId" Text :>
57+ QueryParam "$.xgafv" Text :>
58+ QueryParam "upload_protocol" Text :>
59+ QueryParam "updateMask" Text :>
60+ QueryParam "pp" Bool :>
61+ QueryParam "access_token" Text :>
62+ QueryParam "uploadType" Text :>
63+ QueryParam "bearer_token" Text :>
64+ QueryParam "callback" Text :>
65+ QueryParam "alt" AltJSON :>
66+ ReqBody '[JSON] Application :>
67+ Patch '[JSON] Operation
68+
69+-- | Updates application parameters.
70+--
71+-- /See:/ 'appsPatch' smart constructor.
72+data AppsPatch = AppsPatch'
73+ { _apXgafv :: !(Maybe Text)
74+ , _apUploadProtocol :: !(Maybe Text)
75+ , _apUpdateMask :: !(Maybe Text)
76+ , _apPp :: !Bool
77+ , _apAccessToken :: !(Maybe Text)
78+ , _apUploadType :: !(Maybe Text)
79+ , _apPayload :: !Application
80+ , _apBearerToken :: !(Maybe Text)
81+ , _apAppsId :: !Text
82+ , _apCallback :: !(Maybe Text)
83+ } deriving (Eq,Show,Data,Typeable,Generic)
84+
85+-- | Creates a value of 'AppsPatch' with the minimum fields required to make a request.
86+--
87+-- Use one of the following lenses to modify other fields as desired:
88+--
89+-- * 'apXgafv'
90+--
91+-- * 'apUploadProtocol'
92+--
93+-- * 'apUpdateMask'
94+--
95+-- * 'apPp'
96+--
97+-- * 'apAccessToken'
98+--
99+-- * 'apUploadType'
100+--
101+-- * 'apPayload'
102+--
103+-- * 'apBearerToken'
104+--
105+-- * 'apAppsId'
106+--
107+-- * 'apCallback'
108+appsPatch
109+ :: Application -- ^ 'apPayload'
110+ -> Text -- ^ 'apAppsId'
111+ -> AppsPatch
112+appsPatch pApPayload_ pApAppsId_ =
113+ AppsPatch'
114+ { _apXgafv = Nothing
115+ , _apUploadProtocol = Nothing
116+ , _apUpdateMask = Nothing
117+ , _apPp = True
118+ , _apAccessToken = Nothing
119+ , _apUploadType = Nothing
120+ , _apPayload = pApPayload_
121+ , _apBearerToken = Nothing
122+ , _apAppsId = pApAppsId_
123+ , _apCallback = Nothing
124+ }
125+
126+-- | V1 error format.
127+apXgafv :: Lens' AppsPatch (Maybe Text)
128+apXgafv = lens _apXgafv (\ s a -> s{_apXgafv = a})
129+
130+-- | Upload protocol for media (e.g. \"raw\", \"multipart\").
131+apUploadProtocol :: Lens' AppsPatch (Maybe Text)
132+apUploadProtocol
133+ = lens _apUploadProtocol
134+ (\ s a -> s{_apUploadProtocol = a})
135+
136+-- | Standard field mask for the set of fields to be updated.
137+apUpdateMask :: Lens' AppsPatch (Maybe Text)
138+apUpdateMask
139+ = lens _apUpdateMask (\ s a -> s{_apUpdateMask = a})
140+
141+-- | Pretty-print response.
142+apPp :: Lens' AppsPatch Bool
143+apPp = lens _apPp (\ s a -> s{_apPp = a})
144+
145+-- | OAuth access token.
146+apAccessToken :: Lens' AppsPatch (Maybe Text)
147+apAccessToken
148+ = lens _apAccessToken
149+ (\ s a -> s{_apAccessToken = a})
150+
151+-- | Legacy upload protocol for media (e.g. \"media\", \"multipart\").
152+apUploadType :: Lens' AppsPatch (Maybe Text)
153+apUploadType
154+ = lens _apUploadType (\ s a -> s{_apUploadType = a})
155+
156+-- | Multipart request metadata.
157+apPayload :: Lens' AppsPatch Application
158+apPayload
159+ = lens _apPayload (\ s a -> s{_apPayload = a})
160+
161+-- | OAuth bearer token.
162+apBearerToken :: Lens' AppsPatch (Maybe Text)
163+apBearerToken
164+ = lens _apBearerToken
165+ (\ s a -> s{_apBearerToken = a})
166+
167+-- | Part of \`name\`. Name of the application to update. Example:
168+-- \`apps\/myapp\`.
169+apAppsId :: Lens' AppsPatch Text
170+apAppsId = lens _apAppsId (\ s a -> s{_apAppsId = a})
171+
172+-- | JSONP
173+apCallback :: Lens' AppsPatch (Maybe Text)
174+apCallback
175+ = lens _apCallback (\ s a -> s{_apCallback = a})
176+
177+instance GoogleRequest AppsPatch where
178+ type Rs AppsPatch = Operation
179+ type Scopes AppsPatch =
180+ '["https://www.googleapis.com/auth/cloud-platform"]
181+ requestClient AppsPatch'{..}
182+ = go _apAppsId _apXgafv _apUploadProtocol
183+ _apUpdateMask
184+ (Just _apPp)
185+ _apAccessToken
186+ _apUploadType
187+ _apBearerToken
188+ _apCallback
189+ (Just AltJSON)
190+ _apPayload
191+ appEngineService
192+ where go
193+ = buildClient (Proxy :: Proxy AppsPatchResource)
194+ mempty
gogol-appengine/gen/Network/Google/Resource/AppEngine/Apps/Repair.hsnew file+190
@@ -0,0 +1,190 @@
1+{-# LANGUAGE DataKinds #-}
2+{-# LANGUAGE DeriveDataTypeable #-}
3+{-# LANGUAGE DeriveGeneric #-}
4+{-# LANGUAGE FlexibleInstances #-}
5+{-# LANGUAGE NoImplicitPrelude #-}
6+{-# LANGUAGE OverloadedStrings #-}
7+{-# LANGUAGE RecordWildCards #-}
8+{-# LANGUAGE TypeFamilies #-}
9+{-# LANGUAGE TypeOperators #-}
10+
11+{-# OPTIONS_GHC -fno-warn-duplicate-exports #-}
12+{-# OPTIONS_GHC -fno-warn-unused-binds #-}
13+{-# OPTIONS_GHC -fno-warn-unused-imports #-}
14+
15+-- |
16+-- Module : Network.Google.Resource.AppEngine.Apps.Repair
17+-- Copyright : (c) 2015-2016 Brendan Hay
18+-- License : Mozilla Public License, v. 2.0.
19+-- Maintainer : Brendan Hay <brendan.g.hay@gmail.com>
20+-- Stability : auto-generated
21+-- Portability : non-portable (GHC extensions)
22+--
23+-- Recreates the required App Engine features for the application in your
24+-- project, for example a Cloud Storage bucket or App Engine service
25+-- account. Use this method if you receive an error message about a missing
26+-- feature, for example \"*Error retrieving the App Engine service
27+-- account*\".
28+--
29+-- /See:/ <https://cloud.google.com/appengine/docs/admin-api/ Google App Engine Admin API Reference> for @appengine.apps.repair@.
30+module Network.Google.Resource.AppEngine.Apps.Repair
31+ (
32+ -- * REST Resource
33+ AppsRepairResource
34+
35+ -- * Creating a Request
36+ , appsRepair
37+ , AppsRepair
38+
39+ -- * Request Lenses
40+ , arXgafv
41+ , arUploadProtocol
42+ , arPp
43+ , arAccessToken
44+ , arUploadType
45+ , arPayload
46+ , arBearerToken
47+ , arAppsId
48+ , arCallback
49+ ) where
50+
51+import Network.Google.AppEngine.Types
52+import Network.Google.Prelude
53+
54+-- | A resource alias for @appengine.apps.repair@ method which the
55+-- 'AppsRepair' request conforms to.
56+type AppsRepairResource =
57+ "v1" :>
58+ "apps" :>
59+ CaptureMode "appsId" "repair" Text :>
60+ QueryParam "$.xgafv" Text :>
61+ QueryParam "upload_protocol" Text :>
62+ QueryParam "pp" Bool :>
63+ QueryParam "access_token" Text :>
64+ QueryParam "uploadType" Text :>
65+ QueryParam "bearer_token" Text :>
66+ QueryParam "callback" Text :>
67+ QueryParam "alt" AltJSON :>
68+ ReqBody '[JSON] RepairApplicationRequest :>
69+ Post '[JSON] Operation
70+
71+-- | Recreates the required App Engine features for the application in your
72+-- project, for example a Cloud Storage bucket or App Engine service
73+-- account. Use this method if you receive an error message about a missing
74+-- feature, for example \"*Error retrieving the App Engine service
75+-- account*\".
76+--
77+-- /See:/ 'appsRepair' smart constructor.
78+data AppsRepair = AppsRepair'
79+ { _arXgafv :: !(Maybe Text)
80+ , _arUploadProtocol :: !(Maybe Text)
81+ , _arPp :: !Bool
82+ , _arAccessToken :: !(Maybe Text)
83+ , _arUploadType :: !(Maybe Text)
84+ , _arPayload :: !RepairApplicationRequest
85+ , _arBearerToken :: !(Maybe Text)
86+ , _arAppsId :: !Text
87+ , _arCallback :: !(Maybe Text)
88+ } deriving (Eq,Show,Data,Typeable,Generic)
89+
90+-- | Creates a value of 'AppsRepair' with the minimum fields required to make a request.
91+--
92+-- Use one of the following lenses to modify other fields as desired:
93+--
94+-- * 'arXgafv'
95+--
96+-- * 'arUploadProtocol'
97+--
98+-- * 'arPp'
99+--
100+-- * 'arAccessToken'
101+--
102+-- * 'arUploadType'
103+--
104+-- * 'arPayload'
105+--
106+-- * 'arBearerToken'
107+--
108+-- * 'arAppsId'
109+--
110+-- * 'arCallback'
111+appsRepair
112+ :: RepairApplicationRequest -- ^ 'arPayload'
113+ -> Text -- ^ 'arAppsId'
114+ -> AppsRepair
115+appsRepair pArPayload_ pArAppsId_ =
116+ AppsRepair'
117+ { _arXgafv = Nothing
118+ , _arUploadProtocol = Nothing
119+ , _arPp = True
120+ , _arAccessToken = Nothing
121+ , _arUploadType = Nothing
122+ , _arPayload = pArPayload_
123+ , _arBearerToken = Nothing
124+ , _arAppsId = pArAppsId_
125+ , _arCallback = Nothing
126+ }
127+
128+-- | V1 error format.
129+arXgafv :: Lens' AppsRepair (Maybe Text)
130+arXgafv = lens _arXgafv (\ s a -> s{_arXgafv = a})
131+
132+-- | Upload protocol for media (e.g. \"raw\", \"multipart\").
133+arUploadProtocol :: Lens' AppsRepair (Maybe Text)
134+arUploadProtocol
135+ = lens _arUploadProtocol
136+ (\ s a -> s{_arUploadProtocol = a})
137+
138+-- | Pretty-print response.
139+arPp :: Lens' AppsRepair Bool
140+arPp = lens _arPp (\ s a -> s{_arPp = a})
141+
142+-- | OAuth access token.
143+arAccessToken :: Lens' AppsRepair (Maybe Text)
144+arAccessToken
145+ = lens _arAccessToken
146+ (\ s a -> s{_arAccessToken = a})
147+
148+-- | Legacy upload protocol for media (e.g. \"media\", \"multipart\").
149+arUploadType :: Lens' AppsRepair (Maybe Text)
150+arUploadType
151+ = lens _arUploadType (\ s a -> s{_arUploadType = a})
152+
153+-- | Multipart request metadata.
154+arPayload :: Lens' AppsRepair RepairApplicationRequest
155+arPayload
156+ = lens _arPayload (\ s a -> s{_arPayload = a})
157+
158+-- | OAuth bearer token.
159+arBearerToken :: Lens' AppsRepair (Maybe Text)
160+arBearerToken
161+ = lens _arBearerToken
162+ (\ s a -> s{_arBearerToken = a})
163+
164+-- | Part of \`name\`. Name of the application to repair. Example:
165+-- \`apps\/myapp\`
166+arAppsId :: Lens' AppsRepair Text
167+arAppsId = lens _arAppsId (\ s a -> s{_arAppsId = a})
168+
169+-- | JSONP
170+arCallback :: Lens' AppsRepair (Maybe Text)
171+arCallback
172+ = lens _arCallback (\ s a -> s{_arCallback = a})
173+
174+instance GoogleRequest AppsRepair where
175+ type Rs AppsRepair = Operation
176+ type Scopes AppsRepair =
177+ '["https://www.googleapis.com/auth/cloud-platform"]
178+ requestClient AppsRepair'{..}
179+ = go _arAppsId _arXgafv _arUploadProtocol
180+ (Just _arPp)
181+ _arAccessToken
182+ _arUploadType
183+ _arBearerToken
184+ _arCallback
185+ (Just AltJSON)
186+ _arPayload
187+ appEngineService
188+ where go
189+ = buildClient (Proxy :: Proxy AppsRepairResource)
190+ mempty
gogol-appengine/gen/Network/Google/Resource/AppEngine/Apps/Services/Delete.hs+5−5
@@ -20,7 +20,7 @@
2020-- Stability : auto-generated
2121-- Portability : non-portable (GHC extensions)
2222--
23−-- Deletes a service and all enclosed versions.
23+-- Deletes the specified service and all enclosed versions.
2424--
2525-- /See:/ <https://cloud.google.com/appengine/docs/admin-api/ Google App Engine Admin API Reference> for @appengine.apps.services.delete@.
2626module Network.Google.Resource.AppEngine.Apps.Services.Delete
@@ -50,7 +50,7 @@ import Network.Google.Prelude
5050-- | A resource alias for @appengine.apps.services.delete@ method which the
5151-- 'AppsServicesDelete' request conforms to.
5252type AppsServicesDeleteResource =
53− "v1beta5" :>
53+ "v1" :>
5454 "apps" :>
5555 Capture "appsId" Text :>
5656 "services" :>
@@ -65,7 +65,7 @@ type AppsServicesDeleteResource =
6565 QueryParam "alt" AltJSON :>
6666 Delete '[JSON] Operation
6767
68−-- | Deletes a service and all enclosed versions.
68+-- | Deletes the specified service and all enclosed versions.
6969--
7070-- /See:/ 'appsServicesDelete' smart constructor.
7171data AppsServicesDelete = AppsServicesDelete'
@@ -150,8 +150,8 @@ asdBearerToken
150150 = lens _asdBearerToken
151151 (\ s a -> s{_asdBearerToken = a})
152152
153−-- | Part of \`name\`. Name of the resource requested. For example:
154−-- \"apps\/myapp\/services\/default\".
153+-- | Part of \`name\`. Name of the resource requested. Example:
154+-- \`apps\/myapp\/services\/default\`.
155155asdAppsId :: Lens' AppsServicesDelete Text
156156asdAppsId
157157 = lens _asdAppsId (\ s a -> s{_asdAppsId = a})
gogol-appengine/gen/Network/Google/Resource/AppEngine/Apps/Services/Get.hs+5−5
@@ -20,7 +20,7 @@
2020-- Stability : auto-generated
2121-- Portability : non-portable (GHC extensions)
2222--
23−-- Gets the current configuration of the service.
23+-- Gets the current configuration of the specified service.
2424--
2525-- /See:/ <https://cloud.google.com/appengine/docs/admin-api/ Google App Engine Admin API Reference> for @appengine.apps.services.get@.
2626module Network.Google.Resource.AppEngine.Apps.Services.Get
@@ -50,7 +50,7 @@ import Network.Google.Prelude
5050-- | A resource alias for @appengine.apps.services.get@ method which the
5151-- 'AppsServicesGet' request conforms to.
5252type AppsServicesGetResource =
53− "v1beta5" :>
53+ "v1" :>
5454 "apps" :>
5555 Capture "appsId" Text :>
5656 "services" :>
@@ -64,7 +64,7 @@ type AppsServicesGetResource =
6464 QueryParam "callback" Text :>
6565 QueryParam "alt" AltJSON :> Get '[JSON] Service
6666
67−-- | Gets the current configuration of the service.
67+-- | Gets the current configuration of the specified service.
6868--
6969-- /See:/ 'appsServicesGet' smart constructor.
7070data AppsServicesGet = AppsServicesGet'
@@ -149,8 +149,8 @@ asgBearerToken
149149 = lens _asgBearerToken
150150 (\ s a -> s{_asgBearerToken = a})
151151
152−-- | Part of \`name\`. Name of the resource requested. For example:
153−-- \"apps\/myapp\/services\/default\".
152+-- | Part of \`name\`. Name of the resource requested. Example:
153+-- \`apps\/myapp\/services\/default\`.
154154asgAppsId :: Lens' AppsServicesGet Text
155155asgAppsId
156156 = lens _asgAppsId (\ s a -> s{_asgAppsId = a})
gogol-appengine/gen/Network/Google/Resource/AppEngine/Apps/Services/List.hs+3−3
@@ -51,7 +51,7 @@ import Network.Google.Prelude
5151-- | A resource alias for @appengine.apps.services.list@ method which the
5252-- 'AppsServicesList' request conforms to.
5353type AppsServicesListResource =
54− "v1beta5" :>
54+ "v1" :>
5555 "apps" :>
5656 Capture "appsId" Text :>
5757 "services" :>
@@ -155,8 +155,8 @@ aslBearerToken
155155 = lens _aslBearerToken
156156 (\ s a -> s{_aslBearerToken = a})
157157
158−-- | Part of \`name\`. Name of the resource requested. For example:
159−-- \"apps\/myapp\".
158+-- | Part of \`parent\`. Name of the parent Application resource. Example:
159+-- \`apps\/myapp\`.
160160aslAppsId :: Lens' AppsServicesList Text
161161aslAppsId
162162 = lens _aslAppsId (\ s a -> s{_aslAppsId = a})
gogol-appengine/gen/Network/Google/Resource/AppEngine/Apps/Services/Patch.hs+33−20
@@ -35,12 +35,12 @@ module Network.Google.Resource.AppEngine.Apps.Services.Patch
3535 -- * Request Lenses
3636 , aspXgafv
3737 , aspUploadProtocol
38+ , aspUpdateMask
3839 , aspPp
3940 , aspAccessToken
4041 , aspUploadType
4142 , aspPayload
4243 , aspMigrateTraffic
43− , aspMask
4444 , aspBearerToken
4545 , aspAppsId
4646 , aspServicesId
@@ -53,18 +53,18 @@ import Network.Google.Prelude
5353-- | A resource alias for @appengine.apps.services.patch@ method which the
5454-- 'AppsServicesPatch' request conforms to.
5555type AppsServicesPatchResource =
56− "v1beta5" :>
56+ "v1" :>
5757 "apps" :>
5858 Capture "appsId" Text :>
5959 "services" :>
6060 Capture "servicesId" Text :>
6161 QueryParam "$.xgafv" Text :>
6262 QueryParam "upload_protocol" Text :>
63− QueryParam "pp" Bool :>
64− QueryParam "access_token" Text :>
65− QueryParam "uploadType" Text :>
66− QueryParam "migrateTraffic" Bool :>
67− QueryParam "mask" Text :>
63+ QueryParam "updateMask" Text :>
64+ QueryParam "pp" Bool :>
65+ QueryParam "access_token" Text :>
66+ QueryParam "uploadType" Text :>
67+ QueryParam "migrateTraffic" Bool :>
6868 QueryParam "bearer_token" Text :>
6969 QueryParam "callback" Text :>
7070 QueryParam "alt" AltJSON :>
@@ -77,12 +77,12 @@ type AppsServicesPatchResource =
7777data AppsServicesPatch = AppsServicesPatch'
7878 { _aspXgafv :: !(Maybe Text)
7979 , _aspUploadProtocol :: !(Maybe Text)
80+ , _aspUpdateMask :: !(Maybe Text)
8081 , _aspPp :: !Bool
8182 , _aspAccessToken :: !(Maybe Text)
8283 , _aspUploadType :: !(Maybe Text)
8384 , _aspPayload :: !Service
8485 , _aspMigrateTraffic :: !(Maybe Bool)
85− , _aspMask :: !(Maybe Text)
8686 , _aspBearerToken :: !(Maybe Text)
8787 , _aspAppsId :: !Text
8888 , _aspServicesId :: !Text
@@ -97,6 +97,8 @@ data AppsServicesPatch = AppsServicesPatch'
9797--
9898-- * 'aspUploadProtocol'
9999--
100+-- * 'aspUpdateMask'
101+--
100102-- * 'aspPp'
101103--
102104-- * 'aspAccessToken'
@@ -107,8 +109,6 @@ data AppsServicesPatch = AppsServicesPatch'
107109--
108110-- * 'aspMigrateTraffic'
109111--
110−-- * 'aspMask'
111−--
112112-- * 'aspBearerToken'
113113--
114114-- * 'aspAppsId'
@@ -125,12 +125,12 @@ appsServicesPatch pAspPayload_ pAspAppsId_ pAspServicesId_ =
125125 AppsServicesPatch'
126126 { _aspXgafv = Nothing
127127 , _aspUploadProtocol = Nothing
128+ , _aspUpdateMask = Nothing
128129 , _aspPp = True
129130 , _aspAccessToken = Nothing
130131 , _aspUploadType = Nothing
131132 , _aspPayload = pAspPayload_
132133 , _aspMigrateTraffic = Nothing
133− , _aspMask = Nothing
134134 , _aspBearerToken = Nothing
135135 , _aspAppsId = pAspAppsId_
136136 , _aspServicesId = pAspServicesId_
@@ -147,6 +147,12 @@ aspUploadProtocol
147147 = lens _aspUploadProtocol
148148 (\ s a -> s{_aspUploadProtocol = a})
149149
150+-- | Standard field mask for the set of fields to be updated.
151+aspUpdateMask :: Lens' AppsServicesPatch (Maybe Text)
152+aspUpdateMask
153+ = lens _aspUpdateMask
154+ (\ s a -> s{_aspUpdateMask = a})
155+
150156-- | Pretty-print response.
151157aspPp :: Lens' AppsServicesPatch Bool
152158aspPp = lens _aspPp (\ s a -> s{_aspPp = a})
@@ -168,25 +174,32 @@ aspPayload :: Lens' AppsServicesPatch Service
168174aspPayload
169175 = lens _aspPayload (\ s a -> s{_aspPayload = a})
170176
171−-- | Whether to use Traffic Migration to shift traffic gradually. Traffic can
172−-- only be migrated from a single version to another single version.
177+-- | Set to \`true\` to gradually shift traffic from one version to another
178+-- single version. By default, traffic is shifted immediately. For gradual
179+-- traffic migration, the target version must be located within instances
180+-- that are configured for both [warmup
181+-- requests](https:\/\/cloud.google.com\/appengine\/docs\/admin-api\/reference\/rest\/v1\/apps.services.versions#inboundservicetype)
182+-- and [automatic
183+-- scaling](https:\/\/cloud.google.com\/appengine\/docs\/admin-api\/reference\/rest\/v1\/apps.services.versions#automaticscaling).
184+-- You must specify the
185+-- [\`shardBy\`](https:\/\/cloud.google.com\/appengine\/docs\/admin-api\/reference\/rest\/v1\/apps.services#shardby)
186+-- field in the Service resource. Gradual traffic migration is not
187+-- supported in the App Engine flexible environment. For examples, see
188+-- [Migrating and Splitting
189+-- Traffic](https:\/\/cloud.google.com\/appengine\/docs\/admin-api\/migrating-splitting-traffic).
173190aspMigrateTraffic :: Lens' AppsServicesPatch (Maybe Bool)
174191aspMigrateTraffic
175192 = lens _aspMigrateTraffic
176193 (\ s a -> s{_aspMigrateTraffic = a})
177194
178−-- | Standard field mask for the set of fields to be updated.
179−aspMask :: Lens' AppsServicesPatch (Maybe Text)
180−aspMask = lens _aspMask (\ s a -> s{_aspMask = a})
181−
182195-- | OAuth bearer token.
183196aspBearerToken :: Lens' AppsServicesPatch (Maybe Text)
184197aspBearerToken
185198 = lens _aspBearerToken
186199 (\ s a -> s{_aspBearerToken = a})
187200
188−-- | Part of \`name\`. Name of the resource to update. For example:
189−-- \"apps\/myapp\/services\/default\".
201+-- | Part of \`name\`. Name of the resource to update. Example:
202+-- \`apps\/myapp\/services\/default\`.
190203aspAppsId :: Lens' AppsServicesPatch Text
191204aspAppsId
192205 = lens _aspAppsId (\ s a -> s{_aspAppsId = a})
@@ -209,11 +222,11 @@ instance GoogleRequest AppsServicesPatch where
209222 requestClient AppsServicesPatch'{..}
210223 = go _aspAppsId _aspServicesId _aspXgafv
211224 _aspUploadProtocol
225+ _aspUpdateMask
212226 (Just _aspPp)
213227 _aspAccessToken
214228 _aspUploadType
215229 _aspMigrateTraffic
216− _aspMask
217230 _aspBearerToken
218231 _aspCallback
219232 (Just AltJSON)
gogol-appengine/gen/Network/Google/Resource/AppEngine/Apps/Services/Versions/Create.hs+6−6
@@ -20,7 +20,7 @@
2020-- Stability : auto-generated
2121-- Portability : non-portable (GHC extensions)
2222--
23−-- Deploys new code and resource files to a version.
23+-- Deploys code and resource files to a new version.
2424--
2525-- /See:/ <https://cloud.google.com/appengine/docs/admin-api/ Google App Engine Admin API Reference> for @appengine.apps.services.versions.create@.
2626module Network.Google.Resource.AppEngine.Apps.Services.Versions.Create
@@ -51,7 +51,7 @@ import Network.Google.Prelude
5151-- | A resource alias for @appengine.apps.services.versions.create@ method which the
5252-- 'AppsServicesVersionsCreate' request conforms to.
5353type AppsServicesVersionsCreateResource =
54− "v1beta5" :>
54+ "v1" :>
5555 "apps" :>
5656 Capture "appsId" Text :>
5757 "services" :>
@@ -68,7 +68,7 @@ type AppsServicesVersionsCreateResource =
6868 ReqBody '[JSON] Version :>
6969 Post '[JSON] Operation
7070
71−-- | Deploys new code and resource files to a version.
71+-- | Deploys code and resource files to a new version.
7272--
7373-- /See:/ 'appsServicesVersionsCreate' smart constructor.
7474data AppsServicesVersionsCreate = AppsServicesVersionsCreate'
@@ -164,13 +164,13 @@ asvcBearerToken
164164 = lens _asvcBearerToken
165165 (\ s a -> s{_asvcBearerToken = a})
166166
167−-- | Part of \`name\`. Name of the resource to update. For example:
168−-- \"apps\/myapp\/services\/default\".
167+-- | Part of \`parent\`. Name of the parent resource to create this version
168+-- under. Example: \`apps\/myapp\/services\/default\`.
169169asvcAppsId :: Lens' AppsServicesVersionsCreate Text
170170asvcAppsId
171171 = lens _asvcAppsId (\ s a -> s{_asvcAppsId = a})
172172
173−-- | Part of \`name\`. See documentation of \`appsId\`.
173+-- | Part of \`parent\`. See documentation of \`appsId\`.
174174asvcServicesId :: Lens' AppsServicesVersionsCreate Text
175175asvcServicesId
176176 = lens _asvcServicesId
gogol-appengine/gen/Network/Google/Resource/AppEngine/Apps/Services/Versions/Delete.hs+5−5
@@ -20,7 +20,7 @@
2020-- Stability : auto-generated
2121-- Portability : non-portable (GHC extensions)
2222--
23−-- Deletes an existing version.
23+-- Deletes an existing Version resource.
2424--
2525-- /See:/ <https://cloud.google.com/appengine/docs/admin-api/ Google App Engine Admin API Reference> for @appengine.apps.services.versions.delete@.
2626module Network.Google.Resource.AppEngine.Apps.Services.Versions.Delete
@@ -51,7 +51,7 @@ import Network.Google.Prelude
5151-- | A resource alias for @appengine.apps.services.versions.delete@ method which the
5252-- 'AppsServicesVersionsDelete' request conforms to.
5353type AppsServicesVersionsDeleteResource =
54− "v1beta5" :>
54+ "v1" :>
5555 "apps" :>
5656 Capture "appsId" Text :>
5757 "services" :>
@@ -68,7 +68,7 @@ type AppsServicesVersionsDeleteResource =
6868 QueryParam "alt" AltJSON :>
6969 Delete '[JSON] Operation
7070
71−-- | Deletes an existing version.
71+-- | Deletes an existing Version resource.
7272--
7373-- /See:/ 'appsServicesVersionsDelete' smart constructor.
7474data AppsServicesVersionsDelete = AppsServicesVersionsDelete'
@@ -165,8 +165,8 @@ asvdBearerToken
165165 = lens _asvdBearerToken
166166 (\ s a -> s{_asvdBearerToken = a})
167167
168−-- | Part of \`name\`. Name of the resource requested. For example:
169−-- \"apps\/myapp\/services\/default\/versions\/v1\".
168+-- | Part of \`name\`. Name of the resource requested. Example:
169+-- \`apps\/myapp\/services\/default\/versions\/v1\`.
170170asvdAppsId :: Lens' AppsServicesVersionsDelete Text
171171asvdAppsId
172172 = lens _asvdAppsId (\ s a -> s{_asvdAppsId = a})
gogol-appengine/gen/Network/Google/Resource/AppEngine/Apps/Services/Versions/Get.hs+9−5
@@ -20,7 +20,9 @@
2020-- Stability : auto-generated
2121-- Portability : non-portable (GHC extensions)
2222--
23−-- Gets application deployment information.
23+-- Gets the specified Version resource. By default, only a \`BASIC_VIEW\`
24+-- will be returned. Specify the \`FULL_VIEW\` parameter to get the full
25+-- resource.
2426--
2527-- /See:/ <https://cloud.google.com/appengine/docs/admin-api/ Google App Engine Admin API Reference> for @appengine.apps.services.versions.get@.
2628module Network.Google.Resource.AppEngine.Apps.Services.Versions.Get
@@ -52,7 +54,7 @@ import Network.Google.Prelude
5254-- | A resource alias for @appengine.apps.services.versions.get@ method which the
5355-- 'AppsServicesVersionsGet' request conforms to.
5456type AppsServicesVersionsGetResource =
55− "v1beta5" :>
57+ "v1" :>
5658 "apps" :>
5759 Capture "appsId" Text :>
5860 "services" :>
@@ -70,7 +72,9 @@ type AppsServicesVersionsGetResource =
7072 QueryParam "alt" AltJSON :>
7173 Get '[JSON] Version
7274
73−-- | Gets application deployment information.
75+-- | Gets the specified Version resource. By default, only a \`BASIC_VIEW\`
76+-- will be returned. Specify the \`FULL_VIEW\` parameter to get the full
77+-- resource.
7478--
7579-- /See:/ 'appsServicesVersionsGet' smart constructor.
7680data AppsServicesVersionsGet = AppsServicesVersionsGet'
@@ -171,8 +175,8 @@ asvgBearerToken
171175 = lens _asvgBearerToken
172176 (\ s a -> s{_asvgBearerToken = a})
173177
174−-- | Part of \`name\`. Name of the resource requested. For example:
175−-- \"apps\/myapp\/services\/default\/versions\/v1\".
178+-- | Part of \`name\`. Name of the resource requested. Example:
179+-- \`apps\/myapp\/services\/default\/versions\/v1\`.
176180asvgAppsId :: Lens' AppsServicesVersionsGet Text
177181asvgAppsId
178182 = lens _asvgAppsId (\ s a -> s{_asvgAppsId = a})
gogol-appengine/gen/Network/Google/Resource/AppEngine/Apps/Services/Versions/Instances/Debug.hsnew file+247
@@ -0,0 +1,247 @@
1+{-# LANGUAGE DataKinds #-}
2+{-# LANGUAGE DeriveDataTypeable #-}
3+{-# LANGUAGE DeriveGeneric #-}
4+{-# LANGUAGE FlexibleInstances #-}
5+{-# LANGUAGE NoImplicitPrelude #-}
6+{-# LANGUAGE OverloadedStrings #-}
7+{-# LANGUAGE RecordWildCards #-}
8+{-# LANGUAGE TypeFamilies #-}
9+{-# LANGUAGE TypeOperators #-}
10+
11+{-# OPTIONS_GHC -fno-warn-duplicate-exports #-}
12+{-# OPTIONS_GHC -fno-warn-unused-binds #-}
13+{-# OPTIONS_GHC -fno-warn-unused-imports #-}
14+
15+-- |
16+-- Module : Network.Google.Resource.AppEngine.Apps.Services.Versions.Instances.Debug
17+-- Copyright : (c) 2015-2016 Brendan Hay
18+-- License : Mozilla Public License, v. 2.0.
19+-- Maintainer : Brendan Hay <brendan.g.hay@gmail.com>
20+-- Stability : auto-generated
21+-- Portability : non-portable (GHC extensions)
22+--
23+-- Enables debugging on a VM instance. This allows you to use the SSH
24+-- command to connect to the virtual machine where the instance lives.
25+-- While in \"debug mode\", the instance continues to serve live traffic.
26+-- You should delete the instance when you are done debugging and then
27+-- allow the system to take over and determine if another instance should
28+-- be started. Only applicable for instances in App Engine flexible
29+-- environment.
30+--
31+-- /See:/ <https://cloud.google.com/appengine/docs/admin-api/ Google App Engine Admin API Reference> for @appengine.apps.services.versions.instances.debug@.
32+module Network.Google.Resource.AppEngine.Apps.Services.Versions.Instances.Debug
33+ (
34+ -- * REST Resource
35+ AppsServicesVersionsInstancesDebugResource
36+
37+ -- * Creating a Request
38+ , appsServicesVersionsInstancesDebug
39+ , AppsServicesVersionsInstancesDebug
40+
41+ -- * Request Lenses
42+ , asvidXgafv
43+ , asvidInstancesId
44+ , asvidUploadProtocol
45+ , asvidPp
46+ , asvidAccessToken
47+ , asvidUploadType
48+ , asvidPayload
49+ , asvidVersionsId
50+ , asvidBearerToken
51+ , asvidAppsId
52+ , asvidServicesId
53+ , asvidCallback
54+ ) where
55+
56+import Network.Google.AppEngine.Types
57+import Network.Google.Prelude
58+
59+-- | A resource alias for @appengine.apps.services.versions.instances.debug@ method which the
60+-- 'AppsServicesVersionsInstancesDebug' request conforms to.
61+type AppsServicesVersionsInstancesDebugResource =
62+ "v1" :>
63+ "apps" :>
64+ Capture "appsId" Text :>
65+ "services" :>
66+ Capture "servicesId" Text :>
67+ "versions" :>
68+ Capture "versionsId" Text :>
69+ "instances" :>
70+ CaptureMode "instancesId" "debug" Text :>
71+ QueryParam "$.xgafv" Text :>
72+ QueryParam "upload_protocol" Text :>
73+ QueryParam "pp" Bool :>
74+ QueryParam "access_token" Text :>
75+ QueryParam "uploadType" Text :>
76+ QueryParam "bearer_token" Text :>
77+ QueryParam "callback" Text :>
78+ QueryParam "alt" AltJSON :>
79+ ReqBody '[JSON] DebugInstanceRequest :>
80+ Post '[JSON] Operation
81+
82+-- | Enables debugging on a VM instance. This allows you to use the SSH
83+-- command to connect to the virtual machine where the instance lives.
84+-- While in \"debug mode\", the instance continues to serve live traffic.
85+-- You should delete the instance when you are done debugging and then
86+-- allow the system to take over and determine if another instance should
87+-- be started. Only applicable for instances in App Engine flexible
88+-- environment.
89+--
90+-- /See:/ 'appsServicesVersionsInstancesDebug' smart constructor.
91+data AppsServicesVersionsInstancesDebug = AppsServicesVersionsInstancesDebug'
92+ { _asvidXgafv :: !(Maybe Text)
93+ , _asvidInstancesId :: !Text
94+ , _asvidUploadProtocol :: !(Maybe Text)
95+ , _asvidPp :: !Bool
96+ , _asvidAccessToken :: !(Maybe Text)
97+ , _asvidUploadType :: !(Maybe Text)
98+ , _asvidPayload :: !DebugInstanceRequest
99+ , _asvidVersionsId :: !Text
100+ , _asvidBearerToken :: !(Maybe Text)
101+ , _asvidAppsId :: !Text
102+ , _asvidServicesId :: !Text
103+ , _asvidCallback :: !(Maybe Text)
104+ } deriving (Eq,Show,Data,Typeable,Generic)
105+
106+-- | Creates a value of 'AppsServicesVersionsInstancesDebug' with the minimum fields required to make a request.
107+--
108+-- Use one of the following lenses to modify other fields as desired:
109+--
110+-- * 'asvidXgafv'
111+--
112+-- * 'asvidInstancesId'
113+--
114+-- * 'asvidUploadProtocol'
115+--
116+-- * 'asvidPp'
117+--
118+-- * 'asvidAccessToken'
119+--
120+-- * 'asvidUploadType'
121+--
122+-- * 'asvidPayload'
123+--
124+-- * 'asvidVersionsId'
125+--
126+-- * 'asvidBearerToken'
127+--
128+-- * 'asvidAppsId'
129+--
130+-- * 'asvidServicesId'
131+--
132+-- * 'asvidCallback'
133+appsServicesVersionsInstancesDebug
134+ :: Text -- ^ 'asvidInstancesId'
135+ -> DebugInstanceRequest -- ^ 'asvidPayload'
136+ -> Text -- ^ 'asvidVersionsId'
137+ -> Text -- ^ 'asvidAppsId'
138+ -> Text -- ^ 'asvidServicesId'
139+ -> AppsServicesVersionsInstancesDebug
140+appsServicesVersionsInstancesDebug pAsvidInstancesId_ pAsvidPayload_ pAsvidVersionsId_ pAsvidAppsId_ pAsvidServicesId_ =
141+ AppsServicesVersionsInstancesDebug'
142+ { _asvidXgafv = Nothing
143+ , _asvidInstancesId = pAsvidInstancesId_
144+ , _asvidUploadProtocol = Nothing
145+ , _asvidPp = True
146+ , _asvidAccessToken = Nothing
147+ , _asvidUploadType = Nothing
148+ , _asvidPayload = pAsvidPayload_
149+ , _asvidVersionsId = pAsvidVersionsId_
150+ , _asvidBearerToken = Nothing
151+ , _asvidAppsId = pAsvidAppsId_
152+ , _asvidServicesId = pAsvidServicesId_
153+ , _asvidCallback = Nothing
154+ }
155+
156+-- | V1 error format.
157+asvidXgafv :: Lens' AppsServicesVersionsInstancesDebug (Maybe Text)
158+asvidXgafv
159+ = lens _asvidXgafv (\ s a -> s{_asvidXgafv = a})
160+
161+-- | Part of \`name\`. See documentation of \`appsId\`.
162+asvidInstancesId :: Lens' AppsServicesVersionsInstancesDebug Text
163+asvidInstancesId
164+ = lens _asvidInstancesId
165+ (\ s a -> s{_asvidInstancesId = a})
166+
167+-- | Upload protocol for media (e.g. \"raw\", \"multipart\").
168+asvidUploadProtocol :: Lens' AppsServicesVersionsInstancesDebug (Maybe Text)
169+asvidUploadProtocol
170+ = lens _asvidUploadProtocol
171+ (\ s a -> s{_asvidUploadProtocol = a})
172+
173+-- | Pretty-print response.
174+asvidPp :: Lens' AppsServicesVersionsInstancesDebug Bool
175+asvidPp = lens _asvidPp (\ s a -> s{_asvidPp = a})
176+
177+-- | OAuth access token.
178+asvidAccessToken :: Lens' AppsServicesVersionsInstancesDebug (Maybe Text)
179+asvidAccessToken
180+ = lens _asvidAccessToken
181+ (\ s a -> s{_asvidAccessToken = a})
182+
183+-- | Legacy upload protocol for media (e.g. \"media\", \"multipart\").
184+asvidUploadType :: Lens' AppsServicesVersionsInstancesDebug (Maybe Text)
185+asvidUploadType
186+ = lens _asvidUploadType
187+ (\ s a -> s{_asvidUploadType = a})
188+
189+-- | Multipart request metadata.
190+asvidPayload :: Lens' AppsServicesVersionsInstancesDebug DebugInstanceRequest
191+asvidPayload
192+ = lens _asvidPayload (\ s a -> s{_asvidPayload = a})
193+
194+-- | Part of \`name\`. See documentation of \`appsId\`.
195+asvidVersionsId :: Lens' AppsServicesVersionsInstancesDebug Text
196+asvidVersionsId
197+ = lens _asvidVersionsId
198+ (\ s a -> s{_asvidVersionsId = a})
199+
200+-- | OAuth bearer token.
201+asvidBearerToken :: Lens' AppsServicesVersionsInstancesDebug (Maybe Text)
202+asvidBearerToken
203+ = lens _asvidBearerToken
204+ (\ s a -> s{_asvidBearerToken = a})
205+
206+-- | Part of \`name\`. Name of the resource requested. Example:
207+-- \`apps\/myapp\/services\/default\/versions\/v1\/instances\/instance-1\`.
208+asvidAppsId :: Lens' AppsServicesVersionsInstancesDebug Text
209+asvidAppsId
210+ = lens _asvidAppsId (\ s a -> s{_asvidAppsId = a})
211+
212+-- | Part of \`name\`. See documentation of \`appsId\`.
213+asvidServicesId :: Lens' AppsServicesVersionsInstancesDebug Text
214+asvidServicesId
215+ = lens _asvidServicesId
216+ (\ s a -> s{_asvidServicesId = a})
217+
218+-- | JSONP
219+asvidCallback :: Lens' AppsServicesVersionsInstancesDebug (Maybe Text)
220+asvidCallback
221+ = lens _asvidCallback
222+ (\ s a -> s{_asvidCallback = a})
223+
224+instance GoogleRequest
225+ AppsServicesVersionsInstancesDebug where
226+ type Rs AppsServicesVersionsInstancesDebug =
227+ Operation
228+ type Scopes AppsServicesVersionsInstancesDebug =
229+ '["https://www.googleapis.com/auth/cloud-platform"]
230+ requestClient AppsServicesVersionsInstancesDebug'{..}
231+ = go _asvidAppsId _asvidServicesId _asvidVersionsId
232+ _asvidInstancesId
233+ _asvidXgafv
234+ _asvidUploadProtocol
235+ (Just _asvidPp)
236+ _asvidAccessToken
237+ _asvidUploadType
238+ _asvidBearerToken
239+ _asvidCallback
240+ (Just AltJSON)
241+ _asvidPayload
242+ appEngineService
243+ where go
244+ = buildClient
245+ (Proxy ::
246+ Proxy AppsServicesVersionsInstancesDebugResource)
247+ mempty
gogol-appengine/gen/Network/Google/Resource/AppEngine/Apps/Services/Versions/Instances/Delete.hsnew file+213
@@ -0,0 +1,213 @@
1+{-# LANGUAGE DataKinds #-}
2+{-# LANGUAGE DeriveDataTypeable #-}
3+{-# LANGUAGE DeriveGeneric #-}
4+{-# LANGUAGE FlexibleInstances #-}
5+{-# LANGUAGE NoImplicitPrelude #-}
6+{-# LANGUAGE OverloadedStrings #-}
7+{-# LANGUAGE RecordWildCards #-}
8+{-# LANGUAGE TypeFamilies #-}
9+{-# LANGUAGE TypeOperators #-}
10+
11+{-# OPTIONS_GHC -fno-warn-duplicate-exports #-}
12+{-# OPTIONS_GHC -fno-warn-unused-binds #-}
13+{-# OPTIONS_GHC -fno-warn-unused-imports #-}
14+
15+-- |
16+-- Module : Network.Google.Resource.AppEngine.Apps.Services.Versions.Instances.Delete
17+-- Copyright : (c) 2015-2016 Brendan Hay
18+-- License : Mozilla Public License, v. 2.0.
19+-- Maintainer : Brendan Hay <brendan.g.hay@gmail.com>
20+-- Stability : auto-generated
21+-- Portability : non-portable (GHC extensions)
22+--
23+-- Stops a running instance.
24+--
25+-- /See:/ <https://cloud.google.com/appengine/docs/admin-api/ Google App Engine Admin API Reference> for @appengine.apps.services.versions.instances.delete@.
26+module Network.Google.Resource.AppEngine.Apps.Services.Versions.Instances.Delete
27+ (
28+ -- * REST Resource
29+ AppsServicesVersionsInstancesDeleteResource
30+
31+ -- * Creating a Request
32+ , appsServicesVersionsInstancesDelete
33+ , AppsServicesVersionsInstancesDelete
34+
35+ -- * Request Lenses
36+ , aXgafv
37+ , aInstancesId
38+ , aUploadProtocol
39+ , aPp
40+ , aAccessToken
41+ , aUploadType
42+ , aVersionsId
43+ , aBearerToken
44+ , aAppsId
45+ , aServicesId
46+ , aCallback
47+ ) where
48+
49+import Network.Google.AppEngine.Types
50+import Network.Google.Prelude
51+
52+-- | A resource alias for @appengine.apps.services.versions.instances.delete@ method which the
53+-- 'AppsServicesVersionsInstancesDelete' request conforms to.
54+type AppsServicesVersionsInstancesDeleteResource =
55+ "v1" :>
56+ "apps" :>
57+ Capture "appsId" Text :>
58+ "services" :>
59+ Capture "servicesId" Text :>
60+ "versions" :>
61+ Capture "versionsId" Text :>
62+ "instances" :>
63+ Capture "instancesId" Text :>
64+ QueryParam "$.xgafv" Text :>
65+ QueryParam "upload_protocol" Text :>
66+ QueryParam "pp" Bool :>
67+ QueryParam "access_token" Text :>
68+ QueryParam "uploadType" Text :>
69+ QueryParam "bearer_token" Text :>
70+ QueryParam "callback" Text :>
71+ QueryParam "alt" AltJSON :>
72+ Delete '[JSON] Operation
73+
74+-- | Stops a running instance.
75+--
76+-- /See:/ 'appsServicesVersionsInstancesDelete' smart constructor.
77+data AppsServicesVersionsInstancesDelete = AppsServicesVersionsInstancesDelete'
78+ { _aXgafv :: !(Maybe Text)
79+ , _aInstancesId :: !Text
80+ , _aUploadProtocol :: !(Maybe Text)
81+ , _aPp :: !Bool
82+ , _aAccessToken :: !(Maybe Text)
83+ , _aUploadType :: !(Maybe Text)
84+ , _aVersionsId :: !Text
85+ , _aBearerToken :: !(Maybe Text)
86+ , _aAppsId :: !Text
87+ , _aServicesId :: !Text
88+ , _aCallback :: !(Maybe Text)
89+ } deriving (Eq,Show,Data,Typeable,Generic)
90+
91+-- | Creates a value of 'AppsServicesVersionsInstancesDelete' with the minimum fields required to make a request.
92+--
93+-- Use one of the following lenses to modify other fields as desired:
94+--
95+-- * 'aXgafv'
96+--
97+-- * 'aInstancesId'
98+--
99+-- * 'aUploadProtocol'
100+--
101+-- * 'aPp'
102+--
103+-- * 'aAccessToken'
104+--
105+-- * 'aUploadType'
106+--
107+-- * 'aVersionsId'
108+--
109+-- * 'aBearerToken'
110+--
111+-- * 'aAppsId'
112+--
113+-- * 'aServicesId'
114+--
115+-- * 'aCallback'
116+appsServicesVersionsInstancesDelete
117+ :: Text -- ^ 'aInstancesId'
118+ -> Text -- ^ 'aVersionsId'
119+ -> Text -- ^ 'aAppsId'
120+ -> Text -- ^ 'aServicesId'
121+ -> AppsServicesVersionsInstancesDelete
122+appsServicesVersionsInstancesDelete pAInstancesId_ pAVersionsId_ pAAppsId_ pAServicesId_ =
123+ AppsServicesVersionsInstancesDelete'
124+ { _aXgafv = Nothing
125+ , _aInstancesId = pAInstancesId_
126+ , _aUploadProtocol = Nothing
127+ , _aPp = True
128+ , _aAccessToken = Nothing
129+ , _aUploadType = Nothing
130+ , _aVersionsId = pAVersionsId_
131+ , _aBearerToken = Nothing
132+ , _aAppsId = pAAppsId_
133+ , _aServicesId = pAServicesId_
134+ , _aCallback = Nothing
135+ }
136+
137+-- | V1 error format.
138+aXgafv :: Lens' AppsServicesVersionsInstancesDelete (Maybe Text)
139+aXgafv = lens _aXgafv (\ s a -> s{_aXgafv = a})
140+
141+-- | Part of \`name\`. See documentation of \`appsId\`.
142+aInstancesId :: Lens' AppsServicesVersionsInstancesDelete Text
143+aInstancesId
144+ = lens _aInstancesId (\ s a -> s{_aInstancesId = a})
145+
146+-- | Upload protocol for media (e.g. \"raw\", \"multipart\").
147+aUploadProtocol :: Lens' AppsServicesVersionsInstancesDelete (Maybe Text)
148+aUploadProtocol
149+ = lens _aUploadProtocol
150+ (\ s a -> s{_aUploadProtocol = a})
151+
152+-- | Pretty-print response.
153+aPp :: Lens' AppsServicesVersionsInstancesDelete Bool
154+aPp = lens _aPp (\ s a -> s{_aPp = a})
155+
156+-- | OAuth access token.
157+aAccessToken :: Lens' AppsServicesVersionsInstancesDelete (Maybe Text)
158+aAccessToken
159+ = lens _aAccessToken (\ s a -> s{_aAccessToken = a})
160+
161+-- | Legacy upload protocol for media (e.g. \"media\", \"multipart\").
162+aUploadType :: Lens' AppsServicesVersionsInstancesDelete (Maybe Text)
163+aUploadType
164+ = lens _aUploadType (\ s a -> s{_aUploadType = a})
165+
166+-- | Part of \`name\`. See documentation of \`appsId\`.
167+aVersionsId :: Lens' AppsServicesVersionsInstancesDelete Text
168+aVersionsId
169+ = lens _aVersionsId (\ s a -> s{_aVersionsId = a})
170+
171+-- | OAuth bearer token.
172+aBearerToken :: Lens' AppsServicesVersionsInstancesDelete (Maybe Text)
173+aBearerToken
174+ = lens _aBearerToken (\ s a -> s{_aBearerToken = a})
175+
176+-- | Part of \`name\`. Name of the resource requested. Example:
177+-- \`apps\/myapp\/services\/default\/versions\/v1\/instances\/instance-1\`.
178+aAppsId :: Lens' AppsServicesVersionsInstancesDelete Text
179+aAppsId = lens _aAppsId (\ s a -> s{_aAppsId = a})
180+
181+-- | Part of \`name\`. See documentation of \`appsId\`.
182+aServicesId :: Lens' AppsServicesVersionsInstancesDelete Text
183+aServicesId
184+ = lens _aServicesId (\ s a -> s{_aServicesId = a})
185+
186+-- | JSONP
187+aCallback :: Lens' AppsServicesVersionsInstancesDelete (Maybe Text)
188+aCallback
189+ = lens _aCallback (\ s a -> s{_aCallback = a})
190+
191+instance GoogleRequest
192+ AppsServicesVersionsInstancesDelete where
193+ type Rs AppsServicesVersionsInstancesDelete =
194+ Operation
195+ type Scopes AppsServicesVersionsInstancesDelete =
196+ '["https://www.googleapis.com/auth/cloud-platform"]
197+ requestClient
198+ AppsServicesVersionsInstancesDelete'{..}
199+ = go _aAppsId _aServicesId _aVersionsId _aInstancesId
200+ _aXgafv
201+ _aUploadProtocol
202+ (Just _aPp)
203+ _aAccessToken
204+ _aUploadType
205+ _aBearerToken
206+ _aCallback
207+ (Just AltJSON)
208+ appEngineService
209+ where go
210+ = buildClient
211+ (Proxy ::
212+ Proxy AppsServicesVersionsInstancesDeleteResource)
213+ mempty
gogol-appengine/gen/Network/Google/Resource/AppEngine/Apps/Services/Versions/Instances/Get.hsnew file+221
@@ -0,0 +1,221 @@
1+{-# LANGUAGE DataKinds #-}
2+{-# LANGUAGE DeriveDataTypeable #-}
3+{-# LANGUAGE DeriveGeneric #-}
4+{-# LANGUAGE FlexibleInstances #-}
5+{-# LANGUAGE NoImplicitPrelude #-}
6+{-# LANGUAGE OverloadedStrings #-}
7+{-# LANGUAGE RecordWildCards #-}
8+{-# LANGUAGE TypeFamilies #-}
9+{-# LANGUAGE TypeOperators #-}
10+
11+{-# OPTIONS_GHC -fno-warn-duplicate-exports #-}
12+{-# OPTIONS_GHC -fno-warn-unused-binds #-}
13+{-# OPTIONS_GHC -fno-warn-unused-imports #-}
14+
15+-- |
16+-- Module : Network.Google.Resource.AppEngine.Apps.Services.Versions.Instances.Get
17+-- Copyright : (c) 2015-2016 Brendan Hay
18+-- License : Mozilla Public License, v. 2.0.
19+-- Maintainer : Brendan Hay <brendan.g.hay@gmail.com>
20+-- Stability : auto-generated
21+-- Portability : non-portable (GHC extensions)
22+--
23+-- Gets instance information.
24+--
25+-- /See:/ <https://cloud.google.com/appengine/docs/admin-api/ Google App Engine Admin API Reference> for @appengine.apps.services.versions.instances.get@.
26+module Network.Google.Resource.AppEngine.Apps.Services.Versions.Instances.Get
27+ (
28+ -- * REST Resource
29+ AppsServicesVersionsInstancesGetResource
30+
31+ -- * Creating a Request
32+ , appsServicesVersionsInstancesGet
33+ , AppsServicesVersionsInstancesGet
34+
35+ -- * Request Lenses
36+ , asvigXgafv
37+ , asvigInstancesId
38+ , asvigUploadProtocol
39+ , asvigPp
40+ , asvigAccessToken
41+ , asvigUploadType
42+ , asvigVersionsId
43+ , asvigBearerToken
44+ , asvigAppsId
45+ , asvigServicesId
46+ , asvigCallback
47+ ) where
48+
49+import Network.Google.AppEngine.Types
50+import Network.Google.Prelude
51+
52+-- | A resource alias for @appengine.apps.services.versions.instances.get@ method which the
53+-- 'AppsServicesVersionsInstancesGet' request conforms to.
54+type AppsServicesVersionsInstancesGetResource =
55+ "v1" :>
56+ "apps" :>
57+ Capture "appsId" Text :>
58+ "services" :>
59+ Capture "servicesId" Text :>
60+ "versions" :>
61+ Capture "versionsId" Text :>
62+ "instances" :>
63+ Capture "instancesId" Text :>
64+ QueryParam "$.xgafv" Text :>
65+ QueryParam "upload_protocol" Text :>
66+ QueryParam "pp" Bool :>
67+ QueryParam "access_token" Text :>
68+ QueryParam "uploadType" Text :>
69+ QueryParam "bearer_token" Text :>
70+ QueryParam "callback" Text :>
71+ QueryParam "alt" AltJSON :>
72+ Get '[JSON] Instance
73+
74+-- | Gets instance information.
75+--
76+-- /See:/ 'appsServicesVersionsInstancesGet' smart constructor.
77+data AppsServicesVersionsInstancesGet = AppsServicesVersionsInstancesGet'
78+ { _asvigXgafv :: !(Maybe Text)
79+ , _asvigInstancesId :: !Text
80+ , _asvigUploadProtocol :: !(Maybe Text)
81+ , _asvigPp :: !Bool
82+ , _asvigAccessToken :: !(Maybe Text)
83+ , _asvigUploadType :: !(Maybe Text)
84+ , _asvigVersionsId :: !Text
85+ , _asvigBearerToken :: !(Maybe Text)
86+ , _asvigAppsId :: !Text
87+ , _asvigServicesId :: !Text
88+ , _asvigCallback :: !(Maybe Text)
89+ } deriving (Eq,Show,Data,Typeable,Generic)
90+
91+-- | Creates a value of 'AppsServicesVersionsInstancesGet' with the minimum fields required to make a request.
92+--
93+-- Use one of the following lenses to modify other fields as desired:
94+--
95+-- * 'asvigXgafv'
96+--
97+-- * 'asvigInstancesId'
98+--
99+-- * 'asvigUploadProtocol'
100+--
101+-- * 'asvigPp'
102+--
103+-- * 'asvigAccessToken'
104+--
105+-- * 'asvigUploadType'
106+--
107+-- * 'asvigVersionsId'
108+--
109+-- * 'asvigBearerToken'
110+--
111+-- * 'asvigAppsId'
112+--
113+-- * 'asvigServicesId'
114+--
115+-- * 'asvigCallback'
116+appsServicesVersionsInstancesGet
117+ :: Text -- ^ 'asvigInstancesId'
118+ -> Text -- ^ 'asvigVersionsId'
119+ -> Text -- ^ 'asvigAppsId'
120+ -> Text -- ^ 'asvigServicesId'
121+ -> AppsServicesVersionsInstancesGet
122+appsServicesVersionsInstancesGet pAsvigInstancesId_ pAsvigVersionsId_ pAsvigAppsId_ pAsvigServicesId_ =
123+ AppsServicesVersionsInstancesGet'
124+ { _asvigXgafv = Nothing
125+ , _asvigInstancesId = pAsvigInstancesId_
126+ , _asvigUploadProtocol = Nothing
127+ , _asvigPp = True
128+ , _asvigAccessToken = Nothing
129+ , _asvigUploadType = Nothing
130+ , _asvigVersionsId = pAsvigVersionsId_
131+ , _asvigBearerToken = Nothing
132+ , _asvigAppsId = pAsvigAppsId_
133+ , _asvigServicesId = pAsvigServicesId_
134+ , _asvigCallback = Nothing
135+ }
136+
137+-- | V1 error format.
138+asvigXgafv :: Lens' AppsServicesVersionsInstancesGet (Maybe Text)
139+asvigXgafv
140+ = lens _asvigXgafv (\ s a -> s{_asvigXgafv = a})
141+
142+-- | Part of \`name\`. See documentation of \`appsId\`.
143+asvigInstancesId :: Lens' AppsServicesVersionsInstancesGet Text
144+asvigInstancesId
145+ = lens _asvigInstancesId
146+ (\ s a -> s{_asvigInstancesId = a})
147+
148+-- | Upload protocol for media (e.g. \"raw\", \"multipart\").
149+asvigUploadProtocol :: Lens' AppsServicesVersionsInstancesGet (Maybe Text)
150+asvigUploadProtocol
151+ = lens _asvigUploadProtocol
152+ (\ s a -> s{_asvigUploadProtocol = a})
153+
154+-- | Pretty-print response.
155+asvigPp :: Lens' AppsServicesVersionsInstancesGet Bool
156+asvigPp = lens _asvigPp (\ s a -> s{_asvigPp = a})
157+
158+-- | OAuth access token.
159+asvigAccessToken :: Lens' AppsServicesVersionsInstancesGet (Maybe Text)
160+asvigAccessToken
161+ = lens _asvigAccessToken
162+ (\ s a -> s{_asvigAccessToken = a})
163+
164+-- | Legacy upload protocol for media (e.g. \"media\", \"multipart\").
165+asvigUploadType :: Lens' AppsServicesVersionsInstancesGet (Maybe Text)
166+asvigUploadType
167+ = lens _asvigUploadType
168+ (\ s a -> s{_asvigUploadType = a})
169+
170+-- | Part of \`name\`. See documentation of \`appsId\`.
171+asvigVersionsId :: Lens' AppsServicesVersionsInstancesGet Text
172+asvigVersionsId
173+ = lens _asvigVersionsId
174+ (\ s a -> s{_asvigVersionsId = a})
175+
176+-- | OAuth bearer token.
177+asvigBearerToken :: Lens' AppsServicesVersionsInstancesGet (Maybe Text)
178+asvigBearerToken
179+ = lens _asvigBearerToken
180+ (\ s a -> s{_asvigBearerToken = a})
181+
182+-- | Part of \`name\`. Name of the resource requested. Example:
183+-- \`apps\/myapp\/services\/default\/versions\/v1\/instances\/instance-1\`.
184+asvigAppsId :: Lens' AppsServicesVersionsInstancesGet Text
185+asvigAppsId
186+ = lens _asvigAppsId (\ s a -> s{_asvigAppsId = a})
187+
188+-- | Part of \`name\`. See documentation of \`appsId\`.
189+asvigServicesId :: Lens' AppsServicesVersionsInstancesGet Text
190+asvigServicesId
191+ = lens _asvigServicesId
192+ (\ s a -> s{_asvigServicesId = a})
193+
194+-- | JSONP
195+asvigCallback :: Lens' AppsServicesVersionsInstancesGet (Maybe Text)
196+asvigCallback
197+ = lens _asvigCallback
198+ (\ s a -> s{_asvigCallback = a})
199+
200+instance GoogleRequest
201+ AppsServicesVersionsInstancesGet where
202+ type Rs AppsServicesVersionsInstancesGet = Instance
203+ type Scopes AppsServicesVersionsInstancesGet =
204+ '["https://www.googleapis.com/auth/cloud-platform"]
205+ requestClient AppsServicesVersionsInstancesGet'{..}
206+ = go _asvigAppsId _asvigServicesId _asvigVersionsId
207+ _asvigInstancesId
208+ _asvigXgafv
209+ _asvigUploadProtocol
210+ (Just _asvigPp)
211+ _asvigAccessToken
212+ _asvigUploadType
213+ _asvigBearerToken
214+ _asvigCallback
215+ (Just AltJSON)
216+ appEngineService
217+ where go
218+ = buildClient
219+ (Proxy ::
220+ Proxy AppsServicesVersionsInstancesGetResource)
221+ mempty
gogol-appengine/gen/Network/Google/Resource/AppEngine/Apps/Services/Versions/Instances/List.hs+5−5
@@ -53,7 +53,7 @@ import Network.Google.Prelude
5353-- | A resource alias for @appengine.apps.services.versions.instances.list@ method which the
5454-- 'AppsServicesVersionsInstancesList' request conforms to.
5555type AppsServicesVersionsInstancesListResource =
56− "v1beta5" :>
56+ "v1" :>
5757 "apps" :>
5858 Capture "appsId" Text :>
5959 "services" :>
@@ -166,7 +166,7 @@ asvilUploadType
166166 = lens _asvilUploadType
167167 (\ s a -> s{_asvilUploadType = a})
168168
169−-- | Part of \`name\`. See documentation of \`appsId\`.
169+-- | Part of \`parent\`. See documentation of \`appsId\`.
170170asvilVersionsId :: Lens' AppsServicesVersionsInstancesList Text
171171asvilVersionsId
172172 = lens _asvilVersionsId
@@ -178,8 +178,8 @@ asvilBearerToken
178178 = lens _asvilBearerToken
179179 (\ s a -> s{_asvilBearerToken = a})
180180
181−-- | Part of \`name\`. Name of the resource requested. For example:
182−-- \"apps\/myapp\/services\/default\/versions\/v1\".
181+-- | Part of \`parent\`. Name of the parent Version resource. Example:
182+-- \`apps\/myapp\/services\/default\/versions\/v1\`.
183183asvilAppsId :: Lens' AppsServicesVersionsInstancesList Text
184184asvilAppsId
185185 = lens _asvilAppsId (\ s a -> s{_asvilAppsId = a})
@@ -190,7 +190,7 @@ asvilPageToken
190190 = lens _asvilPageToken
191191 (\ s a -> s{_asvilPageToken = a})
192192
193−-- | Part of \`name\`. See documentation of \`appsId\`.
193+-- | Part of \`parent\`. See documentation of \`appsId\`.
194194asvilServicesId :: Lens' AppsServicesVersionsInstancesList Text
195195asvilServicesId
196196 = lens _asvilServicesId
gogol-appengine/gen/Network/Google/Resource/AppEngine/Apps/Services/Versions/List.hs+4−4
@@ -53,7 +53,7 @@ import Network.Google.Prelude
5353-- | A resource alias for @appengine.apps.services.versions.list@ method which the
5454-- 'AppsServicesVersionsList' request conforms to.
5555type AppsServicesVersionsListResource =
56− "v1beta5" :>
56+ "v1" :>
5757 "apps" :>
5858 Capture "appsId" Text :>
5959 "services" :>
@@ -170,8 +170,8 @@ asvlBearerToken
170170 = lens _asvlBearerToken
171171 (\ s a -> s{_asvlBearerToken = a})
172172
173−-- | Part of \`name\`. Name of the resource requested. For example:
174−-- \"apps\/myapp\/services\/default\".
173+-- | Part of \`parent\`. Name of the parent Service resource. Example:
174+-- \`apps\/myapp\/services\/default\`.
175175asvlAppsId :: Lens' AppsServicesVersionsList Text
176176asvlAppsId
177177 = lens _asvlAppsId (\ s a -> s{_asvlAppsId = a})
@@ -186,7 +186,7 @@ asvlPageToken
186186 = lens _asvlPageToken
187187 (\ s a -> s{_asvlPageToken = a})
188188
189−-- | Part of \`name\`. See documentation of \`appsId\`.
189+-- | Part of \`parent\`. See documentation of \`appsId\`.
190190asvlServicesId :: Lens' AppsServicesVersionsList Text
191191asvlServicesId
192192 = lens _asvlServicesId
gogol-appengine/gen/Network/Google/Resource/AppEngine/Apps/Services/Versions/Patch.hs+47−19
@@ -20,7 +20,20 @@
2020-- Stability : auto-generated
2121-- Portability : non-portable (GHC extensions)
2222--
23−-- Updates an existing version. Note: UNIMPLEMENTED.
23+-- Updates the specified Version resource. You can specify the following
24+-- fields depending on the App Engine environment and type of scaling that
25+-- the version resource uses: *
26+-- [\`serving_status\`](https:\/\/cloud.google.com\/appengine\/docs\/admin-api\/reference\/rest\/v1\/apps.services.versions#Version.FIELDS.serving_status):
27+-- For Version resources that use basic scaling, manual scaling, or run in
28+-- the App Engine flexible environment. *
29+-- [\`instance_class\`](https:\/\/cloud.google.com\/appengine\/docs\/admin-api\/reference\/rest\/v1\/apps.services.versions#Version.FIELDS.instance_class):
30+-- For Version resources that run in the App Engine standard environment. *
31+-- [\`automatic_scaling.min_idle_instances\`](https:\/\/cloud.google.com\/appengine\/docs\/admin-api\/reference\/rest\/v1\/apps.services.versions#Version.FIELDS.automatic_scaling):
32+-- For Version resources that use automatic scaling and run in the App
33+-- Engine standard environment. *
34+-- [\`automatic_scaling.max_idle_instances\`](https:\/\/cloud.google.com\/appengine\/docs\/admin-api\/reference\/rest\/v1\/apps.services.versions#Version.FIELDS.automatic_scaling):
35+-- For Version resources that use automatic scaling and run in the App
36+-- Engine standard environment.
2437--
2538-- /See:/ <https://cloud.google.com/appengine/docs/admin-api/ Google App Engine Admin API Reference> for @appengine.apps.services.versions.patch@.
2639module Network.Google.Resource.AppEngine.Apps.Services.Versions.Patch
@@ -35,12 +48,12 @@ module Network.Google.Resource.AppEngine.Apps.Services.Versions.Patch
3548 -- * Request Lenses
3649 , asvpXgafv
3750 , asvpUploadProtocol
51+ , asvpUpdateMask
3852 , asvpPp
3953 , asvpAccessToken
4054 , asvpUploadType
4155 , asvpPayload
4256 , asvpVersionsId
43− , asvpMask
4457 , asvpBearerToken
4558 , asvpAppsId
4659 , asvpServicesId
@@ -53,7 +66,7 @@ import Network.Google.Prelude
5366-- | A resource alias for @appengine.apps.services.versions.patch@ method which the
5467-- 'AppsServicesVersionsPatch' request conforms to.
5568type AppsServicesVersionsPatchResource =
56− "v1beta5" :>
69+ "v1" :>
5770 "apps" :>
5871 Capture "appsId" Text :>
5972 "services" :>
@@ -62,28 +75,41 @@ type AppsServicesVersionsPatchResource =
6275 Capture "versionsId" Text :>
6376 QueryParam "$.xgafv" Text :>
6477 QueryParam "upload_protocol" Text :>
65− QueryParam "pp" Bool :>
66− QueryParam "access_token" Text :>
67− QueryParam "uploadType" Text :>
68− QueryParam "mask" Text :>
78+ QueryParam "updateMask" Text :>
79+ QueryParam "pp" Bool :>
80+ QueryParam "access_token" Text :>
81+ QueryParam "uploadType" Text :>
6982 QueryParam "bearer_token" Text :>
7083 QueryParam "callback" Text :>
7184 QueryParam "alt" AltJSON :>
7285 ReqBody '[JSON] Version :>
7386 Patch '[JSON] Operation
7487
75−-- | Updates an existing version. Note: UNIMPLEMENTED.
88+-- | Updates the specified Version resource. You can specify the following
89+-- fields depending on the App Engine environment and type of scaling that
90+-- the version resource uses: *
91+-- [\`serving_status\`](https:\/\/cloud.google.com\/appengine\/docs\/admin-api\/reference\/rest\/v1\/apps.services.versions#Version.FIELDS.serving_status):
92+-- For Version resources that use basic scaling, manual scaling, or run in
93+-- the App Engine flexible environment. *
94+-- [\`instance_class\`](https:\/\/cloud.google.com\/appengine\/docs\/admin-api\/reference\/rest\/v1\/apps.services.versions#Version.FIELDS.instance_class):
95+-- For Version resources that run in the App Engine standard environment. *
96+-- [\`automatic_scaling.min_idle_instances\`](https:\/\/cloud.google.com\/appengine\/docs\/admin-api\/reference\/rest\/v1\/apps.services.versions#Version.FIELDS.automatic_scaling):
97+-- For Version resources that use automatic scaling and run in the App
98+-- Engine standard environment. *
99+-- [\`automatic_scaling.max_idle_instances\`](https:\/\/cloud.google.com\/appengine\/docs\/admin-api\/reference\/rest\/v1\/apps.services.versions#Version.FIELDS.automatic_scaling):
100+-- For Version resources that use automatic scaling and run in the App
101+-- Engine standard environment.
76102--
77103-- /See:/ 'appsServicesVersionsPatch' smart constructor.
78104data AppsServicesVersionsPatch = AppsServicesVersionsPatch'
79105 { _asvpXgafv :: !(Maybe Text)
80106 , _asvpUploadProtocol :: !(Maybe Text)
107+ , _asvpUpdateMask :: !(Maybe Text)
81108 , _asvpPp :: !Bool
82109 , _asvpAccessToken :: !(Maybe Text)
83110 , _asvpUploadType :: !(Maybe Text)
84111 , _asvpPayload :: !Version
85112 , _asvpVersionsId :: !Text
86− , _asvpMask :: !(Maybe Text)
87113 , _asvpBearerToken :: !(Maybe Text)
88114 , _asvpAppsId :: !Text
89115 , _asvpServicesId :: !Text
@@ -98,6 +124,8 @@ data AppsServicesVersionsPatch = AppsServicesVersionsPatch'
98124--
99125-- * 'asvpUploadProtocol'
100126--
127+-- * 'asvpUpdateMask'
128+--
101129-- * 'asvpPp'
102130--
103131-- * 'asvpAccessToken'
@@ -108,8 +136,6 @@ data AppsServicesVersionsPatch = AppsServicesVersionsPatch'
108136--
109137-- * 'asvpVersionsId'
110138--
111−-- * 'asvpMask'
112−--
113139-- * 'asvpBearerToken'
114140--
115141-- * 'asvpAppsId'
@@ -127,12 +153,12 @@ appsServicesVersionsPatch pAsvpPayload_ pAsvpVersionsId_ pAsvpAppsId_ pAsvpServi
127153 AppsServicesVersionsPatch'
128154 { _asvpXgafv = Nothing
129155 , _asvpUploadProtocol = Nothing
156+ , _asvpUpdateMask = Nothing
130157 , _asvpPp = True
131158 , _asvpAccessToken = Nothing
132159 , _asvpUploadType = Nothing
133160 , _asvpPayload = pAsvpPayload_
134161 , _asvpVersionsId = pAsvpVersionsId_
135− , _asvpMask = Nothing
136162 , _asvpBearerToken = Nothing
137163 , _asvpAppsId = pAsvpAppsId_
138164 , _asvpServicesId = pAsvpServicesId_
@@ -150,6 +176,12 @@ asvpUploadProtocol
150176 = lens _asvpUploadProtocol
151177 (\ s a -> s{_asvpUploadProtocol = a})
152178
179+-- | Standard field mask for the set of fields to be updated.
180+asvpUpdateMask :: Lens' AppsServicesVersionsPatch (Maybe Text)
181+asvpUpdateMask
182+ = lens _asvpUpdateMask
183+ (\ s a -> s{_asvpUpdateMask = a})
184+
153185-- | Pretty-print response.
154186asvpPp :: Lens' AppsServicesVersionsPatch Bool
155187asvpPp = lens _asvpPp (\ s a -> s{_asvpPp = a})
@@ -177,18 +209,14 @@ asvpVersionsId
177209 = lens _asvpVersionsId
178210 (\ s a -> s{_asvpVersionsId = a})
179211
180−-- | Standard field mask for the set of fields to be updated.
181−asvpMask :: Lens' AppsServicesVersionsPatch (Maybe Text)
182−asvpMask = lens _asvpMask (\ s a -> s{_asvpMask = a})
183−
184212-- | OAuth bearer token.
185213asvpBearerToken :: Lens' AppsServicesVersionsPatch (Maybe Text)
186214asvpBearerToken
187215 = lens _asvpBearerToken
188216 (\ s a -> s{_asvpBearerToken = a})
189217
190−-- | Part of \`name\`. Name of the resource to update. For example:
191−-- \"apps\/myapp\/services\/default\/versions\/1\".
218+-- | Part of \`name\`. Name of the resource to update. Example:
219+-- \`apps\/myapp\/services\/default\/versions\/1\`.
192220asvpAppsId :: Lens' AppsServicesVersionsPatch Text
193221asvpAppsId
194222 = lens _asvpAppsId (\ s a -> s{_asvpAppsId = a})
@@ -213,10 +241,10 @@ instance GoogleRequest AppsServicesVersionsPatch
213241 = go _asvpAppsId _asvpServicesId _asvpVersionsId
214242 _asvpXgafv
215243 _asvpUploadProtocol
244+ _asvpUpdateMask
216245 (Just _asvpPp)
217246 _asvpAccessToken
218247 _asvpUploadType
219− _asvpMask
220248 _asvpBearerToken
221249 _asvpCallback
222250 (Just AltJSON)
gogol-appengine/gen/Network/Google/Resource/AppEngine/Experimental/Apps/Operations/Get.hsnew file+192
@@ -0,0 +1,192 @@
1+{-# LANGUAGE DataKinds #-}
2+{-# LANGUAGE DeriveDataTypeable #-}
3+{-# LANGUAGE DeriveGeneric #-}
4+{-# LANGUAGE FlexibleInstances #-}
5+{-# LANGUAGE NoImplicitPrelude #-}
6+{-# LANGUAGE OverloadedStrings #-}
7+{-# LANGUAGE RecordWildCards #-}
8+{-# LANGUAGE TypeFamilies #-}
9+{-# LANGUAGE TypeOperators #-}
10+
11+{-# OPTIONS_GHC -fno-warn-duplicate-exports #-}
12+{-# OPTIONS_GHC -fno-warn-unused-binds #-}
13+{-# OPTIONS_GHC -fno-warn-unused-imports #-}
14+
15+-- |
16+-- Module : Network.Google.Resource.AppEngine.Experimental.Apps.Operations.Get
17+-- Copyright : (c) 2015-2016 Brendan Hay
18+-- License : Mozilla Public License, v. 2.0.
19+-- Maintainer : Brendan Hay <brendan.g.hay@gmail.com>
20+-- Stability : auto-generated
21+-- Portability : non-portable (GHC extensions)
22+--
23+-- Gets the latest state of a long-running operation. Clients can use this
24+-- method to poll the operation result at intervals as recommended by the
25+-- API service.
26+--
27+-- /See:/ <https://cloud.google.com/appengine/docs/admin-api/ Google App Engine Admin API Reference> for @appengine.experimental.apps.operations.get@.
28+module Network.Google.Resource.AppEngine.Experimental.Apps.Operations.Get
29+ (
30+ -- * REST Resource
31+ ExperimentalAppsOperationsGetResource
32+
33+ -- * Creating a Request
34+ , experimentalAppsOperationsGet
35+ , ExperimentalAppsOperationsGet
36+
37+ -- * Request Lenses
38+ , eaogXgafv
39+ , eaogUploadProtocol
40+ , eaogPp
41+ , eaogAccessToken
42+ , eaogUploadType
43+ , eaogBearerToken
44+ , eaogAppsId
45+ , eaogOperationsId
46+ , eaogCallback
47+ ) where
48+
49+import Network.Google.AppEngine.Types
50+import Network.Google.Prelude
51+
52+-- | A resource alias for @appengine.experimental.apps.operations.get@ method which the
53+-- 'ExperimentalAppsOperationsGet' request conforms to.
54+type ExperimentalAppsOperationsGetResource =
55+ "experimental" :>
56+ "apps" :>
57+ Capture "appsId" Text :>
58+ "operations" :>
59+ Capture "operationsId" Text :>
60+ QueryParam "$.xgafv" Text :>
61+ QueryParam "upload_protocol" Text :>
62+ QueryParam "pp" Bool :>
63+ QueryParam "access_token" Text :>
64+ QueryParam "uploadType" Text :>
65+ QueryParam "bearer_token" Text :>
66+ QueryParam "callback" Text :>
67+ QueryParam "alt" AltJSON :> Get '[JSON] Operation
68+
69+-- | Gets the latest state of a long-running operation. Clients can use this
70+-- method to poll the operation result at intervals as recommended by the
71+-- API service.
72+--
73+-- /See:/ 'experimentalAppsOperationsGet' smart constructor.
74+data ExperimentalAppsOperationsGet = ExperimentalAppsOperationsGet'
75+ { _eaogXgafv :: !(Maybe Text)
76+ , _eaogUploadProtocol :: !(Maybe Text)
77+ , _eaogPp :: !Bool
78+ , _eaogAccessToken :: !(Maybe Text)
79+ , _eaogUploadType :: !(Maybe Text)
80+ , _eaogBearerToken :: !(Maybe Text)
81+ , _eaogAppsId :: !Text
82+ , _eaogOperationsId :: !Text
83+ , _eaogCallback :: !(Maybe Text)
84+ } deriving (Eq,Show,Data,Typeable,Generic)
85+
86+-- | Creates a value of 'ExperimentalAppsOperationsGet' with the minimum fields required to make a request.
87+--
88+-- Use one of the following lenses to modify other fields as desired:
89+--
90+-- * 'eaogXgafv'
91+--
92+-- * 'eaogUploadProtocol'
93+--
94+-- * 'eaogPp'
95+--
96+-- * 'eaogAccessToken'
97+--
98+-- * 'eaogUploadType'
99+--
100+-- * 'eaogBearerToken'
101+--
102+-- * 'eaogAppsId'
103+--
104+-- * 'eaogOperationsId'
105+--
106+-- * 'eaogCallback'
107+experimentalAppsOperationsGet
108+ :: Text -- ^ 'eaogAppsId'
109+ -> Text -- ^ 'eaogOperationsId'
110+ -> ExperimentalAppsOperationsGet
111+experimentalAppsOperationsGet pEaogAppsId_ pEaogOperationsId_ =
112+ ExperimentalAppsOperationsGet'
113+ { _eaogXgafv = Nothing
114+ , _eaogUploadProtocol = Nothing
115+ , _eaogPp = True
116+ , _eaogAccessToken = Nothing
117+ , _eaogUploadType = Nothing
118+ , _eaogBearerToken = Nothing
119+ , _eaogAppsId = pEaogAppsId_
120+ , _eaogOperationsId = pEaogOperationsId_
121+ , _eaogCallback = Nothing
122+ }
123+
124+-- | V1 error format.
125+eaogXgafv :: Lens' ExperimentalAppsOperationsGet (Maybe Text)
126+eaogXgafv
127+ = lens _eaogXgafv (\ s a -> s{_eaogXgafv = a})
128+
129+-- | Upload protocol for media (e.g. \"raw\", \"multipart\").
130+eaogUploadProtocol :: Lens' ExperimentalAppsOperationsGet (Maybe Text)
131+eaogUploadProtocol
132+ = lens _eaogUploadProtocol
133+ (\ s a -> s{_eaogUploadProtocol = a})
134+
135+-- | Pretty-print response.
136+eaogPp :: Lens' ExperimentalAppsOperationsGet Bool
137+eaogPp = lens _eaogPp (\ s a -> s{_eaogPp = a})
138+
139+-- | OAuth access token.
140+eaogAccessToken :: Lens' ExperimentalAppsOperationsGet (Maybe Text)
141+eaogAccessToken
142+ = lens _eaogAccessToken
143+ (\ s a -> s{_eaogAccessToken = a})
144+
145+-- | Legacy upload protocol for media (e.g. \"media\", \"multipart\").
146+eaogUploadType :: Lens' ExperimentalAppsOperationsGet (Maybe Text)
147+eaogUploadType
148+ = lens _eaogUploadType
149+ (\ s a -> s{_eaogUploadType = a})
150+
151+-- | OAuth bearer token.
152+eaogBearerToken :: Lens' ExperimentalAppsOperationsGet (Maybe Text)
153+eaogBearerToken
154+ = lens _eaogBearerToken
155+ (\ s a -> s{_eaogBearerToken = a})
156+
157+-- | Part of \`name\`. The name of the operation resource.
158+eaogAppsId :: Lens' ExperimentalAppsOperationsGet Text
159+eaogAppsId
160+ = lens _eaogAppsId (\ s a -> s{_eaogAppsId = a})
161+
162+-- | Part of \`name\`. See documentation of \`appsId\`.
163+eaogOperationsId :: Lens' ExperimentalAppsOperationsGet Text
164+eaogOperationsId
165+ = lens _eaogOperationsId
166+ (\ s a -> s{_eaogOperationsId = a})
167+
168+-- | JSONP
169+eaogCallback :: Lens' ExperimentalAppsOperationsGet (Maybe Text)
170+eaogCallback
171+ = lens _eaogCallback (\ s a -> s{_eaogCallback = a})
172+
173+instance GoogleRequest ExperimentalAppsOperationsGet
174+ where
175+ type Rs ExperimentalAppsOperationsGet = Operation
176+ type Scopes ExperimentalAppsOperationsGet =
177+ '["https://www.googleapis.com/auth/cloud-platform"]
178+ requestClient ExperimentalAppsOperationsGet'{..}
179+ = go _eaogAppsId _eaogOperationsId _eaogXgafv
180+ _eaogUploadProtocol
181+ (Just _eaogPp)
182+ _eaogAccessToken
183+ _eaogUploadType
184+ _eaogBearerToken
185+ _eaogCallback
186+ (Just AltJSON)
187+ appEngineService
188+ where go
189+ = buildClient
190+ (Proxy ::
191+ Proxy ExperimentalAppsOperationsGetResource)
192+ mempty
gogol-appengine/gen/Network/Google/Resource/AppEngine/Experimental/Apps/Operations/List.hsnew file+222
@@ -0,0 +1,222 @@
1+{-# LANGUAGE DataKinds #-}
2+{-# LANGUAGE DeriveDataTypeable #-}
3+{-# LANGUAGE DeriveGeneric #-}
4+{-# LANGUAGE FlexibleInstances #-}
5+{-# LANGUAGE NoImplicitPrelude #-}
6+{-# LANGUAGE OverloadedStrings #-}
7+{-# LANGUAGE RecordWildCards #-}
8+{-# LANGUAGE TypeFamilies #-}
9+{-# LANGUAGE TypeOperators #-}
10+
11+{-# OPTIONS_GHC -fno-warn-duplicate-exports #-}
12+{-# OPTIONS_GHC -fno-warn-unused-binds #-}
13+{-# OPTIONS_GHC -fno-warn-unused-imports #-}
14+
15+-- |
16+-- Module : Network.Google.Resource.AppEngine.Experimental.Apps.Operations.List
17+-- Copyright : (c) 2015-2016 Brendan Hay
18+-- License : Mozilla Public License, v. 2.0.
19+-- Maintainer : Brendan Hay <brendan.g.hay@gmail.com>
20+-- Stability : auto-generated
21+-- Portability : non-portable (GHC extensions)
22+--
23+-- Lists operations that match the specified filter in the request. If the
24+-- server doesn\'t support this method, it returns \`UNIMPLEMENTED\`. NOTE:
25+-- the \`name\` binding below allows API services to override the binding
26+-- to use different resource name schemes, such as
27+-- \`users\/*\/operations\`.
28+--
29+-- /See:/ <https://cloud.google.com/appengine/docs/admin-api/ Google App Engine Admin API Reference> for @appengine.experimental.apps.operations.list@.
30+module Network.Google.Resource.AppEngine.Experimental.Apps.Operations.List
31+ (
32+ -- * REST Resource
33+ ExperimentalAppsOperationsListResource
34+
35+ -- * Creating a Request
36+ , experimentalAppsOperationsList
37+ , ExperimentalAppsOperationsList
38+
39+ -- * Request Lenses
40+ , eaolXgafv
41+ , eaolUploadProtocol
42+ , eaolPp
43+ , eaolAccessToken
44+ , eaolUploadType
45+ , eaolBearerToken
46+ , eaolAppsId
47+ , eaolFilter
48+ , eaolPageToken
49+ , eaolPageSize
50+ , eaolCallback
51+ ) where
52+
53+import Network.Google.AppEngine.Types
54+import Network.Google.Prelude
55+
56+-- | A resource alias for @appengine.experimental.apps.operations.list@ method which the
57+-- 'ExperimentalAppsOperationsList' request conforms to.
58+type ExperimentalAppsOperationsListResource =
59+ "experimental" :>
60+ "apps" :>
61+ Capture "appsId" Text :>
62+ "operations" :>
63+ QueryParam "$.xgafv" Text :>
64+ QueryParam "upload_protocol" Text :>
65+ QueryParam "pp" Bool :>
66+ QueryParam "access_token" Text :>
67+ QueryParam "uploadType" Text :>
68+ QueryParam "bearer_token" Text :>
69+ QueryParam "filter" Text :>
70+ QueryParam "pageToken" Text :>
71+ QueryParam "pageSize" (Textual Int32) :>
72+ QueryParam "callback" Text :>
73+ QueryParam "alt" AltJSON :>
74+ Get '[JSON] ListOperationsResponse
75+
76+-- | Lists operations that match the specified filter in the request. If the
77+-- server doesn\'t support this method, it returns \`UNIMPLEMENTED\`. NOTE:
78+-- the \`name\` binding below allows API services to override the binding
79+-- to use different resource name schemes, such as
80+-- \`users\/*\/operations\`.
81+--
82+-- /See:/ 'experimentalAppsOperationsList' smart constructor.
83+data ExperimentalAppsOperationsList = ExperimentalAppsOperationsList'
84+ { _eaolXgafv :: !(Maybe Text)
85+ , _eaolUploadProtocol :: !(Maybe Text)
86+ , _eaolPp :: !Bool
87+ , _eaolAccessToken :: !(Maybe Text)
88+ , _eaolUploadType :: !(Maybe Text)
89+ , _eaolBearerToken :: !(Maybe Text)
90+ , _eaolAppsId :: !Text
91+ , _eaolFilter :: !(Maybe Text)
92+ , _eaolPageToken :: !(Maybe Text)
93+ , _eaolPageSize :: !(Maybe (Textual Int32))
94+ , _eaolCallback :: !(Maybe Text)
95+ } deriving (Eq,Show,Data,Typeable,Generic)
96+
97+-- | Creates a value of 'ExperimentalAppsOperationsList' with the minimum fields required to make a request.
98+--
99+-- Use one of the following lenses to modify other fields as desired:
100+--
101+-- * 'eaolXgafv'
102+--
103+-- * 'eaolUploadProtocol'
104+--
105+-- * 'eaolPp'
106+--
107+-- * 'eaolAccessToken'
108+--
109+-- * 'eaolUploadType'
110+--
111+-- * 'eaolBearerToken'
112+--
113+-- * 'eaolAppsId'
114+--
115+-- * 'eaolFilter'
116+--
117+-- * 'eaolPageToken'
118+--
119+-- * 'eaolPageSize'
120+--
121+-- * 'eaolCallback'
122+experimentalAppsOperationsList
123+ :: Text -- ^ 'eaolAppsId'
124+ -> ExperimentalAppsOperationsList
125+experimentalAppsOperationsList pEaolAppsId_ =
126+ ExperimentalAppsOperationsList'
127+ { _eaolXgafv = Nothing
128+ , _eaolUploadProtocol = Nothing
129+ , _eaolPp = True
130+ , _eaolAccessToken = Nothing
131+ , _eaolUploadType = Nothing
132+ , _eaolBearerToken = Nothing
133+ , _eaolAppsId = pEaolAppsId_
134+ , _eaolFilter = Nothing
135+ , _eaolPageToken = Nothing
136+ , _eaolPageSize = Nothing
137+ , _eaolCallback = Nothing
138+ }
139+
140+-- | V1 error format.
141+eaolXgafv :: Lens' ExperimentalAppsOperationsList (Maybe Text)
142+eaolXgafv
143+ = lens _eaolXgafv (\ s a -> s{_eaolXgafv = a})
144+
145+-- | Upload protocol for media (e.g. \"raw\", \"multipart\").
146+eaolUploadProtocol :: Lens' ExperimentalAppsOperationsList (Maybe Text)
147+eaolUploadProtocol
148+ = lens _eaolUploadProtocol
149+ (\ s a -> s{_eaolUploadProtocol = a})
150+
151+-- | Pretty-print response.
152+eaolPp :: Lens' ExperimentalAppsOperationsList Bool
153+eaolPp = lens _eaolPp (\ s a -> s{_eaolPp = a})
154+
155+-- | OAuth access token.
156+eaolAccessToken :: Lens' ExperimentalAppsOperationsList (Maybe Text)
157+eaolAccessToken
158+ = lens _eaolAccessToken
159+ (\ s a -> s{_eaolAccessToken = a})
160+
161+-- | Legacy upload protocol for media (e.g. \"media\", \"multipart\").
162+eaolUploadType :: Lens' ExperimentalAppsOperationsList (Maybe Text)
163+eaolUploadType
164+ = lens _eaolUploadType
165+ (\ s a -> s{_eaolUploadType = a})
166+
167+-- | OAuth bearer token.
168+eaolBearerToken :: Lens' ExperimentalAppsOperationsList (Maybe Text)
169+eaolBearerToken
170+ = lens _eaolBearerToken
171+ (\ s a -> s{_eaolBearerToken = a})
172+
173+-- | Part of \`name\`. The name of the operation collection.
174+eaolAppsId :: Lens' ExperimentalAppsOperationsList Text
175+eaolAppsId
176+ = lens _eaolAppsId (\ s a -> s{_eaolAppsId = a})
177+
178+-- | The standard list filter.
179+eaolFilter :: Lens' ExperimentalAppsOperationsList (Maybe Text)
180+eaolFilter
181+ = lens _eaolFilter (\ s a -> s{_eaolFilter = a})
182+
183+-- | The standard list page token.
184+eaolPageToken :: Lens' ExperimentalAppsOperationsList (Maybe Text)
185+eaolPageToken
186+ = lens _eaolPageToken
187+ (\ s a -> s{_eaolPageToken = a})
188+
189+-- | The standard list page size.
190+eaolPageSize :: Lens' ExperimentalAppsOperationsList (Maybe Int32)
191+eaolPageSize
192+ = lens _eaolPageSize (\ s a -> s{_eaolPageSize = a})
193+ . mapping _Coerce
194+
195+-- | JSONP
196+eaolCallback :: Lens' ExperimentalAppsOperationsList (Maybe Text)
197+eaolCallback
198+ = lens _eaolCallback (\ s a -> s{_eaolCallback = a})
199+
200+instance GoogleRequest ExperimentalAppsOperationsList
201+ where
202+ type Rs ExperimentalAppsOperationsList =
203+ ListOperationsResponse
204+ type Scopes ExperimentalAppsOperationsList =
205+ '["https://www.googleapis.com/auth/cloud-platform"]
206+ requestClient ExperimentalAppsOperationsList'{..}
207+ = go _eaolAppsId _eaolXgafv _eaolUploadProtocol
208+ (Just _eaolPp)
209+ _eaolAccessToken
210+ _eaolUploadType
211+ _eaolBearerToken
212+ _eaolFilter
213+ _eaolPageToken
214+ _eaolPageSize
215+ _eaolCallback
216+ (Just AltJSON)
217+ appEngineService
218+ where go
219+ = buildClient
220+ (Proxy ::
221+ Proxy ExperimentalAppsOperationsListResource)
222+ mempty
gogol-appengine/gogol-appengine.cabal+10−1
@@ -19,7 +19,7 @@ description:
1919 /Warning:/ This is an experimental prototype/preview release which is still
2020 under exploratory development and not intended for public use, caveat emptor!
2121 .
22− This library is compatible with version @v1beta5@
22+ This library is compatible with version @v1@
2323 of the API.
2424
2525source-repository head
@@ -36,8 +36,12 @@ library
3636 Network.Google.AppEngine
3737 , Network.Google.AppEngine.Types
3838 , Network.Google.Resource.AppEngine.Apps.Get
39+ , Network.Google.Resource.AppEngine.Apps.Locations.Get
40+ , Network.Google.Resource.AppEngine.Apps.Locations.List
3941 , Network.Google.Resource.AppEngine.Apps.Operations.Get
4042 , Network.Google.Resource.AppEngine.Apps.Operations.List
43+ , Network.Google.Resource.AppEngine.Apps.Patch
44+ , Network.Google.Resource.AppEngine.Apps.Repair
4145 , Network.Google.Resource.AppEngine.Apps.Services.Delete
4246 , Network.Google.Resource.AppEngine.Apps.Services.Get
4347 , Network.Google.Resource.AppEngine.Apps.Services.List
@@ -45,9 +49,14 @@ library
4549 , Network.Google.Resource.AppEngine.Apps.Services.Versions.Create
4650 , Network.Google.Resource.AppEngine.Apps.Services.Versions.Delete
4751 , Network.Google.Resource.AppEngine.Apps.Services.Versions.Get
52+ , Network.Google.Resource.AppEngine.Apps.Services.Versions.Instances.Debug
53+ , Network.Google.Resource.AppEngine.Apps.Services.Versions.Instances.Delete
54+ , Network.Google.Resource.AppEngine.Apps.Services.Versions.Instances.Get
4855 , Network.Google.Resource.AppEngine.Apps.Services.Versions.Instances.List
4956 , Network.Google.Resource.AppEngine.Apps.Services.Versions.List
5057 , Network.Google.Resource.AppEngine.Apps.Services.Versions.Patch
58+ , Network.Google.Resource.AppEngine.Experimental.Apps.Operations.Get
59+ , Network.Google.Resource.AppEngine.Experimental.Apps.Operations.List
5160
5261 other-modules:
5362 Network.Google.AppEngine.Types.Product