on develop help sign in
Regenerating gogol-appengine from latest service definition
2be77a8Brendan Hay
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 @@
1{
1{
2 "kind": "discovery#restDescription",
2 "kind": "discovery#restDescription",
3− "etag": "\"jQLIOHBVnDZie4rQHGH1WJF-INE/xOhGK-osplEL_ezCgC9eAq4dFhY\"",
3+ "etag": "\"C5oy1hgQsABtYOYIOXWcR3BgYqU/oxqnbHp-xHhVH5Kpw24MjL-SV6E\"",
4 "discoveryVersion": "v1",
4 "discoveryVersion": "v1",
5 "id": "appengine:v1beta4",
5 "id": "appengine:v1beta4",
6 "name": "appengine",
6 "name": "appengine",
7 "version": "v1beta4",
7 "version": "v1beta4",
8− "revision": "20160407",
8+ "revision": "20161012",
9 "title": "Google App Engine Admin API",
9 "title": "Google App Engine Admin API",
10 "description": "Provisions and manages App Engine applications.",
10 "description": "Provisions and manages App Engine applications.",
11 "ownerDomain": "google.com",
11 "ownerDomain": "google.com",
@@ -110,49 +110,129 @@
110 }
110 }
111 },
111 },
112 "schemas": {
112 "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+ },
113 "Application": {
193 "Application": {
114 "id": "Application",
194 "id": "Application",
115 "type": "object",
195 "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.",
117 "properties": {
197 "properties": {
118 "name": {
198 "name": {
119 "type": "string",
199 "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"
121 },
201 },
122 "id": {
202 "id": {
123 "type": "string",
203 "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`."
125 },
205 },
126 "dispatchRules": {
206 "dispatchRules": {
127 "type": "array",
207 "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",
129 "items": {
209 "items": {
130 "$ref": "UrlDispatchRule"
210 "$ref": "UrlDispatchRule"
131 }
211 }
132 },
212 },
133 "authDomain": {
213 "authDomain": {
134 "type": "string",
214 "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."
136 },
216 },
137 "location": {
217 "location": {
138 "type": "string",
218 "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"
140 },
220 },
141 "codeBucket": {
221 "codeBucket": {
142 "type": "string",
222 "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"
144 },
224 },
145 "defaultCookieExpiration": {
225 "defaultCookieExpiration": {
146 "type": "string",
226 "type": "string",
147− "description": "Determines the cookie expiration policy for the application. @OutputOnly"
227+ "description": "Cookie expiration policy for this application. @OutputOnly"
148 },
228 },
149 "defaultHostname": {
229 "defaultHostname": {
150 "type": "string",
230 "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"
152 },
232 },
153 "defaultBucket": {
233 "defaultBucket": {
154 "type": "string",
234 "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"
156 }
236 }
157 }
237 }
158 },
238 },
@@ -163,34 +243,34 @@
163 "properties": {
243 "properties": {
164 "domain": {
244 "domain": {
165 "type": "string",
245 "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: \"`*`\"."
167 },
247 },
168 "path": {
248 "path": {
169 "type": "string",
249 "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."
171 },
251 },
172 "module": {
252 "module": {
173 "type": "string",
253 "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`."
175 }
255 }
176 }
256 }
177 },
257 },
178 "Version": {
258 "Version": {
179 "id": "Version",
259 "id": "Version",
180 "type": "object",
260 "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.",
182 "properties": {
262 "properties": {
183 "name": {
263 "name": {
184 "type": "string",
264 "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"
186 },
266 },
187 "id": {
267 "id": {
188 "type": "string",
268 "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-\"."
190 },
270 },
191 "automaticScaling": {
271 "automaticScaling": {
192 "$ref": "AutomaticScaling",
272 "$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."
194 },
274 },
195 "basicScaling": {
275 "basicScaling": {
196 "$ref": "BasicScaling",
276 "$ref": "BasicScaling",
@@ -206,7 +286,7 @@
206 "enumDescriptions": [
286 "enumDescriptions": [
207 "Not specified.",
287 "Not specified.",
208 "Allows an application to receive mail.",
288 "Allows an application to receive mail.",
209− "Allows an application receive email bound notifications.",
289+ "Allows an application to receive email-bound notifications.",
210 "Allows an application to receive error stanzas.",
290 "Allows an application to receive error stanzas.",
211 "Allows an application to receive instant messages.",
291 "Allows an application to receive instant messages.",
212 "Allows an application to receive user subscription POSTs.",
292 "Allows an application to receive user subscription POSTs.",
@@ -231,42 +311,42 @@
231 },
311 },
232 "instanceClass": {
312 "instanceClass": {
233 "type": "string",
313 "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."
235 },
315 },
236 "network": {
316 "network": {
237 "$ref": "Network",
317 "$ref": "Network",
238− "description": "Used to specify extra network settings (for VM runtimes only)."
318+ "description": "Extra network settings. Only applicable for VM runtimes."
239 },
319 },
240 "resources": {
320 "resources": {
241 "$ref": "Resources",
321 "$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."
243 },
323 },
244 "runtime": {
324 "runtime": {
245 "type": "string",
325 "type": "string",
246− "description": "The desired runtime. Values can include python27, java7, go, etc."
326+ "description": "Desired runtime. Example: `python27`."
247 },
327 },
248 "threadsafe": {
328 "threadsafe": {
249 "type": "boolean",
329 "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."
251 },
331 },
252 "vm": {
332 "vm": {
253 "type": "boolean",
333 "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."
255 },
335 },
256 "betaSettings": {
336 "betaSettings": {
257 "type": "object",
337 "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.",
259 "additionalProperties": {
339 "additionalProperties": {
260 "type": "string"
340 "type": "string"
261 }
341 }
262 },
342 },
263 "env": {
343 "env": {
264 "type": "string",
344 "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`."
266 },
346 },
267 "servingStatus": {
347 "servingStatus": {
268 "type": "string",
348 "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`.",
270 "enum": [
350 "enum": [
271 "SERVING_STATUS_UNSPECIFIED",
351 "SERVING_STATUS_UNSPECIFIED",
272 "SERVING",
352 "SERVING",
@@ -275,70 +355,70 @@
275 },
355 },
276 "deployer": {
356 "deployer": {
277 "type": "string",
357 "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"
279 },
359 },
280 "creationTime": {
360 "creationTime": {
281 "type": "string",
361 "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"
283 },
363 },
284 "handlers": {
364 "handlers": {
285 "type": "array",
365 "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.",
287 "items": {
367 "items": {
288 "$ref": "UrlMap"
368 "$ref": "UrlMap"
289 }
369 }
290 },
370 },
291 "errorHandlers": {
371 "errorHandlers": {
292 "type": "array",
372 "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.",
294 "items": {
374 "items": {
295 "$ref": "ErrorHandler"
375 "$ref": "ErrorHandler"
296 }
376 }
297 },
377 },
298 "libraries": {
378 "libraries": {
299 "type": "array",
379 "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.",
301 "items": {
381 "items": {
302 "$ref": "Library"
382 "$ref": "Library"
303 }
383 }
304 },
384 },
305 "apiConfig": {
385 "apiConfig": {
306 "$ref": "ApiConfigHandler",
386 "$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."
308 },
388 },
309 "envVariables": {
389 "envVariables": {
310 "type": "object",
390 "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.",
312 "additionalProperties": {
392 "additionalProperties": {
313 "type": "string"
393 "type": "string"
314 }
394 }
315 },
395 },
316 "defaultExpiration": {
396 "defaultExpiration": {
317 "type": "string",
397 "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."
319 },
399 },
320 "healthCheck": {
400 "healthCheck": {
321 "$ref": "HealthCheck",
401 "$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."
323 },
403 },
324 "nobuildFilesRegex": {
404 "nobuildFilesRegex": {
325 "type": "string",
405 "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."
327 },
407 },
328 "deployment": {
408 "deployment": {
329 "$ref": "Deployment",
409 "$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."
331 }
411 }
332 }
412 }
333 },
413 },
334 "AutomaticScaling": {
414 "AutomaticScaling": {
335 "id": "AutomaticScaling",
415 "id": "AutomaticScaling",
336 "type": "object",
416 "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.",
338 "properties": {
418 "properties": {
339 "coolDownPeriod": {
419 "coolDownPeriod": {
340 "type": "string",
420 "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."
342 },
422 },
343 "cpuUtilization": {
423 "cpuUtilization": {
344 "$ref": "CpuUtilization",
424 "$ref": "CpuUtilization",
@@ -346,36 +426,36 @@
346 },
426 },
347 "maxConcurrentRequests": {
427 "maxConcurrentRequests": {
348 "type": "integer",
428 "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.",
350 "format": "int32"
430 "format": "int32"
351 },
431 },
352 "maxIdleInstances": {
432 "maxIdleInstances": {
353 "type": "integer",
433 "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.",
355 "format": "int32"
435 "format": "int32"
356 },
436 },
357 "maxTotalInstances": {
437 "maxTotalInstances": {
358 "type": "integer",
438 "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.",
360 "format": "int32"
440 "format": "int32"
361 },
441 },
362 "maxPendingLatency": {
442 "maxPendingLatency": {
363 "type": "string",
443 "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."
365 },
445 },
366 "minIdleInstances": {
446 "minIdleInstances": {
367 "type": "integer",
447 "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.",
369 "format": "int32"
449 "format": "int32"
370 },
450 },
371 "minTotalInstances": {
451 "minTotalInstances": {
372 "type": "integer",
452 "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.",
374 "format": "int32"
454 "format": "int32"
375 },
455 },
376 "minPendingLatency": {
456 "minPendingLatency": {
377 "type": "string",
457 "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."
379 },
459 },
380 "requestUtilization": {
460 "requestUtilization": {
381 "$ref": "RequestUtilization",
461 "$ref": "RequestUtilization",
@@ -398,11 +478,11 @@
398 "properties": {
478 "properties": {
399 "aggregationWindowLength": {
479 "aggregationWindowLength": {
400 "type": "string",
480 "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."
402 },
482 },
403 "targetUtilization": {
483 "targetUtilization": {
404 "type": "number",
484 "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.",
406 "format": "double"
486 "format": "double"
407 }
487 }
408 }
488 }
@@ -410,7 +490,7 @@
410 "RequestUtilization": {
490 "RequestUtilization": {
411 "id": "RequestUtilization",
491 "id": "RequestUtilization",
412 "type": "object",
492 "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.",
414 "properties": {
494 "properties": {
415 "targetRequestCountPerSec": {
495 "targetRequestCountPerSec": {
416 "type": "integer",
496 "type": "integer",
@@ -427,26 +507,26 @@
427 "DiskUtilization": {
507 "DiskUtilization": {
428 "id": "DiskUtilization",
508 "id": "DiskUtilization",
429 "type": "object",
509 "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.",
431 "properties": {
511 "properties": {
432 "targetWriteBytesPerSec": {
512 "targetWriteBytesPerSec": {
433 "type": "integer",
513 "type": "integer",
434− "description": "Target bytes per second written.",
514+ "description": "Target bytes written per second.",
435 "format": "int32"
515 "format": "int32"
436 },
516 },
437 "targetWriteOpsPerSec": {
517 "targetWriteOpsPerSec": {
438 "type": "integer",
518 "type": "integer",
439− "description": "Target ops per second written.",
519+ "description": "Target ops written per second.",
440 "format": "int32"
520 "format": "int32"
441 },
521 },
442 "targetReadBytesPerSec": {
522 "targetReadBytesPerSec": {
443 "type": "integer",
523 "type": "integer",
444− "description": "Target bytes per second read.",
524+ "description": "Target bytes read per second.",
445 "format": "int32"
525 "format": "int32"
446 },
526 },
447 "targetReadOpsPerSec": {
527 "targetReadOpsPerSec": {
448 "type": "integer",
528 "type": "integer",
449− "description": "Target ops per second read.",
529+ "description": "Target ops read per second.",
450 "format": "int32"
530 "format": "int32"
451 }
531 }
452 }
532 }
@@ -454,26 +534,26 @@
454 "NetworkUtilization": {
534 "NetworkUtilization": {
455 "id": "NetworkUtilization",
535 "id": "NetworkUtilization",
456 "type": "object",
536 "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.",
458 "properties": {
538 "properties": {
459 "targetSentBytesPerSec": {
539 "targetSentBytesPerSec": {
460 "type": "integer",
540 "type": "integer",
461− "description": "Target bytes per second sent.",
541+ "description": "Target bytes sent per second.",
462 "format": "int32"
542 "format": "int32"
463 },
543 },
464 "targetSentPacketsPerSec": {
544 "targetSentPacketsPerSec": {
465 "type": "integer",
545 "type": "integer",
466− "description": "Target packets per second sent.",
546+ "description": "Target packets sent per second.",
467 "format": "int32"
547 "format": "int32"
468 },
548 },
469 "targetReceivedBytesPerSec": {
549 "targetReceivedBytesPerSec": {
470 "type": "integer",
550 "type": "integer",
471− "description": "Target bytes per second received.",
551+ "description": "Target bytes received per second.",
472 "format": "int32"
552 "format": "int32"
473 },
553 },
474 "targetReceivedPacketsPerSec": {
554 "targetReceivedPacketsPerSec": {
475 "type": "integer",
555 "type": "integer",
476− "description": "Target packets per second received.",
556+ "description": "Target packets received per second.",
477 "format": "int32"
557 "format": "int32"
478 }
558 }
479 }
559 }
@@ -485,11 +565,11 @@
485 "properties": {
565 "properties": {
486 "idleTimeout": {
566 "idleTimeout": {
487 "type": "string",
567 "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."
489 },
569 },
490 "maxInstances": {
570 "maxInstances": {
491 "type": "integer",
571 "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.",
493 "format": "int32"
573 "format": "int32"
494 }
574 }
495 }
575 }
@@ -501,7 +581,7 @@
501 "properties": {
581 "properties": {
502 "instances": {
582 "instances": {
503 "type": "integer",
583 "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.",
505 "format": "int32"
585 "format": "int32"
506 }
586 }
507 }
587 }
@@ -509,43 +589,43 @@
509 "Network": {
589 "Network": {
510 "id": "Network",
590 "id": "Network",
511 "type": "object",
591 "type": "object",
512− "description": "Used to specify extra network settings (for VM runtimes only).",
592+ "description": "Extra network settings. Only applicable for VM runtimes.",
513 "properties": {
593 "properties": {
514 "forwardedPorts": {
594 "forwardedPorts": {
515 "type": "array",
595 "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.",
517 "items": {
597 "items": {
518 "type": "string"
598 "type": "string"
519 }
599 }
520 },
600 },
521 "instanceTag": {
601 "instanceTag": {
522 "type": "string",
602 "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."
524 },
604 },
525 "name": {
605 "name": {
526 "type": "string",
606 "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`."
528 }
608 }
529 }
609 }
530 },
610 },
531 "Resources": {
611 "Resources": {
532 "id": "Resources",
612 "id": "Resources",
533 "type": "object",
613 "type": "object",
534− "description": "Used to specify how many machine resources an app version needs.",
614+ "description": "Machine resources for a version.",
535 "properties": {
615 "properties": {
536 "cpu": {
616 "cpu": {
537 "type": "number",
617 "type": "number",
538− "description": "How many CPU cores an app version needs.",
618+ "description": "Number of CPU cores needed.",
539 "format": "double"
619 "format": "double"
540 },
620 },
541 "diskGb": {
621 "diskGb": {
542 "type": "number",
622 "type": "number",
543− "description": "How much disk size, in GB, an app version needs.",
623+ "description": "Disk size (GB) needed.",
544 "format": "double"
624 "format": "double"
545 },
625 },
546 "memoryGb": {
626 "memoryGb": {
547 "type": "number",
627 "type": "number",
548− "description": "How much memory, in GB, an app version needs.",
628+ "description": "Memory (GB) needed.",
549 "format": "double"
629 "format": "double"
550 }
630 }
551 }
631 }
@@ -553,11 +633,11 @@
553 "UrlMap": {
633 "UrlMap": {
554 "id": "UrlMap",
634 "id": "UrlMap",
555 "type": "object",
635 "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.",
557 "properties": {
637 "properties": {
558 "urlRegex": {
638 "urlRegex": {
559 "type": "string",
639 "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."
561 },
641 },
562 "staticFiles": {
642 "staticFiles": {
563 "$ref": "StaticFilesHandler",
643 "$ref": "StaticFilesHandler",
@@ -569,15 +649,15 @@
569 },
649 },
570 "script": {
650 "script": {
571 "$ref": "ScriptHandler",
651 "$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."
573 },
653 },
574 "apiEndpoint": {
654 "apiEndpoint": {
575 "$ref": "ApiEndpointHandler",
655 "$ref": "ApiEndpointHandler",
576− "description": "Use API Endpoints to handle requests."
656+ "description": "Uses API Endpoints to handle requests."
577 },
657 },
578 "securityLevel": {
658 "securityLevel": {
579 "type": "string",
659 "type": "string",
580− "description": "Configures whether security (HTTPS) should be enforced for this URL.",
660+ "description": "Security (HTTPS) enforcement for this URL.",
581 "enum": [
661 "enum": [
582 "SECURE_UNSPECIFIED",
662 "SECURE_UNSPECIFIED",
583 "SECURE_DEFAULT",
663 "SECURE_DEFAULT",
@@ -588,7 +668,7 @@
588 },
668 },
589 "login": {
669 "login": {
590 "type": "string",
670 "type": "string",
591− "description": "What level of login is required to access this resource.",
671+ "description": "Level of login required to access this resource.",
592 "enum": [
672 "enum": [
593 "LOGIN_UNSPECIFIED",
673 "LOGIN_UNSPECIFIED",
594 "LOGIN_OPTIONAL",
674 "LOGIN_OPTIONAL",
@@ -598,7 +678,7 @@
598 },
678 },
599 "authFailAction": {
679 "authFailAction": {
600 "type": "string",
680 "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`.",
602 "enum": [
682 "enum": [
603 "AUTH_FAIL_ACTION_UNSPECIFIED",
683 "AUTH_FAIL_ACTION_UNSPECIFIED",
604 "AUTH_FAIL_ACTION_REDIRECT",
684 "AUTH_FAIL_ACTION_REDIRECT",
@@ -607,7 +687,7 @@
607 },
687 },
608 "redirectHttpResponseCode": {
688 "redirectHttpResponseCode": {
609 "type": "string",
689 "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`.",
611 "enum": [
691 "enum": [
612 "REDIRECT_HTTP_RESPONSE_CODE_UNSPECIFIED",
692 "REDIRECT_HTTP_RESPONSE_CODE_UNSPECIFIED",
613 "REDIRECT_HTTP_RESPONSE_CODE_301",
693 "REDIRECT_HTTP_RESPONSE_CODE_301",
@@ -625,11 +705,11 @@
625 "properties": {
705 "properties": {
626 "path": {
706 "path": {
627 "type": "string",
707 "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."
629 },
709 },
630 "uploadPathRegex": {
710 "uploadPathRegex": {
631 "type": "string",
711 "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."
633 },
713 },
634 "httpHeaders": {
714 "httpHeaders": {
635 "type": "object",
715 "type": "object",
@@ -640,19 +720,19 @@
640 },
720 },
641 "mimeType": {
721 "mimeType": {
642 "type": "string",
722 "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."
644 },
724 },
645 "expiration": {
725 "expiration": {
646 "type": "string",
726 "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."
648 },
728 },
649 "requireMatchingFile": {
729 "requireMatchingFile": {
650 "type": "boolean",
730 "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."
652 },
732 },
653 "applicationReadable": {
733 "applicationReadable": {
654 "type": "boolean",
734 "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."
656 }
736 }
657 }
737 }
658 },
738 },
@@ -663,7 +743,7 @@
663 "properties": {
743 "properties": {
664 "directory": {
744 "directory": {
665 "type": "string",
745 "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."
667 },
747 },
668 "httpHeaders": {
748 "httpHeaders": {
669 "type": "object",
749 "type": "object",
@@ -674,19 +754,19 @@
674 },
754 },
675 "mimeType": {
755 "mimeType": {
676 "type": "string",
756 "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."
678 },
758 },
679 "expiration": {
759 "expiration": {
680 "type": "string",
760 "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."
682 },
762 },
683 "requireMatchingFile": {
763 "requireMatchingFile": {
684 "type": "boolean",
764 "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."
686 },
766 },
687 "applicationReadable": {
767 "applicationReadable": {
688 "type": "boolean",
768 "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."
690 }
770 }
691 }
771 }
692 },
772 },
@@ -697,29 +777,29 @@
697 "properties": {
777 "properties": {
698 "scriptPath": {
778 "scriptPath": {
699 "type": "string",
779 "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."
701 }
781 }
702 }
782 }
703 },
783 },
704 "ApiEndpointHandler": {
784 "ApiEndpointHandler": {
705 "id": "ApiEndpointHandler",
785 "id": "ApiEndpointHandler",
706 "type": "object",
786 "type": "object",
707− "description": "Use Google Cloud Endpoints to handle requests.",
787+ "description": "Uses Google Cloud Endpoints to handle requests.",
708 "properties": {
788 "properties": {
709 "scriptPath": {
789 "scriptPath": {
710 "type": "string",
790 "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."
712 }
792 }
713 }
793 }
714 },
794 },
715 "ErrorHandler": {
795 "ErrorHandler": {
716 "id": "ErrorHandler",
796 "id": "ErrorHandler",
717 "type": "object",
797 "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.",
719 "properties": {
799 "properties": {
720 "errorCode": {
800 "errorCode": {
721 "type": "string",
801 "type": "string",
722− "description": "The error condition this handler applies to.",
802+ "description": "Error condition this handler applies to.",
723 "enum": [
803 "enum": [
724 "ERROR_CODE_UNSPECIFIED",
804 "ERROR_CODE_UNSPECIFIED",
725 "ERROR_CODE_DEFAULT",
805 "ERROR_CODE_DEFAULT",
@@ -734,33 +814,33 @@
734 },
814 },
735 "mimeType": {
815 "mimeType": {
736 "type": "string",
816 "type": "string",
737− "description": "MIME type of file. If unspecified, \"text/html\" is assumed."
817+ "description": "MIME type of file. Defaults to `text/html`."
738 }
818 }
739 }
819 }
740 },
820 },
741 "Library": {
821 "Library": {
742 "id": "Library",
822 "id": "Library",
743 "type": "object",
823 "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.",
745 "properties": {
825 "properties": {
746 "name": {
826 "name": {
747 "type": "string",
827 "type": "string",
748− "description": "The name of the library, e.g. \"PIL\" or \"django\"."
828+ "description": "Name of the library. Example: \"django\"."
749 },
829 },
750 "version": {
830 "version": {
751 "type": "string",
831 "type": "string",
752− "description": "The version of the library to select, or \"latest\"."
832+ "description": "Version of the library to select, or \"latest\"."
753 }
833 }
754 }
834 }
755 },
835 },
756 "ApiConfigHandler": {
836 "ApiConfigHandler": {
757 "id": "ApiConfigHandler",
837 "id": "ApiConfigHandler",
758 "type": "object",
838 "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.",
760 "properties": {
840 "properties": {
761 "authFailAction": {
841 "authFailAction": {
762 "type": "string",
842 "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`.",
764 "enum": [
844 "enum": [
765 "AUTH_FAIL_ACTION_UNSPECIFIED",
845 "AUTH_FAIL_ACTION_UNSPECIFIED",
766 "AUTH_FAIL_ACTION_REDIRECT",
846 "AUTH_FAIL_ACTION_REDIRECT",
@@ -769,7 +849,7 @@
769 },
849 },
770 "login": {
850 "login": {
771 "type": "string",
851 "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`.",
773 "enum": [
853 "enum": [
774 "LOGIN_UNSPECIFIED",
854 "LOGIN_UNSPECIFIED",
775 "LOGIN_OPTIONAL",
855 "LOGIN_OPTIONAL",
@@ -779,11 +859,11 @@
779 },
859 },
780 "script": {
860 "script": {
781 "type": "string",
861 "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."
783 },
863 },
784 "securityLevel": {
864 "securityLevel": {
785 "type": "string",
865 "type": "string",
786− "description": "Configures whether security (HTTPS) should be enforced for this URL.",
866+ "description": "Security (HTTPS) enforcement for this URL.",
787 "enum": [
867 "enum": [
788 "SECURE_UNSPECIFIED",
868 "SECURE_UNSPECIFIED",
789 "SECURE_DEFAULT",
869 "SECURE_DEFAULT",
@@ -801,7 +881,7 @@
801 "HealthCheck": {
881 "HealthCheck": {
802 "id": "HealthCheck",
882 "id": "HealthCheck",
803 "type": "object",
883 "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.",
805 "properties": {
885 "properties": {
806 "disableHealthCheck": {
886 "disableHealthCheck": {
807 "type": "boolean",
887 "type": "boolean",
@@ -809,30 +889,30 @@
809 },
889 },
810 "host": {
890 "host": {
811 "type": "string",
891 "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\""
813 },
893 },
814 "healthyThreshold": {
894 "healthyThreshold": {
815 "type": "integer",
895 "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.",
817 "format": "uint32"
897 "format": "uint32"
818 },
898 },
819 "unhealthyThreshold": {
899 "unhealthyThreshold": {
820 "type": "integer",
900 "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.",
822 "format": "uint32"
902 "format": "uint32"
823 },
903 },
824 "restartThreshold": {
904 "restartThreshold": {
825 "type": "integer",
905 "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.",
827 "format": "uint32"
907 "format": "uint32"
828 },
908 },
829 "checkInterval": {
909 "checkInterval": {
830 "type": "string",
910 "type": "string",
831− "description": "The interval between health checks."
911+ "description": "Interval between health checks."
832 },
912 },
833 "timeout": {
913 "timeout": {
834 "type": "string",
914 "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."
836 }
916 }
837 }
917 }
838 },
918 },
@@ -843,18 +923,18 @@
843 "properties": {
923 "properties": {
844 "files": {
924 "files": {
845 "type": "object",
925 "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.",
847 "additionalProperties": {
927 "additionalProperties": {
848 "$ref": "FileInfo"
928 "$ref": "FileInfo"
849 }
929 }
850 },
930 },
851 "container": {
931 "container": {
852 "$ref": "ContainerInfo",
932 "$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."
854 },
934 },
855 "sourceReferences": {
935 "sourceReferences": {
856 "type": "array",
936 "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.",
858 "items": {
938 "items": {
859 "$ref": "SourceReference"
939 "$ref": "SourceReference"
860 }
940 }
@@ -864,107 +944,45 @@
864 "FileInfo": {
944 "FileInfo": {
865 "id": "FileInfo",
945 "id": "FileInfo",
866 "type": "object",
946 "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.",
868 "properties": {
948 "properties": {
869 "sourceUrl": {
949 "sourceUrl": {
870 "type": "string",
950 "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/\\/\\'."
872 },
952 },
873 "sha1Sum": {
953 "sha1Sum": {
874 "type": "string",
954 "type": "string",
875− "description": "The SHA1 (160 bits) hash of the file in hex."
955+ "description": "The SHA1 hash of the file, in hex."
876 },
956 },
877 "mimeType": {
957 "mimeType": {
878 "type": "string",
958 "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."
880 }
960 }
881 }
961 }
882 },
962 },
883 "ContainerInfo": {
963 "ContainerInfo": {
884 "id": "ContainerInfo",
964 "id": "ContainerInfo",
885 "type": "object",
965 "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.",
887 "properties": {
967 "properties": {
888 "image": {
968 "image": {
889 "type": "string",
969 "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\""
891 }
971 }
892 }
972 }
893 },
973 },
894 "SourceReference": {
974 "SourceReference": {
895 "id": "SourceReference",
975 "id": "SourceReference",
896 "type": "object",
976 "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.",
898 "properties": {
978 "properties": {
899 "repository": {
979 "repository": {
900 "type": "string",
980 "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\""
902 },
982 },
903 "revisionId": {
983 "revisionId": {
904 "type": "string",
984 "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\""
985+ "description": "The canonical, persistent identifier of the deployed revision. Aliases that include 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− }
968 }
986 }
969 }
987 }
970 },
988 },
@@ -975,7 +993,7 @@
975 "properties": {
993 "properties": {
976 "versions": {
994 "versions": {
977 "type": "array",
995 "type": "array",
978− "description": "The versions belonging to the requested application module.",
996+ "description": "The versions belonging to the requested module.",
979 "items": {
997 "items": {
980 "$ref": "Version"
998 "$ref": "Version"
981 }
999 }
@@ -989,30 +1007,30 @@
989 "Module": {
1007 "Module": {
990 "id": "Module",
1008 "id": "Module",
991 "type": "object",
1009 "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.",
993 "properties": {
1011 "properties": {
994 "name": {
1012 "name": {
995 "type": "string",
1013 "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"
997 },
1015 },
998 "id": {
1016 "id": {
999 "type": "string",
1017 "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"
1001 },
1019 },
1002 "split": {
1020 "split": {
1003 "$ref": "TrafficSplit",
1021 "$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."
1005 }
1023 }
1006 }
1024 }
1007 },
1025 },
1008 "TrafficSplit": {
1026 "TrafficSplit": {
1009 "id": "TrafficSplit",
1027 "id": "TrafficSplit",
1010 "type": "object",
1028 "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.",
1012 "properties": {
1030 "properties": {
1013 "shardBy": {
1031 "shardBy": {
1014 "type": "string",
1032 "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.",
1016 "enum": [
1034 "enum": [
1017 "UNSPECIFIED",
1035 "UNSPECIFIED",
1018 "COOKIE",
1036 "COOKIE",
@@ -1021,7 +1039,7 @@
1021 },
1039 },
1022 "allocations": {
1040 "allocations": {
1023 "type": "object",
1041 "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.",
1025 "additionalProperties": {
1043 "additionalProperties": {
1026 "type": "number",
1044 "type": "number",
1027 "format": "double"
1045 "format": "double"
@@ -1047,44 +1065,26 @@
1047 }
1065 }
1048 }
1066 }
1049 },
1067 },
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− },
1068 "Instance": {
1068 "Instance": {
1069 "id": "Instance",
1069 "id": "Instance",
1070 "type": "object",
1070 "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.",
1072 "properties": {
1072 "properties": {
1073 "name": {
1073 "name": {
1074 "type": "string",
1074 "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"
1076 },
1076 },
1077 "id": {
1077 "id": {
1078 "type": "string",
1078 "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"
1080 },
1080 },
1081 "appEngineRelease": {
1081 "appEngineRelease": {
1082 "type": "string",
1082 "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"
1084 },
1084 },
1085 "availability": {
1085 "availability": {
1086 "type": "string",
1086 "type": "string",
1087− "description": "Availability of instance. @OutputOnly",
1087+ "description": "Availability of the instance. @OutputOnly",
1088 "enum": [
1088 "enum": [
1089 "UNSPECIFIED",
1089 "UNSPECIFIED",
1090 "RESIDENT",
1090 "RESIDENT",
@@ -1093,65 +1093,88 @@
1093 },
1093 },
1094 "vmName": {
1094 "vmName": {
1095 "type": "string",
1095 "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"
1097 },
1097 },
1098 "vmZoneName": {
1098 "vmZoneName": {
1099 "type": "string",
1099 "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"
1101 },
1101 },
1102 "vmId": {
1102 "vmId": {
1103 "type": "string",
1103 "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"
1105 },
1105 },
1106 "startTimestamp": {
1106 "startTimestamp": {
1107 "type": "string",
1107 "type": "string",
1108− "description": "Time when instance was started. @OutputOnly"
1108+ "description": "Time that this instance was started. @OutputOnly"
1109 },
1109 },
1110 "requests": {
1110 "requests": {
1111 "type": "integer",
1111 "type": "integer",
1112− "description": "Number of requests (since the clone was started). @OutputOnly",
1112+ "description": "Number of requests since this instance was started. @OutputOnly",
1113 "format": "int32"
1113 "format": "int32"
1114 },
1114 },
1115 "errors": {
1115 "errors": {
1116 "type": "integer",
1116 "type": "integer",
1117− "description": "Number of errors since the instance was started. @OutputOnly",
1117+ "description": "Number of errors since this instance was started. @OutputOnly",
1118 "format": "uint32"
1118 "format": "uint32"
1119 },
1119 },
1120 "qps": {
1120 "qps": {
1121 "type": "number",
1121 "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",
1123 "format": "float"
1123 "format": "float"
1124 },
1124 },
1125 "averageLatency": {
1125 "averageLatency": {
1126 "type": "integer",
1126 "type": "integer",
1127− "description": "Latency in milliseconds (averaged over the last minute). @OutputOnly",
1127+ "description": "Average latency (ms) over the last minute. @OutputOnly",
1128 "format": "int32"
1128 "format": "int32"
1129 },
1129 },
1130 "memoryUsage": {
1130 "memoryUsage": {
1131 "type": "string",
1131 "type": "string",
1132− "description": "Memory usage (in bytes). @OutputOnly",
1132+ "description": "Total memory in use (bytes). @OutputOnly",
1133 "format": "int64"
1133 "format": "int64"
1134 },
1134 },
1135 "vmStatus": {
1135 "vmStatus": {
1136 "type": "string",
1136 "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"
1138 },
1138 },
1139 "vmUnlocked": {
1139 "vmUnlocked": {
1140 "type": "boolean",
1140 "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"
1142 }
1142 }
1143 }
1143 }
1144 },
1144 },
1145− "ListOperationsResponse": {
1145+ "ListInstancesResponse": {
1146− "id": "ListOperationsResponse",
1146+ "id": "ListInstancesResponse",
1147 "type": "object",
1147 "type": "object",
1148− "description": "The response message for Operations.ListOperations.",
1148+ "description": "Response message for `Instances.ListInstances`.",
1149 "properties": {
1149 "properties": {
1150− "operations": {
1150+ "instances": {
1151 "type": "array",
1151 "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.",
1153 "items": {
1153 "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"
1155 }
1178 }
1156 },
1179 },
1157 "nextPageToken": {
1180 "nextPageToken": {
@@ -1160,6 +1183,36 @@
1160 }
1183 }
1161 }
1184 }
1162 },
1185 },
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+ },
1163 "OperationMetadata": {
1216 "OperationMetadata": {
1164 "id": "OperationMetadata",
1217 "id": "OperationMetadata",
1165 "type": "object",
1218 "type": "object",
@@ -1167,27 +1220,27 @@
1167 "properties": {
1220 "properties": {
1168 "operationType": {
1221 "operationType": {
1169 "type": "string",
1222 "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"
1171 },
1224 },
1172 "insertTime": {
1225 "insertTime": {
1173 "type": "string",
1226 "type": "string",
1174− "description": "Timestamp that this operation was received. @OutputOnly"
1227+ "description": "Timestamp that this operation was created. @OutputOnly"
1175 },
1228 },
1176 "endTime": {
1229 "endTime": {
1177 "type": "string",
1230 "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"
1179 },
1232 },
1180 "user": {
1233 "user": {
1181 "type": "string",
1234 "type": "string",
1182− "description": "The user who requested this operation. @OutputOnly"
1235+ "description": "User who requested this operation. @OutputOnly"
1183 },
1236 },
1184 "target": {
1237 "target": {
1185 "type": "string",
1238 "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"
1187 },
1240 },
1188 "method": {
1241 "method": {
1189 "type": "string",
1242 "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"
1191 }
1244 }
1192 }
1245 }
1193 },
1246 },
@@ -1198,23 +1251,65 @@
1198 "properties": {
1251 "properties": {
1199 "method": {
1252 "method": {
1200 "type": "string",
1253 "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"
1202 },
1255 },
1203 "insertTime": {
1256 "insertTime": {
1204 "type": "string",
1257 "type": "string",
1205− "description": "Timestamp that this operation was received. @OutputOnly"
1258+ "description": "Timestamp that this operation was created. @OutputOnly"
1206 },
1259 },
1207 "endTime": {
1260 "endTime": {
1208 "type": "string",
1261 "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"
1210 },
1263 },
1211 "user": {
1264 "user": {
1212 "type": "string",
1265 "type": "string",
1213− "description": "The user who requested this operation. @OutputOnly"
1266+ "description": "User who requested this operation. @OutputOnly"
1214 },
1267 },
1215 "target": {
1268 "target": {
1216 "type": "string",
1269 "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"
1218 }
1313 }
1219 }
1314 }
1220 }
1315 }
@@ -1222,6 +1317,21 @@
1222 "resources": {
1317 "resources": {
1223 "apps": {
1318 "apps": {
1224 "methods": {
1319 "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+ },
1225 "get": {
1335 "get": {
1226 "id": "appengine.apps.get",
1336 "id": "appengine.apps.get",
1227 "path": "v1beta4/apps/{appsId}",
1337 "path": "v1beta4/apps/{appsId}",
@@ -1230,7 +1340,7 @@
1230 "parameters": {
1340 "parameters": {
1231 "appsId": {
1341 "appsId": {
1232 "type": "string",
1342 "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`.",
1234 "required": true,
1344 "required": true,
1235 "location": "path"
1345 "location": "path"
1236 },
1346 },
@@ -1249,20 +1359,124 @@
1249 "scopes": [
1359 "scopes": [
1250 "https://www.googleapis.com/auth/cloud-platform"
1360 "https://www.googleapis.com/auth/cloud-platform"
1251 ]
1361 ]
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+ ]
1252 }
1393 }
1253 },
1394 },
1254 "resources": {
1395 "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+ },
1255 "modules": {
1469 "modules": {
1256 "methods": {
1470 "methods": {
1257 "delete": {
1471 "delete": {
1258 "id": "appengine.apps.modules.delete",
1472 "id": "appengine.apps.modules.delete",
1259 "path": "v1beta4/apps/{appsId}/modules/{modulesId}",
1473 "path": "v1beta4/apps/{appsId}/modules/{modulesId}",
1260 "httpMethod": "DELETE",
1474 "httpMethod": "DELETE",
1261− "description": "Deletes a module and all enclosed versions.",
1475+ "description": "Deletes the specified module and all enclosed versions.",
1262 "parameters": {
1476 "parameters": {
1263 "appsId": {
1477 "appsId": {
1264 "type": "string",
1478 "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`.",
1266 "required": true,
1480 "required": true,
1267 "location": "path"
1481 "location": "path"
1268 },
1482 },
@@ -1288,11 +1502,11 @@
1288 "id": "appengine.apps.modules.get",
1502 "id": "appengine.apps.modules.get",
1289 "path": "v1beta4/apps/{appsId}/modules/{modulesId}",
1503 "path": "v1beta4/apps/{appsId}/modules/{modulesId}",
1290 "httpMethod": "GET",
1504 "httpMethod": "GET",
1291− "description": "Gets the current configuration of the module.",
1505+ "description": "Gets the current configuration of the specified module.",
1292 "parameters": {
1506 "parameters": {
1293 "appsId": {
1507 "appsId": {
1294 "type": "string",
1508 "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`.",
1296 "required": true,
1510 "required": true,
1297 "location": "path"
1511 "location": "path"
1298 },
1512 },
@@ -1322,7 +1536,7 @@
1322 "parameters": {
1536 "parameters": {
1323 "appsId": {
1537 "appsId": {
1324 "type": "string",
1538 "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`.",
1326 "required": true,
1540 "required": true,
1327 "location": "path"
1541 "location": "path"
1328 },
1542 },
@@ -1356,7 +1570,7 @@
1356 "parameters": {
1570 "parameters": {
1357 "appsId": {
1571 "appsId": {
1358 "type": "string",
1572 "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`.",
1360 "required": true,
1574 "required": true,
1361 "location": "path"
1575 "location": "path"
1362 },
1576 },
@@ -1373,7 +1587,7 @@
1373 },
1587 },
1374 "migrateTraffic": {
1588 "migrateTraffic": {
1375 "type": "boolean",
1589 "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).",
1377 "location": "query"
1591 "location": "query"
1378 }
1592 }
1379 },
1593 },
@@ -1399,11 +1613,11 @@
1399 "id": "appengine.apps.modules.versions.create",
1613 "id": "appengine.apps.modules.versions.create",
1400 "path": "v1beta4/apps/{appsId}/modules/{modulesId}/versions",
1614 "path": "v1beta4/apps/{appsId}/modules/{modulesId}/versions",
1401 "httpMethod": "POST",
1615 "httpMethod": "POST",
1402− "description": "Deploys new code and resource files to a version.",
1616+ "description": "Deploys code and resource files to a new version.",
1403 "parameters": {
1617 "parameters": {
1404 "appsId": {
1618 "appsId": {
1405 "type": "string",
1619 "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`.",
1407 "required": true,
1621 "required": true,
1408 "location": "path"
1622 "location": "path"
1409 },
1623 },
@@ -1436,7 +1650,7 @@
1436 "parameters": {
1650 "parameters": {
1437 "appsId": {
1651 "appsId": {
1438 "type": "string",
1652 "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`.",
1440 "required": true,
1654 "required": true,
1441 "location": "path"
1655 "location": "path"
1442 },
1656 },
@@ -1469,11 +1683,11 @@
1469 "id": "appengine.apps.modules.versions.get",
1683 "id": "appengine.apps.modules.versions.get",
1470 "path": "v1beta4/apps/{appsId}/modules/{modulesId}/versions/{versionsId}",
1684 "path": "v1beta4/apps/{appsId}/modules/{modulesId}/versions/{versionsId}",
1471 "httpMethod": "GET",
1685 "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.",
1473 "parameters": {
1687 "parameters": {
1474 "appsId": {
1688 "appsId": {
1475 "type": "string",
1689 "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`.",
1477 "required": true,
1691 "required": true,
1478 "location": "path"
1692 "location": "path"
1479 },
1693 },
@@ -1519,7 +1733,7 @@
1519 "parameters": {
1733 "parameters": {
1520 "appsId": {
1734 "appsId": {
1521 "type": "string",
1735 "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`.",
1523 "required": true,
1737 "required": true,
1524 "location": "path"
1738 "location": "path"
1525 },
1739 },
@@ -1565,11 +1779,11 @@
1565 "id": "appengine.apps.modules.versions.patch",
1779 "id": "appengine.apps.modules.versions.patch",
1566 "path": "v1beta4/apps/{appsId}/modules/{modulesId}/versions/{versionsId}",
1780 "path": "v1beta4/apps/{appsId}/modules/{modulesId}/versions/{versionsId}",
1567 "httpMethod": "PATCH",
1781 "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.",
1569 "parameters": {
1783 "parameters": {
1570 "appsId": {
1784 "appsId": {
1571 "type": "string",
1785 "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`.",
1573 "required": true,
1787 "required": true,
1574 "location": "path"
1788 "location": "path"
1575 },
1789 },
@@ -1610,6 +1824,94 @@
1610 "resources": {
1824 "resources": {
1611 "instances": {
1825 "instances": {
1612 "methods": {
1826 "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+ },
1613 "list": {
1915 "list": {
1614 "id": "appengine.apps.modules.versions.instances.list",
1916 "id": "appengine.apps.modules.versions.instances.list",
1615 "path": "v1beta4/apps/{appsId}/modules/{modulesId}/versions/{versionsId}/instances",
1917 "path": "v1beta4/apps/{appsId}/modules/{modulesId}/versions/{versionsId}/instances",
@@ -1618,7 +1920,7 @@
1618 "parameters": {
1920 "parameters": {
1619 "appsId": {
1921 "appsId": {
1620 "type": "string",
1922 "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`.",
1622 "required": true,
1924 "required": true,
1623 "location": "path"
1925 "location": "path"
1624 },
1926 },
@@ -1657,6 +1959,53 @@
1657 "scopes": [
1959 "scopes": [
1658 "https://www.googleapis.com/auth/cloud-platform"
1960 "https://www.googleapis.com/auth/cloud-platform"
1659 ]
1961 ]
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+ ]
1660 }
2009 }
1661 }
2010 }
1662 }
2011 }
@@ -1664,72 +2013,72 @@
1664 }
2013 }
1665 }
2014 }
1666 },
2015 },
1667− "operations": {
2016+ "locations": {
1668 "methods": {
2017 "methods": {
1669− "get": {
2018+ "list": {
1670− "id": "appengine.apps.operations.get",
2019+ "id": "appengine.apps.locations.list",
1671− "path": "v1beta4/apps/{appsId}/operations/{operationsId}",
2020+ "path": "v1beta4/apps/{appsId}/locations",
1672 "httpMethod": "GET",
2021 "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.",
1674 "parameters": {
2023 "parameters": {
1675 "appsId": {
2024 "appsId": {
1676 "type": "string",
2025 "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.",
1678 "required": true,
2027 "required": true,
1679 "location": "path"
2028 "location": "path"
1680 },
2029 },
1681− "operationsId": {
2030+ "filter": {
1682 "type": "string",
2031 "type": "string",
1683− "description": "Part of `name`. See documentation of `appsId`.",
2032+ "description": "The standard list filter.",
1684− "required": true,
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.",
1685− "location": "path"
2044+ "location": "query"
1686 }
2045 }
1687 },
2046 },
1688 "parameterOrder": [
2047 "parameterOrder": [
1689− "appsId",
2048+ "appsId"
1690− "operationsId"
1691 ],
2049 ],
1692 "response": {
2050 "response": {
1693− "$ref": "Operation"
2051+ "$ref": "ListLocationsResponse"
1694 },
2052 },
1695 "scopes": [
2053 "scopes": [
1696 "https://www.googleapis.com/auth/cloud-platform"
2054 "https://www.googleapis.com/auth/cloud-platform"
1697 ]
2055 ]
1698 },
2056 },
1699− "list": {
2057+ "get": {
1700− "id": "appengine.apps.operations.list",
2058+ "id": "appengine.apps.locations.get",
1701− "path": "v1beta4/apps/{appsId}/operations",
2059+ "path": "v1beta4/apps/{appsId}/locations/{locationsId}",
1702 "httpMethod": "GET",
2060 "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.",
1704 "parameters": {
2062 "parameters": {
1705 "appsId": {
2063 "appsId": {
1706 "type": "string",
2064 "type": "string",
1707− "description": "Part of `name`. The name of the operation collection.",
2065+ "description": "Part of `name`. Resource name for the location.",
1708 "required": true,
2066 "required": true,
1709 "location": "path"
2067 "location": "path"
1710 },
2068 },
1711− "filter": {
2069+ "locationsId": {
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": {
1723 "type": "string",
2070 "type": "string",
1724− "description": "The standard list page token.",
2071+ "description": "Part of `name`. See documentation of `appsId`.",
2072+ "required": true,
1725− "location": "query"
2073+ "location": "path"
1726 }
2074 }
1727 },
2075 },
1728 "parameterOrder": [
2076 "parameterOrder": [
1729− "appsId"
2077+ "appsId",
2078+ "locationsId"
1730 ],
2079 ],
1731 "response": {
2080 "response": {
1732− "$ref": "ListOperationsResponse"
2081+ "$ref": "Location"
1733 },
2082 },
1734 "scopes": [
2083 "scopes": [
1735 "https://www.googleapis.com/auth/cloud-platform"
2084 "https://www.googleapis.com/auth/cloud-platform"
gen/model/appengine/v1beta5/appengine-api.json+541−192
@@ -1,11 +1,11 @@
1{
1{
2 "kind": "discovery#restDescription",
2 "kind": "discovery#restDescription",
3− "etag": "\"jQLIOHBVnDZie4rQHGH1WJF-INE/uGRAIMczbUMx-blIXv0SXiGStRQ\"",
3+ "etag": "\"C5oy1hgQsABtYOYIOXWcR3BgYqU/0qciQsoN0Vvlij82hTLNL1WfFOU\"",
4 "discoveryVersion": "v1",
4 "discoveryVersion": "v1",
5 "id": "appengine:v1beta5",
5 "id": "appengine:v1beta5",
6 "name": "appengine",
6 "name": "appengine",
7 "version": "v1beta5",
7 "version": "v1beta5",
8− "revision": "20160407",
8+ "revision": "20161012",
9 "title": "Google App Engine Admin API",
9 "title": "Google App Engine Admin API",
10 "description": "Provisions and manages App Engine applications.",
10 "description": "Provisions and manages App Engine applications.",
11 "ownerDomain": "google.com",
11 "ownerDomain": "google.com",
@@ -124,7 +124,7 @@
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.",
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": {
125 "additionalProperties": {
126 "type": "any",
126 "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."
128 }
128 }
129 },
129 },
130 "done": {
130 "done": {
@@ -140,7 +140,7 @@
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`.",
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": {
141 "additionalProperties": {
142 "type": "any",
142 "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."
144 }
144 }
145 }
145 }
146 }
146 }
@@ -166,7 +166,7 @@
166 "type": "object",
166 "type": "object",
167 "additionalProperties": {
167 "additionalProperties": {
168 "type": "any",
168 "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."
170 }
170 }
171 }
171 }
172 }
172 }
@@ -193,46 +193,46 @@
193 "Application": {
193 "Application": {
194 "id": "Application",
194 "id": "Application",
195 "type": "object",
195 "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.",
197 "properties": {
197 "properties": {
198 "name": {
198 "name": {
199 "type": "string",
199 "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"
201 },
201 },
202 "id": {
202 "id": {
203 "type": "string",
203 "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`."
205 },
205 },
206 "dispatchRules": {
206 "dispatchRules": {
207 "type": "array",
207 "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",
209 "items": {
209 "items": {
210 "$ref": "UrlDispatchRule"
210 "$ref": "UrlDispatchRule"
211 }
211 }
212 },
212 },
213 "authDomain": {
213 "authDomain": {
214 "type": "string",
214 "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."
216 },
216 },
217 "location": {
217 "location": {
218 "type": "string",
218 "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"
220 },
220 },
221 "codeBucket": {
221 "codeBucket": {
222 "type": "string",
222 "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"
224 },
224 },
225 "defaultCookieExpiration": {
225 "defaultCookieExpiration": {
226 "type": "string",
226 "type": "string",
227− "description": "Determines the cookie expiration policy for the application. @OutputOnly"
227+ "description": "Cookie expiration policy for this application. @OutputOnly"
228 },
228 },
229 "defaultHostname": {
229 "defaultHostname": {
230 "type": "string",
230 "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"
232 },
232 },
233 "defaultBucket": {
233 "defaultBucket": {
234 "type": "string",
234 "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"
236 }
236 }
237 }
237 }
238 },
238 },
@@ -243,34 +243,34 @@
243 "properties": {
243 "properties": {
244 "domain": {
244 "domain": {
245 "type": "string",
245 "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: \"`*`\"."
247 },
247 },
248 "path": {
248 "path": {
249 "type": "string",
249 "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."
251 },
251 },
252 "service": {
252 "service": {
253 "type": "string",
253 "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`."
255 }
255 }
256 }
256 }
257 },
257 },
258 "Version": {
258 "Version": {
259 "id": "Version",
259 "id": "Version",
260 "type": "object",
260 "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.",
262 "properties": {
262 "properties": {
263 "name": {
263 "name": {
264 "type": "string",
264 "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"
266 },
266 },
267 "id": {
267 "id": {
268 "type": "string",
268 "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-\"."
270 },
270 },
271 "automaticScaling": {
271 "automaticScaling": {
272 "$ref": "AutomaticScaling",
272 "$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."
274 },
274 },
275 "basicScaling": {
275 "basicScaling": {
276 "$ref": "BasicScaling",
276 "$ref": "BasicScaling",
@@ -286,7 +286,7 @@
286 "enumDescriptions": [
286 "enumDescriptions": [
287 "Not specified.",
287 "Not specified.",
288 "Allows an application to receive mail.",
288 "Allows an application to receive mail.",
289− "Allows an application receive email bound notifications.",
289+ "Allows an application to receive email-bound notifications.",
290 "Allows an application to receive error stanzas.",
290 "Allows an application to receive error stanzas.",
291 "Allows an application to receive instant messages.",
291 "Allows an application to receive instant messages.",
292 "Allows an application to receive user subscription POSTs.",
292 "Allows an application to receive user subscription POSTs.",
@@ -311,42 +311,42 @@
311 },
311 },
312 "instanceClass": {
312 "instanceClass": {
313 "type": "string",
313 "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."
315 },
315 },
316 "network": {
316 "network": {
317 "$ref": "Network",
317 "$ref": "Network",
318− "description": "Used to specify extra network settings (for VM runtimes only)."
318+ "description": "Extra network settings. Only applicable for VM runtimes."
319 },
319 },
320 "resources": {
320 "resources": {
321 "$ref": "Resources",
321 "$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."
323 },
323 },
324 "runtime": {
324 "runtime": {
325 "type": "string",
325 "type": "string",
326− "description": "The desired runtime. Values can include python27, java7, go, etc."
326+ "description": "Desired runtime. Example: `python27`."
327 },
327 },
328 "threadsafe": {
328 "threadsafe": {
329 "type": "boolean",
329 "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."
331 },
331 },
332 "vm": {
332 "vm": {
333 "type": "boolean",
333 "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."
335 },
335 },
336 "betaSettings": {
336 "betaSettings": {
337 "type": "object",
337 "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.",
339 "additionalProperties": {
339 "additionalProperties": {
340 "type": "string"
340 "type": "string"
341 }
341 }
342 },
342 },
343 "env": {
343 "env": {
344 "type": "string",
344 "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`."
346 },
346 },
347 "servingStatus": {
347 "servingStatus": {
348 "type": "string",
348 "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`.",
350 "enum": [
350 "enum": [
351 "SERVING_STATUS_UNSPECIFIED",
351 "SERVING_STATUS_UNSPECIFIED",
352 "SERVING",
352 "SERVING",
@@ -355,11 +355,11 @@
355 },
355 },
356 "deployer": {
356 "deployer": {
357 "type": "string",
357 "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"
359 },
359 },
360 "creationTime": {
360 "creationTime": {
361 "type": "string",
361 "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"
363 },
363 },
364 "diskUsageBytes": {
364 "diskUsageBytes": {
365 "type": "string",
365 "type": "string",
@@ -368,62 +368,62 @@
368 },
368 },
369 "handlers": {
369 "handlers": {
370 "type": "array",
370 "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.",
372 "items": {
372 "items": {
373 "$ref": "UrlMap"
373 "$ref": "UrlMap"
374 }
374 }
375 },
375 },
376 "errorHandlers": {
376 "errorHandlers": {
377 "type": "array",
377 "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.",
379 "items": {
379 "items": {
380 "$ref": "ErrorHandler"
380 "$ref": "ErrorHandler"
381 }
381 }
382 },
382 },
383 "libraries": {
383 "libraries": {
384 "type": "array",
384 "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.",
386 "items": {
386 "items": {
387 "$ref": "Library"
387 "$ref": "Library"
388 }
388 }
389 },
389 },
390 "apiConfig": {
390 "apiConfig": {
391 "$ref": "ApiConfigHandler",
391 "$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."
393 },
393 },
394 "envVariables": {
394 "envVariables": {
395 "type": "object",
395 "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.",
397 "additionalProperties": {
397 "additionalProperties": {
398 "type": "string"
398 "type": "string"
399 }
399 }
400 },
400 },
401 "defaultExpiration": {
401 "defaultExpiration": {
402 "type": "string",
402 "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."
404 },
404 },
405 "healthCheck": {
405 "healthCheck": {
406 "$ref": "HealthCheck",
406 "$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."
408 },
408 },
409 "nobuildFilesRegex": {
409 "nobuildFilesRegex": {
410 "type": "string",
410 "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."
412 },
412 },
413 "deployment": {
413 "deployment": {
414 "$ref": "Deployment",
414 "$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."
416 }
416 }
417 }
417 }
418 },
418 },
419 "AutomaticScaling": {
419 "AutomaticScaling": {
420 "id": "AutomaticScaling",
420 "id": "AutomaticScaling",
421 "type": "object",
421 "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.",
423 "properties": {
423 "properties": {
424 "coolDownPeriod": {
424 "coolDownPeriod": {
425 "type": "string",
425 "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."
427 },
427 },
428 "cpuUtilization": {
428 "cpuUtilization": {
429 "$ref": "CpuUtilization",
429 "$ref": "CpuUtilization",
@@ -431,36 +431,36 @@
431 },
431 },
432 "maxConcurrentRequests": {
432 "maxConcurrentRequests": {
433 "type": "integer",
433 "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.",
435 "format": "int32"
435 "format": "int32"
436 },
436 },
437 "maxIdleInstances": {
437 "maxIdleInstances": {
438 "type": "integer",
438 "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.",
440 "format": "int32"
440 "format": "int32"
441 },
441 },
442 "maxTotalInstances": {
442 "maxTotalInstances": {
443 "type": "integer",
443 "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.",
445 "format": "int32"
445 "format": "int32"
446 },
446 },
447 "maxPendingLatency": {
447 "maxPendingLatency": {
448 "type": "string",
448 "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."
450 },
450 },
451 "minIdleInstances": {
451 "minIdleInstances": {
452 "type": "integer",
452 "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.",
454 "format": "int32"
454 "format": "int32"
455 },
455 },
456 "minTotalInstances": {
456 "minTotalInstances": {
457 "type": "integer",
457 "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.",
459 "format": "int32"
459 "format": "int32"
460 },
460 },
461 "minPendingLatency": {
461 "minPendingLatency": {
462 "type": "string",
462 "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."
464 },
464 },
465 "requestUtilization": {
465 "requestUtilization": {
466 "$ref": "RequestUtilization",
466 "$ref": "RequestUtilization",
@@ -483,11 +483,11 @@
483 "properties": {
483 "properties": {
484 "aggregationWindowLength": {
484 "aggregationWindowLength": {
485 "type": "string",
485 "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."
487 },
487 },
488 "targetUtilization": {
488 "targetUtilization": {
489 "type": "number",
489 "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.",
491 "format": "double"
491 "format": "double"
492 }
492 }
493 }
493 }
@@ -495,7 +495,7 @@
495 "RequestUtilization": {
495 "RequestUtilization": {
496 "id": "RequestUtilization",
496 "id": "RequestUtilization",
497 "type": "object",
497 "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.",
499 "properties": {
499 "properties": {
500 "targetRequestCountPerSec": {
500 "targetRequestCountPerSec": {
501 "type": "integer",
501 "type": "integer",
@@ -512,26 +512,26 @@
512 "DiskUtilization": {
512 "DiskUtilization": {
513 "id": "DiskUtilization",
513 "id": "DiskUtilization",
514 "type": "object",
514 "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.",
516 "properties": {
516 "properties": {
517 "targetWriteBytesPerSec": {
517 "targetWriteBytesPerSec": {
518 "type": "integer",
518 "type": "integer",
519− "description": "Target bytes per second written.",
519+ "description": "Target bytes written per second.",
520 "format": "int32"
520 "format": "int32"
521 },
521 },
522 "targetWriteOpsPerSec": {
522 "targetWriteOpsPerSec": {
523 "type": "integer",
523 "type": "integer",
524− "description": "Target ops per second written.",
524+ "description": "Target ops written per second.",
525 "format": "int32"
525 "format": "int32"
526 },
526 },
527 "targetReadBytesPerSec": {
527 "targetReadBytesPerSec": {
528 "type": "integer",
528 "type": "integer",
529− "description": "Target bytes per second read.",
529+ "description": "Target bytes read per second.",
530 "format": "int32"
530 "format": "int32"
531 },
531 },
532 "targetReadOpsPerSec": {
532 "targetReadOpsPerSec": {
533 "type": "integer",
533 "type": "integer",
534− "description": "Target ops per second read.",
534+ "description": "Target ops read per second.",
535 "format": "int32"
535 "format": "int32"
536 }
536 }
537 }
537 }
@@ -539,26 +539,26 @@
539 "NetworkUtilization": {
539 "NetworkUtilization": {
540 "id": "NetworkUtilization",
540 "id": "NetworkUtilization",
541 "type": "object",
541 "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.",
543 "properties": {
543 "properties": {
544 "targetSentBytesPerSec": {
544 "targetSentBytesPerSec": {
545 "type": "integer",
545 "type": "integer",
546− "description": "Target bytes per second sent.",
546+ "description": "Target bytes sent per second.",
547 "format": "int32"
547 "format": "int32"
548 },
548 },
549 "targetSentPacketsPerSec": {
549 "targetSentPacketsPerSec": {
550 "type": "integer",
550 "type": "integer",
551− "description": "Target packets per second sent.",
551+ "description": "Target packets sent per second.",
552 "format": "int32"
552 "format": "int32"
553 },
553 },
554 "targetReceivedBytesPerSec": {
554 "targetReceivedBytesPerSec": {
555 "type": "integer",
555 "type": "integer",
556− "description": "Target bytes per second received.",
556+ "description": "Target bytes received per second.",
557 "format": "int32"
557 "format": "int32"
558 },
558 },
559 "targetReceivedPacketsPerSec": {
559 "targetReceivedPacketsPerSec": {
560 "type": "integer",
560 "type": "integer",
561− "description": "Target packets per second received.",
561+ "description": "Target packets received per second.",
562 "format": "int32"
562 "format": "int32"
563 }
563 }
564 }
564 }
@@ -570,11 +570,11 @@
570 "properties": {
570 "properties": {
571 "idleTimeout": {
571 "idleTimeout": {
572 "type": "string",
572 "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."
574 },
574 },
575 "maxInstances": {
575 "maxInstances": {
576 "type": "integer",
576 "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.",
578 "format": "int32"
578 "format": "int32"
579 }
579 }
580 }
580 }
@@ -586,7 +586,7 @@
586 "properties": {
586 "properties": {
587 "instances": {
587 "instances": {
588 "type": "integer",
588 "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.",
590 "format": "int32"
590 "format": "int32"
591 }
591 }
592 }
592 }
@@ -594,43 +594,43 @@
594 "Network": {
594 "Network": {
595 "id": "Network",
595 "id": "Network",
596 "type": "object",
596 "type": "object",
597− "description": "Used to specify extra network settings (for VM runtimes only).",
597+ "description": "Extra network settings. Only applicable for VM runtimes.",
598 "properties": {
598 "properties": {
599 "forwardedPorts": {
599 "forwardedPorts": {
600 "type": "array",
600 "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.",
602 "items": {
602 "items": {
603 "type": "string"
603 "type": "string"
604 }
604 }
605 },
605 },
606 "instanceTag": {
606 "instanceTag": {
607 "type": "string",
607 "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."
609 },
609 },
610 "name": {
610 "name": {
611 "type": "string",
611 "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`."
613 }
613 }
614 }
614 }
615 },
615 },
616 "Resources": {
616 "Resources": {
617 "id": "Resources",
617 "id": "Resources",
618 "type": "object",
618 "type": "object",
619− "description": "Used to specify how many machine resources an app version needs.",
619+ "description": "Machine resources for a version.",
620 "properties": {
620 "properties": {
621 "cpu": {
621 "cpu": {
622 "type": "number",
622 "type": "number",
623− "description": "How many CPU cores an app version needs.",
623+ "description": "Number of CPU cores needed.",
624 "format": "double"
624 "format": "double"
625 },
625 },
626 "diskGb": {
626 "diskGb": {
627 "type": "number",
627 "type": "number",
628− "description": "How much disk size, in GB, an app version needs.",
628+ "description": "Disk size (GB) needed.",
629 "format": "double"
629 "format": "double"
630 },
630 },
631 "memoryGb": {
631 "memoryGb": {
632 "type": "number",
632 "type": "number",
633− "description": "How much memory, in GB, an app version needs.",
633+ "description": "Memory (GB) needed.",
634 "format": "double"
634 "format": "double"
635 }
635 }
636 }
636 }
@@ -638,11 +638,11 @@
638 "UrlMap": {
638 "UrlMap": {
639 "id": "UrlMap",
639 "id": "UrlMap",
640 "type": "object",
640 "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.",
642 "properties": {
642 "properties": {
643 "urlRegex": {
643 "urlRegex": {
644 "type": "string",
644 "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."
646 },
646 },
647 "staticFiles": {
647 "staticFiles": {
648 "$ref": "StaticFilesHandler",
648 "$ref": "StaticFilesHandler",
@@ -650,15 +650,15 @@
650 },
650 },
651 "script": {
651 "script": {
652 "$ref": "ScriptHandler",
652 "$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."
654 },
654 },
655 "apiEndpoint": {
655 "apiEndpoint": {
656 "$ref": "ApiEndpointHandler",
656 "$ref": "ApiEndpointHandler",
657− "description": "Use API Endpoints to handle requests."
657+ "description": "Uses API Endpoints to handle requests."
658 },
658 },
659 "securityLevel": {
659 "securityLevel": {
660 "type": "string",
660 "type": "string",
661− "description": "Configures whether security (HTTPS) should be enforced for this URL.",
661+ "description": "Security (HTTPS) enforcement for this URL.",
662 "enum": [
662 "enum": [
663 "SECURE_UNSPECIFIED",
663 "SECURE_UNSPECIFIED",
664 "SECURE_DEFAULT",
664 "SECURE_DEFAULT",
@@ -669,7 +669,7 @@
669 },
669 },
670 "login": {
670 "login": {
671 "type": "string",
671 "type": "string",
672− "description": "What level of login is required to access this resource.",
672+ "description": "Level of login required to access this resource.",
673 "enum": [
673 "enum": [
674 "LOGIN_UNSPECIFIED",
674 "LOGIN_UNSPECIFIED",
675 "LOGIN_OPTIONAL",
675 "LOGIN_OPTIONAL",
@@ -679,7 +679,7 @@
679 },
679 },
680 "authFailAction": {
680 "authFailAction": {
681 "type": "string",
681 "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`.",
683 "enum": [
683 "enum": [
684 "AUTH_FAIL_ACTION_UNSPECIFIED",
684 "AUTH_FAIL_ACTION_UNSPECIFIED",
685 "AUTH_FAIL_ACTION_REDIRECT",
685 "AUTH_FAIL_ACTION_REDIRECT",
@@ -688,7 +688,7 @@
688 },
688 },
689 "redirectHttpResponseCode": {
689 "redirectHttpResponseCode": {
690 "type": "string",
690 "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`.",
692 "enum": [
692 "enum": [
693 "REDIRECT_HTTP_RESPONSE_CODE_UNSPECIFIED",
693 "REDIRECT_HTTP_RESPONSE_CODE_UNSPECIFIED",
694 "REDIRECT_HTTP_RESPONSE_CODE_301",
694 "REDIRECT_HTTP_RESPONSE_CODE_301",
@@ -706,11 +706,11 @@
706 "properties": {
706 "properties": {
707 "path": {
707 "path": {
708 "type": "string",
708 "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."
710 },
710 },
711 "uploadPathRegex": {
711 "uploadPathRegex": {
712 "type": "string",
712 "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."
714 },
714 },
715 "httpHeaders": {
715 "httpHeaders": {
716 "type": "object",
716 "type": "object",
@@ -721,19 +721,19 @@
721 },
721 },
722 "mimeType": {
722 "mimeType": {
723 "type": "string",
723 "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."
725 },
725 },
726 "expiration": {
726 "expiration": {
727 "type": "string",
727 "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."
729 },
729 },
730 "requireMatchingFile": {
730 "requireMatchingFile": {
731 "type": "boolean",
731 "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."
733 },
733 },
734 "applicationReadable": {
734 "applicationReadable": {
735 "type": "boolean",
735 "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."
737 }
737 }
738 }
738 }
739 },
739 },
@@ -744,29 +744,29 @@
744 "properties": {
744 "properties": {
745 "scriptPath": {
745 "scriptPath": {
746 "type": "string",
746 "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."
748 }
748 }
749 }
749 }
750 },
750 },
751 "ApiEndpointHandler": {
751 "ApiEndpointHandler": {
752 "id": "ApiEndpointHandler",
752 "id": "ApiEndpointHandler",
753 "type": "object",
753 "type": "object",
754− "description": "Use Google Cloud Endpoints to handle requests.",
754+ "description": "Uses Google Cloud Endpoints to handle requests.",
755 "properties": {
755 "properties": {
756 "scriptPath": {
756 "scriptPath": {
757 "type": "string",
757 "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."
759 }
759 }
760 }
760 }
761 },
761 },
762 "ErrorHandler": {
762 "ErrorHandler": {
763 "id": "ErrorHandler",
763 "id": "ErrorHandler",
764 "type": "object",
764 "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.",
766 "properties": {
766 "properties": {
767 "errorCode": {
767 "errorCode": {
768 "type": "string",
768 "type": "string",
769− "description": "The error condition this handler applies to.",
769+ "description": "Error condition this handler applies to.",
770 "enum": [
770 "enum": [
771 "ERROR_CODE_UNSPECIFIED",
771 "ERROR_CODE_UNSPECIFIED",
772 "ERROR_CODE_DEFAULT",
772 "ERROR_CODE_DEFAULT",
@@ -781,33 +781,33 @@
781 },
781 },
782 "mimeType": {
782 "mimeType": {
783 "type": "string",
783 "type": "string",
784− "description": "MIME type of file. If unspecified, \"text/html\" is assumed."
784+ "description": "MIME type of file. Defaults to `text/html`."
785 }
785 }
786 }
786 }
787 },
787 },
788 "Library": {
788 "Library": {
789 "id": "Library",
789 "id": "Library",
790 "type": "object",
790 "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.",
792 "properties": {
792 "properties": {
793 "name": {
793 "name": {
794 "type": "string",
794 "type": "string",
795− "description": "The name of the library, e.g. \"PIL\" or \"django\"."
795+ "description": "Name of the library. Example: \"django\"."
796 },
796 },
797 "version": {
797 "version": {
798 "type": "string",
798 "type": "string",
799− "description": "The version of the library to select, or \"latest\"."
799+ "description": "Version of the library to select, or \"latest\"."
800 }
800 }
801 }
801 }
802 },
802 },
803 "ApiConfigHandler": {
803 "ApiConfigHandler": {
804 "id": "ApiConfigHandler",
804 "id": "ApiConfigHandler",
805 "type": "object",
805 "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.",
807 "properties": {
807 "properties": {
808 "authFailAction": {
808 "authFailAction": {
809 "type": "string",
809 "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`.",
811 "enum": [
811 "enum": [
812 "AUTH_FAIL_ACTION_UNSPECIFIED",
812 "AUTH_FAIL_ACTION_UNSPECIFIED",
813 "AUTH_FAIL_ACTION_REDIRECT",
813 "AUTH_FAIL_ACTION_REDIRECT",
@@ -816,7 +816,7 @@
816 },
816 },
817 "login": {
817 "login": {
818 "type": "string",
818 "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`.",
820 "enum": [
820 "enum": [
821 "LOGIN_UNSPECIFIED",
821 "LOGIN_UNSPECIFIED",
822 "LOGIN_OPTIONAL",
822 "LOGIN_OPTIONAL",
@@ -826,11 +826,11 @@
826 },
826 },
827 "script": {
827 "script": {
828 "type": "string",
828 "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."
830 },
830 },
831 "securityLevel": {
831 "securityLevel": {
832 "type": "string",
832 "type": "string",
833− "description": "Configures whether security (HTTPS) should be enforced for this URL.",
833+ "description": "Security (HTTPS) enforcement for this URL.",
834 "enum": [
834 "enum": [
835 "SECURE_UNSPECIFIED",
835 "SECURE_UNSPECIFIED",
836 "SECURE_DEFAULT",
836 "SECURE_DEFAULT",
@@ -848,7 +848,7 @@
848 "HealthCheck": {
848 "HealthCheck": {
849 "id": "HealthCheck",
849 "id": "HealthCheck",
850 "type": "object",
850 "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.",
852 "properties": {
852 "properties": {
853 "disableHealthCheck": {
853 "disableHealthCheck": {
854 "type": "boolean",
854 "type": "boolean",
@@ -856,30 +856,30 @@
856 },
856 },
857 "host": {
857 "host": {
858 "type": "string",
858 "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\""
860 },
860 },
861 "healthyThreshold": {
861 "healthyThreshold": {
862 "type": "integer",
862 "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.",
864 "format": "uint32"
864 "format": "uint32"
865 },
865 },
866 "unhealthyThreshold": {
866 "unhealthyThreshold": {
867 "type": "integer",
867 "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.",
869 "format": "uint32"
869 "format": "uint32"
870 },
870 },
871 "restartThreshold": {
871 "restartThreshold": {
872 "type": "integer",
872 "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.",
874 "format": "uint32"
874 "format": "uint32"
875 },
875 },
876 "checkInterval": {
876 "checkInterval": {
877 "type": "string",
877 "type": "string",
878− "description": "The interval between health checks."
878+ "description": "Interval between health checks."
879 },
879 },
880 "timeout": {
880 "timeout": {
881 "type": "string",
881 "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."
883 }
883 }
884 }
884 }
885 },
885 },
@@ -890,18 +890,18 @@
890 "properties": {
890 "properties": {
891 "files": {
891 "files": {
892 "type": "object",
892 "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.",
894 "additionalProperties": {
894 "additionalProperties": {
895 "$ref": "FileInfo"
895 "$ref": "FileInfo"
896 }
896 }
897 },
897 },
898 "container": {
898 "container": {
899 "$ref": "ContainerInfo",
899 "$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."
901 },
901 },
902 "sourceReferences": {
902 "sourceReferences": {
903 "type": "array",
903 "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.",
905 "items": {
905 "items": {
906 "$ref": "SourceReference"
906 "$ref": "SourceReference"
907 }
907 }
@@ -911,45 +911,45 @@
911 "FileInfo": {
911 "FileInfo": {
912 "id": "FileInfo",
912 "id": "FileInfo",
913 "type": "object",
913 "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.",
915 "properties": {
915 "properties": {
916 "sourceUrl": {
916 "sourceUrl": {
917 "type": "string",
917 "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/\\/\\'."
919 },
919 },
920 "sha1Sum": {
920 "sha1Sum": {
921 "type": "string",
921 "type": "string",
922− "description": "The SHA1 (160 bits) hash of the file in hex."
922+ "description": "The SHA1 hash of the file, in hex."
923 },
923 },
924 "mimeType": {
924 "mimeType": {
925 "type": "string",
925 "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."
927 }
927 }
928 }
928 }
929 },
929 },
930 "ContainerInfo": {
930 "ContainerInfo": {
931 "id": "ContainerInfo",
931 "id": "ContainerInfo",
932 "type": "object",
932 "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.",
934 "properties": {
934 "properties": {
935 "image": {
935 "image": {
936 "type": "string",
936 "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\""
938 }
938 }
939 }
939 }
940 },
940 },
941 "SourceReference": {
941 "SourceReference": {
942 "id": "SourceReference",
942 "id": "SourceReference",
943 "type": "object",
943 "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.",
945 "properties": {
945 "properties": {
946 "repository": {
946 "repository": {
947 "type": "string",
947 "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\""
949 },
949 },
950 "revisionId": {
950 "revisionId": {
951 "type": "string",
951 "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\""
953 }
953 }
954 }
954 }
955 },
955 },
@@ -960,7 +960,7 @@
960 "properties": {
960 "properties": {
961 "versions": {
961 "versions": {
962 "type": "array",
962 "type": "array",
963− "description": "The versions belonging to the requested application service.",
963+ "description": "The versions belonging to the requested service.",
964 "items": {
964 "items": {
965 "$ref": "Version"
965 "$ref": "Version"
966 }
966 }
@@ -974,30 +974,30 @@
974 "Service": {
974 "Service": {
975 "id": "Service",
975 "id": "Service",
976 "type": "object",
976 "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.",
978 "properties": {
978 "properties": {
979 "name": {
979 "name": {
980 "type": "string",
980 "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"
982 },
982 },
983 "id": {
983 "id": {
984 "type": "string",
984 "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"
986 },
986 },
987 "split": {
987 "split": {
988 "$ref": "TrafficSplit",
988 "$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."
990 }
990 }
991 }
991 }
992 },
992 },
993 "TrafficSplit": {
993 "TrafficSplit": {
994 "id": "TrafficSplit",
994 "id": "TrafficSplit",
995 "type": "object",
995 "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.",
997 "properties": {
997 "properties": {
998 "shardBy": {
998 "shardBy": {
999 "type": "string",
999 "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.",
1001 "enum": [
1001 "enum": [
1002 "UNSPECIFIED",
1002 "UNSPECIFIED",
1003 "COOKIE",
1003 "COOKIE",
@@ -1006,7 +1006,7 @@
1006 },
1006 },
1007 "allocations": {
1007 "allocations": {
1008 "type": "object",
1008 "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.",
1010 "additionalProperties": {
1010 "additionalProperties": {
1011 "type": "number",
1011 "type": "number",
1012 "format": "double"
1012 "format": "double"
@@ -1032,44 +1032,26 @@
1032 }
1032 }
1033 }
1033 }
1034 },
1034 },
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− },
1053 "Instance": {
1035 "Instance": {
1054 "id": "Instance",
1036 "id": "Instance",
1055 "type": "object",
1037 "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.",
1057 "properties": {
1039 "properties": {
1058 "name": {
1040 "name": {
1059 "type": "string",
1041 "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"
1061 },
1043 },
1062 "id": {
1044 "id": {
1063 "type": "string",
1045 "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"
1065 },
1047 },
1066 "appEngineRelease": {
1048 "appEngineRelease": {
1067 "type": "string",
1049 "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"
1069 },
1051 },
1070 "availability": {
1052 "availability": {
1071 "type": "string",
1053 "type": "string",
1072− "description": "Availability of instance. @OutputOnly",
1054+ "description": "Availability of the instance. @OutputOnly",
1073 "enum": [
1055 "enum": [
1074 "UNSPECIFIED",
1056 "UNSPECIFIED",
1075 "RESIDENT",
1057 "RESIDENT",
@@ -1078,52 +1060,123 @@
1078 },
1060 },
1079 "vmName": {
1061 "vmName": {
1080 "type": "string",
1062 "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"
1082 },
1064 },
1083 "vmZoneName": {
1065 "vmZoneName": {
1084 "type": "string",
1066 "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"
1086 },
1068 },
1087 "vmId": {
1069 "vmId": {
1088 "type": "string",
1070 "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"
1090 },
1072 },
1091 "startTimestamp": {
1073 "startTimestamp": {
1092 "type": "string",
1074 "type": "string",
1093− "description": "Time when instance was started. @OutputOnly"
1075+ "description": "Time that this instance was started. @OutputOnly"
1094 },
1076 },
1095 "requests": {
1077 "requests": {
1096 "type": "integer",
1078 "type": "integer",
1097− "description": "Number of requests (since the clone was started). @OutputOnly",
1079+ "description": "Number of requests since this instance was started. @OutputOnly",
1098 "format": "int32"
1080 "format": "int32"
1099 },
1081 },
1100 "errors": {
1082 "errors": {
1101 "type": "integer",
1083 "type": "integer",
1102− "description": "Number of errors since the instance was started. @OutputOnly",
1084+ "description": "Number of errors since this instance was started. @OutputOnly",
1103 "format": "uint32"
1085 "format": "uint32"
1104 },
1086 },
1105 "qps": {
1087 "qps": {
1106 "type": "number",
1088 "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",
1108 "format": "float"
1090 "format": "float"
1109 },
1091 },
1110 "averageLatency": {
1092 "averageLatency": {
1111 "type": "integer",
1093 "type": "integer",
1112− "description": "Latency in milliseconds (averaged over the last minute). @OutputOnly",
1094+ "description": "Average latency (ms) over the last minute. @OutputOnly",
1113 "format": "int32"
1095 "format": "int32"
1114 },
1096 },
1115 "memoryUsage": {
1097 "memoryUsage": {
1116 "type": "string",
1098 "type": "string",
1117− "description": "Memory usage (in bytes). @OutputOnly",
1099+ "description": "Total memory in use (bytes). @OutputOnly",
1118 "format": "int64"
1100 "format": "int64"
1119 },
1101 },
1120 "vmStatus": {
1102 "vmStatus": {
1121 "type": "string",
1103 "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"
1123 },
1105 },
1124 "vmUnlocked": {
1106 "vmUnlocked": {
1125 "type": "boolean",
1107 "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+ }
1127 }
1180 }
1128 }
1181 }
1129 },
1182 },
@@ -1134,27 +1187,27 @@
1134 "properties": {
1187 "properties": {
1135 "operationType": {
1188 "operationType": {
1136 "type": "string",
1189 "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"
1138 },
1191 },
1139 "insertTime": {
1192 "insertTime": {
1140 "type": "string",
1193 "type": "string",
1141− "description": "Timestamp that this operation was received. @OutputOnly"
1194+ "description": "Timestamp that this operation was created. @OutputOnly"
1142 },
1195 },
1143 "endTime": {
1196 "endTime": {
1144 "type": "string",
1197 "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"
1146 },
1199 },
1147 "user": {
1200 "user": {
1148 "type": "string",
1201 "type": "string",
1149− "description": "The user who requested this operation. @OutputOnly"
1202+ "description": "User who requested this operation. @OutputOnly"
1150 },
1203 },
1151 "target": {
1204 "target": {
1152 "type": "string",
1205 "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"
1154 },
1207 },
1155 "method": {
1208 "method": {
1156 "type": "string",
1209 "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"
1158 }
1211 }
1159 }
1212 }
1160 },
1213 },
@@ -1165,23 +1218,65 @@
1165 "properties": {
1218 "properties": {
1166 "method": {
1219 "method": {
1167 "type": "string",
1220 "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"
1169 },
1222 },
1170 "insertTime": {
1223 "insertTime": {
1171 "type": "string",
1224 "type": "string",
1172− "description": "Timestamp that this operation was received. @OutputOnly"
1225+ "description": "Timestamp that this operation was created. @OutputOnly"
1173 },
1226 },
1174 "endTime": {
1227 "endTime": {
1175 "type": "string",
1228 "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"
1177 },
1230 },
1178 "user": {
1231 "user": {
1179 "type": "string",
1232 "type": "string",
1180− "description": "The user who requested this operation. @OutputOnly"
1233+ "description": "User who requested this operation. @OutputOnly"
1181 },
1234 },
1182 "target": {
1235 "target": {
1183 "type": "string",
1236 "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"
1185 }
1280 }
1186 }
1281 }
1187 }
1282 }
@@ -1189,6 +1284,21 @@
1189 "resources": {
1284 "resources": {
1190 "apps": {
1285 "apps": {
1191 "methods": {
1286 "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+ },
1192 "get": {
1302 "get": {
1193 "id": "appengine.apps.get",
1303 "id": "appengine.apps.get",
1194 "path": "v1beta5/apps/{appsId}",
1304 "path": "v1beta5/apps/{appsId}",
@@ -1197,7 +1307,7 @@
1197 "parameters": {
1307 "parameters": {
1198 "appsId": {
1308 "appsId": {
1199 "type": "string",
1309 "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`.",
1201 "required": true,
1311 "required": true,
1202 "location": "path"
1312 "location": "path"
1203 },
1313 },
@@ -1216,6 +1326,37 @@
1216 "scopes": [
1326 "scopes": [
1217 "https://www.googleapis.com/auth/cloud-platform"
1327 "https://www.googleapis.com/auth/cloud-platform"
1218 ]
1328 ]
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+ ]
1219 }
1360 }
1220 },
1361 },
1221 "resources": {
1362 "resources": {
@@ -1298,11 +1439,11 @@
1298 "id": "appengine.apps.services.delete",
1439 "id": "appengine.apps.services.delete",
1299 "path": "v1beta5/apps/{appsId}/services/{servicesId}",
1440 "path": "v1beta5/apps/{appsId}/services/{servicesId}",
1300 "httpMethod": "DELETE",
1441 "httpMethod": "DELETE",
1301− "description": "Deletes a service and all enclosed versions.",
1442+ "description": "Deletes the specified service and all enclosed versions.",
1302 "parameters": {
1443 "parameters": {
1303 "appsId": {
1444 "appsId": {
1304 "type": "string",
1445 "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`.",
1306 "required": true,
1447 "required": true,
1307 "location": "path"
1448 "location": "path"
1308 },
1449 },
@@ -1328,11 +1469,11 @@
1328 "id": "appengine.apps.services.get",
1469 "id": "appengine.apps.services.get",
1329 "path": "v1beta5/apps/{appsId}/services/{servicesId}",
1470 "path": "v1beta5/apps/{appsId}/services/{servicesId}",
1330 "httpMethod": "GET",
1471 "httpMethod": "GET",
1331− "description": "Gets the current configuration of the service.",
1472+ "description": "Gets the current configuration of the specified service.",
1332 "parameters": {
1473 "parameters": {
1333 "appsId": {
1474 "appsId": {
1334 "type": "string",
1475 "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`.",
1336 "required": true,
1477 "required": true,
1337 "location": "path"
1478 "location": "path"
1338 },
1479 },
@@ -1362,7 +1503,7 @@
1362 "parameters": {
1503 "parameters": {
1363 "appsId": {
1504 "appsId": {
1364 "type": "string",
1505 "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`.",
1366 "required": true,
1507 "required": true,
1367 "location": "path"
1508 "location": "path"
1368 },
1509 },
@@ -1396,7 +1537,7 @@
1396 "parameters": {
1537 "parameters": {
1397 "appsId": {
1538 "appsId": {
1398 "type": "string",
1539 "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`.",
1400 "required": true,
1541 "required": true,
1401 "location": "path"
1542 "location": "path"
1402 },
1543 },
@@ -1413,7 +1554,7 @@
1413 },
1554 },
1414 "migrateTraffic": {
1555 "migrateTraffic": {
1415 "type": "boolean",
1556 "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).",
1417 "location": "query"
1558 "location": "query"
1418 }
1559 }
1419 },
1560 },
@@ -1439,7 +1580,7 @@
1439 "id": "appengine.apps.services.versions.create",
1580 "id": "appengine.apps.services.versions.create",
1440 "path": "v1beta5/apps/{appsId}/services/{servicesId}/versions",
1581 "path": "v1beta5/apps/{appsId}/services/{servicesId}/versions",
1441 "httpMethod": "POST",
1582 "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.",
1443 "parameters": {
1584 "parameters": {
1444 "appsId": {
1585 "appsId": {
1445 "type": "string",
1586 "type": "string",
@@ -1476,7 +1617,7 @@
1476 "parameters": {
1617 "parameters": {
1477 "appsId": {
1618 "appsId": {
1478 "type": "string",
1619 "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`.",
1480 "required": true,
1621 "required": true,
1481 "location": "path"
1622 "location": "path"
1482 },
1623 },
@@ -1509,11 +1650,11 @@
1509 "id": "appengine.apps.services.versions.get",
1650 "id": "appengine.apps.services.versions.get",
1510 "path": "v1beta5/apps/{appsId}/services/{servicesId}/versions/{versionsId}",
1651 "path": "v1beta5/apps/{appsId}/services/{servicesId}/versions/{versionsId}",
1511 "httpMethod": "GET",
1652 "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.",
1513 "parameters": {
1654 "parameters": {
1514 "appsId": {
1655 "appsId": {
1515 "type": "string",
1656 "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`.",
1517 "required": true,
1658 "required": true,
1518 "location": "path"
1659 "location": "path"
1519 },
1660 },
@@ -1559,7 +1700,7 @@
1559 "parameters": {
1700 "parameters": {
1560 "appsId": {
1701 "appsId": {
1561 "type": "string",
1702 "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`.",
1563 "required": true,
1704 "required": true,
1564 "location": "path"
1705 "location": "path"
1565 },
1706 },
@@ -1605,11 +1746,11 @@
1605 "id": "appengine.apps.services.versions.patch",
1746 "id": "appengine.apps.services.versions.patch",
1606 "path": "v1beta5/apps/{appsId}/services/{servicesId}/versions/{versionsId}",
1747 "path": "v1beta5/apps/{appsId}/services/{servicesId}/versions/{versionsId}",
1607 "httpMethod": "PATCH",
1748 "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.",
1609 "parameters": {
1750 "parameters": {
1610 "appsId": {
1751 "appsId": {
1611 "type": "string",
1752 "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`.",
1613 "required": true,
1754 "required": true,
1614 "location": "path"
1755 "location": "path"
1615 },
1756 },
@@ -1650,6 +1791,94 @@
1650 "resources": {
1791 "resources": {
1651 "instances": {
1792 "instances": {
1652 "methods": {
1793 "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+ },
1653 "list": {
1882 "list": {
1654 "id": "appengine.apps.services.versions.instances.list",
1883 "id": "appengine.apps.services.versions.instances.list",
1655 "path": "v1beta5/apps/{appsId}/services/{servicesId}/versions/{versionsId}/instances",
1884 "path": "v1beta5/apps/{appsId}/services/{servicesId}/versions/{versionsId}/instances",
@@ -1658,7 +1887,7 @@
1658 "parameters": {
1887 "parameters": {
1659 "appsId": {
1888 "appsId": {
1660 "type": "string",
1889 "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`.",
1662 "required": true,
1891 "required": true,
1663 "location": "path"
1892 "location": "path"
1664 },
1893 },
@@ -1697,12 +1926,132 @@
1697 "scopes": [
1926 "scopes": [
1698 "https://www.googleapis.com/auth/cloud-platform"
1927 "https://www.googleapis.com/auth/cloud-platform"
1699 ]
1928 ]
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+ ]
1700 }
1976 }
1701 }
1977 }
1702 }
1978 }
1703 }
1979 }
1704 }
1980 }
1705 }
1981 }
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+ }
1706 }
2055 }
1707 }
2056 }
1708 }
2057 }
gogol-appengine/gen/Network/Google/AppEngine.hs+113−20
@@ -32,12 +32,24 @@ module Network.Google.AppEngine
32 -- ** appengine.apps.get
32 -- ** appengine.apps.get
33 , module Network.Google.Resource.AppEngine.Apps.Get
33 , module Network.Google.Resource.AppEngine.Apps.Get
34
34
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+
35 -- ** appengine.apps.operations.get
41 -- ** appengine.apps.operations.get
36 , module Network.Google.Resource.AppEngine.Apps.Operations.Get
42 , module Network.Google.Resource.AppEngine.Apps.Operations.Get
37
43
38 -- ** appengine.apps.operations.list
44 -- ** appengine.apps.operations.list
39 , module Network.Google.Resource.AppEngine.Apps.Operations.List
45 , module Network.Google.Resource.AppEngine.Apps.Operations.List
40
46
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+
41 -- ** appengine.apps.services.delete
53 -- ** appengine.apps.services.delete
42 , module Network.Google.Resource.AppEngine.Apps.Services.Delete
54 , module Network.Google.Resource.AppEngine.Apps.Services.Delete
43
55
@@ -59,6 +71,15 @@ module Network.Google.AppEngine
59 -- ** appengine.apps.services.versions.get
71 -- ** appengine.apps.services.versions.get
60 , module Network.Google.Resource.AppEngine.Apps.Services.Versions.Get
72 , module Network.Google.Resource.AppEngine.Apps.Services.Versions.Get
61
73
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+
62 -- ** appengine.apps.services.versions.instances.list
83 -- ** appengine.apps.services.versions.instances.list
63 , module Network.Google.Resource.AppEngine.Apps.Services.Versions.Instances.List
84 , module Network.Google.Resource.AppEngine.Apps.Services.Versions.Instances.List
64
85
@@ -68,15 +89,21 @@ module Network.Google.AppEngine
68 -- ** appengine.apps.services.versions.patch
89 -- ** appengine.apps.services.versions.patch
69 , module Network.Google.Resource.AppEngine.Apps.Services.Versions.Patch
90 , module Network.Google.Resource.AppEngine.Apps.Services.Versions.Patch
70
91
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+
71 -- * Types
98 -- * Types
72
99
73 -- ** NetworkUtilization
100 -- ** NetworkUtilization
74 , NetworkUtilization
101 , NetworkUtilization
75 , networkUtilization
102 , networkUtilization
76− , nuTargetReceivedBytesPerSec
103+ , nuTargetReceivedBytesPerSecond
77− , nuTargetSentPacketsPerSec
104+ , nuTargetSentPacketsPerSecond
78− , nuTargetReceivedPacketsPerSec
105+ , nuTargetReceivedPacketsPerSecond
79− , nuTargetSentBytesPerSec
106+ , nuTargetSentBytesPerSecond
80
107
81 -- ** Status
108 -- ** Status
82 , Status
109 , Status
@@ -90,6 +117,11 @@ module Network.Google.AppEngine
90 , operationSchema
117 , operationSchema
91 , osAddtional
118 , osAddtional
92
119
120+ -- ** LocationSchema
121+ , LocationSchema
122+ , locationSchema
123+ , lsAddtional
124+
93 -- ** TrafficSplit
125 -- ** TrafficSplit
94 , TrafficSplit
126 , TrafficSplit
95 , trafficSplit
127 , trafficSplit
@@ -125,13 +157,19 @@ module Network.Google.AppEngine
125 , lName
157 , lName
126 , lVersion
158 , lVersion
127
159
160+ -- ** ListLocationsResponse
161+ , ListLocationsResponse
162+ , listLocationsResponse
163+ , llrNextPageToken
164+ , llrLocations
165+
128 -- ** DiskUtilization
166 -- ** DiskUtilization
129 , DiskUtilization
167 , DiskUtilization
130 , diskUtilization
168 , diskUtilization
131− , duTargetWriteOpsPerSec
169+ , duTargetReadBytesPerSecond
132− , duTargetReadOpsPerSec
170+ , duTargetReadOpsPerSecond
133− , duTargetWriteBytesPerSec
171+ , duTargetWriteOpsPerSecond
134− , duTargetReadBytesPerSec
172+ , duTargetWriteBytesPerSecond
135
173
136 -- ** ListOperationsResponse
174 -- ** ListOperationsResponse
137 , ListOperationsResponse
175 , ListOperationsResponse
@@ -169,13 +207,13 @@ module Network.Google.AppEngine
169 , application
207 , application
170 , aDefaultHostname
208 , aDefaultHostname
171 , aDefaultCookieExpiration
209 , aDefaultCookieExpiration
172− , aLocation
173 , aAuthDomain
210 , aAuthDomain
174 , aCodeBucket
211 , aCodeBucket
175 , aName
212 , aName
176 , aDispatchRules
213 , aDispatchRules
177 , aDefaultBucket
214 , aDefaultBucket
178 , aId
215 , aId
216+ , aLocationId
179
217
180 -- ** VersionBetaSettings
218 -- ** VersionBetaSettings
181 , VersionBetaSettings
219 , VersionBetaSettings
@@ -189,6 +227,14 @@ module Network.Google.AppEngine
189 , sName
227 , sName
190 , sId
228 , sId
191
229
230+ -- ** Location
231+ , Location
232+ , location
233+ , locName
234+ , locMetadata
235+ , locLabels
236+ , locLocationId
237+
192 -- ** Operation
238 -- ** Operation
193 , Operation
239 , Operation
194 , operation
240 , operation
@@ -198,6 +244,12 @@ module Network.Google.AppEngine
198 , oName
244 , oName
199 , oMetadata
245 , oMetadata
200
246
247+ -- ** ZipInfo
248+ , ZipInfo
249+ , zipInfo
250+ , ziFilesCount
251+ , ziSourceURL
252+
201 -- ** URLDispatchRule
253 -- ** URLDispatchRule
202 , URLDispatchRule
254 , URLDispatchRule
203 , urlDispatchRule
255 , urlDispatchRule
@@ -260,6 +312,10 @@ module Network.Google.AppEngine
260 , nInstanceTag
312 , nInstanceTag
261 , nName
313 , nName
262
314
315+ -- ** DebugInstanceRequest
316+ , DebugInstanceRequest
317+ , debugInstanceRequest
318+
263 -- ** StaticFilesHandlerHTTPHeaders
319 -- ** StaticFilesHandlerHTTPHeaders
264 , StaticFilesHandlerHTTPHeaders
320 , StaticFilesHandlerHTTPHeaders
265 , staticFilesHandlerHTTPHeaders
321 , staticFilesHandlerHTTPHeaders
@@ -299,12 +355,19 @@ module Network.Google.AppEngine
299 , bsMaxInstances
355 , bsMaxInstances
300 , bsIdleTimeout
356 , bsIdleTimeout
301
357
358+ -- ** OperationMetadataV1
359+ , OperationMetadataV1
360+ , operationMetadataV1
361+ , omvInsertTime
362+ , omvUser
363+ , omvMethod
364+ , omvEndTime
365+ , omvTarget
366+
302 -- ** Version
367 -- ** Version
303 , Version
368 , Version
304 , version
369 , version
305− , vCreationTime
306 , vRuntime
370 , vRuntime
307− , vDeployer
308 , vNobuildFilesRegex
371 , vNobuildFilesRegex
309 , vInstanceClass
372 , vInstanceClass
310 , vHealthCheck
373 , vHealthCheck
@@ -312,6 +375,7 @@ module Network.Google.AppEngine
312 , vDefaultExpiration
375 , vDefaultExpiration
313 , vAutomaticScaling
376 , vAutomaticScaling
314 , vErrorHandlers
377 , vErrorHandlers
378+ , vCreatedBy
315 , vVM
379 , vVM
316 , vHandlers
380 , vHandlers
317 , vInboundServices
381 , vInboundServices
@@ -327,7 +391,9 @@ module Network.Google.AppEngine
327 , vEnvVariables
391 , vEnvVariables
328 , vServingStatus
392 , vServingStatus
329 , vDiskUsageBytes
393 , vDiskUsageBytes
394+ , vCreateTime
330 , vLibraries
395 , vLibraries
396+ , vVersionURL
331 , vDeployment
397 , vDeployment
332
398
333 -- ** StaticFilesHandler
399 -- ** StaticFilesHandler
@@ -348,6 +414,17 @@ module Network.Google.AppEngine
348 , ehErrorCode
414 , ehErrorCode
349 , ehStaticFile
415 , ehStaticFile
350
416
417+ -- ** LocationLabels
418+ , LocationLabels
419+ , locationLabels
420+ , llAddtional
421+
422+ -- ** LocationMetadata
423+ , LocationMetadata
424+ , locationMetadata
425+ , lmStandardEnvironmentAvailable
426+ , lmFlexibleEnvironmentAvailable
427+
351 -- ** OperationMetadata
428 -- ** OperationMetadata
352 , OperationMetadata
429 , OperationMetadata
353 , operationMetadata
430 , operationMetadata
@@ -368,13 +445,11 @@ module Network.Google.AppEngine
368 , RequestUtilization
445 , RequestUtilization
369 , requestUtilization
446 , requestUtilization
370 , ruTargetConcurrentRequests
447 , ruTargetConcurrentRequests
371− , ruTargetRequestCountPerSec
448+ , ruTargetRequestCountPerSecond
372
449
373− -- ** SourceReference
450+ -- ** RepairApplicationRequest
374− , SourceReference
451+ , RepairApplicationRequest
375− , sourceReference
452+ , repairApplicationRequest
376− , srRepository
377− , srRevisionId
378
453
379 -- ** OperationResponse
454 -- ** OperationResponse
380 , OperationResponse
455 , OperationResponse
@@ -392,32 +467,36 @@ module Network.Google.AppEngine
392 , iMemoryUsage
467 , iMemoryUsage
393 , iVMStatus
468 , iVMStatus
394 , iVMZoneName
469 , iVMZoneName
470+ , iStartTime
395 , iVMId
471 , iVMId
396 , iAvailability
472 , iAvailability
397 , iVMName
473 , iVMName
398 , iName
474 , iName
399− , iVMUnlocked
475+ , iVMDebugEnabled
400 , iRequests
476 , iRequests
401 , iQps
477 , iQps
402 , iId
478 , iId
403 , iErrors
479 , iErrors
404 , iAverageLatency
480 , iAverageLatency
405− , iStartTimestamp
406 , iAppEngineRelease
481 , iAppEngineRelease
407
482
408 -- ** Deployment
483 -- ** Deployment
409 , Deployment
484 , Deployment
410 , deployment
485 , deployment
486+ , dZip
411 , dContainer
487 , dContainer
412 , dFiles
488 , dFiles
413− , dSourceReferences
414 ) where
489 ) where
415
490
416import Network.Google.AppEngine.Types
491import Network.Google.AppEngine.Types
417import Network.Google.Prelude
492import Network.Google.Prelude
418import Network.Google.Resource.AppEngine.Apps.Get
493import Network.Google.Resource.AppEngine.Apps.Get
494+import Network.Google.Resource.AppEngine.Apps.Locations.Get
495+import Network.Google.Resource.AppEngine.Apps.Locations.List
419import Network.Google.Resource.AppEngine.Apps.Operations.Get
496import Network.Google.Resource.AppEngine.Apps.Operations.Get
420import Network.Google.Resource.AppEngine.Apps.Operations.List
497import Network.Google.Resource.AppEngine.Apps.Operations.List
498+import Network.Google.Resource.AppEngine.Apps.Patch
499+import Network.Google.Resource.AppEngine.Apps.Repair
421import Network.Google.Resource.AppEngine.Apps.Services.Delete
500import Network.Google.Resource.AppEngine.Apps.Services.Delete
422import Network.Google.Resource.AppEngine.Apps.Services.Get
501import Network.Google.Resource.AppEngine.Apps.Services.Get
423import Network.Google.Resource.AppEngine.Apps.Services.List
502import Network.Google.Resource.AppEngine.Apps.Services.List
@@ -425,9 +504,14 @@ import Network.Google.Resource.AppEngine.Apps.Services.Patch
425import Network.Google.Resource.AppEngine.Apps.Services.Versions.Create
504import Network.Google.Resource.AppEngine.Apps.Services.Versions.Create
426import Network.Google.Resource.AppEngine.Apps.Services.Versions.Delete
505import Network.Google.Resource.AppEngine.Apps.Services.Versions.Delete
427import Network.Google.Resource.AppEngine.Apps.Services.Versions.Get
506import 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
428import Network.Google.Resource.AppEngine.Apps.Services.Versions.Instances.List
510import Network.Google.Resource.AppEngine.Apps.Services.Versions.Instances.List
429import Network.Google.Resource.AppEngine.Apps.Services.Versions.List
511import Network.Google.Resource.AppEngine.Apps.Services.Versions.List
430import Network.Google.Resource.AppEngine.Apps.Services.Versions.Patch
512import 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
431
515
432{- $resources
516{- $resources
433TODO
517TODO
@@ -437,7 +521,12 @@ TODO
437type AppEngineAPI =
521type AppEngineAPI =
438 AppsOperationsListResource :<|>
522 AppsOperationsListResource :<|>
439 AppsOperationsGetResource
523 AppsOperationsGetResource
524+ :<|> AppsLocationsListResource
525+ :<|> AppsLocationsGetResource
440 :<|> AppsServicesVersionsInstancesListResource
526 :<|> AppsServicesVersionsInstancesListResource
527+ :<|> AppsServicesVersionsInstancesGetResource
528+ :<|> AppsServicesVersionsInstancesDebugResource
529+ :<|> AppsServicesVersionsInstancesDeleteResource
441 :<|> AppsServicesVersionsListResource
530 :<|> AppsServicesVersionsListResource
442 :<|> AppsServicesVersionsPatchResource
531 :<|> AppsServicesVersionsPatchResource
443 :<|> AppsServicesVersionsGetResource
532 :<|> AppsServicesVersionsGetResource
@@ -447,4 +536,8 @@ type AppEngineAPI =
447 :<|> AppsServicesPatchResource
536 :<|> AppsServicesPatchResource
448 :<|> AppsServicesGetResource
537 :<|> AppsServicesGetResource
449 :<|> AppsServicesDeleteResource
538 :<|> AppsServicesDeleteResource
539+ :<|> AppsPatchResource
450 :<|> AppsGetResource
540 :<|> 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
25 -- * NetworkUtilization
25 -- * NetworkUtilization
26 , NetworkUtilization
26 , NetworkUtilization
27 , networkUtilization
27 , networkUtilization
28− , nuTargetReceivedBytesPerSec
28+ , nuTargetReceivedBytesPerSecond
29− , nuTargetSentPacketsPerSec
29+ , nuTargetSentPacketsPerSecond
30− , nuTargetReceivedPacketsPerSec
30+ , nuTargetReceivedPacketsPerSecond
31− , nuTargetSentBytesPerSec
31+ , nuTargetSentBytesPerSecond
32
32
33 -- * Status
33 -- * Status
34 , Status
34 , Status
@@ -42,6 +42,11 @@ module Network.Google.AppEngine.Types
42 , operationSchema
42 , operationSchema
43 , osAddtional
43 , osAddtional
44
44
45+ -- * LocationSchema
46+ , LocationSchema
47+ , locationSchema
48+ , lsAddtional
49+
45 -- * TrafficSplit
50 -- * TrafficSplit
46 , TrafficSplit
51 , TrafficSplit
47 , trafficSplit
52 , trafficSplit
@@ -77,13 +82,19 @@ module Network.Google.AppEngine.Types
77 , lName
82 , lName
78 , lVersion
83 , lVersion
79
84
85+ -- * ListLocationsResponse
86+ , ListLocationsResponse
87+ , listLocationsResponse
88+ , llrNextPageToken
89+ , llrLocations
90+
80 -- * DiskUtilization
91 -- * DiskUtilization
81 , DiskUtilization
92 , DiskUtilization
82 , diskUtilization
93 , diskUtilization
83− , duTargetWriteOpsPerSec
94+ , duTargetReadBytesPerSecond
84− , duTargetReadOpsPerSec
95+ , duTargetReadOpsPerSecond
85− , duTargetWriteBytesPerSec
96+ , duTargetWriteOpsPerSecond
86− , duTargetReadBytesPerSec
97+ , duTargetWriteBytesPerSecond
87
98
88 -- * ListOperationsResponse
99 -- * ListOperationsResponse
89 , ListOperationsResponse
100 , ListOperationsResponse
@@ -121,13 +132,13 @@ module Network.Google.AppEngine.Types
121 , application
132 , application
122 , aDefaultHostname
133 , aDefaultHostname
123 , aDefaultCookieExpiration
134 , aDefaultCookieExpiration
124− , aLocation
125 , aAuthDomain
135 , aAuthDomain
126 , aCodeBucket
136 , aCodeBucket
127 , aName
137 , aName
128 , aDispatchRules
138 , aDispatchRules
129 , aDefaultBucket
139 , aDefaultBucket
130 , aId
140 , aId
141+ , aLocationId
131
142
132 -- * VersionBetaSettings
143 -- * VersionBetaSettings
133 , VersionBetaSettings
144 , VersionBetaSettings
@@ -141,6 +152,14 @@ module Network.Google.AppEngine.Types
141 , sName
152 , sName
142 , sId
153 , sId
143
154
155+ -- * Location
156+ , Location
157+ , location
158+ , locName
159+ , locMetadata
160+ , locLabels
161+ , locLocationId
162+
144 -- * Operation
163 -- * Operation
145 , Operation
164 , Operation
146 , operation
165 , operation
@@ -150,6 +169,12 @@ module Network.Google.AppEngine.Types
150 , oName
169 , oName
151 , oMetadata
170 , oMetadata
152
171
172+ -- * ZipInfo
173+ , ZipInfo
174+ , zipInfo
175+ , ziFilesCount
176+ , ziSourceURL
177+
153 -- * URLDispatchRule
178 -- * URLDispatchRule
154 , URLDispatchRule
179 , URLDispatchRule
155 , urlDispatchRule
180 , urlDispatchRule
@@ -212,6 +237,10 @@ module Network.Google.AppEngine.Types
212 , nInstanceTag
237 , nInstanceTag
213 , nName
238 , nName
214
239
240+ -- * DebugInstanceRequest
241+ , DebugInstanceRequest
242+ , debugInstanceRequest
243+
215 -- * StaticFilesHandlerHTTPHeaders
244 -- * StaticFilesHandlerHTTPHeaders
216 , StaticFilesHandlerHTTPHeaders
245 , StaticFilesHandlerHTTPHeaders
217 , staticFilesHandlerHTTPHeaders
246 , staticFilesHandlerHTTPHeaders
@@ -251,12 +280,19 @@ module Network.Google.AppEngine.Types
251 , bsMaxInstances
280 , bsMaxInstances
252 , bsIdleTimeout
281 , bsIdleTimeout
253
282
283+ -- * OperationMetadataV1
284+ , OperationMetadataV1
285+ , operationMetadataV1
286+ , omvInsertTime
287+ , omvUser
288+ , omvMethod
289+ , omvEndTime
290+ , omvTarget
291+
254 -- * Version
292 -- * Version
255 , Version
293 , Version
256 , version
294 , version
257− , vCreationTime
258 , vRuntime
295 , vRuntime
259− , vDeployer
260 , vNobuildFilesRegex
296 , vNobuildFilesRegex
261 , vInstanceClass
297 , vInstanceClass
262 , vHealthCheck
298 , vHealthCheck
@@ -264,6 +300,7 @@ module Network.Google.AppEngine.Types
264 , vDefaultExpiration
300 , vDefaultExpiration
265 , vAutomaticScaling
301 , vAutomaticScaling
266 , vErrorHandlers
302 , vErrorHandlers
303+ , vCreatedBy
267 , vVM
304 , vVM
268 , vHandlers
305 , vHandlers
269 , vInboundServices
306 , vInboundServices
@@ -279,7 +316,9 @@ module Network.Google.AppEngine.Types
279 , vEnvVariables
316 , vEnvVariables
280 , vServingStatus
317 , vServingStatus
281 , vDiskUsageBytes
318 , vDiskUsageBytes
319+ , vCreateTime
282 , vLibraries
320 , vLibraries
321+ , vVersionURL
283 , vDeployment
322 , vDeployment
284
323
285 -- * StaticFilesHandler
324 -- * StaticFilesHandler
@@ -300,6 +339,17 @@ module Network.Google.AppEngine.Types
300 , ehErrorCode
339 , ehErrorCode
301 , ehStaticFile
340 , ehStaticFile
302
341
342+ -- * LocationLabels
343+ , LocationLabels
344+ , locationLabels
345+ , llAddtional
346+
347+ -- * LocationMetadata
348+ , LocationMetadata
349+ , locationMetadata
350+ , lmStandardEnvironmentAvailable
351+ , lmFlexibleEnvironmentAvailable
352+
303 -- * OperationMetadata
353 -- * OperationMetadata
304 , OperationMetadata
354 , OperationMetadata
305 , operationMetadata
355 , operationMetadata
@@ -320,13 +370,11 @@ module Network.Google.AppEngine.Types
320 , RequestUtilization
370 , RequestUtilization
321 , requestUtilization
371 , requestUtilization
322 , ruTargetConcurrentRequests
372 , ruTargetConcurrentRequests
323− , ruTargetRequestCountPerSec
373+ , ruTargetRequestCountPerSecond
324
374
325− -- * SourceReference
375+ -- * RepairApplicationRequest
326− , SourceReference
376+ , RepairApplicationRequest
327− , sourceReference
377+ , repairApplicationRequest
328− , srRepository
329− , srRevisionId
330
378
331 -- * OperationResponse
379 -- * OperationResponse
332 , OperationResponse
380 , OperationResponse
@@ -344,35 +392,35 @@ module Network.Google.AppEngine.Types
344 , iMemoryUsage
392 , iMemoryUsage
345 , iVMStatus
393 , iVMStatus
346 , iVMZoneName
394 , iVMZoneName
395+ , iStartTime
347 , iVMId
396 , iVMId
348 , iAvailability
397 , iAvailability
349 , iVMName
398 , iVMName
350 , iName
399 , iName
351− , iVMUnlocked
400+ , iVMDebugEnabled
352 , iRequests
401 , iRequests
353 , iQps
402 , iQps
354 , iId
403 , iId
355 , iErrors
404 , iErrors
356 , iAverageLatency
405 , iAverageLatency
357− , iStartTimestamp
358 , iAppEngineRelease
406 , iAppEngineRelease
359
407
360 -- * Deployment
408 -- * Deployment
361 , Deployment
409 , Deployment
362 , deployment
410 , deployment
411+ , dZip
363 , dContainer
412 , dContainer
364 , dFiles
413 , dFiles
365− , dSourceReferences
366 ) where
414 ) where
367
415
368import Network.Google.AppEngine.Types.Product
416import Network.Google.AppEngine.Types.Product
369import Network.Google.AppEngine.Types.Sum
417import Network.Google.AppEngine.Types.Sum
370import Network.Google.Prelude
418import Network.Google.Prelude
371
419
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.
373appEngineService :: ServiceConfig
421appEngineService :: ServiceConfig
374appEngineService
422appEngineService
375− = defaultService (ServiceId "appengine:v1beta5")
423+ = defaultService (ServiceId "appengine:v1")
376 "appengine.googleapis.com"
424 "appengine.googleapis.com"
377
425
378-- | View and manage your data across Google Cloud Platform services
426-- | 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
20import Network.Google.AppEngine.Types.Sum
20import Network.Google.AppEngine.Types.Sum
21import Network.Google.Prelude
21import Network.Google.Prelude
22
22
23−-- | Target scaling by network usage (for VM runtimes only).
23+-- | Target scaling by network usage. Only applicable for VM runtimes.
24--
24--
25-- /See:/ 'networkUtilization' smart constructor.
25-- /See:/ 'networkUtilization' smart constructor.
26data NetworkUtilization = NetworkUtilization'
26data NetworkUtilization = NetworkUtilization'
27− { _nuTargetReceivedBytesPerSec :: !(Maybe (Textual Int32))
27+ { _nuTargetReceivedBytesPerSecond :: !(Maybe (Textual Int32))
28− , _nuTargetSentPacketsPerSec :: !(Maybe (Textual Int32))
28+ , _nuTargetSentPacketsPerSecond :: !(Maybe (Textual Int32))
29− , _nuTargetReceivedPacketsPerSec :: !(Maybe (Textual Int32))
29+ , _nuTargetReceivedPacketsPerSecond :: !(Maybe (Textual Int32))
30− , _nuTargetSentBytesPerSec :: !(Maybe (Textual Int32))
30+ , _nuTargetSentBytesPerSecond :: !(Maybe (Textual Int32))
31 } deriving (Eq,Show,Data,Typeable,Generic)
31 } deriving (Eq,Show,Data,Typeable,Generic)
32
32
33-- | Creates a value of 'NetworkUtilization' with the minimum fields required to make a request.
33-- | Creates a value of 'NetworkUtilization' with the minimum fields required to make a request.
34--
34--
35-- Use one of the following lenses to modify other fields as desired:
35-- Use one of the following lenses to modify other fields as desired:
36--
36--
37−-- * 'nuTargetReceivedBytesPerSec'
37+-- * 'nuTargetReceivedBytesPerSecond'
38--
38--
39−-- * 'nuTargetSentPacketsPerSec'
39+-- * 'nuTargetSentPacketsPerSecond'
40--
40--
41−-- * 'nuTargetReceivedPacketsPerSec'
41+-- * 'nuTargetReceivedPacketsPerSecond'
42--
42--
43−-- * 'nuTargetSentBytesPerSec'
43+-- * 'nuTargetSentBytesPerSecond'
44networkUtilization
44networkUtilization
45 :: NetworkUtilization
45 :: NetworkUtilization
46networkUtilization =
46networkUtilization =
47 NetworkUtilization'
47 NetworkUtilization'
48− { _nuTargetReceivedBytesPerSec = Nothing
48+ { _nuTargetReceivedBytesPerSecond = Nothing
49− , _nuTargetSentPacketsPerSec = Nothing
49+ , _nuTargetSentPacketsPerSecond = Nothing
50− , _nuTargetReceivedPacketsPerSec = Nothing
50+ , _nuTargetReceivedPacketsPerSecond = Nothing
51− , _nuTargetSentBytesPerSec = Nothing
51+ , _nuTargetSentBytesPerSecond = Nothing
52 }
52 }
53
53
54−-- | Target bytes per second received.
54+-- | Target bytes received per second.
55−nuTargetReceivedBytesPerSec :: Lens' NetworkUtilization (Maybe Int32)
55+nuTargetReceivedBytesPerSecond :: Lens' NetworkUtilization (Maybe Int32)
56−nuTargetReceivedBytesPerSec
56+nuTargetReceivedBytesPerSecond
57− = lens _nuTargetReceivedBytesPerSec
57+ = lens _nuTargetReceivedBytesPerSecond
58− (\ s a -> s{_nuTargetReceivedBytesPerSec = a})
58+ (\ s a -> s{_nuTargetReceivedBytesPerSecond = a})
59 . mapping _Coerce
59 . mapping _Coerce
60
60
61−-- | Target packets per second sent.
61+-- | Target packets sent per second.
62−nuTargetSentPacketsPerSec :: Lens' NetworkUtilization (Maybe Int32)
62+nuTargetSentPacketsPerSecond :: Lens' NetworkUtilization (Maybe Int32)
63−nuTargetSentPacketsPerSec
63+nuTargetSentPacketsPerSecond
64− = lens _nuTargetSentPacketsPerSec
64+ = lens _nuTargetSentPacketsPerSecond
65− (\ s a -> s{_nuTargetSentPacketsPerSec = a})
65+ (\ s a -> s{_nuTargetSentPacketsPerSecond = a})
66 . mapping _Coerce
66 . mapping _Coerce
67
67
68−-- | Target packets per second received.
68+-- | Target packets received per second.
69−nuTargetReceivedPacketsPerSec :: Lens' NetworkUtilization (Maybe Int32)
69+nuTargetReceivedPacketsPerSecond :: Lens' NetworkUtilization (Maybe Int32)
70−nuTargetReceivedPacketsPerSec
70+nuTargetReceivedPacketsPerSecond
71− = lens _nuTargetReceivedPacketsPerSec
71+ = lens _nuTargetReceivedPacketsPerSecond
72− (\ s a -> s{_nuTargetReceivedPacketsPerSec = a})
72+ (\ s a -> s{_nuTargetReceivedPacketsPerSecond = a})
73 . mapping _Coerce
73 . mapping _Coerce
74
74
75−-- | Target bytes per second sent.
75+-- | Target bytes sent per second.
76−nuTargetSentBytesPerSec :: Lens' NetworkUtilization (Maybe Int32)
76+nuTargetSentBytesPerSecond :: Lens' NetworkUtilization (Maybe Int32)
77−nuTargetSentBytesPerSec
77+nuTargetSentBytesPerSecond
78− = lens _nuTargetSentBytesPerSec
78+ = lens _nuTargetSentBytesPerSecond
79− (\ s a -> s{_nuTargetSentBytesPerSec = a})
79+ (\ s a -> s{_nuTargetSentBytesPerSecond = a})
80 . mapping _Coerce
80 . mapping _Coerce
81
81
82instance FromJSON NetworkUtilization where
82instance FromJSON NetworkUtilization where
@@ -84,23 +84,23 @@ instance FromJSON NetworkUtilization where
84 = withObject "NetworkUtilization"
84 = withObject "NetworkUtilization"
85 (\ o ->
85 (\ o ->
86 NetworkUtilization' <$>
86 NetworkUtilization' <$>
87− (o .:? "targetReceivedBytesPerSec") <*>
87+ (o .:? "targetReceivedBytesPerSecond") <*>
88− (o .:? "targetSentPacketsPerSec")
88+ (o .:? "targetSentPacketsPerSecond")
89− <*> (o .:? "targetReceivedPacketsPerSec")
89+ <*> (o .:? "targetReceivedPacketsPerSecond")
90− <*> (o .:? "targetSentBytesPerSec"))
90+ <*> (o .:? "targetSentBytesPerSecond"))
91
91
92instance ToJSON NetworkUtilization where
92instance ToJSON NetworkUtilization where
93 toJSON NetworkUtilization'{..}
93 toJSON NetworkUtilization'{..}
94 = object
94 = object
95 (catMaybes
95 (catMaybes
96− [("targetReceivedBytesPerSec" .=) <$>
96+ [("targetReceivedBytesPerSecond" .=) <$>
97− _nuTargetReceivedBytesPerSec,
97+ _nuTargetReceivedBytesPerSecond,
98− ("targetSentPacketsPerSec" .=) <$>
98+ ("targetSentPacketsPerSecond" .=) <$>
99− _nuTargetSentPacketsPerSec,
99+ _nuTargetSentPacketsPerSecond,
100− ("targetReceivedPacketsPerSec" .=) <$>
100+ ("targetReceivedPacketsPerSecond" .=) <$>
101− _nuTargetReceivedPacketsPerSec,
101+ _nuTargetReceivedPacketsPerSecond,
102− ("targetSentBytesPerSec" .=) <$>
102+ ("targetSentBytesPerSecond" .=) <$>
103− _nuTargetSentBytesPerSec])
103+ _nuTargetSentBytesPerSecond])
104
104
105-- | The \`Status\` type defines a logical error model that is suitable for
105-- | The \`Status\` type defines a logical error model that is suitable for
106-- different programming environments, including REST APIs and RPC APIs. It
106-- different programming environments, including REST APIs and RPC APIs. It
@@ -222,7 +222,7 @@ operationSchema pOsAddtional_ =
222 { _osAddtional = _Coerce # pOsAddtional_
222 { _osAddtional = _Coerce # pOsAddtional_
223 }
223 }
224
224
225−-- | Properties of the object. Contains field \'ype with type URL.
225+-- | Properties of the object. Contains field \'type with type URL.
226osAddtional :: Lens' OperationSchema (HashMap Text JSONValue)
226osAddtional :: Lens' OperationSchema (HashMap Text JSONValue)
227osAddtional
227osAddtional
228 = lens _osAddtional (\ s a -> s{_osAddtional = a}) .
228 = lens _osAddtional (\ s a -> s{_osAddtional = a}) .
@@ -236,10 +236,44 @@ instance FromJSON OperationSchema where
236instance ToJSON OperationSchema where
236instance ToJSON OperationSchema where
237 toJSON = toJSON . _osAddtional
237 toJSON = toJSON . _osAddtional
238
238
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+
239−-- | Configuration for traffic splitting for versions within a single
274+-- | Traffic routing configuration for versions within a single service.
240−-- service. Traffic splitting allows traffic directed to the service to be
275+-- Traffic splits define how traffic directed to the service is assigned to
241−-- assigned to one of several versions in a fractional way, enabling
276+-- versions.
242−-- experiments and canarying new builds, for example.
243--
277--
244-- /See:/ 'trafficSplit' smart constructor.
278-- /See:/ 'trafficSplit' smart constructor.
245data TrafficSplit = TrafficSplit'
279data TrafficSplit = TrafficSplit'
@@ -262,21 +296,21 @@ trafficSplit =
262 , _tsAllocations = Nothing
296 , _tsAllocations = Nothing
263 }
297 }
264
298
265−-- | Which mechanism should be used as a selector when choosing a version to
299+-- | Mechanism used to determine which version a request is sent to. The
266−-- send a request to. The traffic selection algorithm will be stable for
300+-- traffic selection algorithm will be stable for either type until
267−-- either type until allocations are changed.
301+-- allocations are changed.
268tsShardBy :: Lens' TrafficSplit (Maybe Text)
302tsShardBy :: Lens' TrafficSplit (Maybe Text)
269tsShardBy
303tsShardBy
270 = lens _tsShardBy (\ s a -> s{_tsShardBy = a})
304 = lens _tsShardBy (\ s a -> s{_tsShardBy = a})
271
305
272−-- | Mapping from service version IDs within the service to fractional
306+-- | Mapping from version IDs within the service to fractional (0.000, 1]
273−-- (0.000, 1] allocations of traffic for that version. Each version may
307+-- allocations of traffic for that version. Each version can be specified
274−-- only be specified once, but some versions in the service may not have
308+-- only once, but some versions in the service may not have any traffic
275−-- any traffic allocation. Services that have traffic allocated in this
309+-- allocation. Services that have traffic allocated cannot be deleted until
276−-- field may not be deleted until the service is deleted, or their traffic
310+-- either the service is deleted or their traffic allocation is removed.
277−-- allocation is removed. Allocations must sum to 1. Supports precision up
311+-- Allocations must sum to 1. Up to two decimal place precision is
278−-- to two decimal places for IP-based splits and up to three decimal places
312+-- supported for IP-based splits and up to three decimal places is
279−-- for cookie-based splits.
313+-- supported for cookie-based splits.
280tsAllocations :: Lens' TrafficSplit (Maybe TrafficSplitAllocations)
314tsAllocations :: Lens' TrafficSplit (Maybe TrafficSplitAllocations)
281tsAllocations
315tsAllocations
282 = lens _tsAllocations
316 = lens _tsAllocations
@@ -315,7 +349,7 @@ scriptHandler =
315 { _shScriptPath = Nothing
349 { _shScriptPath = Nothing
316 }
350 }
317
351
318−-- | Specifies the path to the script from the application root directory.
352+-- | Path to the script from the application root directory.
319shScriptPath :: Lens' ScriptHandler (Maybe Text)
353shScriptPath :: Lens' ScriptHandler (Maybe Text)
320shScriptPath
354shScriptPath
321 = lens _shScriptPath (\ s a -> s{_shScriptPath = a})
355 = lens _shScriptPath (\ s a -> s{_shScriptPath = a})
@@ -381,9 +415,9 @@ instance ToJSON ListServicesResponse where
381 [("nextPageToken" .=) <$> _lsrNextPageToken,
415 [("nextPageToken" .=) <$> _lsrNextPageToken,
382 ("services" .=) <$> _lsrServices])
416 ("services" .=) <$> _lsrServices])
383
417
384−-- | A URL pattern and description of how it should be handled. App Engine
418+-- | URL pattern and description of how the URL should be handled. App Engine
385−-- can handle URLs by executing application code, or by serving static
419+-- can handle URLs by executing application code or by serving static files
386−-- files uploaded with the code, such as images, CSS or JavaScript.
420+-- uploaded with the version, such as images, CSS, or JavaScript.
387--
421--
388-- /See:/ 'urlMap' smart constructor.
422-- /See:/ 'urlMap' smart constructor.
389data URLMap = URLMap'
423data URLMap = URLMap'
@@ -430,40 +464,39 @@ urlMap =
430 , _umLogin = Nothing
464 , _umLogin = Nothing
431 }
465 }
432
466
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.
434umScript :: Lens' URLMap (Maybe ScriptHandler)
468umScript :: Lens' URLMap (Maybe ScriptHandler)
435umScript = lens _umScript (\ s a -> s{_umScript = a})
469umScript = lens _umScript (\ s a -> s{_umScript = a})
436
470
437−-- | Configures whether security (HTTPS) should be enforced for this URL.
471+-- | Security (HTTPS) enforcement for this URL.
438umSecurityLevel :: Lens' URLMap (Maybe Text)
472umSecurityLevel :: Lens' URLMap (Maybe Text)
439umSecurityLevel
473umSecurityLevel
440 = lens _umSecurityLevel
474 = lens _umSecurityLevel
441 (\ s a -> s{_umSecurityLevel = a})
475 (\ s a -> s{_umSecurityLevel = a})
442
476
443−-- | Use API Endpoints to handle requests.
477+-- | Uses API Endpoints to handle requests.
444umAPIEndpoint :: Lens' URLMap (Maybe APIEndpointHandler)
478umAPIEndpoint :: Lens' URLMap (Maybe APIEndpointHandler)
445umAPIEndpoint
479umAPIEndpoint
446 = lens _umAPIEndpoint
480 = lens _umAPIEndpoint
447 (\ s a -> s{_umAPIEndpoint = a})
481 (\ s a -> s{_umAPIEndpoint = a})
448
482
449−-- | A URL prefix. This value uses regular expression syntax (and so regexp
483+-- | URL prefix. Uses regular expression syntax, which means regexp special
450−-- special characters must be escaped), but it should not contain
484+-- characters must be escaped, but should not contain groupings. All URLs
451−-- groupings. All URLs that begin with this prefix are handled by this
485+-- that begin with this prefix are handled by this handler, using the
452−-- handler, using the portion of the URL after the prefix as part of the
486+-- portion of the URL after the prefix as part of the file path.
453−-- file path. This is always required.
454umURLRegex :: Lens' URLMap (Maybe Text)
487umURLRegex :: Lens' URLMap (Maybe Text)
455umURLRegex
488umURLRegex
456 = lens _umURLRegex (\ s a -> s{_umURLRegex = a})
489 = lens _umURLRegex (\ s a -> s{_umURLRegex = a})
457
490
458-- | \`30x\` code to use when performing redirects for the \`secure\` field.
491-- | \`30x\` code to use when performing redirects for the \`secure\` field.
459−-- A \`302\` is used by default.
492+-- Defaults to \`302\`.
460umRedirectHTTPResponseCode :: Lens' URLMap (Maybe Text)
493umRedirectHTTPResponseCode :: Lens' URLMap (Maybe Text)
461umRedirectHTTPResponseCode
494umRedirectHTTPResponseCode
462 = lens _umRedirectHTTPResponseCode
495 = lens _umRedirectHTTPResponseCode
463 (\ s a -> s{_umRedirectHTTPResponseCode = a})
496 (\ s a -> s{_umRedirectHTTPResponseCode = a})
464
497
465−-- | For users not logged in, how to handle access to resources with required
498+-- | Action to take when users access resources that require authentication.
466−-- login. Defaults to \"redirect\".
499+-- Defaults to \`redirect\`.
467umAuthFailAction :: Lens' URLMap (Maybe Text)
500umAuthFailAction :: Lens' URLMap (Maybe Text)
468umAuthFailAction
501umAuthFailAction
469 = lens _umAuthFailAction
502 = lens _umAuthFailAction
@@ -475,7 +508,7 @@ umStaticFiles
475 = lens _umStaticFiles
508 = lens _umStaticFiles
476 (\ s a -> s{_umStaticFiles = a})
509 (\ s a -> s{_umStaticFiles = a})
477
510
478−-- | What level of login is required to access this resource.
511+-- | Level of login required to access this resource.
479umLogin :: Lens' URLMap (Maybe Text)
512umLogin :: Lens' URLMap (Maybe Text)
480umLogin = lens _umLogin (\ s a -> s{_umLogin = a})
513umLogin = lens _umLogin (\ s a -> s{_umLogin = a})
481
514
@@ -506,7 +539,7 @@ instance ToJSON URLMap where
506 ("staticFiles" .=) <$> _umStaticFiles,
539 ("staticFiles" .=) <$> _umStaticFiles,
507 ("login" .=) <$> _umLogin])
540 ("login" .=) <$> _umLogin])
508
541
509−-- | A Python runtime third-party library required by the application.
542+-- | Third-party Python runtime library that is required by the application.
510--
543--
511-- /See:/ 'library' smart constructor.
544-- /See:/ 'library' smart constructor.
512data Library = Library'
545data Library = Library'
@@ -529,11 +562,11 @@ library =
529 , _lVersion = Nothing
562 , _lVersion = Nothing
530 }
563 }
531
564
532−-- | The name of the library, e.g. \"PIL\" or \"django\".
565+-- | Name of the library. Example: \"django\".
533lName :: Lens' Library (Maybe Text)
566lName :: Lens' Library (Maybe Text)
534lName = lens _lName (\ s a -> s{_lName = a})
567lName = lens _lName (\ s a -> s{_lName = a})
535
568
536−-- | The version of the library to select, or \"latest\".
569+-- | Version of the library to select, or \"latest\".
537lVersion :: Lens' Library (Maybe Text)
570lVersion :: Lens' Library (Maybe Text)
538lVersion = lens _lVersion (\ s a -> s{_lVersion = a})
571lVersion = lens _lVersion (\ s a -> s{_lVersion = a})
539
572
@@ -550,63 +583,114 @@ instance ToJSON Library where
550 [("name" .=) <$> _lName,
583 [("name" .=) <$> _lName,
551 ("version" .=) <$> _lVersion])
584 ("version" .=) <$> _lVersion])
552
585
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+
553−-- | Target scaling by disk usage (for VM runtimes only).
637+-- | Target scaling by disk usage. Only applicable for VM runtimes.
554--
638--
555-- /See:/ 'diskUtilization' smart constructor.
639-- /See:/ 'diskUtilization' smart constructor.
556data DiskUtilization = DiskUtilization'
640data DiskUtilization = DiskUtilization'
641+ { _duTargetReadBytesPerSecond :: !(Maybe (Textual Int32))
642+ , _duTargetReadOpsPerSecond :: !(Maybe (Textual Int32))
557− { _duTargetWriteOpsPerSec :: !(Maybe (Textual Int32))
643+ , _duTargetWriteOpsPerSecond :: !(Maybe (Textual Int32))
558− , _duTargetReadOpsPerSec :: !(Maybe (Textual Int32))
644+ , _duTargetWriteBytesPerSecond :: !(Maybe (Textual Int32))
559− , _duTargetWriteBytesPerSec :: !(Maybe (Textual Int32))
560− , _duTargetReadBytesPerSec :: !(Maybe (Textual Int32))
561 } deriving (Eq,Show,Data,Typeable,Generic)
645 } deriving (Eq,Show,Data,Typeable,Generic)
562
646
563-- | Creates a value of 'DiskUtilization' with the minimum fields required to make a request.
647-- | Creates a value of 'DiskUtilization' with the minimum fields required to make a request.
564--
648--
565-- Use one of the following lenses to modify other fields as desired:
649-- Use one of the following lenses to modify other fields as desired:
566--
650--
567−-- * 'duTargetWriteOpsPerSec'
651+-- * 'duTargetReadBytesPerSecond'
568--
652--
569−-- * 'duTargetReadOpsPerSec'
653+-- * 'duTargetReadOpsPerSecond'
570--
654--
571−-- * 'duTargetWriteBytesPerSec'
655+-- * 'duTargetWriteOpsPerSecond'
572--
656--
573−-- * 'duTargetReadBytesPerSec'
657+-- * 'duTargetWriteBytesPerSecond'
574diskUtilization
658diskUtilization
575 :: DiskUtilization
659 :: DiskUtilization
576diskUtilization =
660diskUtilization =
577 DiskUtilization'
661 DiskUtilization'
578− { _duTargetWriteOpsPerSec = Nothing
662+ { _duTargetReadBytesPerSecond = Nothing
579− , _duTargetReadOpsPerSec = Nothing
663+ , _duTargetReadOpsPerSecond = Nothing
580− , _duTargetWriteBytesPerSec = Nothing
664+ , _duTargetWriteOpsPerSecond = Nothing
581− , _duTargetReadBytesPerSec = Nothing
665+ , _duTargetWriteBytesPerSecond = Nothing
582 }
666 }
583
667
584−-- | Target ops per second written.
668+-- | Target bytes read per second.
585−duTargetWriteOpsPerSec :: Lens' DiskUtilization (Maybe Int32)
669+duTargetReadBytesPerSecond :: Lens' DiskUtilization (Maybe Int32)
586−duTargetWriteOpsPerSec
670+duTargetReadBytesPerSecond
587− = lens _duTargetWriteOpsPerSec
671+ = lens _duTargetReadBytesPerSecond
588− (\ s a -> s{_duTargetWriteOpsPerSec = a})
672+ (\ s a -> s{_duTargetReadBytesPerSecond = a})
589 . mapping _Coerce
673 . mapping _Coerce
590
674
591−-- | Target ops per second read.
675+-- | Target ops read per seconds.
592−duTargetReadOpsPerSec :: Lens' DiskUtilization (Maybe Int32)
676+duTargetReadOpsPerSecond :: Lens' DiskUtilization (Maybe Int32)
593−duTargetReadOpsPerSec
677+duTargetReadOpsPerSecond
594− = lens _duTargetReadOpsPerSec
678+ = lens _duTargetReadOpsPerSecond
595− (\ s a -> s{_duTargetReadOpsPerSec = a})
679+ (\ s a -> s{_duTargetReadOpsPerSecond = a})
596 . mapping _Coerce
680 . mapping _Coerce
597
681
598−-- | Target bytes per second written.
682+-- | Target ops written per second.
599−duTargetWriteBytesPerSec :: Lens' DiskUtilization (Maybe Int32)
683+duTargetWriteOpsPerSecond :: Lens' DiskUtilization (Maybe Int32)
600−duTargetWriteBytesPerSec
684+duTargetWriteOpsPerSecond
601− = lens _duTargetWriteBytesPerSec
685+ = lens _duTargetWriteOpsPerSecond
602− (\ s a -> s{_duTargetWriteBytesPerSec = a})
686+ (\ s a -> s{_duTargetWriteOpsPerSecond = a})
603 . mapping _Coerce
687 . mapping _Coerce
604
688
605−-- | Target bytes per second read.
689+-- | Target bytes written per second.
606−duTargetReadBytesPerSec :: Lens' DiskUtilization (Maybe Int32)
690+duTargetWriteBytesPerSecond :: Lens' DiskUtilization (Maybe Int32)
607−duTargetReadBytesPerSec
691+duTargetWriteBytesPerSecond
608− = lens _duTargetReadBytesPerSec
692+ = lens _duTargetWriteBytesPerSecond
609− (\ s a -> s{_duTargetReadBytesPerSec = a})
693+ (\ s a -> s{_duTargetWriteBytesPerSecond = a})
610 . mapping _Coerce
694 . mapping _Coerce
611
695
612instance FromJSON DiskUtilization where
696instance FromJSON DiskUtilization where
@@ -614,23 +698,23 @@ instance FromJSON DiskUtilization where
614 = withObject "DiskUtilization"
698 = withObject "DiskUtilization"
615 (\ o ->
699 (\ o ->
616 DiskUtilization' <$>
700 DiskUtilization' <$>
617− (o .:? "targetWriteOpsPerSec") <*>
701+ (o .:? "targetReadBytesPerSecond") <*>
618− (o .:? "targetReadOpsPerSec")
702+ (o .:? "targetReadOpsPerSecond")
619− <*> (o .:? "targetWriteBytesPerSec")
703+ <*> (o .:? "targetWriteOpsPerSecond")
620− <*> (o .:? "targetReadBytesPerSec"))
704+ <*> (o .:? "targetWriteBytesPerSecond"))
621
705
622instance ToJSON DiskUtilization where
706instance ToJSON DiskUtilization where
623 toJSON DiskUtilization'{..}
707 toJSON DiskUtilization'{..}
624 = object
708 = object
625 (catMaybes
709 (catMaybes
626− [("targetWriteOpsPerSec" .=) <$>
710+ [("targetReadBytesPerSecond" .=) <$>
627− _duTargetWriteOpsPerSec,
711+ _duTargetReadBytesPerSecond,
628− ("targetReadOpsPerSec" .=) <$>
712+ ("targetReadOpsPerSecond" .=) <$>
629− _duTargetReadOpsPerSec,
713+ _duTargetReadOpsPerSecond,
630− ("targetWriteBytesPerSec" .=) <$>
714+ ("targetWriteOpsPerSecond" .=) <$>
631− _duTargetWriteBytesPerSec,
715+ _duTargetWriteOpsPerSecond,
632− ("targetReadBytesPerSec" .=) <$>
716+ ("targetWriteBytesPerSecond" .=) <$>
633− _duTargetReadBytesPerSec])
717+ _duTargetWriteBytesPerSecond])
634
718
635-- | The response message for Operations.ListOperations.
719-- | The response message for Operations.ListOperations.
636--
720--
@@ -684,8 +768,9 @@ instance ToJSON ListOperationsResponse where
684 [("nextPageToken" .=) <$> _lorNextPageToken,
768 [("nextPageToken" .=) <$> _lorNextPageToken,
685 ("operations" .=) <$> _lorOperations])
769 ("operations" .=) <$> _lorOperations])
686
770
687−-- | Configure health checking for the VM instances. Unhealthy VM instances
771+-- | Health checking configuration for VM instances. Unhealthy instances are
688−-- will be killed and replaced with new instances.
772+-- killed and replaced with new instances. Only applicable for instances in
773+-- App Engine flexible environment.
689--
774--
690-- /See:/ 'healthCheck' smart constructor.
775-- /See:/ 'healthCheck' smart constructor.
691data HealthCheck = HealthCheck'
776data HealthCheck = HealthCheck'
@@ -728,7 +813,7 @@ healthCheck =
728 , _hcUnhealthyThreshold = Nothing
813 , _hcUnhealthyThreshold = Nothing
729 }
814 }
730
815
731−-- | The number of consecutive successful health checks before receiving
816+-- | Number of consecutive successful health checks required before receiving
732-- traffic.
817-- traffic.
733hcHealthyThreshold :: Lens' HealthCheck (Maybe Word32)
818hcHealthyThreshold :: Lens' HealthCheck (Maybe Word32)
734hcHealthyThreshold
819hcHealthyThreshold
@@ -742,31 +827,32 @@ hcDisableHealthCheck
742 = lens _hcDisableHealthCheck
827 = lens _hcDisableHealthCheck
743 (\ s a -> s{_hcDisableHealthCheck = a})
828 (\ s a -> s{_hcDisableHealthCheck = a})
744
829
745−-- | The interval between health checks.
830+-- | Interval between health checks.
746hcCheckInterval :: Lens' HealthCheck (Maybe Text)
831hcCheckInterval :: Lens' HealthCheck (Maybe Text)
747hcCheckInterval
832hcCheckInterval
748 = lens _hcCheckInterval
833 = lens _hcCheckInterval
749 (\ s a -> s{_hcCheckInterval = a})
834 (\ s a -> s{_hcCheckInterval = a})
750
835
751−-- | The number of consecutive failed health checks before an instance is
836+-- | Number of consecutive failed health checks required before an instance
752−-- restarted.
837+-- is restarted.
753hcRestartThreshold :: Lens' HealthCheck (Maybe Word32)
838hcRestartThreshold :: Lens' HealthCheck (Maybe Word32)
754hcRestartThreshold
839hcRestartThreshold
755 = lens _hcRestartThreshold
840 = lens _hcRestartThreshold
756 (\ s a -> s{_hcRestartThreshold = a})
841 (\ s a -> s{_hcRestartThreshold = a})
757 . mapping _Coerce
842 . mapping _Coerce
758
843
759−-- | The host header to send when performing an HTTP health check (e.g.
844+-- | Host header to send when performing an HTTP health check. Example:
760−-- myapp.appspot.com)
845+-- \"myapp.appspot.com\"
761hcHost :: Lens' HealthCheck (Maybe Text)
846hcHost :: Lens' HealthCheck (Maybe Text)
762hcHost = lens _hcHost (\ s a -> s{_hcHost = a})
847hcHost = lens _hcHost (\ s a -> s{_hcHost = a})
763
848
764−-- | The amount of time before the health check is considered failed.
849+-- | Time before the health check is considered failed.
765hcTimeout :: Lens' HealthCheck (Maybe Text)
850hcTimeout :: Lens' HealthCheck (Maybe Text)
766hcTimeout
851hcTimeout
767 = lens _hcTimeout (\ s a -> s{_hcTimeout = a})
852 = lens _hcTimeout (\ s a -> s{_hcTimeout = a})
768
853
769−-- | The number of consecutive failed health checks before removing traffic.
854+-- | Number of consecutive failed health checks required before removing
855+-- traffic.
770hcUnhealthyThreshold :: Lens' HealthCheck (Maybe Word32)
856hcUnhealthyThreshold :: Lens' HealthCheck (Maybe Word32)
771hcUnhealthyThreshold
857hcUnhealthyThreshold
772 = lens _hcUnhealthyThreshold
858 = lens _hcUnhealthyThreshold
@@ -798,7 +884,9 @@ instance ToJSON HealthCheck where
798 ("timeout" .=) <$> _hcTimeout,
884 ("timeout" .=) <$> _hcTimeout,
799 ("unhealthyThreshold" .=) <$> _hcUnhealthyThreshold])
885 ("unhealthyThreshold" .=) <$> _hcUnhealthyThreshold])
800
886
887+-- | [Google Cloud
888+-- Endpoints](https:\/\/cloud.google.com\/appengine\/docs\/python\/endpoints\/)
801−-- | API Serving configuration for Cloud Endpoints.
889+-- configuration for API handlers.
802--
890--
803-- /See:/ 'apiConfigHandler' smart constructor.
891-- /See:/ 'apiConfigHandler' smart constructor.
804data APIConfigHandler = APIConfigHandler'
892data APIConfigHandler = APIConfigHandler'
@@ -833,12 +921,12 @@ apiConfigHandler =
833 , _achLogin = Nothing
921 , _achLogin = Nothing
834 }
922 }
835
923
836−-- | Specifies the path to the script from the application root directory.
924+-- | Path to the script from the application root directory.
837achScript :: Lens' APIConfigHandler (Maybe Text)
925achScript :: Lens' APIConfigHandler (Maybe Text)
838achScript
926achScript
839 = lens _achScript (\ s a -> s{_achScript = a})
927 = lens _achScript (\ s a -> s{_achScript = a})
840
928
841−-- | Configures whether security (HTTPS) should be enforced for this URL.
929+-- | Security (HTTPS) enforcement for this URL.
842achSecurityLevel :: Lens' APIConfigHandler (Maybe Text)
930achSecurityLevel :: Lens' APIConfigHandler (Maybe Text)
843achSecurityLevel
931achSecurityLevel
844 = lens _achSecurityLevel
932 = lens _achSecurityLevel
@@ -848,15 +936,15 @@ achSecurityLevel
848achURL :: Lens' APIConfigHandler (Maybe Text)
936achURL :: Lens' APIConfigHandler (Maybe Text)
849achURL = lens _achURL (\ s a -> s{_achURL = a})
937achURL = lens _achURL (\ s a -> s{_achURL = a})
850
938
851−-- | For users not logged in, how to handle access to resources with required
939+-- | Action to take when users access resources that require authentication.
852−-- login. Defaults to \"redirect\".
940+-- Defaults to \`redirect\`.
853achAuthFailAction :: Lens' APIConfigHandler (Maybe Text)
941achAuthFailAction :: Lens' APIConfigHandler (Maybe Text)
854achAuthFailAction
942achAuthFailAction
855 = lens _achAuthFailAction
943 = lens _achAuthFailAction
856 (\ s a -> s{_achAuthFailAction = a})
944 (\ s a -> s{_achAuthFailAction = a})
857
945
858−-- | What level of login is required to access this resource. Default is
946+-- | Level of login required to access this resource. Defaults to
859−-- \"optional\".
947+-- \`optional\`.
860achLogin :: Lens' APIConfigHandler (Maybe Text)
948achLogin :: Lens' APIConfigHandler (Maybe Text)
861achLogin = lens _achLogin (\ s a -> s{_achLogin = a})
949achLogin = lens _achLogin (\ s a -> s{_achLogin = a})
862
950
@@ -880,9 +968,8 @@ instance ToJSON APIConfigHandler where
880 ("authFailAction" .=) <$> _achAuthFailAction,
968 ("authFailAction" .=) <$> _achAuthFailAction,
881 ("login" .=) <$> _achLogin])
969 ("login" .=) <$> _achLogin])
882
970
883−-- | Environment variables made available to the application. Only returned
971+-- | Environment variables available to the application. Only returned in
884−-- in \`GET\` requests if \`view=FULL\` is set. May only be set on create
972+-- \`GET\` requests if \`view=FULL\` is set.
885−-- requests; once created, is immutable.
886--
973--
887-- /See:/ 'versionEnvVariables' smart constructor.
974-- /See:/ 'versionEnvVariables' smart constructor.
888newtype VersionEnvVariables = VersionEnvVariables'
975newtype VersionEnvVariables = VersionEnvVariables'
@@ -915,20 +1002,20 @@ instance FromJSON VersionEnvVariables where
915instance ToJSON VersionEnvVariables where
1002instance ToJSON VersionEnvVariables where
916 toJSON = toJSON . _vevAddtional
1003 toJSON = toJSON . _vevAddtional
917
1004
918−-- | An Application contains the top-level configuration of an App Engine
1005+-- | An Application resource contains the top-level configuration of an App
919−-- application.
1006+-- Engine application.
920--
1007--
921-- /See:/ 'application' smart constructor.
1008-- /See:/ 'application' smart constructor.
922data Application = Application'
1009data Application = Application'
923 { _aDefaultHostname :: !(Maybe Text)
1010 { _aDefaultHostname :: !(Maybe Text)
924 , _aDefaultCookieExpiration :: !(Maybe Text)
1011 , _aDefaultCookieExpiration :: !(Maybe Text)
925− , _aLocation :: !(Maybe Text)
926 , _aAuthDomain :: !(Maybe Text)
1012 , _aAuthDomain :: !(Maybe Text)
927 , _aCodeBucket :: !(Maybe Text)
1013 , _aCodeBucket :: !(Maybe Text)
928 , _aName :: !(Maybe Text)
1014 , _aName :: !(Maybe Text)
929 , _aDispatchRules :: !(Maybe [URLDispatchRule])
1015 , _aDispatchRules :: !(Maybe [URLDispatchRule])
930 , _aDefaultBucket :: !(Maybe Text)
1016 , _aDefaultBucket :: !(Maybe Text)
931 , _aId :: !(Maybe Text)
1017 , _aId :: !(Maybe Text)
1018+ , _aLocationId :: !(Maybe Text)
932 } deriving (Eq,Show,Data,Typeable,Generic)
1019 } deriving (Eq,Show,Data,Typeable,Generic)
933
1020
934-- | Creates a value of 'Application' with the minimum fields required to make a request.
1021-- | Creates a value of 'Application' with the minimum fields required to make a request.
@@ -939,8 +1026,6 @@ data Application = Application'
939--
1026--
940-- * 'aDefaultCookieExpiration'
1027-- * 'aDefaultCookieExpiration'
941--
1028--
942−-- * 'aLocation'
943−--
944-- * 'aAuthDomain'
1029-- * 'aAuthDomain'
945--
1030--
946-- * 'aCodeBucket'
1031-- * 'aCodeBucket'
@@ -952,66 +1037,58 @@ data Application = Application'
952-- * 'aDefaultBucket'
1037-- * 'aDefaultBucket'
953--
1038--
954-- * 'aId'
1039-- * 'aId'
1040+--
1041+-- * 'aLocationId'
955application
1042application
956 :: Application
1043 :: Application
957application =
1044application =
958 Application'
1045 Application'
959 { _aDefaultHostname = Nothing
1046 { _aDefaultHostname = Nothing
960 , _aDefaultCookieExpiration = Nothing
1047 , _aDefaultCookieExpiration = Nothing
961− , _aLocation = Nothing
962 , _aAuthDomain = Nothing
1048 , _aAuthDomain = Nothing
963 , _aCodeBucket = Nothing
1049 , _aCodeBucket = Nothing
964 , _aName = Nothing
1050 , _aName = Nothing
965 , _aDispatchRules = Nothing
1051 , _aDispatchRules = Nothing
966 , _aDefaultBucket = Nothing
1052 , _aDefaultBucket = Nothing
967 , _aId = Nothing
1053 , _aId = Nothing
1054+ , _aLocationId = Nothing
968 }
1055 }
969
1056
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.
971-- \'OutputOnly
1058-- \'OutputOnly
972aDefaultHostname :: Lens' Application (Maybe Text)
1059aDefaultHostname :: Lens' Application (Maybe Text)
973aDefaultHostname
1060aDefaultHostname
974 = lens _aDefaultHostname
1061 = lens _aDefaultHostname
975 (\ s a -> s{_aDefaultHostname = a})
1062 (\ s a -> s{_aDefaultHostname = a})
976
1063
977−-- | Determines the cookie expiration policy for the application.
1064+-- | Cookie expiration policy for this application. \'OutputOnly
978−-- \'OutputOnly
979aDefaultCookieExpiration :: Lens' Application (Maybe Text)
1065aDefaultCookieExpiration :: Lens' Application (Maybe Text)
980aDefaultCookieExpiration
1066aDefaultCookieExpiration
981 = lens _aDefaultCookieExpiration
1067 = lens _aDefaultCookieExpiration
982 (\ s a -> s{_aDefaultCookieExpiration = a})
1068 (\ s a -> s{_aDefaultCookieExpiration = a})
983
1069
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
1070+-- | Google Apps authentication domain that controls which users can access
994−-- may access the application. If not set, any Google Account may access
1071+-- this application. Defaults to open access for any Google Account.
995−-- the application.
996aAuthDomain :: Lens' Application (Maybe Text)
1072aAuthDomain :: Lens' Application (Maybe Text)
997aAuthDomain
1073aAuthDomain
998 = lens _aAuthDomain (\ s a -> s{_aAuthDomain = a})
1074 = lens _aAuthDomain (\ s a -> s{_aAuthDomain = a})
999
1075
1000−-- | A Google Cloud Storage bucket which can be used for storing files
1076+-- | Google Cloud Storage bucket that can be used for storing files
1001−-- associated with an application. This bucket is associated with the
1077+-- associated with this application. This bucket is associated with the
1002-- application and can be used by the gcloud deployment commands.
1078-- application and can be used by the gcloud deployment commands.
1003-- \'OutputOnly
1079-- \'OutputOnly
1004aCodeBucket :: Lens' Application (Maybe Text)
1080aCodeBucket :: Lens' Application (Maybe Text)
1005aCodeBucket
1081aCodeBucket
1006 = lens _aCodeBucket (\ s a -> s{_aCodeBucket = a})
1082 = lens _aCodeBucket (\ s a -> s{_aCodeBucket = a})
1007
1083
1008−-- | The full path to the application in the API. Example: \"apps\/myapp\".
1084+-- | Full path to the Application resource in the API. Example:
1009−-- \'OutputOnly
1085+-- \`apps\/myapp\`. \'OutputOnly
1010aName :: Lens' Application (Maybe Text)
1086aName :: Lens' Application (Maybe Text)
1011aName = lens _aName (\ s a -> s{_aName = a})
1087aName = lens _aName (\ s a -> s{_aName = a})
1012
1088
1013−-- | HTTP path dispatch rules for requests to the app that do not explicitly
1089+-- | HTTP path dispatch rules for requests to the application that do not
1014−-- target a service or version. The rules are order-dependent. \'OutputOnly
1090+-- explicitly target a service or version. Rules are order-dependent.
1091+-- \'OutputOnly
1015aDispatchRules :: Lens' Application [URLDispatchRule]
1092aDispatchRules :: Lens' Application [URLDispatchRule]
1016aDispatchRules
1093aDispatchRules
1017 = lens _aDispatchRules
1094 = lens _aDispatchRules
@@ -1019,17 +1096,28 @@ aDispatchRules
1019 . _Default
1096 . _Default
1020 . _Coerce
1097 . _Coerce
1021
1098
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
1023-- store content. \'OutputOnly
1100-- store content. \'OutputOnly
1024aDefaultBucket :: Lens' Application (Maybe Text)
1101aDefaultBucket :: Lens' Application (Maybe Text)
1025aDefaultBucket
1102aDefaultBucket
1026 = lens _aDefaultBucket
1103 = lens _aDefaultBucket
1027 (\ s a -> s{_aDefaultBucket = a})
1104 (\ s a -> s{_aDefaultBucket = a})
1028
1105
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
1029−-- | The relative name\/path of the application. Example: \"myapp\".
1108+-- deploy your application. Example: \`myapp\`.
1030aId :: Lens' Application (Maybe Text)
1109aId :: Lens' Application (Maybe Text)
1031aId = lens _aId (\ s a -> s{_aId = a})
1110aId = lens _aId (\ s a -> s{_aId = a})
1032
1111
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+
1033instance FromJSON Application where
1121instance FromJSON Application where
1034 parseJSON
1122 parseJSON
1035 = withObject "Application"
1123 = withObject "Application"
@@ -1037,13 +1125,13 @@ instance FromJSON Application where
1037 Application' <$>
1125 Application' <$>
1038 (o .:? "defaultHostname") <*>
1126 (o .:? "defaultHostname") <*>
1039 (o .:? "defaultCookieExpiration")
1127 (o .:? "defaultCookieExpiration")
1040− <*> (o .:? "location")
1041 <*> (o .:? "authDomain")
1128 <*> (o .:? "authDomain")
1042 <*> (o .:? "codeBucket")
1129 <*> (o .:? "codeBucket")
1043 <*> (o .:? "name")
1130 <*> (o .:? "name")
1044 <*> (o .:? "dispatchRules" .!= mempty)
1131 <*> (o .:? "dispatchRules" .!= mempty)
1045 <*> (o .:? "defaultBucket")
1132 <*> (o .:? "defaultBucket")
1046− <*> (o .:? "id"))
1133+ <*> (o .:? "id")
1134+ <*> (o .:? "locationId"))
1047
1135
1048instance ToJSON Application where
1136instance ToJSON Application where
1049 toJSON Application'{..}
1137 toJSON Application'{..}
@@ -1052,15 +1140,16 @@ instance ToJSON Application where
1052 [("defaultHostname" .=) <$> _aDefaultHostname,
1140 [("defaultHostname" .=) <$> _aDefaultHostname,
1053 ("defaultCookieExpiration" .=) <$>
1141 ("defaultCookieExpiration" .=) <$>
1054 _aDefaultCookieExpiration,
1142 _aDefaultCookieExpiration,
1055− ("location" .=) <$> _aLocation,
1056 ("authDomain" .=) <$> _aAuthDomain,
1143 ("authDomain" .=) <$> _aAuthDomain,
1057 ("codeBucket" .=) <$> _aCodeBucket,
1144 ("codeBucket" .=) <$> _aCodeBucket,
1058 ("name" .=) <$> _aName,
1145 ("name" .=) <$> _aName,
1059 ("dispatchRules" .=) <$> _aDispatchRules,
1146 ("dispatchRules" .=) <$> _aDispatchRules,
1060 ("defaultBucket" .=) <$> _aDefaultBucket,
1147 ("defaultBucket" .=) <$> _aDefaultBucket,
1061− ("id" .=) <$> _aId])
1148+ ("id" .=) <$> _aId,
1149+ ("locationId" .=) <$> _aLocationId])
1062
1150
1063−-- | Beta settings supplied to the application via metadata.
1151+-- | Metadata settings that are supplied to this version to enable beta
1152+-- runtime features.
1064--
1153--
1065-- /See:/ 'versionBetaSettings' smart constructor.
1154-- /See:/ 'versionBetaSettings' smart constructor.
1066newtype VersionBetaSettings = VersionBetaSettings'
1155newtype VersionBetaSettings = VersionBetaSettings'
@@ -1093,13 +1182,13 @@ instance FromJSON VersionBetaSettings where
1093instance ToJSON VersionBetaSettings where
1182instance ToJSON VersionBetaSettings where
1094 toJSON = toJSON . _vbsAddtional
1183 toJSON = toJSON . _vbsAddtional
1095
1184
1096−-- | A service is a logical component of an application that can share state
1185+-- | A Service resource is a logical component of an application that can
1097−-- and communicate in a secure fashion with other services. For example, an
1186+-- share state and communicate in a secure fashion with other services. For
1098−-- application that handles customer requests might include separate
1187+-- example, an application that handles customer requests might include
1099−-- services to handle other tasks such as API requests from mobile devices
1188+-- separate services to handle tasks such as backend data analysis or API
1100−-- or backend data analysis. Each service has a collection of versions that
1189+-- requests from mobile devices. Each service has a collection of versions
1101−-- define a specific set of code used to implement the functionality of
1190+-- that define a specific set of code used to implement the functionality
1102−-- that service.
1191+-- of that service.
1103--
1192--
1104-- /See:/ 'service' smart constructor.
1193-- /See:/ 'service' smart constructor.
1105data Service = Service'
1194data Service = Service'
@@ -1126,18 +1215,18 @@ service =
1126 , _sId = Nothing
1215 , _sId = Nothing
1127 }
1216 }
1128
1217
1129−-- | A mapping that defines fractional HTTP traffic diversion to different
1218+-- | Mapping that defines fractional HTTP traffic diversion to different
1130-- versions within the service.
1219-- versions within the service.
1131sSplit :: Lens' Service (Maybe TrafficSplit)
1220sSplit :: Lens' Service (Maybe TrafficSplit)
1132sSplit = lens _sSplit (\ s a -> s{_sSplit = a})
1221sSplit = lens _sSplit (\ s a -> s{_sSplit = a})
1133
1222
1134−-- | The full path to the Service resource in the API. Example:
1223+-- | Full path to the Service resource in the API. Example:
1135−-- \"apps\/myapp\/services\/default\" \'OutputOnly
1224+-- \`apps\/myapp\/services\/default\`. \'OutputOnly
1136sName :: Lens' Service (Maybe Text)
1225sName :: Lens' Service (Maybe Text)
1137sName = lens _sName (\ s a -> s{_sName = a})
1226sName = lens _sName (\ s a -> s{_sName = a})
1138
1227
1139−-- | The relative name\/path of the service within the application. Example:
1228+-- | Relative name of the service within the application. Example:
1140−-- \"default\" \'OutputOnly
1229+-- \`default\`. \'OutputOnly
1141sId :: Lens' Service (Maybe Text)
1230sId :: Lens' Service (Maybe Text)
1142sId = lens _sId (\ s a -> s{_sId = a})
1231sId = lens _sId (\ s a -> s{_sId = a})
1143
1232
@@ -1155,6 +1244,78 @@ instance ToJSON Service where
1155 [("split" .=) <$> _sSplit, ("name" .=) <$> _sName,
1244 [("split" .=) <$> _sSplit, ("name" .=) <$> _sName,
1156 ("id" .=) <$> _sId])
1245 ("id" .=) <$> _sId])
1157
1246
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+
1158-- | This resource represents a long-running operation that is the result of
1319-- | This resource represents a long-running operation that is the result of
1159-- a network API call.
1320-- a network API call.
1160--
1321--
@@ -1246,6 +1407,58 @@ instance ToJSON Operation where
1246 ("name" .=) <$> _oName,
1407 ("name" .=) <$> _oName,
1247 ("metadata" .=) <$> _oMetadata])
1408 ("metadata" .=) <$> _oMetadata])
1248
1409
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+
1249-- | Rules to match an HTTP request and dispatch that request to a service.
1462-- | Rules to match an HTTP request and dispatch that request to a service.
1250--
1463--
1251-- /See:/ 'urlDispatchRule' smart constructor.
1464-- /See:/ 'urlDispatchRule' smart constructor.
@@ -1273,21 +1486,21 @@ urlDispatchRule =
1273 , _udrDomain = Nothing
1486 , _udrDomain = Nothing
1274 }
1487 }
1275
1488
1276−-- | The pathname within the host. This must start with a \'\/\'. A single
1489+-- | Pathname within the host. Must start with a \"\`\/\`\". A single
1277−-- \'*\' (glob) can be included at the end of the path. The sum of the
1490+-- \"\`*\`\" can be included at the end of the path. The sum of the lengths
1278−-- lengths of the domain and path may not exceed 100 characters.
1491+-- of the domain and path may not exceed 100 characters.
1279udrPath :: Lens' URLDispatchRule (Maybe Text)
1492udrPath :: Lens' URLDispatchRule (Maybe Text)
1280udrPath = lens _udrPath (\ s a -> s{_udrPath = a})
1493udrPath = lens _udrPath (\ s a -> s{_udrPath = a})
1281
1494
1282−-- | The resource id of a Service in this application that should service the
1495+-- | Resource ID of a service in this application that should serve the
1283−-- matched request. The Service must already exist. Example: \"default\".
1496+-- matched request. The service must already exist. Example: \`default\`.
1284udrService :: Lens' URLDispatchRule (Maybe Text)
1497udrService :: Lens' URLDispatchRule (Maybe Text)
1285udrService
1498udrService
1286 = lens _udrService (\ s a -> s{_udrService = a})
1499 = lens _udrService (\ s a -> s{_udrService = a})
1287
1500
1288−-- | The domain name to match on. Supports \'*\' (glob) wildcarding on the
1501+-- | Domain name to match against. The wildcard \"\`*\`\" is supported if
1289−-- left-hand side of a \'.\'. If empty, all domains will be matched (the
1502+-- specified before a period: \"\`*.\`\". Defaults to matching all domains:
1290−-- same as \'*\').
1503+-- \"\`*\`\".
1291udrDomain :: Lens' URLDispatchRule (Maybe Text)
1504udrDomain :: Lens' URLDispatchRule (Maybe Text)
1292udrDomain
1505udrDomain
1293 = lens _udrDomain (\ s a -> s{_udrDomain = a})
1506 = lens _udrDomain (\ s a -> s{_udrDomain = a})
@@ -1337,7 +1550,7 @@ lvrNextPageToken
1337 = lens _lvrNextPageToken
1550 = lens _lvrNextPageToken
1338 (\ s a -> s{_lvrNextPageToken = a})
1551 (\ s a -> s{_lvrNextPageToken = a})
1339
1552
1340−-- | The versions belonging to the requested application service.
1553+-- | The versions belonging to the requested service.
1341lvrVersions :: Lens' ListVersionsResponse [Version]
1554lvrVersions :: Lens' ListVersionsResponse [Version]
1342lvrVersions
1555lvrVersions
1343 = lens _lvrVersions (\ s a -> s{_lvrVersions = a}) .
1556 = lens _lvrVersions (\ s a -> s{_lvrVersions = a}) .
@@ -1359,7 +1572,8 @@ instance ToJSON ListVersionsResponse where
1359 [("nextPageToken" .=) <$> _lvrNextPageToken,
1572 [("nextPageToken" .=) <$> _lvrNextPageToken,
1360 ("versions" .=) <$> _lvrVersions])
1573 ("versions" .=) <$> _lvrVersions])
1361
1574
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.
1363--
1577--
1364-- /See:/ 'fileInfo' smart constructor.
1578-- /See:/ 'fileInfo' smart constructor.
1365data FileInfo = FileInfo'
1579data FileInfo = FileInfo'
@@ -1386,18 +1600,18 @@ fileInfo =
1386 , _fiSourceURL = Nothing
1600 , _fiSourceURL = Nothing
1387 }
1601 }
1388
1602
1389−-- | The SHA1 (160 bits) hash of the file in hex.
1603+-- | The SHA1 hash of the file, in hex.
1390fiSha1Sum :: Lens' FileInfo (Maybe Text)
1604fiSha1Sum :: Lens' FileInfo (Maybe Text)
1391fiSha1Sum
1605fiSha1Sum
1392 = lens _fiSha1Sum (\ s a -> s{_fiSha1Sum = a})
1606 = lens _fiSha1Sum (\ s a -> s{_fiSha1Sum = a})
1393
1607
1394−-- | The MIME type of the file; if unspecified, the value from Google Cloud
1608+-- | The MIME type of the file. Defaults to the value from Google Cloud
1395−-- Storage will be used.
1609+-- Storage.
1396fiMimeType :: Lens' FileInfo (Maybe Text)
1610fiMimeType :: Lens' FileInfo (Maybe Text)
1397fiMimeType
1611fiMimeType
1398 = lens _fiMimeType (\ s a -> s{_fiMimeType = a})
1612 = lens _fiMimeType (\ s a -> s{_fiMimeType = a})
1399
1613
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
1401-- Google Cloud Storage in the form
1615-- Google Cloud Storage in the form
1402-- \'http(s):\/\/storage.googleapis.com\/\\\/\\\'.
1616-- \'http(s):\/\/storage.googleapis.com\/\\\/\\\'.
1403fiSourceURL :: Lens' FileInfo (Maybe Text)
1617fiSourceURL :: Lens' FileInfo (Maybe Text)
@@ -1420,8 +1634,7 @@ instance ToJSON FileInfo where
1420 ("mimeType" .=) <$> _fiMimeType,
1634 ("mimeType" .=) <$> _fiMimeType,
1421 ("sourceUrl" .=) <$> _fiSourceURL])
1635 ("sourceUrl" .=) <$> _fiSourceURL])
1422
1636
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
1425-- other application metrics.
1638-- other application metrics.
1426--
1639--
1427-- /See:/ 'automaticScaling' smart constructor.
1640-- /See:/ 'automaticScaling' smart constructor.
@@ -1491,16 +1704,15 @@ asNetworkUtilization
1491 = lens _asNetworkUtilization
1704 = lens _asNetworkUtilization
1492 (\ s a -> s{_asNetworkUtilization = a})
1705 (\ s a -> s{_asNetworkUtilization = a})
1493
1706
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.
1495asMaxTotalInstances :: Lens' AutomaticScaling (Maybe Int32)
1708asMaxTotalInstances :: Lens' AutomaticScaling (Maybe Int32)
1496asMaxTotalInstances
1709asMaxTotalInstances
1497 = lens _asMaxTotalInstances
1710 = lens _asMaxTotalInstances
1498 (\ s a -> s{_asMaxTotalInstances = a})
1711 (\ s a -> s{_asMaxTotalInstances = a})
1499 . mapping _Coerce
1712 . mapping _Coerce
1500
1713
1501−-- | The minimum number of idle instances that App Engine should maintain for
1714+-- | Minimum number of idle instances that should be maintained for this
1502−-- this version. Only applies to the default version of a service, since
1715+-- version. Only applicable for the default version of a service.
1503−-- other versions are not expected to receive significant traffic.
1504asMinIdleInstances :: Lens' AutomaticScaling (Maybe Int32)
1716asMinIdleInstances :: Lens' AutomaticScaling (Maybe Int32)
1505asMinIdleInstances
1717asMinIdleInstances
1506 = lens _asMinIdleInstances
1718 = lens _asMinIdleInstances
@@ -1513,8 +1725,8 @@ asDiskUtilization
1513 = lens _asDiskUtilization
1725 = lens _asDiskUtilization
1514 (\ s a -> s{_asDiskUtilization = a})
1726 (\ s a -> s{_asDiskUtilization = a})
1515
1727
1516−-- | The minimum amount of time that App Engine should allow a request to
1728+-- | Minimum amount of time a request should wait in the pending queue before
1517−-- wait in the pending queue before starting a new instance to handle it.
1729+-- starting a new instance to handle it.
1518asMinPendingLatency :: Lens' AutomaticScaling (Maybe Text)
1730asMinPendingLatency :: Lens' AutomaticScaling (Maybe Text)
1519asMinPendingLatency
1731asMinPendingLatency
1520 = lens _asMinPendingLatency
1732 = lens _asMinPendingLatency
@@ -1526,34 +1738,34 @@ asCPUUtilization
1526 = lens _asCPUUtilization
1738 = lens _asCPUUtilization
1527 (\ s a -> s{_asCPUUtilization = a})
1739 (\ s a -> s{_asCPUUtilization = a})
1528
1740
1529−-- | The maximum number of idle instances that App Engine should maintain for
1741+-- | Maximum number of idle instances that should be maintained for this
1530−-- this version.
1742+-- version.
1531asMaxIdleInstances :: Lens' AutomaticScaling (Maybe Int32)
1743asMaxIdleInstances :: Lens' AutomaticScaling (Maybe Int32)
1532asMaxIdleInstances
1744asMaxIdleInstances
1533 = lens _asMaxIdleInstances
1745 = lens _asMaxIdleInstances
1534 (\ s a -> s{_asMaxIdleInstances = a})
1746 (\ s a -> s{_asMaxIdleInstances = a})
1535 . mapping _Coerce
1747 . mapping _Coerce
1536
1748
1537−-- | Minimum number of instances that App Engine should maintain.
1749+-- | Minimum number of instances that should be maintained for this version.
1538asMinTotalInstances :: Lens' AutomaticScaling (Maybe Int32)
1750asMinTotalInstances :: Lens' AutomaticScaling (Maybe Int32)
1539asMinTotalInstances
1751asMinTotalInstances
1540 = lens _asMinTotalInstances
1752 = lens _asMinTotalInstances
1541 (\ s a -> s{_asMinTotalInstances = a})
1753 (\ s a -> s{_asMinTotalInstances = a})
1542 . mapping _Coerce
1754 . mapping _Coerce
1543
1755
1544−-- | The number of concurrent requests an automatic scaling instance can
1756+-- | Number of concurrent requests an automatic scaling instance can accept
1545−-- accept before the scheduler spawns a new instance. Default value is
1757+-- before the scheduler spawns a new instance. Defaults to a
1546−-- chosen based on the runtime.
1758+-- runtime-specific value.
1547asMaxConcurrentRequests :: Lens' AutomaticScaling (Maybe Int32)
1759asMaxConcurrentRequests :: Lens' AutomaticScaling (Maybe Int32)
1548asMaxConcurrentRequests
1760asMaxConcurrentRequests
1549 = lens _asMaxConcurrentRequests
1761 = lens _asMaxConcurrentRequests
1550 (\ s a -> s{_asMaxConcurrentRequests = a})
1762 (\ s a -> s{_asMaxConcurrentRequests = a})
1551 . mapping _Coerce
1763 . mapping _Coerce
1552
1764
1553−-- | The amount of time that the
1765+-- | Amount of time that the
1554-- [Autoscaler](https:\/\/cloud.google.com\/compute\/docs\/autoscaler\/)
1766-- [Autoscaler](https:\/\/cloud.google.com\/compute\/docs\/autoscaler\/)
1555−-- should wait between changes to the number of virtual machines. Applies
1767+-- should wait between changes to the number of virtual machines. Only
1556−-- only to the VM runtime.
1768+-- applicable for VM runtimes.
1557asCoolDownPeriod :: Lens' AutomaticScaling (Maybe Text)
1769asCoolDownPeriod :: Lens' AutomaticScaling (Maybe Text)
1558asCoolDownPeriod
1770asCoolDownPeriod
1559 = lens _asCoolDownPeriod
1771 = lens _asCoolDownPeriod
@@ -1565,8 +1777,8 @@ asRequestUtilization
1565 = lens _asRequestUtilization
1777 = lens _asRequestUtilization
1566 (\ s a -> s{_asRequestUtilization = a})
1778 (\ s a -> s{_asRequestUtilization = a})
1567
1779
1568−-- | The maximum amount of time that App Engine should allow a request to
1780+-- | Maximum amount of time that a request should wait in the pending queue
1569−-- wait in the pending queue before starting a new instance to handle it.
1781+-- before starting a new instance to handle it.
1570asMaxPendingLatency :: Lens' AutomaticScaling (Maybe Text)
1782asMaxPendingLatency :: Lens' AutomaticScaling (Maybe Text)
1571asMaxPendingLatency
1783asMaxPendingLatency
1572 = lens _asMaxPendingLatency
1784 = lens _asMaxPendingLatency
@@ -1643,30 +1855,29 @@ operationMetadataV1Beta5 =
1643 , _omvbTarget = Nothing
1855 , _omvbTarget = Nothing
1644 }
1856 }
1645
1857
1646−-- | Timestamp that this operation was received. \'OutputOnly
1858+-- | Timestamp that this operation was created. \'OutputOnly
1647omvbInsertTime :: Lens' OperationMetadataV1Beta5 (Maybe Text)
1859omvbInsertTime :: Lens' OperationMetadataV1Beta5 (Maybe Text)
1648omvbInsertTime
1860omvbInsertTime
1649 = lens _omvbInsertTime
1861 = lens _omvbInsertTime
1650 (\ s a -> s{_omvbInsertTime = a})
1862 (\ s a -> s{_omvbInsertTime = a})
1651
1863
1652−-- | The user who requested this operation. \'OutputOnly
1864+-- | User who requested this operation. \'OutputOnly
1653omvbUser :: Lens' OperationMetadataV1Beta5 (Maybe Text)
1865omvbUser :: Lens' OperationMetadataV1Beta5 (Maybe Text)
1654omvbUser = lens _omvbUser (\ s a -> s{_omvbUser = a})
1866omvbUser = lens _omvbUser (\ s a -> s{_omvbUser = a})
1655
1867
1656−-- | API method name that initiated the operation. Example:
1868+-- | API method name that initiated this operation. Example:
1657−-- \"google.appengine.v1beta5.Version.CreateVersion\". \'OutputOnly
1869+-- \`google.appengine.v1beta5.Version.CreateVersion\`. \'OutputOnly
1658omvbMethod :: Lens' OperationMetadataV1Beta5 (Maybe Text)
1870omvbMethod :: Lens' OperationMetadataV1Beta5 (Maybe Text)
1659omvbMethod
1871omvbMethod
1660 = lens _omvbMethod (\ s a -> s{_omvbMethod = a})
1872 = lens _omvbMethod (\ s a -> s{_omvbMethod = a})
1661
1873
1662−-- | Timestamp that this operation was completed. (Not present if the
1874+-- | Timestamp that this operation completed. \'OutputOnly
1663−-- operation is still in progress.) \'OutputOnly
1664omvbEndTime :: Lens' OperationMetadataV1Beta5 (Maybe Text)
1875omvbEndTime :: Lens' OperationMetadataV1Beta5 (Maybe Text)
1665omvbEndTime
1876omvbEndTime
1666 = lens _omvbEndTime (\ s a -> s{_omvbEndTime = a})
1877 = lens _omvbEndTime (\ s a -> s{_omvbEndTime = a})
1667
1878
1668−-- | Resource that this operation is acting on. Example:
1879+-- | Name of the resource that this operation is acting on. Example:
1669−-- \"apps\/myapp\/services\/default\". \'OutputOnly
1880+-- \`apps\/myapp\/services\/default\`. \'OutputOnly
1670omvbTarget :: Lens' OperationMetadataV1Beta5 (Maybe Text)
1881omvbTarget :: Lens' OperationMetadataV1Beta5 (Maybe Text)
1671omvbTarget
1882omvbTarget
1672 = lens _omvbTarget (\ s a -> s{_omvbTarget = a})
1883 = lens _omvbTarget (\ s a -> s{_omvbTarget = a})
@@ -1691,7 +1902,7 @@ instance ToJSON OperationMetadataV1Beta5 where
1691 ("endTime" .=) <$> _omvbEndTime,
1902 ("endTime" .=) <$> _omvbEndTime,
1692 ("target" .=) <$> _omvbTarget])
1903 ("target" .=) <$> _omvbTarget])
1693
1904
1694−-- | Use Google Cloud Endpoints to handle requests.
1905+-- | Uses Google Cloud Endpoints to handle requests.
1695--
1906--
1696-- /See:/ 'apiEndpointHandler' smart constructor.
1907-- /See:/ 'apiEndpointHandler' smart constructor.
1697newtype APIEndpointHandler = APIEndpointHandler'
1908newtype APIEndpointHandler = APIEndpointHandler'
@@ -1710,7 +1921,7 @@ apiEndpointHandler =
1710 { _aehScriptPath = Nothing
1921 { _aehScriptPath = Nothing
1711 }
1922 }
1712
1923
1713−-- | Specifies the path to the script from the application root directory.
1924+-- | Path to the script from the application root directory.
1714aehScriptPath :: Lens' APIEndpointHandler (Maybe Text)
1925aehScriptPath :: Lens' APIEndpointHandler (Maybe Text)
1715aehScriptPath
1926aehScriptPath
1716 = lens _aehScriptPath
1927 = lens _aehScriptPath
@@ -1745,7 +1956,7 @@ statusDetailsItem pSdiAddtional_ =
1745 { _sdiAddtional = _Coerce # pSdiAddtional_
1956 { _sdiAddtional = _Coerce # pSdiAddtional_
1746 }
1957 }
1747
1958
1748−-- | Properties of the object. Contains field \'ype with type URL.
1959+-- | Properties of the object. Contains field \'type with type URL.
1749sdiAddtional :: Lens' StatusDetailsItem (HashMap Text JSONValue)
1960sdiAddtional :: Lens' StatusDetailsItem (HashMap Text JSONValue)
1750sdiAddtional
1961sdiAddtional
1751 = lens _sdiAddtional (\ s a -> s{_sdiAddtional = a})
1962 = lens _sdiAddtional (\ s a -> s{_sdiAddtional = a})
@@ -1759,7 +1970,7 @@ instance FromJSON StatusDetailsItem where
1759instance ToJSON StatusDetailsItem where
1970instance ToJSON StatusDetailsItem where
1760 toJSON = toJSON . _sdiAddtional
1971 toJSON = toJSON . _sdiAddtional
1761
1972
1762−-- | Used to specify extra network settings (for VM runtimes only).
1973+-- | Extra network settings. Only applicable for VM runtimes.
1763--
1974--
1764-- /See:/ 'network' smart constructor.
1975-- /See:/ 'network' smart constructor.
1765data Network = Network'
1976data Network = Network'
@@ -1786,8 +1997,8 @@ network =
1786 , _nName = Nothing
1997 , _nName = Nothing
1787 }
1998 }
1788
1999
1789−-- | A list of ports (or port pairs) to forward from the VM into the app
2000+-- | List of ports, or port pairs, to forward from the virtual machine to the
1790−-- container.
2001+-- application container.
1791nForwardedPorts :: Lens' Network [Text]
2002nForwardedPorts :: Lens' Network [Text]
1792nForwardedPorts
2003nForwardedPorts
1793 = lens _nForwardedPorts
2004 = lens _nForwardedPorts
@@ -1795,14 +2006,13 @@ nForwardedPorts
1795 . _Default
2006 . _Default
1796 . _Coerce
2007 . _Coerce
1797
2008
1798−-- | A tag to apply to the VM instance during creation.
2009+-- | Tag to apply to the VM instance during creation.
1799nInstanceTag :: Lens' Network (Maybe Text)
2010nInstanceTag :: Lens' Network (Maybe Text)
1800nInstanceTag
2011nInstanceTag
1801 = lens _nInstanceTag (\ s a -> s{_nInstanceTag = a})
2012 = lens _nInstanceTag (\ s a -> s{_nInstanceTag = a})
1802
2013
1803−-- | The Google Compute Engine network where the VMs will be created. If not
2014+-- | Google Cloud Platform network where the virtual machines are created.
1804−-- specified, or empty, the network named \"default\" will be used. (The
1805−-- short name should be specified, not the resource path.)
2015+-- Specify the short name, not the resource path. Defaults to \`default\`.
1806nName :: Lens' Network (Maybe Text)
2016nName :: Lens' Network (Maybe Text)
1807nName = lens _nName (\ s a -> s{_nName = a})
2017nName = lens _nName (\ s a -> s{_nName = a})
1808
2018
@@ -1823,6 +2033,27 @@ instance ToJSON Network where
1823 ("instanceTag" .=) <$> _nInstanceTag,
2033 ("instanceTag" .=) <$> _nInstanceTag,
1824 ("name" .=) <$> _nName])
2034 ("name" .=) <$> _nName])
1825
2035
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+
1826-- | HTTP headers to use for all responses from these URLs.
2057-- | HTTP headers to use for all responses from these URLs.
1827--
2058--
1828-- /See:/ 'staticFilesHandlerHTTPHeaders' smart constructor.
2059-- /See:/ 'staticFilesHandlerHTTPHeaders' smart constructor.
@@ -1859,7 +2090,7 @@ instance FromJSON StaticFilesHandlerHTTPHeaders where
1859instance ToJSON StaticFilesHandlerHTTPHeaders where
2090instance ToJSON StaticFilesHandlerHTTPHeaders where
1860 toJSON = toJSON . _sfhhttphAddtional
2091 toJSON = toJSON . _sfhhttphAddtional
1861
2092
1862−-- | Used to specify how many machine resources an app version needs.
2093+-- | Machine resources for a version.
1863--
2094--
1864-- /See:/ 'resources' smart constructor.
2095-- /See:/ 'resources' smart constructor.
1865data Resources = Resources'
2096data Resources = Resources'
@@ -1886,19 +2117,19 @@ resources =
1886 , _rCPU = Nothing
2117 , _rCPU = Nothing
1887 }
2118 }
1888
2119
1889−-- | How much memory, in GB, an app version needs.
2120+-- | Memory (GB) needed.
1890rMemoryGb :: Lens' Resources (Maybe Double)
2121rMemoryGb :: Lens' Resources (Maybe Double)
1891rMemoryGb
2122rMemoryGb
1892 = lens _rMemoryGb (\ s a -> s{_rMemoryGb = a}) .
2123 = lens _rMemoryGb (\ s a -> s{_rMemoryGb = a}) .
1893 mapping _Coerce
2124 mapping _Coerce
1894
2125
1895−-- | How much disk size, in GB, an app version needs.
2126+-- | Disk size (GB) needed.
1896rDiskGb :: Lens' Resources (Maybe Double)
2127rDiskGb :: Lens' Resources (Maybe Double)
1897rDiskGb
2128rDiskGb
1898 = lens _rDiskGb (\ s a -> s{_rDiskGb = a}) .
2129 = lens _rDiskGb (\ s a -> s{_rDiskGb = a}) .
1899 mapping _Coerce
2130 mapping _Coerce
1900
2131
1901−-- | How many CPU cores an app version needs.
2132+-- | Number of CPU cores needed.
1902rCPU :: Lens' Resources (Maybe Double)
2133rCPU :: Lens' Resources (Maybe Double)
1903rCPU
2134rCPU
1904 = lens _rCPU (\ s a -> s{_rCPU = a}) .
2135 = lens _rCPU (\ s a -> s{_rCPU = a}) .
@@ -1919,9 +2150,9 @@ instance ToJSON Resources where
1919 [("memoryGb" .=) <$> _rMemoryGb,
2150 [("memoryGb" .=) <$> _rMemoryGb,
1920 ("diskGb" .=) <$> _rDiskGb, ("cpu" .=) <$> _rCPU])
2151 ("diskGb" .=) <$> _rDiskGb, ("cpu" .=) <$> _rCPU])
1921
2152
1922−-- | A manifest of files stored in Google Cloud Storage which should be
2153+-- | Manifest of the files stored in Google Cloud Storage that are included
1923−-- included as part of this application. All files must be readable using
2154+-- as part of this version. All files must be readable using the
1924−-- the credentials supplied with this call.
2155+-- credentials supplied with this call.
1925--
2156--
1926-- /See:/ 'deploymentFiles' smart constructor.
2157-- /See:/ 'deploymentFiles' smart constructor.
1927newtype DeploymentFiles = DeploymentFiles'
2158newtype DeploymentFiles = DeploymentFiles'
@@ -1977,13 +2208,14 @@ cpuUtilization =
1977 , _cuTargetUtilization = Nothing
2208 , _cuTargetUtilization = Nothing
1978 }
2209 }
1979
2210
1980−-- | The period of time over which CPU utilization is calculated.
2211+-- | Period of time over which CPU utilization is calculated.
1981cuAggregationWindowLength :: Lens' CPUUtilization (Maybe Text)
2212cuAggregationWindowLength :: Lens' CPUUtilization (Maybe Text)
1982cuAggregationWindowLength
2213cuAggregationWindowLength
1983 = lens _cuAggregationWindowLength
2214 = lens _cuAggregationWindowLength
1984 (\ s a -> s{_cuAggregationWindowLength = a})
2215 (\ s a -> s{_cuAggregationWindowLength = a})
1985
2216
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.
1987cuTargetUtilization :: Lens' CPUUtilization (Maybe Double)
2219cuTargetUtilization :: Lens' CPUUtilization (Maybe Double)
1988cuTargetUtilization
2220cuTargetUtilization
1989 = lens _cuTargetUtilization
2221 = lens _cuTargetUtilization
@@ -2006,14 +2238,14 @@ instance ToJSON CPUUtilization where
2006 _cuAggregationWindowLength,
2238 _cuAggregationWindowLength,
2007 ("targetUtilization" .=) <$> _cuTargetUtilization])
2239 ("targetUtilization" .=) <$> _cuTargetUtilization])
2008
2240
2009−-- | Mapping from service version IDs within the service to fractional
2241+-- | Mapping from version IDs within the service to fractional (0.000, 1]
2010−-- (0.000, 1] allocations of traffic for that version. Each version may
2242+-- allocations of traffic for that version. Each version can be specified
2011−-- only be specified once, but some versions in the service may not have
2243+-- only once, but some versions in the service may not have any traffic
2012−-- any traffic allocation. Services that have traffic allocated in this
2244+-- allocation. Services that have traffic allocated cannot be deleted until
2013−-- field may not be deleted until the service is deleted, or their traffic
2245+-- either the service is deleted or their traffic allocation is removed.
2014−-- allocation is removed. Allocations must sum to 1. Supports precision up
2246+-- Allocations must sum to 1. Up to two decimal place precision is
2015−-- to two decimal places for IP-based splits and up to three decimal places
2247+-- supported for IP-based splits and up to three decimal places is
2016−-- for cookie-based splits.
2248+-- supported for cookie-based splits.
2017--
2249--
2018-- /See:/ 'trafficSplitAllocations' smart constructor.
2250-- /See:/ 'trafficSplitAllocations' smart constructor.
2019newtype TrafficSplitAllocations = TrafficSplitAllocations'
2251newtype TrafficSplitAllocations = TrafficSplitAllocations'
@@ -2067,8 +2299,8 @@ manualScaling =
2067 { _msInstances = Nothing
2299 { _msInstances = Nothing
2068 }
2300 }
2069
2301
2070−-- | The number of instances to assign to the service at the start. This
2302+-- | Number of instances to assign to the service at the start. This number
2071−-- number can later be altered by using the [Modules
2303+-- can later be altered by using the [Modules
2072-- API](https:\/\/cloud.google.com\/appengine\/docs\/python\/modules\/functions)
2304-- API](https:\/\/cloud.google.com\/appengine\/docs\/python\/modules\/functions)
2073-- \`set_num_instances()\` function.
2305-- \`set_num_instances()\` function.
2074msInstances :: Lens' ManualScaling (Maybe Int32)
2306msInstances :: Lens' ManualScaling (Maybe Int32)
@@ -2112,16 +2344,15 @@ basicScaling =
2112 , _bsIdleTimeout = Nothing
2344 , _bsIdleTimeout = Nothing
2113 }
2345 }
2114
2346
2115−-- | The maximum number of instances for App Engine to create for this
2347+-- | Maximum number of instances to create for this version.
2116−-- version.
2117bsMaxInstances :: Lens' BasicScaling (Maybe Int32)
2348bsMaxInstances :: Lens' BasicScaling (Maybe Int32)
2118bsMaxInstances
2349bsMaxInstances
2119 = lens _bsMaxInstances
2350 = lens _bsMaxInstances
2120 (\ s a -> s{_bsMaxInstances = a})
2351 (\ s a -> s{_bsMaxInstances = a})
2121 . mapping _Coerce
2352 . mapping _Coerce
2122
2353
2123−-- | The instance will be shut down this amount of time after receiving its
2354+-- | Duration of time after the last request that an instance must wait
2124−-- last request.
2355+-- before the instance is shut down.
2125bsIdleTimeout :: Lens' BasicScaling (Maybe Text)
2356bsIdleTimeout :: Lens' BasicScaling (Maybe Text)
2126bsIdleTimeout
2357bsIdleTimeout
2127 = lens _bsIdleTimeout
2358 = lens _bsIdleTimeout
@@ -2141,14 +2372,94 @@ instance ToJSON BasicScaling where
2141 [("maxInstances" .=) <$> _bsMaxInstances,
2372 [("maxInstances" .=) <$> _bsMaxInstances,
2142 ("idleTimeout" .=) <$> _bsIdleTimeout])
2373 ("idleTimeout" .=) <$> _bsIdleTimeout])
2143
2374
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+
2144−-- | A Version is a specific set of source code and configuration files
2457+-- | A Version resource is a specific set of source code and configuration
2145−-- deployed to a service.
2458+-- files that are deployed into a service.
2146--
2459--
2147-- /See:/ 'version' smart constructor.
2460-- /See:/ 'version' smart constructor.
2148data Version = Version'
2461data Version = Version'
2149− { _vCreationTime :: !(Maybe Text)
2150− , _vRuntime :: !(Maybe Text)
2462+ { _vRuntime :: !(Maybe Text)
2151− , _vDeployer :: !(Maybe Text)
2152 , _vNobuildFilesRegex :: !(Maybe Text)
2463 , _vNobuildFilesRegex :: !(Maybe Text)
2153 , _vInstanceClass :: !(Maybe Text)
2464 , _vInstanceClass :: !(Maybe Text)
2154 , _vHealthCheck :: !(Maybe HealthCheck)
2465 , _vHealthCheck :: !(Maybe HealthCheck)
@@ -2156,6 +2467,7 @@ data Version = Version'
2156 , _vDefaultExpiration :: !(Maybe Text)
2467 , _vDefaultExpiration :: !(Maybe Text)
2157 , _vAutomaticScaling :: !(Maybe AutomaticScaling)
2468 , _vAutomaticScaling :: !(Maybe AutomaticScaling)
2158 , _vErrorHandlers :: !(Maybe [ErrorHandler])
2469 , _vErrorHandlers :: !(Maybe [ErrorHandler])
2470+ , _vCreatedBy :: !(Maybe Text)
2159 , _vVM :: !(Maybe Bool)
2471 , _vVM :: !(Maybe Bool)
2160 , _vHandlers :: !(Maybe [URLMap])
2472 , _vHandlers :: !(Maybe [URLMap])
2161 , _vInboundServices :: !(Maybe [Text])
2473 , _vInboundServices :: !(Maybe [Text])
@@ -2171,7 +2483,9 @@ data Version = Version'
2171 , _vEnvVariables :: !(Maybe VersionEnvVariables)
2483 , _vEnvVariables :: !(Maybe VersionEnvVariables)
2172 , _vServingStatus :: !(Maybe Text)
2484 , _vServingStatus :: !(Maybe Text)
2173 , _vDiskUsageBytes :: !(Maybe (Textual Int64))
2485 , _vDiskUsageBytes :: !(Maybe (Textual Int64))
2486+ , _vCreateTime :: !(Maybe Text)
2174 , _vLibraries :: !(Maybe [Library])
2487 , _vLibraries :: !(Maybe [Library])
2488+ , _vVersionURL :: !(Maybe Text)
2175 , _vDeployment :: !(Maybe Deployment)
2489 , _vDeployment :: !(Maybe Deployment)
2176 } deriving (Eq,Show,Data,Typeable,Generic)
2490 } deriving (Eq,Show,Data,Typeable,Generic)
2177
2491
@@ -2179,12 +2493,8 @@ data Version = Version'
2179--
2493--
2180-- Use one of the following lenses to modify other fields as desired:
2494-- Use one of the following lenses to modify other fields as desired:
2181--
2495--
2182−-- * 'vCreationTime'
2183−--
2184-- * 'vRuntime'
2496-- * 'vRuntime'
2185--
2497--
2186−-- * 'vDeployer'
2187−--
2188-- * 'vNobuildFilesRegex'
2498-- * 'vNobuildFilesRegex'
2189--
2499--
2190-- * 'vInstanceClass'
2500-- * 'vInstanceClass'
@@ -2199,6 +2509,8 @@ data Version = Version'
2199--
2509--
2200-- * 'vErrorHandlers'
2510-- * 'vErrorHandlers'
2201--
2511--
2512+-- * 'vCreatedBy'
2513+--
2202-- * 'vVM'
2514-- * 'vVM'
2203--
2515--
2204-- * 'vHandlers'
2516-- * 'vHandlers'
@@ -2229,16 +2541,18 @@ data Version = Version'
2229--
2541--
2230-- * 'vDiskUsageBytes'
2542-- * 'vDiskUsageBytes'
2231--
2543--
2544+-- * 'vCreateTime'
2545+--
2232-- * 'vLibraries'
2546-- * 'vLibraries'
2233--
2547--
2548+-- * 'vVersionURL'
2549+--
2234-- * 'vDeployment'
2550-- * 'vDeployment'
2235version
2551version
2236 :: Version
2552 :: Version
2237version =
2553version =
2238 Version'
2554 Version'
2239− { _vCreationTime = Nothing
2240− , _vRuntime = Nothing
2555+ { _vRuntime = Nothing
2241− , _vDeployer = Nothing
2242 , _vNobuildFilesRegex = Nothing
2556 , _vNobuildFilesRegex = Nothing
2243 , _vInstanceClass = Nothing
2557 , _vInstanceClass = Nothing
2244 , _vHealthCheck = Nothing
2558 , _vHealthCheck = Nothing
@@ -2246,6 +2560,7 @@ version =
2246 , _vDefaultExpiration = Nothing
2560 , _vDefaultExpiration = Nothing
2247 , _vAutomaticScaling = Nothing
2561 , _vAutomaticScaling = Nothing
2248 , _vErrorHandlers = Nothing
2562 , _vErrorHandlers = Nothing
2563+ , _vCreatedBy = Nothing
2249 , _vVM = Nothing
2564 , _vVM = Nothing
2250 , _vHandlers = Nothing
2565 , _vHandlers = Nothing
2251 , _vInboundServices = Nothing
2566 , _vInboundServices = Nothing
@@ -2261,76 +2576,65 @@ version =
2261 , _vEnvVariables = Nothing
2576 , _vEnvVariables = Nothing
2262 , _vServingStatus = Nothing
2577 , _vServingStatus = Nothing
2263 , _vDiskUsageBytes = Nothing
2578 , _vDiskUsageBytes = Nothing
2579+ , _vCreateTime = Nothing
2264 , _vLibraries = Nothing
2580 , _vLibraries = Nothing
2581+ , _vVersionURL = Nothing
2265 , _vDeployment = Nothing
2582 , _vDeployment = Nothing
2266 }
2583 }
2267
2584
2268−-- | Creation time of this version. This will be between the start and end
2585+-- | Desired runtime. Example: \`python27\`.
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.
2276vRuntime :: Lens' Version (Maybe Text)
2586vRuntime :: Lens' Version (Maybe Text)
2277vRuntime = lens _vRuntime (\ s a -> s{_vRuntime = a})
2587vRuntime = lens _vRuntime (\ s a -> s{_vRuntime = a})
2278
2588
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.
2589+-- | Files that match this pattern will not be built into this version. Only
2285−-- May only be set on create requests.
2590+-- applicable for Go runtimes. Only returned in \`GET\` requests if
2591+-- \`view=FULL\` is set.
2286vNobuildFilesRegex :: Lens' Version (Maybe Text)
2592vNobuildFilesRegex :: Lens' Version (Maybe Text)
2287vNobuildFilesRegex
2593vNobuildFilesRegex
2288 = lens _vNobuildFilesRegex
2594 = lens _vNobuildFilesRegex
2289 (\ s a -> s{_vNobuildFilesRegex = a})
2595 (\ s a -> s{_vNobuildFilesRegex = a})
2290
2596
2291−-- | The instance class to use to run this app. Valid values for
2597+-- | Instance class that is used to run this version. Valid values are: *
2292−-- AutomaticScaling are \`[F1, F2, F4, F4_1G]\`. Valid values for
2598+-- AutomaticScaling: \`F1\`, \`F2\`, \`F4\`, \`F4_1G\` * ManualScaling or
2293−-- ManualScaling and BasicScaling are \`[B1, B2, B4, B8, B4_1G]\`. Default:
2599+-- BasicScaling: \`B1\`, \`B2\`, \`B4\`, \`B8\`, \`B4_1G\` Defaults to
2294−-- \"F1\" for AutomaticScaling, \"B1\" for ManualScaling and BasicScaling
2600+-- \`F1\` for AutomaticScaling and \`B1\` for ManualScaling or
2601+-- BasicScaling.
2295vInstanceClass :: Lens' Version (Maybe Text)
2602vInstanceClass :: Lens' Version (Maybe Text)
2296vInstanceClass
2603vInstanceClass
2297 = lens _vInstanceClass
2604 = lens _vInstanceClass
2298 (\ s a -> s{_vInstanceClass = a})
2605 (\ s a -> s{_vInstanceClass = a})
2299
2606
2300−-- | Configure health checking for the VM instances. Unhealthy VM instances
2607+-- | Configures health checking for VM instances. Unhealthy instances are
2301−-- will be stopped and replaced with new instances. Only returned in
2608+-- stopped and replaced with new instances. Only applicable for VM
2302−-- \`GET\` requests if \`view=FULL\` is set. May only be set on create
2609+-- runtimes. Only returned in \`GET\` requests if \`view=FULL\` is set.
2303−-- requests; once created, is immutable.
2304vHealthCheck :: Lens' Version (Maybe HealthCheck)
2610vHealthCheck :: Lens' Version (Maybe HealthCheck)
2305vHealthCheck
2611vHealthCheck
2306 = lens _vHealthCheck (\ s a -> s{_vHealthCheck = a})
2612 = lens _vHealthCheck (\ s a -> s{_vHealthCheck = a})
2307
2613
2308−-- | The App Engine execution environment to use for this version. Default:
2614+-- | App Engine execution environment for this version. Defaults to
2309−-- \"1\"
2615+-- \`standard\`.
2310vEnv :: Lens' Version (Maybe Text)
2616vEnv :: Lens' Version (Maybe Text)
2311vEnv = lens _vEnv (\ s a -> s{_vEnv = a})
2617vEnv = lens _vEnv (\ s a -> s{_vEnv = a})
2312
2618
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
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)
2315−-- specify its own expiration. Only returned in \`GET\` requests if
2622+-- does not specify its own expiration time. Only returned in \`GET\`
2316−-- \`view=FULL\` is set. May only be set on create requests; once created,
2623+-- requests if \`view=FULL\` is set.
2317−-- is immutable.
2318vDefaultExpiration :: Lens' Version (Maybe Text)
2624vDefaultExpiration :: Lens' Version (Maybe Text)
2319vDefaultExpiration
2625vDefaultExpiration
2320 = lens _vDefaultExpiration
2626 = lens _vDefaultExpiration
2321 (\ s a -> s{_vDefaultExpiration = a})
2627 (\ s a -> s{_vDefaultExpiration = a})
2322
2628
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
2325-- other application metrics.
2630-- other application metrics.
2326vAutomaticScaling :: Lens' Version (Maybe AutomaticScaling)
2631vAutomaticScaling :: Lens' Version (Maybe AutomaticScaling)
2327vAutomaticScaling
2632vAutomaticScaling
2328 = lens _vAutomaticScaling
2633 = lens _vAutomaticScaling
2329 (\ s a -> s{_vAutomaticScaling = a})
2634 (\ s a -> s{_vAutomaticScaling = a})
2330
2635
2331−-- | Custom static error pages instead of these generic error pages, (limit
2636+-- | Custom static error pages. Limited to 10KB per page. Only returned in
2332−-- 10 KB\/page) Only returned in \`GET\` requests if \`view=FULL\` is set.
2637+-- \`GET\` requests if \`view=FULL\` is set.
2333−-- May only be set on create requests; once created, is immutable.
2334vErrorHandlers :: Lens' Version [ErrorHandler]
2638vErrorHandlers :: Lens' Version [ErrorHandler]
2335vErrorHandlers
2639vErrorHandlers
2336 = lens _vErrorHandlers
2640 = lens _vErrorHandlers
@@ -2338,15 +2642,19 @@ vErrorHandlers
2338 . _Default
2642 . _Default
2339 . _Coerce
2643 . _Coerce
2340
2644
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+
2341−-- | Whether to deploy this app in a VM container.
2650+-- | Whether to deploy this version in a container on a virtual machine.
2342vVM :: Lens' Version (Maybe Bool)
2651vVM :: Lens' Version (Maybe Bool)
2343vVM = lens _vVM (\ s a -> s{_vVM = a})
2652vVM = lens _vVM (\ s a -> s{_vVM = a})
2344
2653
2345−-- | An ordered list of URL Matching patterns that should be applied to
2654+-- | An ordered list of URL-matching patterns that should be applied to
2346−-- incoming requests. The first matching URL consumes the request, and
2655+-- incoming requests. The first matching URL handles the request and other
2347−-- subsequent handlers are not attempted. Only returned in \`GET\` requests
2656+-- request handlers are not attempted. Only returned in \`GET\` requests if
2348−-- if \`view=FULL\` is set. May only be set on create requests; once
2657+-- \`view=FULL\` is set.
2349−-- created, is immutable.
2350vHandlers :: Lens' Version [URLMap]
2658vHandlers :: Lens' Version [URLMap]
2351vHandlers
2659vHandlers
2352 = lens _vHandlers (\ s a -> s{_vHandlers = a}) .
2660 = lens _vHandlers (\ s a -> s{_vHandlers = a}) .
@@ -2362,27 +2670,27 @@ vInboundServices
2362 . _Default
2670 . _Default
2363 . _Coerce
2671 . _Coerce
2364
2672
2365−-- | Used to specify extra network settings (for VM runtimes only).
2673+-- | Extra network settings. Only applicable for VM runtimes.
2366vNetwork :: Lens' Version (Maybe Network)
2674vNetwork :: Lens' Version (Maybe Network)
2367vNetwork = lens _vNetwork (\ s a -> s{_vNetwork = a})
2675vNetwork = lens _vNetwork (\ s a -> s{_vNetwork = a})
2368
2676
2369−-- | Used to specify how many machine resources an app version needs (for VM
2677+-- | Machine resources for this version. Only applicable for VM runtimes.
2370−-- runtimes only).
2371vResources :: Lens' Version (Maybe Resources)
2678vResources :: Lens' Version (Maybe Resources)
2372vResources
2679vResources
2373 = lens _vResources (\ s a -> s{_vResources = a})
2680 = lens _vResources (\ s a -> s{_vResources = a})
2374
2681
2375−-- | The full path to the Version resource in the API. Example:
2682+-- | Full path to the Version resource in the API. Example:
2376−-- \"apps\/myapp\/services\/default\/versions\/v1\". \'OutputOnly
2683+-- \`apps\/myapp\/services\/default\/versions\/v1\`. \'OutputOnly
2377vName :: Lens' Version (Maybe Text)
2684vName :: Lens' Version (Maybe Text)
2378vName = lens _vName (\ s a -> s{_vName = a})
2685vName = lens _vName (\ s a -> s{_vName = a})
2379
2686
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.
2381vThreadsafe :: Lens' Version (Maybe Bool)
2688vThreadsafe :: Lens' Version (Maybe Bool)
2382vThreadsafe
2689vThreadsafe
2383 = lens _vThreadsafe (\ s a -> s{_vThreadsafe = a})
2690 = lens _vThreadsafe (\ s a -> s{_vThreadsafe = a})
2384
2691
2385−-- | Beta settings supplied to the application via metadata.
2692+-- | Metadata settings that are supplied to this version to enable beta
2693+-- runtime features.
2386vBetaSettings :: Lens' Version (Maybe VersionBetaSettings)
2694vBetaSettings :: Lens' Version (Maybe VersionBetaSettings)
2387vBetaSettings
2695vBetaSettings
2388 = lens _vBetaSettings
2696 = lens _vBetaSettings
@@ -2404,57 +2712,66 @@ vManualScaling
2404 = lens _vManualScaling
2712 = lens _vManualScaling
2405 (\ s a -> s{_vManualScaling = a})
2713 (\ s a -> s{_vManualScaling = a})
2406
2714
2407−-- | Serving configuration for Google Cloud Endpoints. Only returned in
2715+-- | Serving configuration for [Google Cloud
2716+-- Endpoints](https:\/\/cloud.google.com\/appengine\/docs\/python\/endpoints\/).
2408−-- \`GET\` requests if \`view=FULL\` is set. May only be set on create
2717+-- Only returned in \`GET\` requests if \`view=FULL\` is set.
2409−-- requests; once created, is immutable.
2410vAPIConfig :: Lens' Version (Maybe APIConfigHandler)
2718vAPIConfig :: Lens' Version (Maybe APIConfigHandler)
2411vAPIConfig
2719vAPIConfig
2412 = lens _vAPIConfig (\ s a -> s{_vAPIConfig = a})
2720 = lens _vAPIConfig (\ s a -> s{_vAPIConfig = a})
2413
2721
2414−-- | The relative name\/path of the Version within the service. Example:
2722+-- | Relative name of the version within the service. Example: \`v1\`.
2415−-- \"v1\". Version specifiers can contain lowercase letters, digits, and
2723+-- Version names can contain only lowercase letters, numbers, or hyphens.
2416−-- hyphens. It cannot begin with the prefix \`ah-\` and the names
2724+-- Reserved names: \"default\", \"latest\", and any name with the prefix
2417−-- \`default\` and \`latest\` are reserved and cannot be used.
2725+-- \"ah-\".
2418vId :: Lens' Version (Maybe Text)
2726vId :: Lens' Version (Maybe Text)
2419vId = lens _vId (\ s a -> s{_vId = a})
2727vId = lens _vId (\ s a -> s{_vId = a})
2420
2728
2421−-- | Environment variables made available to the application. Only returned
2729+-- | Environment variables available to the application. Only returned in
2422−-- in \`GET\` requests if \`view=FULL\` is set. May only be set on create
2730+-- \`GET\` requests if \`view=FULL\` is set.
2423−-- requests; once created, is immutable.
2424vEnvVariables :: Lens' Version (Maybe VersionEnvVariables)
2731vEnvVariables :: Lens' Version (Maybe VersionEnvVariables)
2425vEnvVariables
2732vEnvVariables
2426 = lens _vEnvVariables
2733 = lens _vEnvVariables
2427 (\ s a -> s{_vEnvVariables = a})
2734 (\ s a -> s{_vEnvVariables = a})
2428
2735
2429−-- | The current serving status of this version. Only \`SERVING\` versions
2736+-- | Current serving status of this version. Only the versions with a
2430−-- will have instances created or billed for. If this field is unset when a
2737+-- \`SERVING\` status create instances and can be billed.
2431−-- version is created, \`SERVING\` status will be assumed. It is an error
2738+-- \`SERVING_STATUS_UNSPECIFIED\` is an invalid value. Defaults to
2432−-- to explicitly set this field to \`SERVING_STATUS_UNSPECIFIED\`.
2739+-- \`SERVING\`.
2433vServingStatus :: Lens' Version (Maybe Text)
2740vServingStatus :: Lens' Version (Maybe Text)
2434vServingStatus
2741vServingStatus
2435 = lens _vServingStatus
2742 = lens _vServingStatus
2436 (\ s a -> s{_vServingStatus = a})
2743 (\ s a -> s{_vServingStatus = a})
2437
2744
2745+-- | Total size in bytes of all the files that are included in this version
2438−-- | Total size of version files hosted on App Engine disk in bytes.
2746+-- and curerntly hosted on the App Engine disk. \'OutputOnly
2439−-- \'OutputOnly
2440vDiskUsageBytes :: Lens' Version (Maybe Int64)
2747vDiskUsageBytes :: Lens' Version (Maybe Int64)
2441vDiskUsageBytes
2748vDiskUsageBytes
2442 = lens _vDiskUsageBytes
2749 = lens _vDiskUsageBytes
2443 (\ s a -> s{_vDiskUsageBytes = a})
2750 (\ s a -> s{_vDiskUsageBytes = a})
2444 . mapping _Coerce
2751 . mapping _Coerce
2445
2752
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+
2446−-- | Configuration for Python runtime third-party libraries required by the
2758+-- | Configuration for third-party Python runtime libraries that are required
2447−-- application. Only returned in \`GET\` requests if \`view=FULL\` is set.
2759+-- by the application. Only returned in \`GET\` requests if \`view=FULL\`
2448−-- May only be set on create requests; once created, is immutable.
2760+-- is set.
2449vLibraries :: Lens' Version [Library]
2761vLibraries :: Lens' Version [Library]
2450vLibraries
2762vLibraries
2451 = lens _vLibraries (\ s a -> s{_vLibraries = a}) .
2763 = lens _vLibraries (\ s a -> s{_vLibraries = a}) .
2452 _Default
2764 _Default
2453 . _Coerce
2765 . _Coerce
2454
2766
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+
2455-- | Code and application artifacts that make up this version. Only returned
2773-- | 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
2774+-- in \`GET\` requests if \`view=FULL\` is set.
2457−-- requests; once created, is immutable.
2458vDeployment :: Lens' Version (Maybe Deployment)
2775vDeployment :: Lens' Version (Maybe Deployment)
2459vDeployment
2776vDeployment
2460 = lens _vDeployment (\ s a -> s{_vDeployment = a})
2777 = lens _vDeployment (\ s a -> s{_vDeployment = a})
@@ -2464,15 +2781,14 @@ instance FromJSON Version where
2464 = withObject "Version"
2781 = withObject "Version"
2465 (\ o ->
2782 (\ o ->
2466 Version' <$>
2783 Version' <$>
2467− (o .:? "creationTime") <*> (o .:? "runtime") <*>
2468− (o .:? "deployer")
2469− <*> (o .:? "nobuildFilesRegex")
2784+ (o .:? "runtime") <*> (o .:? "nobuildFilesRegex") <*>
2470− <*> (o .:? "instanceClass")
2785+ (o .:? "instanceClass")
2471 <*> (o .:? "healthCheck")
2786 <*> (o .:? "healthCheck")
2472 <*> (o .:? "env")
2787 <*> (o .:? "env")
2473 <*> (o .:? "defaultExpiration")
2788 <*> (o .:? "defaultExpiration")
2474 <*> (o .:? "automaticScaling")
2789 <*> (o .:? "automaticScaling")
2475 <*> (o .:? "errorHandlers" .!= mempty)
2790 <*> (o .:? "errorHandlers" .!= mempty)
2791+ <*> (o .:? "createdBy")
2476 <*> (o .:? "vm")
2792 <*> (o .:? "vm")
2477 <*> (o .:? "handlers" .!= mempty)
2793 <*> (o .:? "handlers" .!= mempty)
2478 <*> (o .:? "inboundServices" .!= mempty)
2794 <*> (o .:? "inboundServices" .!= mempty)
@@ -2488,16 +2804,16 @@ instance FromJSON Version where
2488 <*> (o .:? "envVariables")
2804 <*> (o .:? "envVariables")
2489 <*> (o .:? "servingStatus")
2805 <*> (o .:? "servingStatus")
2490 <*> (o .:? "diskUsageBytes")
2806 <*> (o .:? "diskUsageBytes")
2807+ <*> (o .:? "createTime")
2491 <*> (o .:? "libraries" .!= mempty)
2808 <*> (o .:? "libraries" .!= mempty)
2809+ <*> (o .:? "versionUrl")
2492 <*> (o .:? "deployment"))
2810 <*> (o .:? "deployment"))
2493
2811
2494instance ToJSON Version where
2812instance ToJSON Version where
2495 toJSON Version'{..}
2813 toJSON Version'{..}
2496 = object
2814 = object
2497 (catMaybes
2815 (catMaybes
2498− [("creationTime" .=) <$> _vCreationTime,
2499− ("runtime" .=) <$> _vRuntime,
2816+ [("runtime" .=) <$> _vRuntime,
2500− ("deployer" .=) <$> _vDeployer,
2501 ("nobuildFilesRegex" .=) <$> _vNobuildFilesRegex,
2817 ("nobuildFilesRegex" .=) <$> _vNobuildFilesRegex,
2502 ("instanceClass" .=) <$> _vInstanceClass,
2818 ("instanceClass" .=) <$> _vInstanceClass,
2503 ("healthCheck" .=) <$> _vHealthCheck,
2819 ("healthCheck" .=) <$> _vHealthCheck,
@@ -2505,7 +2821,8 @@ instance ToJSON Version where
2505 ("defaultExpiration" .=) <$> _vDefaultExpiration,
2821 ("defaultExpiration" .=) <$> _vDefaultExpiration,
2506 ("automaticScaling" .=) <$> _vAutomaticScaling,
2822 ("automaticScaling" .=) <$> _vAutomaticScaling,
2507 ("errorHandlers" .=) <$> _vErrorHandlers,
2823 ("errorHandlers" .=) <$> _vErrorHandlers,
2824+ ("createdBy" .=) <$> _vCreatedBy, ("vm" .=) <$> _vVM,
2508− ("vm" .=) <$> _vVM, ("handlers" .=) <$> _vHandlers,
2825+ ("handlers" .=) <$> _vHandlers,
2509 ("inboundServices" .=) <$> _vInboundServices,
2826 ("inboundServices" .=) <$> _vInboundServices,
2510 ("network" .=) <$> _vNetwork,
2827 ("network" .=) <$> _vNetwork,
2511 ("resources" .=) <$> _vResources,
2828 ("resources" .=) <$> _vResources,
@@ -2518,7 +2835,9 @@ instance ToJSON Version where
2518 ("envVariables" .=) <$> _vEnvVariables,
2835 ("envVariables" .=) <$> _vEnvVariables,
2519 ("servingStatus" .=) <$> _vServingStatus,
2836 ("servingStatus" .=) <$> _vServingStatus,
2520 ("diskUsageBytes" .=) <$> _vDiskUsageBytes,
2837 ("diskUsageBytes" .=) <$> _vDiskUsageBytes,
2838+ ("createTime" .=) <$> _vCreateTime,
2521 ("libraries" .=) <$> _vLibraries,
2839 ("libraries" .=) <$> _vLibraries,
2840+ ("versionUrl" .=) <$> _vVersionURL,
2522 ("deployment" .=) <$> _vDeployment])
2841 ("deployment" .=) <$> _vDeployment])
2523
2842
2524-- | Files served directly to the user for a given URL, such as images, CSS
2843-- | Files served directly to the user for a given URL, such as images, CSS
@@ -2573,46 +2892,44 @@ sfhHTTPHeaders
2573 = lens _sfhHTTPHeaders
2892 = lens _sfhHTTPHeaders
2574 (\ s a -> s{_sfhHTTPHeaders = a})
2893 (\ s a -> s{_sfhHTTPHeaders = a})
2575
2894
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
2577-- application root directory. The path can refer to text matched in
2896-- application root directory. The path can refer to text matched in
2578-- groupings in the URL pattern.
2897-- groupings in the URL pattern.
2579sfhPath :: Lens' StaticFilesHandler (Maybe Text)
2898sfhPath :: Lens' StaticFilesHandler (Maybe Text)
2580sfhPath = lens _sfhPath (\ s a -> s{_sfhPath = a})
2899sfhPath = lens _sfhPath (\ s a -> s{_sfhPath = a})
2581
2900
2582−-- | If true, this UrlMap entry does not match the request unless the file
2901+-- | Whether this handler should match the request if the file referenced by
2583−-- referenced by the handler also exists. If no such file exists,
2902+-- the handler does not exist.
2584−-- processing will continue with the next UrlMap that matches the requested
2585−-- URL.
2586sfhRequireMatchingFile :: Lens' StaticFilesHandler (Maybe Bool)
2903sfhRequireMatchingFile :: Lens' StaticFilesHandler (Maybe Bool)
2587sfhRequireMatchingFile
2904sfhRequireMatchingFile
2588 = lens _sfhRequireMatchingFile
2905 = lens _sfhRequireMatchingFile
2589 (\ s a -> s{_sfhRequireMatchingFile = a})
2906 (\ s a -> s{_sfhRequireMatchingFile = a})
2590
2907
2591−-- | The length of time a static file served by this handler ought to be
2908+-- | Time a static file served by this handler should be cached by web
2592−-- cached by web proxies and browsers.
2909+-- proxies and browsers.
2593sfhExpiration :: Lens' StaticFilesHandler (Maybe Text)
2910sfhExpiration :: Lens' StaticFilesHandler (Maybe Text)
2594sfhExpiration
2911sfhExpiration
2595 = lens _sfhExpiration
2912 = lens _sfhExpiration
2596 (\ s a -> s{_sfhExpiration = a})
2913 (\ s a -> s{_sfhExpiration = a})
2597
2914
2598−-- | If specified, all files served by this handler will be served using the
2915+-- | MIME type used to serve all files served by this handler. Defaults to
2599−-- specified MIME type. If not specified, the MIME type for a file will be
2600−-- derived from the file\'s filename extension.
2916+-- file-specific MIME types, which are derived from each file\'s filename
2917+-- extension.
2601sfhMimeType :: Lens' StaticFilesHandler (Maybe Text)
2918sfhMimeType :: Lens' StaticFilesHandler (Maybe Text)
2602sfhMimeType
2919sfhMimeType
2603 = lens _sfhMimeType (\ s a -> s{_sfhMimeType = a})
2920 = lens _sfhMimeType (\ s a -> s{_sfhMimeType = a})
2604
2921
2922+-- | Whether files should also be uploaded as code data. By default, files
2605−-- | By default, files declared in static file handlers are uploaded as
2923+-- declared in static file handlers are uploaded as static data and are
2606−-- static data and are only served to end users, they cannot be read by an
2924+-- only served to end users; they cannot be read by the application. If
2607−-- application. If this field is set to true, the files are also uploaded
2925+-- enabled, uploads are charged against both your code and static data
2608−-- as code data so your application can read them. Both uploads are charged
2609−-- against your code and static data storage resource quotas.
2926+-- storage resource quotas.
2610sfhApplicationReadable :: Lens' StaticFilesHandler (Maybe Bool)
2927sfhApplicationReadable :: Lens' StaticFilesHandler (Maybe Bool)
2611sfhApplicationReadable
2928sfhApplicationReadable
2612 = lens _sfhApplicationReadable
2929 = lens _sfhApplicationReadable
2613 (\ s a -> s{_sfhApplicationReadable = a})
2930 (\ s a -> s{_sfhApplicationReadable = a})
2614
2931
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
2616-- be referenced by this handler.
2933-- be referenced by this handler.
2617sfhUploadPathRegex :: Lens' StaticFilesHandler (Maybe Text)
2934sfhUploadPathRegex :: Lens' StaticFilesHandler (Maybe Text)
2618sfhUploadPathRegex
2935sfhUploadPathRegex
@@ -2645,7 +2962,7 @@ instance ToJSON StaticFilesHandler where
2645 _sfhApplicationReadable,
2962 _sfhApplicationReadable,
2646 ("uploadPathRegex" .=) <$> _sfhUploadPathRegex])
2963 ("uploadPathRegex" .=) <$> _sfhUploadPathRegex])
2647
2964
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.
2649--
2966--
2650-- /See:/ 'errorHandler' smart constructor.
2967-- /See:/ 'errorHandler' smart constructor.
2651data ErrorHandler = ErrorHandler'
2968data ErrorHandler = ErrorHandler'
@@ -2672,12 +2989,12 @@ errorHandler =
2672 , _ehStaticFile = Nothing
2989 , _ehStaticFile = Nothing
2673 }
2990 }
2674
2991
2675−-- | MIME type of file. If unspecified, \"text\/html\" is assumed.
2992+-- | MIME type of file. Defaults to \`text\/html\`.
2676ehMimeType :: Lens' ErrorHandler (Maybe Text)
2993ehMimeType :: Lens' ErrorHandler (Maybe Text)
2677ehMimeType
2994ehMimeType
2678 = lens _ehMimeType (\ s a -> s{_ehMimeType = a})
2995 = lens _ehMimeType (\ s a -> s{_ehMimeType = a})
2679
2996
2680−-- | The error condition this handler applies to.
2997+-- | Error condition this handler applies to.
2681ehErrorCode :: Lens' ErrorHandler (Maybe Text)
2998ehErrorCode :: Lens' ErrorHandler (Maybe Text)
2682ehErrorCode
2999ehErrorCode
2683 = lens _ehErrorCode (\ s a -> s{_ehErrorCode = a})
3000 = lens _ehErrorCode (\ s a -> s{_ehErrorCode = a})
@@ -2703,6 +3020,94 @@ instance ToJSON ErrorHandler where
2703 ("errorCode" .=) <$> _ehErrorCode,
3020 ("errorCode" .=) <$> _ehErrorCode,
2704 ("staticFile" .=) <$> _ehStaticFile])
3021 ("staticFile" .=) <$> _ehStaticFile])
2705
3022
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+
2706-- | Metadata for the given google.longrunning.Operation.
3111-- | Metadata for the given google.longrunning.Operation.
2707--
3112--
2708-- /See:/ 'operationMetadata' smart constructor.
3113-- /See:/ 'operationMetadata' smart constructor.
@@ -2742,35 +3147,34 @@ operationMetadata =
2742 , _omTarget = Nothing
3147 , _omTarget = Nothing
2743 }
3148 }
2744
3149
2745−-- | Timestamp that this operation was received. \'OutputOnly
3150+-- | Timestamp that this operation was created. \'OutputOnly
2746omInsertTime :: Lens' OperationMetadata (Maybe Text)
3151omInsertTime :: Lens' OperationMetadata (Maybe Text)
2747omInsertTime
3152omInsertTime
2748 = lens _omInsertTime (\ s a -> s{_omInsertTime = a})
3153 = lens _omInsertTime (\ s a -> s{_omInsertTime = a})
2749
3154
2750−-- | The user who requested this operation. \'OutputOnly
3155+-- | User who requested this operation. \'OutputOnly
2751omUser :: Lens' OperationMetadata (Maybe Text)
3156omUser :: Lens' OperationMetadata (Maybe Text)
2752omUser = lens _omUser (\ s a -> s{_omUser = a})
3157omUser = lens _omUser (\ s a -> s{_omUser = a})
2753
3158
2754−-- | API method name that initiated the operation. Example:
3159+-- | API method that initiated this operation. Example:
2755−-- \"google.appengine.v1beta4.Version.CreateVersion\". \'OutputOnly
3160+-- \`google.appengine.v1beta4.Version.CreateVersion\`. \'OutputOnly
2756omMethod :: Lens' OperationMetadata (Maybe Text)
3161omMethod :: Lens' OperationMetadata (Maybe Text)
2757omMethod = lens _omMethod (\ s a -> s{_omMethod = a})
3162omMethod = lens _omMethod (\ s a -> s{_omMethod = a})
2758
3163
2759−-- | Timestamp that this operation was completed. (Not present if the
3164+-- | Timestamp that this operation completed. \'OutputOnly
2760−-- operation is still in progress.) \'OutputOnly
2761omEndTime :: Lens' OperationMetadata (Maybe Text)
3165omEndTime :: Lens' OperationMetadata (Maybe Text)
2762omEndTime
3166omEndTime
2763 = lens _omEndTime (\ s a -> s{_omEndTime = a})
3167 = lens _omEndTime (\ s a -> s{_omEndTime = a})
2764
3168
2765−-- | The type of the operation (deprecated, use method field instead).
3169+-- | Type of this operation. Deprecated, use method field instead. Example:
2766−-- Example: \"create_version\". \'OutputOnly
3170+-- \"create_version\". \'OutputOnly
2767omOperationType :: Lens' OperationMetadata (Maybe Text)
3171omOperationType :: Lens' OperationMetadata (Maybe Text)
2768omOperationType
3172omOperationType
2769 = lens _omOperationType
3173 = lens _omOperationType
2770 (\ s a -> s{_omOperationType = a})
3174 (\ s a -> s{_omOperationType = a})
2771
3175
2772−-- | Resource that this operation is acting on. Example:
3176+-- | Name of the resource that this operation is acting on. Example:
2773−-- \"apps\/myapp\/modules\/default\". \'OutputOnly
3177+-- \`apps\/myapp\/modules\/default\`. \'OutputOnly
2774omTarget :: Lens' OperationMetadata (Maybe Text)
3178omTarget :: Lens' OperationMetadata (Maybe Text)
2775omTarget = lens _omTarget (\ s a -> s{_omTarget = a})
3179omTarget = lens _omTarget (\ s a -> s{_omTarget = a})
2776
3180
@@ -2846,12 +3250,12 @@ instance ToJSON ListInstancesResponse where
2846 [("nextPageToken" .=) <$> _lirNextPageToken,
3250 [("nextPageToken" .=) <$> _lirNextPageToken,
2847 ("instances" .=) <$> _lirInstances])
3251 ("instances" .=) <$> _lirInstances])
2848
3252
2849−-- | Target scaling by request utilization (for VM runtimes only).
3253+-- | Target scaling by request utilization. Only applicable for VM runtimes.
2850--
3254--
2851-- /See:/ 'requestUtilization' smart constructor.
3255-- /See:/ 'requestUtilization' smart constructor.
2852data RequestUtilization = RequestUtilization'
3256data RequestUtilization = RequestUtilization'
2853− { _ruTargetConcurrentRequests :: !(Maybe (Textual Int32))
3257+ { _ruTargetConcurrentRequests :: !(Maybe (Textual Int32))
2854− , _ruTargetRequestCountPerSec :: !(Maybe (Textual Int32))
3258+ , _ruTargetRequestCountPerSecond :: !(Maybe (Textual Int32))
2855 } deriving (Eq,Show,Data,Typeable,Generic)
3259 } deriving (Eq,Show,Data,Typeable,Generic)
2856
3260
2857-- | Creates a value of 'RequestUtilization' with the minimum fields required to make a request.
3261-- | Creates a value of 'RequestUtilization' with the minimum fields required to make a request.
@@ -2860,13 +3264,13 @@ data RequestUtilization = RequestUtilization'
2860--
3264--
2861-- * 'ruTargetConcurrentRequests'
3265-- * 'ruTargetConcurrentRequests'
2862--
3266--
2863−-- * 'ruTargetRequestCountPerSec'
3267+-- * 'ruTargetRequestCountPerSecond'
2864requestUtilization
3268requestUtilization
2865 :: RequestUtilization
3269 :: RequestUtilization
2866requestUtilization =
3270requestUtilization =
2867 RequestUtilization'
3271 RequestUtilization'
2868 { _ruTargetConcurrentRequests = Nothing
3272 { _ruTargetConcurrentRequests = Nothing
2869− , _ruTargetRequestCountPerSec = Nothing
3273+ , _ruTargetRequestCountPerSecond = Nothing
2870 }
3274 }
2871
3275
2872-- | Target number of concurrent requests.
3276-- | Target number of concurrent requests.
@@ -2877,10 +3281,10 @@ ruTargetConcurrentRequests
2877 . mapping _Coerce
3281 . mapping _Coerce
2878
3282
2879-- | Target requests per second.
3283-- | Target requests per second.
2880−ruTargetRequestCountPerSec :: Lens' RequestUtilization (Maybe Int32)
3284+ruTargetRequestCountPerSecond :: Lens' RequestUtilization (Maybe Int32)
2881−ruTargetRequestCountPerSec
3285+ruTargetRequestCountPerSecond
2882− = lens _ruTargetRequestCountPerSec
3286+ = lens _ruTargetRequestCountPerSecond
2883− (\ s a -> s{_ruTargetRequestCountPerSec = a})
3287+ (\ s a -> s{_ruTargetRequestCountPerSecond = a})
2884 . mapping _Coerce
3288 . mapping _Coerce
2885
3289
2886instance FromJSON RequestUtilization where
3290instance FromJSON RequestUtilization where
@@ -2889,7 +3293,7 @@ instance FromJSON RequestUtilization where
2889 (\ o ->
3293 (\ o ->
2890 RequestUtilization' <$>
3294 RequestUtilization' <$>
2891 (o .:? "targetConcurrentRequests") <*>
3295 (o .:? "targetConcurrentRequests") <*>
2892− (o .:? "targetRequestCountPerSec"))
3296+ (o .:? "targetRequestCountPerSecond"))
2893
3297
2894instance ToJSON RequestUtilization where
3298instance ToJSON RequestUtilization where
2895 toJSON RequestUtilization'{..}
3299 toJSON RequestUtilization'{..}
@@ -2897,59 +3301,29 @@ instance ToJSON RequestUtilization where
2897 (catMaybes
3301 (catMaybes
2898 [("targetConcurrentRequests" .=) <$>
3302 [("targetConcurrentRequests" .=) <$>
2899 _ruTargetConcurrentRequests,
3303 _ruTargetConcurrentRequests,
2900− ("targetRequestCountPerSec" .=) <$>
3304+ ("targetRequestCountPerSecond" .=) <$>
2901− _ruTargetRequestCountPerSec])
3305+ _ruTargetRequestCountPerSecond])
2902
3306
2903−-- | A reference to a particular snapshot of the source tree used to build
3307+-- | Request message for \'Applications.RepairApplication\'.
2904−-- and deploy the application.
2905--
3308--
2906−-- /See:/ 'sourceReference' smart constructor.
3309+-- /See:/ 'repairApplicationRequest' smart constructor.
2907−data SourceReference = SourceReference'
3310+data RepairApplicationRequest =
2908− { _srRepository :: !(Maybe Text)
3311+ RepairApplicationRequest'
2909− , _srRevisionId :: !(Maybe Text)
2910− } deriving (Eq,Show,Data,Typeable,Generic)
3312+ deriving (Eq,Show,Data,Typeable,Generic)
2911
3313
2912−-- | Creates a value of 'SourceReference' with the minimum fields required to make a request.
3314+-- | Creates a value of 'RepairApplicationRequest' 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'
2917--
3315--
2918−-- * 'srRevisionId'
3316+repairApplicationRequest
2919−sourceReference
3317+ :: RepairApplicationRequest
2920− :: SourceReference
3318+repairApplicationRequest = RepairApplicationRequest'
2921−sourceReference =
2922− SourceReference'
2923− { _srRepository = Nothing
2924− , _srRevisionId = Nothing
2925− }
2926
3319
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
2941 parseJSON
3321 parseJSON
2942− = withObject "SourceReference"
3322+ = withObject "RepairApplicationRequest"
2943− (\ o ->
3323+ (\ o -> pure RepairApplicationRequest')
2944− SourceReference' <$>
2945− (o .:? "repository") <*> (o .:? "revisionId"))
2946
3324
2947−instance ToJSON SourceReference where
3325+instance ToJSON RepairApplicationRequest where
2948− toJSON SourceReference'{..}
3326+ toJSON = const emptyObject
2949− = object
2950− (catMaybes
2951− [("repository" .=) <$> _srRepository,
2952− ("revisionId" .=) <$> _srRevisionId])
2953
3327
2954-- | The normal response of the operation in case of success. If the original
3328-- | The normal response of the operation in case of success. If the original
2955-- method returns no data on success, such as \`Delete\`, the response is
3329-- method returns no data on success, such as \`Delete\`, the response is
@@ -2978,7 +3352,7 @@ operationResponse pOrAddtional_ =
2978 { _orAddtional = _Coerce # pOrAddtional_
3352 { _orAddtional = _Coerce # pOrAddtional_
2979 }
3353 }
2980
3354
2981−-- | Properties of the object. Contains field \'ype with type URL.
3355+-- | Properties of the object. Contains field \'type with type URL.
2982orAddtional :: Lens' OperationResponse (HashMap Text JSONValue)
3356orAddtional :: Lens' OperationResponse (HashMap Text JSONValue)
2983orAddtional
3357orAddtional
2984 = lens _orAddtional (\ s a -> s{_orAddtional = a}) .
3358 = lens _orAddtional (\ s a -> s{_orAddtional = a}) .
@@ -2992,8 +3366,8 @@ instance FromJSON OperationResponse where
2992instance ToJSON OperationResponse where
3366instance ToJSON OperationResponse where
2993 toJSON = toJSON . _orAddtional
3367 toJSON = toJSON . _orAddtional
2994
3368
2995−-- | A Docker (container) image which should be used to start the
3369+-- | Docker image that is used to start a VM container for the version you
2996−-- application.
3370+-- deploy.
2997--
3371--
2998-- /See:/ 'containerInfo' smart constructor.
3372-- /See:/ 'containerInfo' smart constructor.
2999newtype ContainerInfo = ContainerInfo'
3373newtype ContainerInfo = ContainerInfo'
@@ -3012,9 +3386,10 @@ containerInfo =
3012 { _ciImage = Nothing
3386 { _ciImage = Nothing
3013 }
3387 }
3014
3388
3015−-- | Reference to a hosted container image. Must be a URI to a resource in a
3389+-- | URI to the hosted container image in a Docker repository. The URI must
3016−-- Docker repository. Must be fully qualified, including tag or digest.
3390+-- be fully qualified and include a tag or digest. Examples:
3391+-- \"gcr.io\/my-project\/image:tag\" or
3017−-- e.g. gcr.io\/my-project\/image:tag or gcr.io\/my-project\/image\'digest
3392+-- \"gcr.io\/my-project\/image\'digest\"
3018ciImage :: Lens' ContainerInfo (Maybe Text)
3393ciImage :: Lens' ContainerInfo (Maybe Text)
3019ciImage = lens _ciImage (\ s a -> s{_ciImage = a})
3394ciImage = lens _ciImage (\ s a -> s{_ciImage = a})
3020
3395
@@ -3027,25 +3402,25 @@ instance ToJSON ContainerInfo where
3027 toJSON ContainerInfo'{..}
3402 toJSON ContainerInfo'{..}
3028 = object (catMaybes [("image" .=) <$> _ciImage])
3403 = object (catMaybes [("image" .=) <$> _ciImage])
3029
3404
3030−-- | Instances are the computing units that App Engine uses to automatically
3405+-- | An Instance resource is the computing unit that App Engine uses to
3031−-- scale an application.
3406+-- automatically scale an application.
3032--
3407--
3033-- /See:/ 'instance'' smart constructor.
3408-- /See:/ 'instance'' smart constructor.
3034data Instance = Instance'
3409data Instance = Instance'
3035 { _iMemoryUsage :: !(Maybe (Textual Int64))
3410 { _iMemoryUsage :: !(Maybe (Textual Int64))
3036 , _iVMStatus :: !(Maybe Text)
3411 , _iVMStatus :: !(Maybe Text)
3037 , _iVMZoneName :: !(Maybe Text)
3412 , _iVMZoneName :: !(Maybe Text)
3413+ , _iStartTime :: !(Maybe Text)
3038 , _iVMId :: !(Maybe Text)
3414 , _iVMId :: !(Maybe Text)
3039 , _iAvailability :: !(Maybe Text)
3415 , _iAvailability :: !(Maybe Text)
3040 , _iVMName :: !(Maybe Text)
3416 , _iVMName :: !(Maybe Text)
3041 , _iName :: !(Maybe Text)
3417 , _iName :: !(Maybe Text)
3042− , _iVMUnlocked :: !(Maybe Bool)
3418+ , _iVMDebugEnabled :: !(Maybe Bool)
3043 , _iRequests :: !(Maybe (Textual Int32))
3419 , _iRequests :: !(Maybe (Textual Int32))
3044 , _iQps :: !(Maybe (Textual Double))
3420 , _iQps :: !(Maybe (Textual Double))
3045 , _iId :: !(Maybe Text)
3421 , _iId :: !(Maybe Text)
3046− , _iErrors :: !(Maybe (Textual Word32))
3422+ , _iErrors :: !(Maybe (Textual Int32))
3047 , _iAverageLatency :: !(Maybe (Textual Int32))
3423 , _iAverageLatency :: !(Maybe (Textual Int32))
3048− , _iStartTimestamp :: !(Maybe Text)
3049 , _iAppEngineRelease :: !(Maybe Text)
3424 , _iAppEngineRelease :: !(Maybe Text)
3050 } deriving (Eq,Show,Data,Typeable,Generic)
3425 } deriving (Eq,Show,Data,Typeable,Generic)
3051
3426
@@ -3059,6 +3434,8 @@ data Instance = Instance'
3059--
3434--
3060-- * 'iVMZoneName'
3435-- * 'iVMZoneName'
3061--
3436--
3437+-- * 'iStartTime'
3438+--
3062-- * 'iVMId'
3439-- * 'iVMId'
3063--
3440--
3064-- * 'iAvailability'
3441-- * 'iAvailability'
@@ -3067,7 +3444,7 @@ data Instance = Instance'
3067--
3444--
3068-- * 'iName'
3445-- * 'iName'
3069--
3446--
3070−-- * 'iVMUnlocked'
3447+-- * 'iVMDebugEnabled'
3071--
3448--
3072-- * 'iRequests'
3449-- * 'iRequests'
3073--
3450--
@@ -3079,8 +3456,6 @@ data Instance = Instance'
3079--
3456--
3080-- * 'iAverageLatency'
3457-- * 'iAverageLatency'
3081--
3458--
3082−-- * 'iStartTimestamp'
3083−--
3084-- * 'iAppEngineRelease'
3459-- * 'iAppEngineRelease'
3085instance'
3460instance'
3086 :: Instance
3461 :: Instance
@@ -3089,102 +3464,103 @@ instance' =
3089 { _iMemoryUsage = Nothing
3464 { _iMemoryUsage = Nothing
3090 , _iVMStatus = Nothing
3465 , _iVMStatus = Nothing
3091 , _iVMZoneName = Nothing
3466 , _iVMZoneName = Nothing
3467+ , _iStartTime = Nothing
3092 , _iVMId = Nothing
3468 , _iVMId = Nothing
3093 , _iAvailability = Nothing
3469 , _iAvailability = Nothing
3094 , _iVMName = Nothing
3470 , _iVMName = Nothing
3095 , _iName = Nothing
3471 , _iName = Nothing
3096− , _iVMUnlocked = Nothing
3472+ , _iVMDebugEnabled = Nothing
3097 , _iRequests = Nothing
3473 , _iRequests = Nothing
3098 , _iQps = Nothing
3474 , _iQps = Nothing
3099 , _iId = Nothing
3475 , _iId = Nothing
3100 , _iErrors = Nothing
3476 , _iErrors = Nothing
3101 , _iAverageLatency = Nothing
3477 , _iAverageLatency = Nothing
3102− , _iStartTimestamp = Nothing
3103 , _iAppEngineRelease = Nothing
3478 , _iAppEngineRelease = Nothing
3104 }
3479 }
3105
3480
3106−-- | Memory usage (in bytes). \'OutputOnly
3481+-- | Total memory in use (bytes). \'OutputOnly
3107iMemoryUsage :: Lens' Instance (Maybe Int64)
3482iMemoryUsage :: Lens' Instance (Maybe Int64)
3108iMemoryUsage
3483iMemoryUsage
3109 = lens _iMemoryUsage (\ s a -> s{_iMemoryUsage = a})
3484 = lens _iMemoryUsage (\ s a -> s{_iMemoryUsage = a})
3110 . mapping _Coerce
3485 . mapping _Coerce
3111
3486
3112−-- | For VMEngines instances, the status of GCE VM where the instance lives.
3487+-- | Status of the virtual machine where this instance lives. Only applicable
3113−-- \'OutputOnly
3488+-- for instances in App Engine flexible environment. \'OutputOnly
3114iVMStatus :: Lens' Instance (Maybe Text)
3489iVMStatus :: Lens' Instance (Maybe Text)
3115iVMStatus
3490iVMStatus
3116 = lens _iVMStatus (\ s a -> s{_iVMStatus = a})
3491 = lens _iVMStatus (\ s a -> s{_iVMStatus = a})
3117
3492
3118−-- | For VMEngines instances, the zone where the GCE VM is located.
3493+-- | Zone where the virtual machine is located. Only applicable for instances
3119−-- \'OutputOnly
3494+-- in App Engine flexible environment. \'OutputOnly
3120iVMZoneName :: Lens' Instance (Maybe Text)
3495iVMZoneName :: Lens' Instance (Maybe Text)
3121iVMZoneName
3496iVMZoneName
3122 = lens _iVMZoneName (\ s a -> s{_iVMZoneName = a})
3497 = lens _iVMZoneName (\ s a -> s{_iVMZoneName = a})
3123
3498
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
3125iVMId :: Lens' Instance (Maybe Text)
3506iVMId :: Lens' Instance (Maybe Text)
3126iVMId = lens _iVMId (\ s a -> s{_iVMId = a})
3507iVMId = lens _iVMId (\ s a -> s{_iVMId = a})
3127
3508
3128−-- | Availability of instance. \'OutputOnly
3509+-- | Availability of the instance. \'OutputOnly
3129iAvailability :: Lens' Instance (Maybe Text)
3510iAvailability :: Lens' Instance (Maybe Text)
3130iAvailability
3511iAvailability
3131 = lens _iAvailability
3512 = lens _iAvailability
3132 (\ s a -> s{_iAvailability = a})
3513 (\ s a -> s{_iAvailability = a})
3133
3514
3134−-- | For VMEngines instances, the name of GCE VM where the instance lives.
3515+-- | Name of the virtual machine where this instance lives. Only applicable
3135−-- \'OutputOnly
3516+-- for instances in App Engine flexible environment. \'OutputOnly
3136iVMName :: Lens' Instance (Maybe Text)
3517iVMName :: Lens' Instance (Maybe Text)
3137iVMName = lens _iVMName (\ s a -> s{_iVMName = a})
3518iVMName = lens _iVMName (\ s a -> s{_iVMName = a})
3138
3519
3139−-- | The full path to the Instance resource in the API. Example:
3520+-- | Full path to the Instance resource in the API. Example:
3140−-- \"apps\/myapp\/services\/default\/versions\/v1\/instances\/instance-1\"
3521+-- \`apps\/myapp\/services\/default\/versions\/v1\/instances\/instance-1\`.
3141-- \'OutputOnly
3522-- \'OutputOnly
3142iName :: Lens' Instance (Maybe Text)
3523iName :: Lens' Instance (Maybe Text)
3143iName = lens _iName (\ s a -> s{_iName = a})
3524iName = lens _iName (\ s a -> s{_iName = a})
3144
3525
3145−-- | For VMEngines instances, whether the instance has been unlocked.
3526+-- | Whether this instance is in debug mode. Only applicable for instances in
3146−-- \'OutputOnly
3527+-- App Engine flexible environment. \'OutputOnly
3147−iVMUnlocked :: Lens' Instance (Maybe Bool)
3528+iVMDebugEnabled :: Lens' Instance (Maybe Bool)
3148−iVMUnlocked
3529+iVMDebugEnabled
3149− = lens _iVMUnlocked (\ s a -> s{_iVMUnlocked = a})
3530+ = lens _iVMDebugEnabled
3531+ (\ s a -> s{_iVMDebugEnabled = a})
3150
3532
3151−-- | Number of requests (since the clone was started). \'OutputOnly
3533+-- | Number of requests since this instance was started. \'OutputOnly
3152iRequests :: Lens' Instance (Maybe Int32)
3534iRequests :: Lens' Instance (Maybe Int32)
3153iRequests
3535iRequests
3154 = lens _iRequests (\ s a -> s{_iRequests = a}) .
3536 = lens _iRequests (\ s a -> s{_iRequests = a}) .
3155 mapping _Coerce
3537 mapping _Coerce
3156
3538
3157−-- | QPS for this instance (averaged over the last minute). \'OutputOnly
3539+-- | Average queries per second (QPS) over the last minute. \'OutputOnly
3158iQps :: Lens' Instance (Maybe Double)
3540iQps :: Lens' Instance (Maybe Double)
3159iQps
3541iQps
3160 = lens _iQps (\ s a -> s{_iQps = a}) .
3542 = lens _iQps (\ s a -> s{_iQps = a}) .
3161 mapping _Coerce
3543 mapping _Coerce
3162
3544
3163−-- | The relative name\/path of the instance within the version. Example:
3545+-- | Relative name of the instance within the version. Example:
3164−-- \"instance-1\" \'OutputOnly
3546+-- \`instance-1\`. \'OutputOnly
3165iId :: Lens' Instance (Maybe Text)
3547iId :: Lens' Instance (Maybe Text)
3166iId = lens _iId (\ s a -> s{_iId = a})
3548iId = lens _iId (\ s a -> s{_iId = a})
3167
3549
3168−-- | Number of errors since the instance was started. \'OutputOnly
3550+-- | Number of errors since this instance was started. \'OutputOnly
3169−iErrors :: Lens' Instance (Maybe Word32)
3551+iErrors :: Lens' Instance (Maybe Int32)
3170iErrors
3552iErrors
3171 = lens _iErrors (\ s a -> s{_iErrors = a}) .
3553 = lens _iErrors (\ s a -> s{_iErrors = a}) .
3172 mapping _Coerce
3554 mapping _Coerce
3173
3555
3174−-- | Latency in milliseconds (averaged over the last minute). \'OutputOnly
3556+-- | Average latency (ms) over the last minute. \'OutputOnly
3175iAverageLatency :: Lens' Instance (Maybe Int32)
3557iAverageLatency :: Lens' Instance (Maybe Int32)
3176iAverageLatency
3558iAverageLatency
3177 = lens _iAverageLatency
3559 = lens _iAverageLatency
3178 (\ s a -> s{_iAverageLatency = a})
3560 (\ s a -> s{_iAverageLatency = a})
3179 . mapping _Coerce
3561 . mapping _Coerce
3180
3562
3181−-- | Time when instance was started. \'OutputOnly
3563+-- | App Engine release this instance is running on. \'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
3188iAppEngineRelease :: Lens' Instance (Maybe Text)
3564iAppEngineRelease :: Lens' Instance (Maybe Text)
3189iAppEngineRelease
3565iAppEngineRelease
3190 = lens _iAppEngineRelease
3566 = lens _iAppEngineRelease
@@ -3197,17 +3573,17 @@ instance FromJSON Instance where
3197 Instance' <$>
3573 Instance' <$>
3198 (o .:? "memoryUsage") <*> (o .:? "vmStatus") <*>
3574 (o .:? "memoryUsage") <*> (o .:? "vmStatus") <*>
3199 (o .:? "vmZoneName")
3575 (o .:? "vmZoneName")
3576+ <*> (o .:? "startTime")
3200 <*> (o .:? "vmId")
3577 <*> (o .:? "vmId")
3201 <*> (o .:? "availability")
3578 <*> (o .:? "availability")
3202 <*> (o .:? "vmName")
3579 <*> (o .:? "vmName")
3203 <*> (o .:? "name")
3580 <*> (o .:? "name")
3204− <*> (o .:? "vmUnlocked")
3581+ <*> (o .:? "vmDebugEnabled")
3205 <*> (o .:? "requests")
3582 <*> (o .:? "requests")
3206 <*> (o .:? "qps")
3583 <*> (o .:? "qps")
3207 <*> (o .:? "id")
3584 <*> (o .:? "id")
3208 <*> (o .:? "errors")
3585 <*> (o .:? "errors")
3209 <*> (o .:? "averageLatency")
3586 <*> (o .:? "averageLatency")
3210− <*> (o .:? "startTimestamp")
3211 <*> (o .:? "appEngineRelease"))
3587 <*> (o .:? "appEngineRelease"))
3212
3588
3213instance ToJSON Instance where
3589instance ToJSON Instance where
@@ -3217,77 +3593,71 @@ instance ToJSON Instance where
3217 [("memoryUsage" .=) <$> _iMemoryUsage,
3593 [("memoryUsage" .=) <$> _iMemoryUsage,
3218 ("vmStatus" .=) <$> _iVMStatus,
3594 ("vmStatus" .=) <$> _iVMStatus,
3219 ("vmZoneName" .=) <$> _iVMZoneName,
3595 ("vmZoneName" .=) <$> _iVMZoneName,
3596+ ("startTime" .=) <$> _iStartTime,
3220 ("vmId" .=) <$> _iVMId,
3597 ("vmId" .=) <$> _iVMId,
3221 ("availability" .=) <$> _iAvailability,
3598 ("availability" .=) <$> _iAvailability,
3222 ("vmName" .=) <$> _iVMName, ("name" .=) <$> _iName,
3599 ("vmName" .=) <$> _iVMName, ("name" .=) <$> _iName,
3223− ("vmUnlocked" .=) <$> _iVMUnlocked,
3600+ ("vmDebugEnabled" .=) <$> _iVMDebugEnabled,
3224 ("requests" .=) <$> _iRequests, ("qps" .=) <$> _iQps,
3601 ("requests" .=) <$> _iRequests, ("qps" .=) <$> _iQps,
3225 ("id" .=) <$> _iId, ("errors" .=) <$> _iErrors,
3602 ("id" .=) <$> _iId, ("errors" .=) <$> _iErrors,
3226 ("averageLatency" .=) <$> _iAverageLatency,
3603 ("averageLatency" .=) <$> _iAverageLatency,
3227− ("startTimestamp" .=) <$> _iStartTimestamp,
3228 ("appEngineRelease" .=) <$> _iAppEngineRelease])
3604 ("appEngineRelease" .=) <$> _iAppEngineRelease])
3229
3605
3230-- | Code and application artifacts used to deploy a version to App Engine.
3606-- | Code and application artifacts used to deploy a version to App Engine.
3231--
3607--
3232-- /See:/ 'deployment' smart constructor.
3608-- /See:/ 'deployment' smart constructor.
3233data Deployment = Deployment'
3609data Deployment = Deployment'
3234− { _dContainer :: !(Maybe ContainerInfo)
3610+ { _dZip :: !(Maybe ZipInfo)
3235− , _dFiles :: !(Maybe DeploymentFiles)
3611+ , _dContainer :: !(Maybe ContainerInfo)
3236− , _dSourceReferences :: !(Maybe [SourceReference])
3612+ , _dFiles :: !(Maybe DeploymentFiles)
3237 } deriving (Eq,Show,Data,Typeable,Generic)
3613 } deriving (Eq,Show,Data,Typeable,Generic)
3238
3614
3239-- | Creates a value of 'Deployment' with the minimum fields required to make a request.
3615-- | Creates a value of 'Deployment' with the minimum fields required to make a request.
3240--
3616--
3241-- Use one of the following lenses to modify other fields as desired:
3617-- Use one of the following lenses to modify other fields as desired:
3242--
3618--
3619+-- * 'dZip'
3620+--
3243-- * 'dContainer'
3621-- * 'dContainer'
3244--
3622--
3245-- * 'dFiles'
3623-- * 'dFiles'
3246−--
3247−-- * 'dSourceReferences'
3248deployment
3624deployment
3249 :: Deployment
3625 :: Deployment
3250deployment =
3626deployment =
3251 Deployment'
3627 Deployment'
3252− { _dContainer = Nothing
3628+ { _dZip = Nothing
3629+ , _dContainer = Nothing
3253 , _dFiles = Nothing
3630 , _dFiles = Nothing
3254− , _dSourceReferences = Nothing
3255 }
3631 }
3256
3632
3257−-- | If supplied, a docker (container) image which should be used to start
3633+-- | The zip file for this deployment, if this is a zip deployment.
3258−-- the application. Only applicable to the \'vm\' runtime.
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.
3259dContainer :: Lens' Deployment (Maybe ContainerInfo)
3639dContainer :: Lens' Deployment (Maybe ContainerInfo)
3260dContainer
3640dContainer
3261 = lens _dContainer (\ s a -> s{_dContainer = a})
3641 = lens _dContainer (\ s a -> s{_dContainer = a})
3262
3642
3263−-- | A manifest of files stored in Google Cloud Storage which should be
3643+-- | Manifest of the files stored in Google Cloud Storage that are included
3264−-- included as part of this application. All files must be readable using
3644+-- as part of this version. All files must be readable using the
3265−-- the credentials supplied with this call.
3645+-- credentials supplied with this call.
3266dFiles :: Lens' Deployment (Maybe DeploymentFiles)
3646dFiles :: Lens' Deployment (Maybe DeploymentFiles)
3267dFiles = lens _dFiles (\ s a -> s{_dFiles = a})
3647dFiles = lens _dFiles (\ s a -> s{_dFiles = a})
3268
3648
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−
3279instance FromJSON Deployment where
3649instance FromJSON Deployment where
3280 parseJSON
3650 parseJSON
3281 = withObject "Deployment"
3651 = withObject "Deployment"
3282 (\ o ->
3652 (\ o ->
3283 Deployment' <$>
3653 Deployment' <$>
3284− (o .:? "container") <*> (o .:? "files") <*>
3654+ (o .:? "zip") <*> (o .:? "container") <*>
3285− (o .:? "sourceReferences" .!= mempty))
3655+ (o .:? "files"))
3286
3656
3287instance ToJSON Deployment where
3657instance ToJSON Deployment where
3288 toJSON Deployment'{..}
3658 toJSON Deployment'{..}
3289 = object
3659 = object
3290 (catMaybes
3660 (catMaybes
3291− [("container" .=) <$> _dContainer,
3661+ [("zip" .=) <$> _dZip,
3292− ("files" .=) <$> _dFiles,
3662+ ("container" .=) <$> _dContainer,
3293− ("sourceReferences" .=) <$> _dSourceReferences])
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
40 , agUploadType
40 , agUploadType
41 , agBearerToken
41 , agBearerToken
42 , agAppsId
42 , agAppsId
43− , agEnsureResourcesExist
44 , agCallback
43 , agCallback
45 ) where
44 ) where
46
45
@@ -50,7 +49,7 @@ import Network.Google.Prelude
50-- | A resource alias for @appengine.apps.get@ method which the
49-- | A resource alias for @appengine.apps.get@ method which the
51-- 'AppsGet' request conforms to.
50-- 'AppsGet' request conforms to.
52type AppsGetResource =
51type AppsGetResource =
53− "v1beta5" :>
52+ "v1" :>
54 "apps" :>
53 "apps" :>
55 Capture "appsId" Text :>
54 Capture "appsId" Text :>
56 QueryParam "$.xgafv" Text :>
55 QueryParam "$.xgafv" Text :>
@@ -59,23 +58,21 @@ type AppsGetResource =
59 QueryParam "access_token" Text :>
58 QueryParam "access_token" Text :>
60 QueryParam "uploadType" Text :>
59 QueryParam "uploadType" Text :>
61 QueryParam "bearer_token" Text :>
60 QueryParam "bearer_token" Text :>
62− QueryParam "ensureResourcesExist" Bool :>
61+ QueryParam "callback" Text :>
63− QueryParam "callback" Text :>
62+ QueryParam "alt" AltJSON :> Get '[JSON] Application
64− QueryParam "alt" AltJSON :> Get '[JSON] Application
65
63
66-- | Gets information about an application.
64-- | Gets information about an application.
67--
65--
68-- /See:/ 'appsGet' smart constructor.
66-- /See:/ 'appsGet' smart constructor.
69data AppsGet = AppsGet'
67data AppsGet = AppsGet'
70− { _agXgafv :: !(Maybe Text)
68+ { _agXgafv :: !(Maybe Text)
71− , _agUploadProtocol :: !(Maybe Text)
69+ , _agUploadProtocol :: !(Maybe Text)
72− , _agPp :: !Bool
70+ , _agPp :: !Bool
73− , _agAccessToken :: !(Maybe Text)
71+ , _agAccessToken :: !(Maybe Text)
74− , _agUploadType :: !(Maybe Text)
72+ , _agUploadType :: !(Maybe Text)
75− , _agBearerToken :: !(Maybe Text)
73+ , _agBearerToken :: !(Maybe Text)
76− , _agAppsId :: !Text
74+ , _agAppsId :: !Text
77− , _agEnsureResourcesExist :: !(Maybe Bool)
75+ , _agCallback :: !(Maybe Text)
78− , _agCallback :: !(Maybe Text)
79 } deriving (Eq,Show,Data,Typeable,Generic)
76 } deriving (Eq,Show,Data,Typeable,Generic)
80
77
81-- | Creates a value of 'AppsGet' with the minimum fields required to make a request.
78-- | Creates a value of 'AppsGet' with the minimum fields required to make a request.
@@ -96,8 +93,6 @@ data AppsGet = AppsGet'
96--
93--
97-- * 'agAppsId'
94-- * 'agAppsId'
98--
95--
99−-- * 'agEnsureResourcesExist'
100−--
101-- * 'agCallback'
96-- * 'agCallback'
102appsGet
97appsGet
103 :: Text -- ^ 'agAppsId'
98 :: Text -- ^ 'agAppsId'
@@ -111,7 +106,6 @@ appsGet pAgAppsId_ =
111 , _agUploadType = Nothing
106 , _agUploadType = Nothing
112 , _agBearerToken = Nothing
107 , _agBearerToken = Nothing
113 , _agAppsId = pAgAppsId_
108 , _agAppsId = pAgAppsId_
114− , _agEnsureResourcesExist = Nothing
115 , _agCallback = Nothing
109 , _agCallback = Nothing
116 }
110 }
117
111
@@ -146,22 +140,11 @@ agBearerToken
146 = lens _agBearerToken
140 = lens _agBearerToken
147 (\ s a -> s{_agBearerToken = a})
141 (\ s a -> s{_agBearerToken = a})
148
142
149−-- | Part of \`name\`. Name of the application to get. For example:
143+-- | Part of \`name\`. Name of the Application resource to get. Example:
150−-- \"apps\/myapp\".
144+-- \`apps\/myapp\`.
151agAppsId :: Lens' AppsGet Text
145agAppsId :: Lens' AppsGet Text
152agAppsId = lens _agAppsId (\ s a -> s{_agAppsId = a})
146agAppsId = lens _agAppsId (\ s a -> s{_agAppsId = a})
153
147
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−
165-- | JSONP
148-- | JSONP
166agCallback :: Lens' AppsGet (Maybe Text)
149agCallback :: Lens' AppsGet (Maybe Text)
167agCallback
150agCallback
@@ -177,7 +160,6 @@ instance GoogleRequest AppsGet where
177 _agAccessToken
160 _agAccessToken
178 _agUploadType
161 _agUploadType
179 _agBearerToken
162 _agBearerToken
180− _agEnsureResourcesExist
181 _agCallback
163 _agCallback
182 (Just AltJSON)
164 (Just AltJSON)
183 appEngineService
165 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
52-- | A resource alias for @appengine.apps.operations.get@ method which the
52-- | A resource alias for @appengine.apps.operations.get@ method which the
53-- 'AppsOperationsGet' request conforms to.
53-- 'AppsOperationsGet' request conforms to.
54type AppsOperationsGetResource =
54type AppsOperationsGetResource =
55− "v1beta5" :>
55+ "v1" :>
56 "apps" :>
56 "apps" :>
57 Capture "appsId" Text :>
57 Capture "appsId" Text :>
58 "operations" :>
58 "operations" :>
gogol-appengine/gen/Network/Google/Resource/AppEngine/Apps/Operations/List.hs+1−1
@@ -56,7 +56,7 @@ import Network.Google.Prelude
56-- | A resource alias for @appengine.apps.operations.list@ method which the
56-- | A resource alias for @appengine.apps.operations.list@ method which the
57-- 'AppsOperationsList' request conforms to.
57-- 'AppsOperationsList' request conforms to.
58type AppsOperationsListResource =
58type AppsOperationsListResource =
59− "v1beta5" :>
59+ "v1" :>
60 "apps" :>
60 "apps" :>
61 Capture "appsId" Text :>
61 Capture "appsId" Text :>
62 "operations" :>
62 "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 @@
20-- Stability : auto-generated
20-- Stability : auto-generated
21-- Portability : non-portable (GHC extensions)
21-- Portability : non-portable (GHC extensions)
22--
22--
23−-- Deletes a service and all enclosed versions.
23+-- Deletes the specified service and all enclosed versions.
24--
24--
25-- /See:/ <https://cloud.google.com/appengine/docs/admin-api/ Google App Engine Admin API Reference> for @appengine.apps.services.delete@.
25-- /See:/ <https://cloud.google.com/appengine/docs/admin-api/ Google App Engine Admin API Reference> for @appengine.apps.services.delete@.
26module Network.Google.Resource.AppEngine.Apps.Services.Delete
26module Network.Google.Resource.AppEngine.Apps.Services.Delete
@@ -50,7 +50,7 @@ import Network.Google.Prelude
50-- | A resource alias for @appengine.apps.services.delete@ method which the
50-- | A resource alias for @appengine.apps.services.delete@ method which the
51-- 'AppsServicesDelete' request conforms to.
51-- 'AppsServicesDelete' request conforms to.
52type AppsServicesDeleteResource =
52type AppsServicesDeleteResource =
53− "v1beta5" :>
53+ "v1" :>
54 "apps" :>
54 "apps" :>
55 Capture "appsId" Text :>
55 Capture "appsId" Text :>
56 "services" :>
56 "services" :>
@@ -65,7 +65,7 @@ type AppsServicesDeleteResource =
65 QueryParam "alt" AltJSON :>
65 QueryParam "alt" AltJSON :>
66 Delete '[JSON] Operation
66 Delete '[JSON] Operation
67
67
68−-- | Deletes a service and all enclosed versions.
68+-- | Deletes the specified service and all enclosed versions.
69--
69--
70-- /See:/ 'appsServicesDelete' smart constructor.
70-- /See:/ 'appsServicesDelete' smart constructor.
71data AppsServicesDelete = AppsServicesDelete'
71data AppsServicesDelete = AppsServicesDelete'
@@ -150,8 +150,8 @@ asdBearerToken
150 = lens _asdBearerToken
150 = lens _asdBearerToken
151 (\ s a -> s{_asdBearerToken = a})
151 (\ s a -> s{_asdBearerToken = a})
152
152
153−-- | Part of \`name\`. Name of the resource requested. For example:
153+-- | Part of \`name\`. Name of the resource requested. Example:
154−-- \"apps\/myapp\/services\/default\".
154+-- \`apps\/myapp\/services\/default\`.
155asdAppsId :: Lens' AppsServicesDelete Text
155asdAppsId :: Lens' AppsServicesDelete Text
156asdAppsId
156asdAppsId
157 = lens _asdAppsId (\ s a -> s{_asdAppsId = a})
157 = lens _asdAppsId (\ s a -> s{_asdAppsId = a})
gogol-appengine/gen/Network/Google/Resource/AppEngine/Apps/Services/Get.hs+5−5
@@ -20,7 +20,7 @@
20-- Stability : auto-generated
20-- Stability : auto-generated
21-- Portability : non-portable (GHC extensions)
21-- Portability : non-portable (GHC extensions)
22--
22--
23−-- Gets the current configuration of the service.
23+-- Gets the current configuration of the specified service.
24--
24--
25-- /See:/ <https://cloud.google.com/appengine/docs/admin-api/ Google App Engine Admin API Reference> for @appengine.apps.services.get@.
25-- /See:/ <https://cloud.google.com/appengine/docs/admin-api/ Google App Engine Admin API Reference> for @appengine.apps.services.get@.
26module Network.Google.Resource.AppEngine.Apps.Services.Get
26module Network.Google.Resource.AppEngine.Apps.Services.Get
@@ -50,7 +50,7 @@ import Network.Google.Prelude
50-- | A resource alias for @appengine.apps.services.get@ method which the
50-- | A resource alias for @appengine.apps.services.get@ method which the
51-- 'AppsServicesGet' request conforms to.
51-- 'AppsServicesGet' request conforms to.
52type AppsServicesGetResource =
52type AppsServicesGetResource =
53− "v1beta5" :>
53+ "v1" :>
54 "apps" :>
54 "apps" :>
55 Capture "appsId" Text :>
55 Capture "appsId" Text :>
56 "services" :>
56 "services" :>
@@ -64,7 +64,7 @@ type AppsServicesGetResource =
64 QueryParam "callback" Text :>
64 QueryParam "callback" Text :>
65 QueryParam "alt" AltJSON :> Get '[JSON] Service
65 QueryParam "alt" AltJSON :> Get '[JSON] Service
66
66
67−-- | Gets the current configuration of the service.
67+-- | Gets the current configuration of the specified service.
68--
68--
69-- /See:/ 'appsServicesGet' smart constructor.
69-- /See:/ 'appsServicesGet' smart constructor.
70data AppsServicesGet = AppsServicesGet'
70data AppsServicesGet = AppsServicesGet'
@@ -149,8 +149,8 @@ asgBearerToken
149 = lens _asgBearerToken
149 = lens _asgBearerToken
150 (\ s a -> s{_asgBearerToken = a})
150 (\ s a -> s{_asgBearerToken = a})
151
151
152−-- | Part of \`name\`. Name of the resource requested. For example:
152+-- | Part of \`name\`. Name of the resource requested. Example:
153−-- \"apps\/myapp\/services\/default\".
153+-- \`apps\/myapp\/services\/default\`.
154asgAppsId :: Lens' AppsServicesGet Text
154asgAppsId :: Lens' AppsServicesGet Text
155asgAppsId
155asgAppsId
156 = lens _asgAppsId (\ s a -> s{_asgAppsId = a})
156 = 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
51-- | A resource alias for @appengine.apps.services.list@ method which the
51-- | A resource alias for @appengine.apps.services.list@ method which the
52-- 'AppsServicesList' request conforms to.
52-- 'AppsServicesList' request conforms to.
53type AppsServicesListResource =
53type AppsServicesListResource =
54− "v1beta5" :>
54+ "v1" :>
55 "apps" :>
55 "apps" :>
56 Capture "appsId" Text :>
56 Capture "appsId" Text :>
57 "services" :>
57 "services" :>
@@ -155,8 +155,8 @@ aslBearerToken
155 = lens _aslBearerToken
155 = lens _aslBearerToken
156 (\ s a -> s{_aslBearerToken = a})
156 (\ s a -> s{_aslBearerToken = a})
157
157
158−-- | Part of \`name\`. Name of the resource requested. For example:
158+-- | Part of \`parent\`. Name of the parent Application resource. Example:
159−-- \"apps\/myapp\".
159+-- \`apps\/myapp\`.
160aslAppsId :: Lens' AppsServicesList Text
160aslAppsId :: Lens' AppsServicesList Text
161aslAppsId
161aslAppsId
162 = lens _aslAppsId (\ s a -> s{_aslAppsId = a})
162 = 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
35 -- * Request Lenses
35 -- * Request Lenses
36 , aspXgafv
36 , aspXgafv
37 , aspUploadProtocol
37 , aspUploadProtocol
38+ , aspUpdateMask
38 , aspPp
39 , aspPp
39 , aspAccessToken
40 , aspAccessToken
40 , aspUploadType
41 , aspUploadType
41 , aspPayload
42 , aspPayload
42 , aspMigrateTraffic
43 , aspMigrateTraffic
43− , aspMask
44 , aspBearerToken
44 , aspBearerToken
45 , aspAppsId
45 , aspAppsId
46 , aspServicesId
46 , aspServicesId
@@ -53,18 +53,18 @@ import Network.Google.Prelude
53-- | A resource alias for @appengine.apps.services.patch@ method which the
53-- | A resource alias for @appengine.apps.services.patch@ method which the
54-- 'AppsServicesPatch' request conforms to.
54-- 'AppsServicesPatch' request conforms to.
55type AppsServicesPatchResource =
55type AppsServicesPatchResource =
56− "v1beta5" :>
56+ "v1" :>
57 "apps" :>
57 "apps" :>
58 Capture "appsId" Text :>
58 Capture "appsId" Text :>
59 "services" :>
59 "services" :>
60 Capture "servicesId" Text :>
60 Capture "servicesId" Text :>
61 QueryParam "$.xgafv" Text :>
61 QueryParam "$.xgafv" Text :>
62 QueryParam "upload_protocol" Text :>
62 QueryParam "upload_protocol" Text :>
63− QueryParam "pp" Bool :>
63+ QueryParam "updateMask" Text :>
64− QueryParam "access_token" Text :>
64+ QueryParam "pp" Bool :>
65− QueryParam "uploadType" Text :>
65+ QueryParam "access_token" Text :>
66− QueryParam "migrateTraffic" Bool :>
66+ QueryParam "uploadType" Text :>
67− QueryParam "mask" Text :>
67+ QueryParam "migrateTraffic" Bool :>
68 QueryParam "bearer_token" Text :>
68 QueryParam "bearer_token" Text :>
69 QueryParam "callback" Text :>
69 QueryParam "callback" Text :>
70 QueryParam "alt" AltJSON :>
70 QueryParam "alt" AltJSON :>
@@ -77,12 +77,12 @@ type AppsServicesPatchResource =
77data AppsServicesPatch = AppsServicesPatch'
77data AppsServicesPatch = AppsServicesPatch'
78 { _aspXgafv :: !(Maybe Text)
78 { _aspXgafv :: !(Maybe Text)
79 , _aspUploadProtocol :: !(Maybe Text)
79 , _aspUploadProtocol :: !(Maybe Text)
80+ , _aspUpdateMask :: !(Maybe Text)
80 , _aspPp :: !Bool
81 , _aspPp :: !Bool
81 , _aspAccessToken :: !(Maybe Text)
82 , _aspAccessToken :: !(Maybe Text)
82 , _aspUploadType :: !(Maybe Text)
83 , _aspUploadType :: !(Maybe Text)
83 , _aspPayload :: !Service
84 , _aspPayload :: !Service
84 , _aspMigrateTraffic :: !(Maybe Bool)
85 , _aspMigrateTraffic :: !(Maybe Bool)
85− , _aspMask :: !(Maybe Text)
86 , _aspBearerToken :: !(Maybe Text)
86 , _aspBearerToken :: !(Maybe Text)
87 , _aspAppsId :: !Text
87 , _aspAppsId :: !Text
88 , _aspServicesId :: !Text
88 , _aspServicesId :: !Text
@@ -97,6 +97,8 @@ data AppsServicesPatch = AppsServicesPatch'
97--
97--
98-- * 'aspUploadProtocol'
98-- * 'aspUploadProtocol'
99--
99--
100+-- * 'aspUpdateMask'
101+--
100-- * 'aspPp'
102-- * 'aspPp'
101--
103--
102-- * 'aspAccessToken'
104-- * 'aspAccessToken'
@@ -107,8 +109,6 @@ data AppsServicesPatch = AppsServicesPatch'
107--
109--
108-- * 'aspMigrateTraffic'
110-- * 'aspMigrateTraffic'
109--
111--
110−-- * 'aspMask'
111−--
112-- * 'aspBearerToken'
112-- * 'aspBearerToken'
113--
113--
114-- * 'aspAppsId'
114-- * 'aspAppsId'
@@ -125,12 +125,12 @@ appsServicesPatch pAspPayload_ pAspAppsId_ pAspServicesId_ =
125 AppsServicesPatch'
125 AppsServicesPatch'
126 { _aspXgafv = Nothing
126 { _aspXgafv = Nothing
127 , _aspUploadProtocol = Nothing
127 , _aspUploadProtocol = Nothing
128+ , _aspUpdateMask = Nothing
128 , _aspPp = True
129 , _aspPp = True
129 , _aspAccessToken = Nothing
130 , _aspAccessToken = Nothing
130 , _aspUploadType = Nothing
131 , _aspUploadType = Nothing
131 , _aspPayload = pAspPayload_
132 , _aspPayload = pAspPayload_
132 , _aspMigrateTraffic = Nothing
133 , _aspMigrateTraffic = Nothing
133− , _aspMask = Nothing
134 , _aspBearerToken = Nothing
134 , _aspBearerToken = Nothing
135 , _aspAppsId = pAspAppsId_
135 , _aspAppsId = pAspAppsId_
136 , _aspServicesId = pAspServicesId_
136 , _aspServicesId = pAspServicesId_
@@ -147,6 +147,12 @@ aspUploadProtocol
147 = lens _aspUploadProtocol
147 = lens _aspUploadProtocol
148 (\ s a -> s{_aspUploadProtocol = a})
148 (\ s a -> s{_aspUploadProtocol = a})
149
149
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+
150-- | Pretty-print response.
156-- | Pretty-print response.
151aspPp :: Lens' AppsServicesPatch Bool
157aspPp :: Lens' AppsServicesPatch Bool
152aspPp = lens _aspPp (\ s a -> s{_aspPp = a})
158aspPp = lens _aspPp (\ s a -> s{_aspPp = a})
@@ -168,25 +174,32 @@ aspPayload :: Lens' AppsServicesPatch Service
168aspPayload
174aspPayload
169 = lens _aspPayload (\ s a -> s{_aspPayload = a})
175 = lens _aspPayload (\ s a -> s{_aspPayload = a})
170
176
171−-- | Whether to use Traffic Migration to shift traffic gradually. Traffic can
177+-- | Set to \`true\` to gradually shift traffic from one version to another
172−-- only be migrated from a single version to another single version.
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).
173aspMigrateTraffic :: Lens' AppsServicesPatch (Maybe Bool)
190aspMigrateTraffic :: Lens' AppsServicesPatch (Maybe Bool)
174aspMigrateTraffic
191aspMigrateTraffic
175 = lens _aspMigrateTraffic
192 = lens _aspMigrateTraffic
176 (\ s a -> s{_aspMigrateTraffic = a})
193 (\ s a -> s{_aspMigrateTraffic = a})
177
194
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−
182-- | OAuth bearer token.
195-- | OAuth bearer token.
183aspBearerToken :: Lens' AppsServicesPatch (Maybe Text)
196aspBearerToken :: Lens' AppsServicesPatch (Maybe Text)
184aspBearerToken
197aspBearerToken
185 = lens _aspBearerToken
198 = lens _aspBearerToken
186 (\ s a -> s{_aspBearerToken = a})
199 (\ s a -> s{_aspBearerToken = a})
187
200
188−-- | Part of \`name\`. Name of the resource to update. For example:
201+-- | Part of \`name\`. Name of the resource to update. Example:
189−-- \"apps\/myapp\/services\/default\".
202+-- \`apps\/myapp\/services\/default\`.
190aspAppsId :: Lens' AppsServicesPatch Text
203aspAppsId :: Lens' AppsServicesPatch Text
191aspAppsId
204aspAppsId
192 = lens _aspAppsId (\ s a -> s{_aspAppsId = a})
205 = lens _aspAppsId (\ s a -> s{_aspAppsId = a})
@@ -209,11 +222,11 @@ instance GoogleRequest AppsServicesPatch where
209 requestClient AppsServicesPatch'{..}
222 requestClient AppsServicesPatch'{..}
210 = go _aspAppsId _aspServicesId _aspXgafv
223 = go _aspAppsId _aspServicesId _aspXgafv
211 _aspUploadProtocol
224 _aspUploadProtocol
225+ _aspUpdateMask
212 (Just _aspPp)
226 (Just _aspPp)
213 _aspAccessToken
227 _aspAccessToken
214 _aspUploadType
228 _aspUploadType
215 _aspMigrateTraffic
229 _aspMigrateTraffic
216− _aspMask
217 _aspBearerToken
230 _aspBearerToken
218 _aspCallback
231 _aspCallback
219 (Just AltJSON)
232 (Just AltJSON)
gogol-appengine/gen/Network/Google/Resource/AppEngine/Apps/Services/Versions/Create.hs+6−6
@@ -20,7 +20,7 @@
20-- Stability : auto-generated
20-- Stability : auto-generated
21-- Portability : non-portable (GHC extensions)
21-- Portability : non-portable (GHC extensions)
22--
22--
23−-- Deploys new code and resource files to a version.
23+-- Deploys code and resource files to a new version.
24--
24--
25-- /See:/ <https://cloud.google.com/appengine/docs/admin-api/ Google App Engine Admin API Reference> for @appengine.apps.services.versions.create@.
25-- /See:/ <https://cloud.google.com/appengine/docs/admin-api/ Google App Engine Admin API Reference> for @appengine.apps.services.versions.create@.
26module Network.Google.Resource.AppEngine.Apps.Services.Versions.Create
26module Network.Google.Resource.AppEngine.Apps.Services.Versions.Create
@@ -51,7 +51,7 @@ import Network.Google.Prelude
51-- | A resource alias for @appengine.apps.services.versions.create@ method which the
51-- | A resource alias for @appengine.apps.services.versions.create@ method which the
52-- 'AppsServicesVersionsCreate' request conforms to.
52-- 'AppsServicesVersionsCreate' request conforms to.
53type AppsServicesVersionsCreateResource =
53type AppsServicesVersionsCreateResource =
54− "v1beta5" :>
54+ "v1" :>
55 "apps" :>
55 "apps" :>
56 Capture "appsId" Text :>
56 Capture "appsId" Text :>
57 "services" :>
57 "services" :>
@@ -68,7 +68,7 @@ type AppsServicesVersionsCreateResource =
68 ReqBody '[JSON] Version :>
68 ReqBody '[JSON] Version :>
69 Post '[JSON] Operation
69 Post '[JSON] Operation
70
70
71−-- | Deploys new code and resource files to a version.
71+-- | Deploys code and resource files to a new version.
72--
72--
73-- /See:/ 'appsServicesVersionsCreate' smart constructor.
73-- /See:/ 'appsServicesVersionsCreate' smart constructor.
74data AppsServicesVersionsCreate = AppsServicesVersionsCreate'
74data AppsServicesVersionsCreate = AppsServicesVersionsCreate'
@@ -164,13 +164,13 @@ asvcBearerToken
164 = lens _asvcBearerToken
164 = lens _asvcBearerToken
165 (\ s a -> s{_asvcBearerToken = a})
165 (\ s a -> s{_asvcBearerToken = a})
166
166
167−-- | Part of \`name\`. Name of the resource to update. For example:
167+-- | Part of \`parent\`. Name of the parent resource to create this version
168−-- \"apps\/myapp\/services\/default\".
168+-- under. Example: \`apps\/myapp\/services\/default\`.
169asvcAppsId :: Lens' AppsServicesVersionsCreate Text
169asvcAppsId :: Lens' AppsServicesVersionsCreate Text
170asvcAppsId
170asvcAppsId
171 = lens _asvcAppsId (\ s a -> s{_asvcAppsId = a})
171 = lens _asvcAppsId (\ s a -> s{_asvcAppsId = a})
172
172
173−-- | Part of \`name\`. See documentation of \`appsId\`.
173+-- | Part of \`parent\`. See documentation of \`appsId\`.
174asvcServicesId :: Lens' AppsServicesVersionsCreate Text
174asvcServicesId :: Lens' AppsServicesVersionsCreate Text
175asvcServicesId
175asvcServicesId
176 = lens _asvcServicesId
176 = lens _asvcServicesId
gogol-appengine/gen/Network/Google/Resource/AppEngine/Apps/Services/Versions/Delete.hs+5−5
@@ -20,7 +20,7 @@
20-- Stability : auto-generated
20-- Stability : auto-generated
21-- Portability : non-portable (GHC extensions)
21-- Portability : non-portable (GHC extensions)
22--
22--
23−-- Deletes an existing version.
23+-- Deletes an existing Version resource.
24--
24--
25-- /See:/ <https://cloud.google.com/appengine/docs/admin-api/ Google App Engine Admin API Reference> for @appengine.apps.services.versions.delete@.
25-- /See:/ <https://cloud.google.com/appengine/docs/admin-api/ Google App Engine Admin API Reference> for @appengine.apps.services.versions.delete@.
26module Network.Google.Resource.AppEngine.Apps.Services.Versions.Delete
26module Network.Google.Resource.AppEngine.Apps.Services.Versions.Delete
@@ -51,7 +51,7 @@ import Network.Google.Prelude
51-- | A resource alias for @appengine.apps.services.versions.delete@ method which the
51-- | A resource alias for @appengine.apps.services.versions.delete@ method which the
52-- 'AppsServicesVersionsDelete' request conforms to.
52-- 'AppsServicesVersionsDelete' request conforms to.
53type AppsServicesVersionsDeleteResource =
53type AppsServicesVersionsDeleteResource =
54− "v1beta5" :>
54+ "v1" :>
55 "apps" :>
55 "apps" :>
56 Capture "appsId" Text :>
56 Capture "appsId" Text :>
57 "services" :>
57 "services" :>
@@ -68,7 +68,7 @@ type AppsServicesVersionsDeleteResource =
68 QueryParam "alt" AltJSON :>
68 QueryParam "alt" AltJSON :>
69 Delete '[JSON] Operation
69 Delete '[JSON] Operation
70
70
71−-- | Deletes an existing version.
71+-- | Deletes an existing Version resource.
72--
72--
73-- /See:/ 'appsServicesVersionsDelete' smart constructor.
73-- /See:/ 'appsServicesVersionsDelete' smart constructor.
74data AppsServicesVersionsDelete = AppsServicesVersionsDelete'
74data AppsServicesVersionsDelete = AppsServicesVersionsDelete'
@@ -165,8 +165,8 @@ asvdBearerToken
165 = lens _asvdBearerToken
165 = lens _asvdBearerToken
166 (\ s a -> s{_asvdBearerToken = a})
166 (\ s a -> s{_asvdBearerToken = a})
167
167
168−-- | Part of \`name\`. Name of the resource requested. For example:
168+-- | Part of \`name\`. Name of the resource requested. Example:
169−-- \"apps\/myapp\/services\/default\/versions\/v1\".
169+-- \`apps\/myapp\/services\/default\/versions\/v1\`.
170asvdAppsId :: Lens' AppsServicesVersionsDelete Text
170asvdAppsId :: Lens' AppsServicesVersionsDelete Text
171asvdAppsId
171asvdAppsId
172 = lens _asvdAppsId (\ s a -> s{_asvdAppsId = a})
172 = 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 @@
20-- Stability : auto-generated
20-- Stability : auto-generated
21-- Portability : non-portable (GHC extensions)
21-- Portability : non-portable (GHC extensions)
22--
22--
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.
24--
26--
25-- /See:/ <https://cloud.google.com/appengine/docs/admin-api/ Google App Engine Admin API Reference> for @appengine.apps.services.versions.get@.
27-- /See:/ <https://cloud.google.com/appengine/docs/admin-api/ Google App Engine Admin API Reference> for @appengine.apps.services.versions.get@.
26module Network.Google.Resource.AppEngine.Apps.Services.Versions.Get
28module Network.Google.Resource.AppEngine.Apps.Services.Versions.Get
@@ -52,7 +54,7 @@ import Network.Google.Prelude
52-- | A resource alias for @appengine.apps.services.versions.get@ method which the
54-- | A resource alias for @appengine.apps.services.versions.get@ method which the
53-- 'AppsServicesVersionsGet' request conforms to.
55-- 'AppsServicesVersionsGet' request conforms to.
54type AppsServicesVersionsGetResource =
56type AppsServicesVersionsGetResource =
55− "v1beta5" :>
57+ "v1" :>
56 "apps" :>
58 "apps" :>
57 Capture "appsId" Text :>
59 Capture "appsId" Text :>
58 "services" :>
60 "services" :>
@@ -70,7 +72,9 @@ type AppsServicesVersionsGetResource =
70 QueryParam "alt" AltJSON :>
72 QueryParam "alt" AltJSON :>
71 Get '[JSON] Version
73 Get '[JSON] Version
72
74
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.
74--
78--
75-- /See:/ 'appsServicesVersionsGet' smart constructor.
79-- /See:/ 'appsServicesVersionsGet' smart constructor.
76data AppsServicesVersionsGet = AppsServicesVersionsGet'
80data AppsServicesVersionsGet = AppsServicesVersionsGet'
@@ -171,8 +175,8 @@ asvgBearerToken
171 = lens _asvgBearerToken
175 = lens _asvgBearerToken
172 (\ s a -> s{_asvgBearerToken = a})
176 (\ s a -> s{_asvgBearerToken = a})
173
177
174−-- | Part of \`name\`. Name of the resource requested. For example:
178+-- | Part of \`name\`. Name of the resource requested. Example:
175−-- \"apps\/myapp\/services\/default\/versions\/v1\".
179+-- \`apps\/myapp\/services\/default\/versions\/v1\`.
176asvgAppsId :: Lens' AppsServicesVersionsGet Text
180asvgAppsId :: Lens' AppsServicesVersionsGet Text
177asvgAppsId
181asvgAppsId
178 = lens _asvgAppsId (\ s a -> s{_asvgAppsId = a})
182 = 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
53-- | A resource alias for @appengine.apps.services.versions.instances.list@ method which the
53-- | A resource alias for @appengine.apps.services.versions.instances.list@ method which the
54-- 'AppsServicesVersionsInstancesList' request conforms to.
54-- 'AppsServicesVersionsInstancesList' request conforms to.
55type AppsServicesVersionsInstancesListResource =
55type AppsServicesVersionsInstancesListResource =
56− "v1beta5" :>
56+ "v1" :>
57 "apps" :>
57 "apps" :>
58 Capture "appsId" Text :>
58 Capture "appsId" Text :>
59 "services" :>
59 "services" :>
@@ -166,7 +166,7 @@ asvilUploadType
166 = lens _asvilUploadType
166 = lens _asvilUploadType
167 (\ s a -> s{_asvilUploadType = a})
167 (\ s a -> s{_asvilUploadType = a})
168
168
169−-- | Part of \`name\`. See documentation of \`appsId\`.
169+-- | Part of \`parent\`. See documentation of \`appsId\`.
170asvilVersionsId :: Lens' AppsServicesVersionsInstancesList Text
170asvilVersionsId :: Lens' AppsServicesVersionsInstancesList Text
171asvilVersionsId
171asvilVersionsId
172 = lens _asvilVersionsId
172 = lens _asvilVersionsId
@@ -178,8 +178,8 @@ asvilBearerToken
178 = lens _asvilBearerToken
178 = lens _asvilBearerToken
179 (\ s a -> s{_asvilBearerToken = a})
179 (\ s a -> s{_asvilBearerToken = a})
180
180
181−-- | Part of \`name\`. Name of the resource requested. For example:
181+-- | Part of \`parent\`. Name of the parent Version resource. Example:
182−-- \"apps\/myapp\/services\/default\/versions\/v1\".
182+-- \`apps\/myapp\/services\/default\/versions\/v1\`.
183asvilAppsId :: Lens' AppsServicesVersionsInstancesList Text
183asvilAppsId :: Lens' AppsServicesVersionsInstancesList Text
184asvilAppsId
184asvilAppsId
185 = lens _asvilAppsId (\ s a -> s{_asvilAppsId = a})
185 = lens _asvilAppsId (\ s a -> s{_asvilAppsId = a})
@@ -190,7 +190,7 @@ asvilPageToken
190 = lens _asvilPageToken
190 = lens _asvilPageToken
191 (\ s a -> s{_asvilPageToken = a})
191 (\ s a -> s{_asvilPageToken = a})
192
192
193−-- | Part of \`name\`. See documentation of \`appsId\`.
193+-- | Part of \`parent\`. See documentation of \`appsId\`.
194asvilServicesId :: Lens' AppsServicesVersionsInstancesList Text
194asvilServicesId :: Lens' AppsServicesVersionsInstancesList Text
195asvilServicesId
195asvilServicesId
196 = lens _asvilServicesId
196 = lens _asvilServicesId
gogol-appengine/gen/Network/Google/Resource/AppEngine/Apps/Services/Versions/List.hs+4−4
@@ -53,7 +53,7 @@ import Network.Google.Prelude
53-- | A resource alias for @appengine.apps.services.versions.list@ method which the
53-- | A resource alias for @appengine.apps.services.versions.list@ method which the
54-- 'AppsServicesVersionsList' request conforms to.
54-- 'AppsServicesVersionsList' request conforms to.
55type AppsServicesVersionsListResource =
55type AppsServicesVersionsListResource =
56− "v1beta5" :>
56+ "v1" :>
57 "apps" :>
57 "apps" :>
58 Capture "appsId" Text :>
58 Capture "appsId" Text :>
59 "services" :>
59 "services" :>
@@ -170,8 +170,8 @@ asvlBearerToken
170 = lens _asvlBearerToken
170 = lens _asvlBearerToken
171 (\ s a -> s{_asvlBearerToken = a})
171 (\ s a -> s{_asvlBearerToken = a})
172
172
173−-- | Part of \`name\`. Name of the resource requested. For example:
173+-- | Part of \`parent\`. Name of the parent Service resource. Example:
174−-- \"apps\/myapp\/services\/default\".
174+-- \`apps\/myapp\/services\/default\`.
175asvlAppsId :: Lens' AppsServicesVersionsList Text
175asvlAppsId :: Lens' AppsServicesVersionsList Text
176asvlAppsId
176asvlAppsId
177 = lens _asvlAppsId (\ s a -> s{_asvlAppsId = a})
177 = lens _asvlAppsId (\ s a -> s{_asvlAppsId = a})
@@ -186,7 +186,7 @@ asvlPageToken
186 = lens _asvlPageToken
186 = lens _asvlPageToken
187 (\ s a -> s{_asvlPageToken = a})
187 (\ s a -> s{_asvlPageToken = a})
188
188
189−-- | Part of \`name\`. See documentation of \`appsId\`.
189+-- | Part of \`parent\`. See documentation of \`appsId\`.
190asvlServicesId :: Lens' AppsServicesVersionsList Text
190asvlServicesId :: Lens' AppsServicesVersionsList Text
191asvlServicesId
191asvlServicesId
192 = lens _asvlServicesId
192 = lens _asvlServicesId
gogol-appengine/gen/Network/Google/Resource/AppEngine/Apps/Services/Versions/Patch.hs+47−19
@@ -20,7 +20,20 @@
20-- Stability : auto-generated
20-- Stability : auto-generated
21-- Portability : non-portable (GHC extensions)
21-- Portability : non-portable (GHC extensions)
22--
22--
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.
24--
37--
25-- /See:/ <https://cloud.google.com/appengine/docs/admin-api/ Google App Engine Admin API Reference> for @appengine.apps.services.versions.patch@.
38-- /See:/ <https://cloud.google.com/appengine/docs/admin-api/ Google App Engine Admin API Reference> for @appengine.apps.services.versions.patch@.
26module Network.Google.Resource.AppEngine.Apps.Services.Versions.Patch
39module Network.Google.Resource.AppEngine.Apps.Services.Versions.Patch
@@ -35,12 +48,12 @@ module Network.Google.Resource.AppEngine.Apps.Services.Versions.Patch
35 -- * Request Lenses
48 -- * Request Lenses
36 , asvpXgafv
49 , asvpXgafv
37 , asvpUploadProtocol
50 , asvpUploadProtocol
51+ , asvpUpdateMask
38 , asvpPp
52 , asvpPp
39 , asvpAccessToken
53 , asvpAccessToken
40 , asvpUploadType
54 , asvpUploadType
41 , asvpPayload
55 , asvpPayload
42 , asvpVersionsId
56 , asvpVersionsId
43− , asvpMask
44 , asvpBearerToken
57 , asvpBearerToken
45 , asvpAppsId
58 , asvpAppsId
46 , asvpServicesId
59 , asvpServicesId
@@ -53,7 +66,7 @@ import Network.Google.Prelude
53-- | A resource alias for @appengine.apps.services.versions.patch@ method which the
66-- | A resource alias for @appengine.apps.services.versions.patch@ method which the
54-- 'AppsServicesVersionsPatch' request conforms to.
67-- 'AppsServicesVersionsPatch' request conforms to.
55type AppsServicesVersionsPatchResource =
68type AppsServicesVersionsPatchResource =
56− "v1beta5" :>
69+ "v1" :>
57 "apps" :>
70 "apps" :>
58 Capture "appsId" Text :>
71 Capture "appsId" Text :>
59 "services" :>
72 "services" :>
@@ -62,28 +75,41 @@ type AppsServicesVersionsPatchResource =
62 Capture "versionsId" Text :>
75 Capture "versionsId" Text :>
63 QueryParam "$.xgafv" Text :>
76 QueryParam "$.xgafv" Text :>
64 QueryParam "upload_protocol" Text :>
77 QueryParam "upload_protocol" Text :>
65− QueryParam "pp" Bool :>
78+ QueryParam "updateMask" Text :>
66− QueryParam "access_token" Text :>
79+ QueryParam "pp" Bool :>
67− QueryParam "uploadType" Text :>
80+ QueryParam "access_token" Text :>
68− QueryParam "mask" Text :>
81+ QueryParam "uploadType" Text :>
69 QueryParam "bearer_token" Text :>
82 QueryParam "bearer_token" Text :>
70 QueryParam "callback" Text :>
83 QueryParam "callback" Text :>
71 QueryParam "alt" AltJSON :>
84 QueryParam "alt" AltJSON :>
72 ReqBody '[JSON] Version :>
85 ReqBody '[JSON] Version :>
73 Patch '[JSON] Operation
86 Patch '[JSON] Operation
74
87
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.
76--
102--
77-- /See:/ 'appsServicesVersionsPatch' smart constructor.
103-- /See:/ 'appsServicesVersionsPatch' smart constructor.
78data AppsServicesVersionsPatch = AppsServicesVersionsPatch'
104data AppsServicesVersionsPatch = AppsServicesVersionsPatch'
79 { _asvpXgafv :: !(Maybe Text)
105 { _asvpXgafv :: !(Maybe Text)
80 , _asvpUploadProtocol :: !(Maybe Text)
106 , _asvpUploadProtocol :: !(Maybe Text)
107+ , _asvpUpdateMask :: !(Maybe Text)
81 , _asvpPp :: !Bool
108 , _asvpPp :: !Bool
82 , _asvpAccessToken :: !(Maybe Text)
109 , _asvpAccessToken :: !(Maybe Text)
83 , _asvpUploadType :: !(Maybe Text)
110 , _asvpUploadType :: !(Maybe Text)
84 , _asvpPayload :: !Version
111 , _asvpPayload :: !Version
85 , _asvpVersionsId :: !Text
112 , _asvpVersionsId :: !Text
86− , _asvpMask :: !(Maybe Text)
87 , _asvpBearerToken :: !(Maybe Text)
113 , _asvpBearerToken :: !(Maybe Text)
88 , _asvpAppsId :: !Text
114 , _asvpAppsId :: !Text
89 , _asvpServicesId :: !Text
115 , _asvpServicesId :: !Text
@@ -98,6 +124,8 @@ data AppsServicesVersionsPatch = AppsServicesVersionsPatch'
98--
124--
99-- * 'asvpUploadProtocol'
125-- * 'asvpUploadProtocol'
100--
126--
127+-- * 'asvpUpdateMask'
128+--
101-- * 'asvpPp'
129-- * 'asvpPp'
102--
130--
103-- * 'asvpAccessToken'
131-- * 'asvpAccessToken'
@@ -108,8 +136,6 @@ data AppsServicesVersionsPatch = AppsServicesVersionsPatch'
108--
136--
109-- * 'asvpVersionsId'
137-- * 'asvpVersionsId'
110--
138--
111−-- * 'asvpMask'
112−--
113-- * 'asvpBearerToken'
139-- * 'asvpBearerToken'
114--
140--
115-- * 'asvpAppsId'
141-- * 'asvpAppsId'
@@ -127,12 +153,12 @@ appsServicesVersionsPatch pAsvpPayload_ pAsvpVersionsId_ pAsvpAppsId_ pAsvpServi
127 AppsServicesVersionsPatch'
153 AppsServicesVersionsPatch'
128 { _asvpXgafv = Nothing
154 { _asvpXgafv = Nothing
129 , _asvpUploadProtocol = Nothing
155 , _asvpUploadProtocol = Nothing
156+ , _asvpUpdateMask = Nothing
130 , _asvpPp = True
157 , _asvpPp = True
131 , _asvpAccessToken = Nothing
158 , _asvpAccessToken = Nothing
132 , _asvpUploadType = Nothing
159 , _asvpUploadType = Nothing
133 , _asvpPayload = pAsvpPayload_
160 , _asvpPayload = pAsvpPayload_
134 , _asvpVersionsId = pAsvpVersionsId_
161 , _asvpVersionsId = pAsvpVersionsId_
135− , _asvpMask = Nothing
136 , _asvpBearerToken = Nothing
162 , _asvpBearerToken = Nothing
137 , _asvpAppsId = pAsvpAppsId_
163 , _asvpAppsId = pAsvpAppsId_
138 , _asvpServicesId = pAsvpServicesId_
164 , _asvpServicesId = pAsvpServicesId_
@@ -150,6 +176,12 @@ asvpUploadProtocol
150 = lens _asvpUploadProtocol
176 = lens _asvpUploadProtocol
151 (\ s a -> s{_asvpUploadProtocol = a})
177 (\ s a -> s{_asvpUploadProtocol = a})
152
178
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+
153-- | Pretty-print response.
185-- | Pretty-print response.
154asvpPp :: Lens' AppsServicesVersionsPatch Bool
186asvpPp :: Lens' AppsServicesVersionsPatch Bool
155asvpPp = lens _asvpPp (\ s a -> s{_asvpPp = a})
187asvpPp = lens _asvpPp (\ s a -> s{_asvpPp = a})
@@ -177,18 +209,14 @@ asvpVersionsId
177 = lens _asvpVersionsId
209 = lens _asvpVersionsId
178 (\ s a -> s{_asvpVersionsId = a})
210 (\ s a -> s{_asvpVersionsId = a})
179
211
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−
184-- | OAuth bearer token.
212-- | OAuth bearer token.
185asvpBearerToken :: Lens' AppsServicesVersionsPatch (Maybe Text)
213asvpBearerToken :: Lens' AppsServicesVersionsPatch (Maybe Text)
186asvpBearerToken
214asvpBearerToken
187 = lens _asvpBearerToken
215 = lens _asvpBearerToken
188 (\ s a -> s{_asvpBearerToken = a})
216 (\ s a -> s{_asvpBearerToken = a})
189
217
190−-- | Part of \`name\`. Name of the resource to update. For example:
218+-- | Part of \`name\`. Name of the resource to update. Example:
191−-- \"apps\/myapp\/services\/default\/versions\/1\".
219+-- \`apps\/myapp\/services\/default\/versions\/1\`.
192asvpAppsId :: Lens' AppsServicesVersionsPatch Text
220asvpAppsId :: Lens' AppsServicesVersionsPatch Text
193asvpAppsId
221asvpAppsId
194 = lens _asvpAppsId (\ s a -> s{_asvpAppsId = a})
222 = lens _asvpAppsId (\ s a -> s{_asvpAppsId = a})
@@ -213,10 +241,10 @@ instance GoogleRequest AppsServicesVersionsPatch
213 = go _asvpAppsId _asvpServicesId _asvpVersionsId
241 = go _asvpAppsId _asvpServicesId _asvpVersionsId
214 _asvpXgafv
242 _asvpXgafv
215 _asvpUploadProtocol
243 _asvpUploadProtocol
244+ _asvpUpdateMask
216 (Just _asvpPp)
245 (Just _asvpPp)
217 _asvpAccessToken
246 _asvpAccessToken
218 _asvpUploadType
247 _asvpUploadType
219− _asvpMask
220 _asvpBearerToken
248 _asvpBearerToken
221 _asvpCallback
249 _asvpCallback
222 (Just AltJSON)
250 (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:
19 /Warning:/ This is an experimental prototype/preview release which is still
19 /Warning:/ This is an experimental prototype/preview release which is still
20 under exploratory development and not intended for public use, caveat emptor!
20 under exploratory development and not intended for public use, caveat emptor!
21 .
21 .
22− This library is compatible with version @v1beta5@
22+ This library is compatible with version @v1@
23 of the API.
23 of the API.
24
24
25source-repository head
25source-repository head
@@ -36,8 +36,12 @@ library
36 Network.Google.AppEngine
36 Network.Google.AppEngine
37 , Network.Google.AppEngine.Types
37 , Network.Google.AppEngine.Types
38 , Network.Google.Resource.AppEngine.Apps.Get
38 , Network.Google.Resource.AppEngine.Apps.Get
39+ , Network.Google.Resource.AppEngine.Apps.Locations.Get
40+ , Network.Google.Resource.AppEngine.Apps.Locations.List
39 , Network.Google.Resource.AppEngine.Apps.Operations.Get
41 , Network.Google.Resource.AppEngine.Apps.Operations.Get
40 , Network.Google.Resource.AppEngine.Apps.Operations.List
42 , Network.Google.Resource.AppEngine.Apps.Operations.List
43+ , Network.Google.Resource.AppEngine.Apps.Patch
44+ , Network.Google.Resource.AppEngine.Apps.Repair
41 , Network.Google.Resource.AppEngine.Apps.Services.Delete
45 , Network.Google.Resource.AppEngine.Apps.Services.Delete
42 , Network.Google.Resource.AppEngine.Apps.Services.Get
46 , Network.Google.Resource.AppEngine.Apps.Services.Get
43 , Network.Google.Resource.AppEngine.Apps.Services.List
47 , Network.Google.Resource.AppEngine.Apps.Services.List
@@ -45,9 +49,14 @@ library
45 , Network.Google.Resource.AppEngine.Apps.Services.Versions.Create
49 , Network.Google.Resource.AppEngine.Apps.Services.Versions.Create
46 , Network.Google.Resource.AppEngine.Apps.Services.Versions.Delete
50 , Network.Google.Resource.AppEngine.Apps.Services.Versions.Delete
47 , Network.Google.Resource.AppEngine.Apps.Services.Versions.Get
51 , 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
48 , Network.Google.Resource.AppEngine.Apps.Services.Versions.Instances.List
55 , Network.Google.Resource.AppEngine.Apps.Services.Versions.Instances.List
49 , Network.Google.Resource.AppEngine.Apps.Services.Versions.List
56 , Network.Google.Resource.AppEngine.Apps.Services.Versions.List
50 , Network.Google.Resource.AppEngine.Apps.Services.Versions.Patch
57 , 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
51
60
52 other-modules:
61 other-modules:
53 Network.Google.AppEngine.Types.Product
62 Network.Google.AppEngine.Types.Product