on develop help sign in
Regenerating gogol-logging from latest service definition
commit9d02aff8496e32d653d26fe43839a54ef0c7c1a8 authorBrendan Hay <brendan.g.hay@gmail.com> dateTue 25 Oct 2016, 11:37 (10 years ago) parentb14cba5
29 files changed+4866−1712
gen/model/logging/v2/logging-api.json+1504 gen/model/logging/v2beta1/logging-api.json+1299−1159 gogol-logging/README.md+1−1 gogol-logging/gen/Network/Google/Logging.hs+63−23 gogol-logging/gen/Network/Google/Logging/Types.hs+27−21 gogol-logging/gen/Network/Google/Logging/Types/Product.hs+253−321 gogol-logging/gen/Network/Google/Logging/Types/Sum.hs+262 gogol-logging/gen/Network/Google/Resource/Logging/BillingAccounts/Logs/Delete.hs+175 gogol-logging/gen/Network/Google/Resource/Logging/Entries/List.hs+5−5 gogol-logging/gen/Network/Google/Resource/Logging/Entries/Write.hs+9−9 gogol-logging/gen/Network/Google/Resource/Logging/MonitoredResourceDescriptors/List.hs+14−15 gogol-logging/gen/Network/Google/Resource/Logging/Organizations/Logs/Delete.hs+173 gogol-logging/gen/Network/Google/Resource/Logging/Organizations/Sinks/Create.hs+186 gogol-logging/gen/Network/Google/Resource/Logging/Organizations/Sinks/Delete.hs+173 gogol-logging/gen/Network/Google/Resource/Logging/Organizations/Sinks/Get.hs+173 gogol-logging/gen/Network/Google/Resource/Logging/Organizations/Sinks/List.hs+205 gogol-logging/gen/Network/Google/Resource/Logging/Organizations/Sinks/Update.hs+186 gogol-logging/gen/Network/Google/Resource/Logging/Projects/Logs/Delete.hs+5−5 gogol-logging/gen/Network/Google/Resource/Logging/Projects/Metrics/Create.hs+23−24 gogol-logging/gen/Network/Google/Resource/Logging/Projects/Metrics/Delete.hs+5−5 gogol-logging/gen/Network/Google/Resource/Logging/Projects/Metrics/Get.hs+5−5 gogol-logging/gen/Network/Google/Resource/Logging/Projects/Metrics/List.hs+28−31 gogol-logging/gen/Network/Google/Resource/Logging/Projects/Metrics/Update.hs+5−5 gogol-logging/gen/Network/Google/Resource/Logging/Projects/Sinks/Create.hs+23−24 gogol-logging/gen/Network/Google/Resource/Logging/Projects/Sinks/Delete.hs+9−7 gogol-logging/gen/Network/Google/Resource/Logging/Projects/Sinks/Get.hs+6−6 gogol-logging/gen/Network/Google/Resource/Logging/Projects/Sinks/List.hs+28−31 gogol-logging/gen/Network/Google/Resource/Logging/Projects/Sinks/Update.hs+11−11 gogol-logging/gogol-logging.cabal+10−4
gen/model/logging/v2/logging-api.jsonnew file+1504
@@ -0,0 +1,1504 @@
1+{
2+ "id": "logging:v2",
3+ "auth": {
4+ "oauth2": {
5+ "scopes": {
6+ "https://www.googleapis.com/auth/cloud-platform": {
7+ "description": "View and manage your data across Google Cloud Platform services"
8+ },
9+ "https://www.googleapis.com/auth/cloud-platform.read-only": {
10+ "description": "View your data across Google Cloud Platform services"
11+ },
12+ "https://www.googleapis.com/auth/logging.read": {
13+ "description": "View log data for your projects"
14+ },
15+ "https://www.googleapis.com/auth/logging.write": {
16+ "description": "Submit log data for your projects"
17+ },
18+ "https://www.googleapis.com/auth/logging.admin": {
19+ "description": "Administrate log data for your projects"
20+ }
21+ }
22+ }
23+ },
24+ "description": "Writes log entries and manages your Stackdriver Logging configuration.",
25+ "protocol": "rest",
26+ "title": "Stackdriver Logging API",
27+ "resources": {
28+ "projects": {
29+ "resources": {
30+ "metrics": {
31+ "methods": {
32+ "update": {
33+ "id": "logging.projects.metrics.update",
34+ "response": {
35+ "$ref": "LogMetric"
36+ },
37+ "parameterOrder": [
38+ "metricName"
39+ ],
40+ "description": "Creates or updates a logs-based metric.",
41+ "request": {
42+ "$ref": "LogMetric"
43+ },
44+ "flatPath": "v2/projects/{projectsId}/metrics/{metricsId}",
45+ "httpMethod": "PUT",
46+ "parameters": {
47+ "metricName": {
48+ "description": "The resource name of the metric to update.\nExample: `\"projects/my-project-id/metrics/my-metric-id\"`.\n\nThe updated metric must be provided in the request and have the\nsame identifier that is specified in `metricName`.\nIf the metric does not exist, it is created.",
49+ "required": true,
50+ "pattern": "^projects/[^/]+/metrics/[^/]+$",
51+ "location": "path",
52+ "type": "string"
53+ }
54+ },
55+ "path": "v2/{+metricName}",
56+ "scopes": [
57+ "https://www.googleapis.com/auth/cloud-platform",
58+ "https://www.googleapis.com/auth/logging.admin",
59+ "https://www.googleapis.com/auth/logging.write"
60+ ]
61+ },
62+ "get": {
63+ "id": "logging.projects.metrics.get",
64+ "response": {
65+ "$ref": "LogMetric"
66+ },
67+ "parameterOrder": [
68+ "metricName"
69+ ],
70+ "description": "Gets a logs-based metric.",
71+ "flatPath": "v2/projects/{projectsId}/metrics/{metricsId}",
72+ "httpMethod": "GET",
73+ "parameters": {
74+ "metricName": {
75+ "description": "The resource name of the desired metric.\nExample: `\"projects/my-project-id/metrics/my-metric-id\"`.",
76+ "required": true,
77+ "pattern": "^projects/[^/]+/metrics/[^/]+$",
78+ "location": "path",
79+ "type": "string"
80+ }
81+ },
82+ "path": "v2/{+metricName}",
83+ "scopes": [
84+ "https://www.googleapis.com/auth/cloud-platform",
85+ "https://www.googleapis.com/auth/cloud-platform.read-only",
86+ "https://www.googleapis.com/auth/logging.admin",
87+ "https://www.googleapis.com/auth/logging.read"
88+ ]
89+ },
90+ "create": {
91+ "id": "logging.projects.metrics.create",
92+ "response": {
93+ "$ref": "LogMetric"
94+ },
95+ "parameterOrder": [
96+ "parent"
97+ ],
98+ "description": "Creates a logs-based metric.",
99+ "request": {
100+ "$ref": "LogMetric"
101+ },
102+ "flatPath": "v2/projects/{projectsId}/metrics",
103+ "httpMethod": "POST",
104+ "parameters": {
105+ "parent": {
106+ "description": "The resource name of the project in which to create the metric.\nExample: `\"projects/my-project-id\"`.\n\nThe new metric must be provided in the request.",
107+ "required": true,
108+ "pattern": "^projects/[^/]+$",
109+ "location": "path",
110+ "type": "string"
111+ }
112+ },
113+ "path": "v2/{+parent}/metrics",
114+ "scopes": [
115+ "https://www.googleapis.com/auth/cloud-platform",
116+ "https://www.googleapis.com/auth/logging.admin",
117+ "https://www.googleapis.com/auth/logging.write"
118+ ]
119+ },
120+ "list": {
121+ "id": "logging.projects.metrics.list",
122+ "response": {
123+ "$ref": "ListLogMetricsResponse"
124+ },
125+ "parameterOrder": [
126+ "parent"
127+ ],
128+ "description": "Lists logs-based metrics.",
129+ "flatPath": "v2/projects/{projectsId}/metrics",
130+ "httpMethod": "GET",
131+ "parameters": {
132+ "pageSize": {
133+ "description": "Optional. The maximum number of results to return from this request.\nNon-positive values are ignored. The presence of `nextPageToken` in the\nresponse indicates that more results might be available.",
134+ "location": "query",
135+ "type": "integer",
136+ "format": "int32"
137+ },
138+ "parent": {
139+ "description": "Required. The resource name containing the metrics.\nExample: `\"projects/my-project-id\"`.",
140+ "required": true,
141+ "pattern": "^projects/[^/]+$",
142+ "location": "path",
143+ "type": "string"
144+ },
145+ "pageToken": {
146+ "description": "Optional. If present, then retrieve the next batch of results from the\npreceding call to this method. `pageToken` must be the value of\n`nextPageToken` from the previous response. The values of other method\nparameters should be identical to those in the previous call.",
147+ "location": "query",
148+ "type": "string"
149+ }
150+ },
151+ "path": "v2/{+parent}/metrics",
152+ "scopes": [
153+ "https://www.googleapis.com/auth/cloud-platform",
154+ "https://www.googleapis.com/auth/cloud-platform.read-only",
155+ "https://www.googleapis.com/auth/logging.admin",
156+ "https://www.googleapis.com/auth/logging.read"
157+ ]
158+ },
159+ "delete": {
160+ "id": "logging.projects.metrics.delete",
161+ "response": {
162+ "$ref": "Empty"
163+ },
164+ "parameterOrder": [
165+ "metricName"
166+ ],
167+ "description": "Deletes a logs-based metric.",
168+ "flatPath": "v2/projects/{projectsId}/metrics/{metricsId}",
169+ "httpMethod": "DELETE",
170+ "parameters": {
171+ "metricName": {
172+ "description": "The resource name of the metric to delete.\nExample: `\"projects/my-project-id/metrics/my-metric-id\"`.",
173+ "required": true,
174+ "pattern": "^projects/[^/]+/metrics/[^/]+$",
175+ "location": "path",
176+ "type": "string"
177+ }
178+ },
179+ "path": "v2/{+metricName}",
180+ "scopes": [
181+ "https://www.googleapis.com/auth/cloud-platform",
182+ "https://www.googleapis.com/auth/logging.admin",
183+ "https://www.googleapis.com/auth/logging.write"
184+ ]
185+ }
186+ }
187+ },
188+ "logs": {
189+ "methods": {
190+ "delete": {
191+ "id": "logging.projects.logs.delete",
192+ "response": {
193+ "$ref": "Empty"
194+ },
195+ "parameterOrder": [
196+ "logName"
197+ ],
198+ "description": "Deletes a log and all its log entries.\nThe log will reappear if it receives new entries.",
199+ "flatPath": "v2/projects/{projectsId}/logs/{logsId}",
200+ "httpMethod": "DELETE",
201+ "parameters": {
202+ "logName": {
203+ "description": "Required. The resource name of the log to delete. Example:\n`\"projects/my-project/logs/syslog\"`.",
204+ "required": true,
205+ "pattern": "^projects/[^/]+/logs/[^/]+$",
206+ "location": "path",
207+ "type": "string"
208+ }
209+ },
210+ "path": "v2/{+logName}",
211+ "scopes": [
212+ "https://www.googleapis.com/auth/cloud-platform",
213+ "https://www.googleapis.com/auth/logging.admin"
214+ ]
215+ }
216+ }
217+ },
218+ "sinks": {
219+ "methods": {
220+ "update": {
221+ "id": "logging.projects.sinks.update",
222+ "response": {
223+ "$ref": "LogSink"
224+ },
225+ "parameterOrder": [
226+ "sinkName"
227+ ],
228+ "description": "Updates or creates a sink.",
229+ "request": {
230+ "$ref": "LogSink"
231+ },
232+ "flatPath": "v2/projects/{projectsId}/sinks/{sinksId}",
233+ "httpMethod": "PUT",
234+ "parameters": {
235+ "sinkName": {
236+ "description": "Required. The resource name of the sink to update, including the parent\nresource and the sink identifier. If the sink does not exist, this method\ncreates the sink. Example: `\"projects/my-project-id/sinks/my-sink-id\"`.",
237+ "required": true,
238+ "pattern": "^projects/[^/]+/sinks/[^/]+$",
239+ "location": "path",
240+ "type": "string"
241+ }
242+ },
243+ "path": "v2/{+sinkName}",
244+ "scopes": [
245+ "https://www.googleapis.com/auth/cloud-platform",
246+ "https://www.googleapis.com/auth/logging.admin"
247+ ]
248+ },
249+ "get": {
250+ "id": "logging.projects.sinks.get",
251+ "response": {
252+ "$ref": "LogSink"
253+ },
254+ "parameterOrder": [
255+ "sinkName"
256+ ],
257+ "description": "Gets a sink.",
258+ "flatPath": "v2/projects/{projectsId}/sinks/{sinksId}",
259+ "httpMethod": "GET",
260+ "parameters": {
261+ "sinkName": {
262+ "description": "Required. The resource name of the sink to return.\nExample: `\"projects/my-project-id/sinks/my-sink-id\"`.",
263+ "required": true,
264+ "pattern": "^projects/[^/]+/sinks/[^/]+$",
265+ "location": "path",
266+ "type": "string"
267+ }
268+ },
269+ "path": "v2/{+sinkName}",
270+ "scopes": [
271+ "https://www.googleapis.com/auth/cloud-platform",
272+ "https://www.googleapis.com/auth/cloud-platform.read-only",
273+ "https://www.googleapis.com/auth/logging.admin",
274+ "https://www.googleapis.com/auth/logging.read"
275+ ]
276+ },
277+ "create": {
278+ "id": "logging.projects.sinks.create",
279+ "response": {
280+ "$ref": "LogSink"
281+ },
282+ "parameterOrder": [
283+ "parent"
284+ ],
285+ "description": "Creates a sink.",
286+ "request": {
287+ "$ref": "LogSink"
288+ },
289+ "flatPath": "v2/projects/{projectsId}/sinks",
290+ "httpMethod": "POST",
291+ "parameters": {
292+ "parent": {
293+ "description": "Required. The resource in which to create the sink.\nExample: `\"projects/my-project-id\"`.\nThe new sink must be provided in the request.",
294+ "required": true,
295+ "pattern": "^projects/[^/]+$",
296+ "location": "path",
297+ "type": "string"
298+ }
299+ },
300+ "path": "v2/{+parent}/sinks",
301+ "scopes": [
302+ "https://www.googleapis.com/auth/cloud-platform",
303+ "https://www.googleapis.com/auth/logging.admin"
304+ ]
305+ },
306+ "list": {
307+ "id": "logging.projects.sinks.list",
308+ "response": {
309+ "$ref": "ListSinksResponse"
310+ },
311+ "parameterOrder": [
312+ "parent"
313+ ],
314+ "description": "Lists sinks.",
315+ "flatPath": "v2/projects/{projectsId}/sinks",
316+ "httpMethod": "GET",
317+ "parameters": {
318+ "pageSize": {
319+ "description": "Optional. The maximum number of results to return from this request.\nNon-positive values are ignored. The presence of `nextPageToken` in the\nresponse indicates that more results might be available.",
320+ "location": "query",
321+ "type": "integer",
322+ "format": "int32"
323+ },
324+ "parent": {
325+ "description": "Required. The cloud resource containing the sinks.\nExample: `\"projects/my-logging-project\"`.",
326+ "required": true,
327+ "pattern": "^projects/[^/]+$",
328+ "location": "path",
329+ "type": "string"
330+ },
331+ "pageToken": {
332+ "description": "Optional. If present, then retrieve the next batch of results from the\npreceding call to this method. `pageToken` must be the value of\n`nextPageToken` from the previous response. The values of other method\nparameters should be identical to those in the previous call.",
333+ "location": "query",
334+ "type": "string"
335+ }
336+ },
337+ "path": "v2/{+parent}/sinks",
338+ "scopes": [
339+ "https://www.googleapis.com/auth/cloud-platform",
340+ "https://www.googleapis.com/auth/cloud-platform.read-only",
341+ "https://www.googleapis.com/auth/logging.admin",
342+ "https://www.googleapis.com/auth/logging.read"
343+ ]
344+ },
345+ "delete": {
346+ "id": "logging.projects.sinks.delete",
347+ "response": {
348+ "$ref": "Empty"
349+ },
350+ "parameterOrder": [
351+ "sinkName"
352+ ],
353+ "description": "Deletes a sink.",
354+ "flatPath": "v2/projects/{projectsId}/sinks/{sinksId}",
355+ "httpMethod": "DELETE",
356+ "parameters": {
357+ "sinkName": {
358+ "description": "Required. The resource name of the sink to delete, including the parent\nresource and the sink identifier. Example:\n`\"projects/my-project-id/sinks/my-sink-id\"`. It is an error if the sink\ndoes not exist.",
359+ "required": true,
360+ "pattern": "^projects/[^/]+/sinks/[^/]+$",
361+ "location": "path",
362+ "type": "string"
363+ }
364+ },
365+ "path": "v2/{+sinkName}",
366+ "scopes": [
367+ "https://www.googleapis.com/auth/cloud-platform",
368+ "https://www.googleapis.com/auth/logging.admin"
369+ ]
370+ }
371+ }
372+ }
373+ }
374+ },
375+ "organizations": {
376+ "resources": {
377+ "logs": {
378+ "methods": {
379+ "delete": {
380+ "id": "logging.organizations.logs.delete",
381+ "response": {
382+ "$ref": "Empty"
383+ },
384+ "parameterOrder": [
385+ "logName"
386+ ],
387+ "description": "Deletes a log and all its log entries.\nThe log will reappear if it receives new entries.",
388+ "flatPath": "v2/organizations/{organizationsId}/logs/{logsId}",
389+ "httpMethod": "DELETE",
390+ "parameters": {
391+ "logName": {
392+ "description": "Required. The resource name of the log to delete. Example:\n`\"projects/my-project/logs/syslog\"`.",
393+ "required": true,
394+ "pattern": "^organizations/[^/]+/logs/[^/]+$",
395+ "location": "path",
396+ "type": "string"
397+ }
398+ },
399+ "path": "v2/{+logName}",
400+ "scopes": [
401+ "https://www.googleapis.com/auth/cloud-platform",
402+ "https://www.googleapis.com/auth/logging.admin"
403+ ]
404+ }
405+ }
406+ },
407+ "sinks": {
408+ "methods": {
409+ "update": {
410+ "id": "logging.organizations.sinks.update",
411+ "response": {
412+ "$ref": "LogSink"
413+ },
414+ "parameterOrder": [
415+ "sinkName"
416+ ],
417+ "description": "Updates or creates a sink.",
418+ "request": {
419+ "$ref": "LogSink"
420+ },
421+ "flatPath": "v2/organizations/{organizationsId}/sinks/{sinksId}",
422+ "httpMethod": "PUT",
423+ "parameters": {
424+ "sinkName": {
425+ "description": "Required. The resource name of the sink to update, including the parent\nresource and the sink identifier. If the sink does not exist, this method\ncreates the sink. Example: `\"projects/my-project-id/sinks/my-sink-id\"`.",
426+ "required": true,
427+ "pattern": "^organizations/[^/]+/sinks/[^/]+$",
428+ "location": "path",
429+ "type": "string"
430+ }
431+ },
432+ "path": "v2/{+sinkName}",
433+ "scopes": [
434+ "https://www.googleapis.com/auth/cloud-platform",
435+ "https://www.googleapis.com/auth/logging.admin"
436+ ]
437+ },
438+ "get": {
439+ "id": "logging.organizations.sinks.get",
440+ "response": {
441+ "$ref": "LogSink"
442+ },
443+ "parameterOrder": [
444+ "sinkName"
445+ ],
446+ "description": "Gets a sink.",
447+ "flatPath": "v2/organizations/{organizationsId}/sinks/{sinksId}",
448+ "httpMethod": "GET",
449+ "parameters": {
450+ "sinkName": {
451+ "description": "Required. The resource name of the sink to return.\nExample: `\"projects/my-project-id/sinks/my-sink-id\"`.",
452+ "required": true,
453+ "pattern": "^organizations/[^/]+/sinks/[^/]+$",
454+ "location": "path",
455+ "type": "string"
456+ }
457+ },
458+ "path": "v2/{+sinkName}",
459+ "scopes": [
460+ "https://www.googleapis.com/auth/cloud-platform",
461+ "https://www.googleapis.com/auth/cloud-platform.read-only",
462+ "https://www.googleapis.com/auth/logging.admin",
463+ "https://www.googleapis.com/auth/logging.read"
464+ ]
465+ },
466+ "create": {
467+ "id": "logging.organizations.sinks.create",
468+ "response": {
469+ "$ref": "LogSink"
470+ },
471+ "parameterOrder": [
472+ "parent"
473+ ],
474+ "description": "Creates a sink.",
475+ "request": {
476+ "$ref": "LogSink"
477+ },
478+ "flatPath": "v2/organizations/{organizationsId}/sinks",
479+ "httpMethod": "POST",
480+ "parameters": {
481+ "parent": {
482+ "description": "Required. The resource in which to create the sink.\nExample: `\"projects/my-project-id\"`.\nThe new sink must be provided in the request.",
483+ "required": true,
484+ "pattern": "^organizations/[^/]+$",
485+ "location": "path",
486+ "type": "string"
487+ }
488+ },
489+ "path": "v2/{+parent}/sinks",
490+ "scopes": [
491+ "https://www.googleapis.com/auth/cloud-platform",
492+ "https://www.googleapis.com/auth/logging.admin"
493+ ]
494+ },
495+ "list": {
496+ "id": "logging.organizations.sinks.list",
497+ "response": {
498+ "$ref": "ListSinksResponse"
499+ },
500+ "parameterOrder": [
501+ "parent"
502+ ],
503+ "description": "Lists sinks.",
504+ "flatPath": "v2/organizations/{organizationsId}/sinks",
505+ "httpMethod": "GET",
506+ "parameters": {
507+ "pageSize": {
508+ "description": "Optional. The maximum number of results to return from this request.\nNon-positive values are ignored. The presence of `nextPageToken` in the\nresponse indicates that more results might be available.",
509+ "location": "query",
510+ "type": "integer",
511+ "format": "int32"
512+ },
513+ "parent": {
514+ "description": "Required. The cloud resource containing the sinks.\nExample: `\"projects/my-logging-project\"`.",
515+ "required": true,
516+ "pattern": "^organizations/[^/]+$",
517+ "location": "path",
518+ "type": "string"
519+ },
520+ "pageToken": {
521+ "description": "Optional. If present, then retrieve the next batch of results from the\npreceding call to this method. `pageToken` must be the value of\n`nextPageToken` from the previous response. The values of other method\nparameters should be identical to those in the previous call.",
522+ "location": "query",
523+ "type": "string"
524+ }
525+ },
526+ "path": "v2/{+parent}/sinks",
527+ "scopes": [
528+ "https://www.googleapis.com/auth/cloud-platform",
529+ "https://www.googleapis.com/auth/cloud-platform.read-only",
530+ "https://www.googleapis.com/auth/logging.admin",
531+ "https://www.googleapis.com/auth/logging.read"
532+ ]
533+ },
534+ "delete": {
535+ "id": "logging.organizations.sinks.delete",
536+ "response": {
537+ "$ref": "Empty"
538+ },
539+ "parameterOrder": [
540+ "sinkName"
541+ ],
542+ "description": "Deletes a sink.",
543+ "flatPath": "v2/organizations/{organizationsId}/sinks/{sinksId}",
544+ "httpMethod": "DELETE",
545+ "parameters": {
546+ "sinkName": {
547+ "description": "Required. The resource name of the sink to delete, including the parent\nresource and the sink identifier. Example:\n`\"projects/my-project-id/sinks/my-sink-id\"`. It is an error if the sink\ndoes not exist.",
548+ "required": true,
549+ "pattern": "^organizations/[^/]+/sinks/[^/]+$",
550+ "location": "path",
551+ "type": "string"
552+ }
553+ },
554+ "path": "v2/{+sinkName}",
555+ "scopes": [
556+ "https://www.googleapis.com/auth/cloud-platform",
557+ "https://www.googleapis.com/auth/logging.admin"
558+ ]
559+ }
560+ }
561+ }
562+ }
563+ },
564+ "entries": {
565+ "methods": {
566+ "write": {
567+ "id": "logging.entries.write",
568+ "response": {
569+ "$ref": "WriteLogEntriesResponse"
570+ },
571+ "parameterOrder": [],
572+ "description": "Writes log entries to Stackdriver Logging. All log entries are\nwritten by this method.",
573+ "request": {
574+ "$ref": "WriteLogEntriesRequest"
575+ },
576+ "flatPath": "v2/entries:write",
577+ "httpMethod": "POST",
578+ "parameters": {},
579+ "path": "v2/entries:write",
580+ "scopes": [
581+ "https://www.googleapis.com/auth/cloud-platform",
582+ "https://www.googleapis.com/auth/logging.admin",
583+ "https://www.googleapis.com/auth/logging.write"
584+ ]
585+ },
586+ "list": {
587+ "id": "logging.entries.list",
588+ "response": {
589+ "$ref": "ListLogEntriesResponse"
590+ },
591+ "parameterOrder": [],
592+ "description": "Lists log entries. Use this method to retrieve log entries from Cloud\nLogging. For ways to export log entries, see\n[Exporting Logs](/logging/docs/export).",
593+ "request": {
594+ "$ref": "ListLogEntriesRequest"
595+ },
596+ "flatPath": "v2/entries:list",
597+ "httpMethod": "POST",
598+ "parameters": {},
599+ "path": "v2/entries:list",
600+ "scopes": [
601+ "https://www.googleapis.com/auth/cloud-platform",
602+ "https://www.googleapis.com/auth/cloud-platform.read-only",
603+ "https://www.googleapis.com/auth/logging.admin",
604+ "https://www.googleapis.com/auth/logging.read"
605+ ]
606+ }
607+ }
608+ },
609+ "monitoredResourceDescriptors": {
610+ "methods": {
611+ "list": {
612+ "id": "logging.monitoredResourceDescriptors.list",
613+ "response": {
614+ "$ref": "ListMonitoredResourceDescriptorsResponse"
615+ },
616+ "parameterOrder": [],
617+ "description": "Lists the monitored resource descriptors used by Stackdriver Logging.",
618+ "flatPath": "v2/monitoredResourceDescriptors",
619+ "httpMethod": "GET",
620+ "parameters": {
621+ "pageSize": {
622+ "description": "Optional. The maximum number of results to return from this request.\nNon-positive values are ignored. The presence of `nextPageToken` in the\nresponse indicates that more results might be available.",
623+ "location": "query",
624+ "type": "integer",
625+ "format": "int32"
626+ },
627+ "pageToken": {
628+ "description": "Optional. If present, then retrieve the next batch of results from the\npreceding call to this method. `pageToken` must be the value of\n`nextPageToken` from the previous response. The values of other method\nparameters should be identical to those in the previous call.",
629+ "location": "query",
630+ "type": "string"
631+ }
632+ },
633+ "path": "v2/monitoredResourceDescriptors",
634+ "scopes": [
635+ "https://www.googleapis.com/auth/cloud-platform",
636+ "https://www.googleapis.com/auth/cloud-platform.read-only",
637+ "https://www.googleapis.com/auth/logging.admin",
638+ "https://www.googleapis.com/auth/logging.read"
639+ ]
640+ }
641+ }
642+ },
643+ "billingAccounts": {
644+ "resources": {
645+ "logs": {
646+ "methods": {
647+ "delete": {
648+ "id": "logging.billingAccounts.logs.delete",
649+ "response": {
650+ "$ref": "Empty"
651+ },
652+ "parameterOrder": [
653+ "logName"
654+ ],
655+ "description": "Deletes a log and all its log entries.\nThe log will reappear if it receives new entries.",
656+ "flatPath": "v2/billingAccounts/{billingAccountsId}/logs/{logsId}",
657+ "httpMethod": "DELETE",
658+ "parameters": {
659+ "logName": {
660+ "description": "Required. The resource name of the log to delete. Example:\n`\"projects/my-project/logs/syslog\"`.",
661+ "required": true,
662+ "pattern": "^billingAccounts/[^/]+/logs/[^/]+$",
663+ "location": "path",
664+ "type": "string"
665+ }
666+ },
667+ "path": "v2/{+logName}",
668+ "scopes": [
669+ "https://www.googleapis.com/auth/cloud-platform",
670+ "https://www.googleapis.com/auth/logging.admin"
671+ ]
672+ }
673+ }
674+ }
675+ }
676+ }
677+ },
678+ "schemas": {
679+ "ListLogEntriesResponse": {
680+ "description": "Result returned from `ListLogEntries`.",
681+ "type": "object",
682+ "properties": {
683+ "entries": {
684+ "description": "A list of log entries.",
685+ "type": "array",
686+ "items": {
687+ "$ref": "LogEntry"
688+ }
689+ },
690+ "nextPageToken": {
691+ "description": "If there might be more results than appear in this response, then\n`nextPageToken` is included. To get the next set of results, call this\nmethod again using the value of `nextPageToken` as `pageToken`.",
692+ "type": "string"
693+ }
694+ },
695+ "id": "ListLogEntriesResponse"
696+ },
697+ "ListSinksResponse": {
698+ "description": "Result returned from `ListSinks`.",
699+ "type": "object",
700+ "properties": {
701+ "nextPageToken": {
702+ "description": "If there might be more results than appear in this response, then\n`nextPageToken` is included. To get the next set of results, call the same\nmethod again using the value of `nextPageToken` as `pageToken`.",
703+ "type": "string"
704+ },
705+ "sinks": {
706+ "description": "A list of sinks.",
707+ "type": "array",
708+ "items": {
709+ "$ref": "LogSink"
710+ }
711+ }
712+ },
713+ "id": "ListSinksResponse"
714+ },
715+ "SourceLocation": {
716+ "description": "Specifies a location in a source code file.",
717+ "type": "object",
718+ "properties": {
719+ "file": {
720+ "description": "Source file name. Depending on the runtime environment, this might be a\nsimple name or a fully-qualified name.",
721+ "type": "string"
722+ },
723+ "functionName": {
724+ "description": "Human-readable name of the function or method being invoked, with optional\ncontext such as the class or package name. This information is used in\ncontexts such as the logs viewer, where a file and line number are less\nmeaningful. The format can vary by language. For example:\n`qual.if.ied.Class.method` (Java), `dir/package.func` (Go), `function`\n(Python).",
725+ "type": "string"
726+ },
727+ "line": {
728+ "description": "Line within the source file.",
729+ "type": "string",
730+ "format": "int64"
731+ }
732+ },
733+ "id": "SourceLocation"
734+ },
735+ "LogSink": {
736+ "description": "Describes a sink used to export log entries outside of Stackdriver Logging.",
737+ "type": "object",
738+ "properties": {
739+ "destination": {
740+ "description": "Required. The export destination. See\n[Exporting Logs With Sinks](/logging/docs/api/tasks/exporting-logs).\nExamples:\n\n \"storage.googleapis.com/my-gcs-bucket\"\n \"bigquery.googleapis.com/projects/my-project-id/datasets/my-dataset\"\n \"pubsub.googleapis.com/projects/my-project/topics/my-topic\"",
741+ "type": "string"
742+ },
743+ "filter": {
744+ "description": "Optional. An [advanced logs filter](/logging/docs/view/advanced_filters).\nOnly log entries matching the filter are exported. The filter\nmust be consistent with the log entry format specified by the\n`outputVersionFormat` parameter, regardless of the format of the\nlog entry that was originally written to Stackdriver Logging.\nExample filter (V2 format):\n\n logName=projects/my-projectid/logs/syslog AND severity\u003e=ERROR",
745+ "type": "string"
746+ },
747+ "endTime": {
748+ "description": "Optional. Time at which this sink expires.",
749+ "type": "string",
750+ "format": "google-datetime"
751+ },
752+ "name": {
753+ "description": "Required. The client-assigned sink identifier, unique within the\nproject. Example: `\"my-syslog-errors-to-pubsub\"`. Sink identifiers are\nlimited to 1000 characters and can include only the following characters:\n`A-Z`, `a-z`, `0-9`, and the special characters `_-.`. The maximum length\nof the name is 100 characters.",
754+ "type": "string"
755+ },
756+ "startTime": {
757+ "description": "Optional. Time range for which this sink is active.\nLogs are exported only if start_time \u003c= entry.timestamp \u003c end_time\nBoth start_time and end_time may be omitted to specify\n(half) infinite ranges. The start_time must be less than the end_time.",
758+ "type": "string",
759+ "format": "google-datetime"
760+ },
761+ "outputVersionFormat": {
762+ "description": "Optional. The log entry version to use for this sink's exported log\nentries. This version does not have to correspond to the version of the\nlog entry that was written to Stackdriver Logging. If omitted, the\nv2 format is used.",
763+ "enum": [
764+ "VERSION_FORMAT_UNSPECIFIED",
765+ "V2",
766+ "V1"
767+ ],
768+ "enumDescriptions": [
769+ "An unspecified version format will default to V2.",
770+ "`LogEntry` version 2 format.",
771+ "`LogEntry` version 1 format."
772+ ],
773+ "type": "string"
774+ },
775+ "writerIdentity": {
776+ "description": "Output only. The IAM identity to which the destination needs to grant write\naccess. This may be a service account or a group.\nExamples (Do not assume these specific values):\n \"serviceAccount:cloud-logs@system.gserviceaccount.com\"\n \"group:cloud-logs@google.com\"\n\n For GCS destinations, the role \"roles/owner\" is required on the bucket\n For Cloud Pubsub destinations, the role \"roles/pubsub.publisher\" is\n required on the topic\n For BigQuery, the role \"roles/editor\" is required on the dataset",
777+ "type": "string"
778+ }
779+ },
780+ "id": "LogSink"
781+ },
782+ "LogMetric": {
783+ "description": "Describes a logs-based metric. The value of the metric is the\nnumber of log entries that match a logs filter.",
784+ "type": "object",
785+ "properties": {
786+ "description": {
787+ "description": "Optional. A description of this metric, which is used in documentation.",
788+ "type": "string"
789+ },
790+ "filter": {
791+ "description": "Required. An [advanced logs filter](/logging/docs/view/advanced_filters).\nExample: `\"resource.type=gae_app AND severity\u003e=ERROR\"`.",
792+ "type": "string"
793+ },
794+ "name": {
795+ "description": "Required. The client-assigned metric identifier. Example:\n`\"severe_errors\"`. Metric identifiers are limited to 100\ncharacters and can include only the following characters: `A-Z`,\n`a-z`, `0-9`, and the special characters `_-.,+!*',()%/`. The\nforward-slash character (`/`) denotes a hierarchy of name pieces,\nand it cannot be the first character of the name. The '%' character\nis used to URL encode unsafe and reserved characters and must be\nfollowed by two hexadecimal digits according to RFC 1738.",
796+ "type": "string"
797+ },
798+ "version": {
799+ "description": "Output only. The API version that created or updated this metric.\nThe version also dictates the syntax of the filter expression. When a value\nfor this field is missing, the default value of V2 should be assumed.",
800+ "enum": [
801+ "V2",
802+ "V1"
803+ ],
804+ "enumDescriptions": [
805+ "Stackdriver Logging API v2.",
806+ "Stackdriver Logging API v1."
807+ ],
808+ "type": "string"
809+ }
810+ },
811+ "id": "LogMetric"
812+ },
813+ "LogEntry": {
814+ "description": "An individual entry in a log.",
815+ "type": "object",
816+ "properties": {
817+ "textPayload": {
818+ "description": "The log entry payload, represented as a Unicode string (UTF-8).",
819+ "type": "string"
820+ },
821+ "httpRequest": {
822+ "description": "Optional. Information about the HTTP request associated with this\nlog entry, if applicable.",
823+ "$ref": "HttpRequest"
824+ },
825+ "jsonPayload": {
826+ "description": "The log entry payload, represented as a structure that\nis expressed as a JSON object.",
827+ "additionalProperties": {
828+ "description": "Properties of the object.",
829+ "type": "any"
830+ },
831+ "type": "object"
832+ },
833+ "labels": {
834+ "description": "Optional. A set of user-defined (key, value) data that provides additional\ninformation about the log entry.",
835+ "additionalProperties": {
836+ "type": "string"
837+ },
838+ "type": "object"
839+ },
840+ "logName": {
841+ "description": "Required. The resource name of the log to which this log entry\nbelongs. The format of the name is\n`\"projects/\u003cproject-id\u003e/logs/\u003clog-id\u003e\"`. Examples:\n`\"projects/my-projectid/logs/syslog\"`,\n`\"projects/my-projectid/logs/library.googleapis.com%2Fbook_log\"`.\n\nThe log ID part of resource name must be less than 512 characters\nlong and can only include the following characters: upper and\nlower case alphanumeric characters: [A-Za-z0-9]; and punctuation\ncharacters: forward-slash, underscore, hyphen, and period.\nForward-slash (`/`) characters in the log ID must be URL-encoded.",
842+ "type": "string"
843+ },
844+ "severity": {
845+ "description": "Optional. The severity of the log entry. The default value is\n`LogSeverity.DEFAULT`.",
846+ "enum": [
847+ "DEFAULT",
848+ "DEBUG",
849+ "INFO",
850+ "NOTICE",
851+ "WARNING",
852+ "ERROR",
853+ "CRITICAL",
854+ "ALERT",
855+ "EMERGENCY"
856+ ],
857+ "enumDescriptions": [
858+ "(0) The log entry has no assigned severity level.",
859+ "(100) Debug or trace information.",
860+ "(200) Routine information, such as ongoing status or performance.",
861+ "(300) Normal but significant events, such as start up, shut down, or\na configuration change.",
862+ "(400) Warning events might cause problems.",
863+ "(500) Error events are likely to cause problems.",
864+ "(600) Critical events cause more severe problems or outages.",
865+ "(700) A person must take an action immediately.",
866+ "(800) One or more systems are unusable."
867+ ],
868+ "type": "string"
869+ },
870+ "resource": {
871+ "description": "Required. The monitored resource associated with this log entry.\nExample: a log entry that reports a database error would be\nassociated with the monitored resource designating the particular\ndatabase that reported the error.",
872+ "$ref": "MonitoredResource"
873+ },
874+ "protoPayload": {
875+ "description": "The log entry payload, represented as a protocol buffer. Some\nGoogle Cloud Platform services use this field for their log\nentry payloads.",
876+ "additionalProperties": {
877+ "description": "Properties of the object. Contains field @type with type URL.",
878+ "type": "any"
879+ },
880+ "type": "object"
881+ },
882+ "timestamp": {
883+ "description": "Optional. The time the event described by the log entry occurred. If\nomitted, Stackdriver Logging will use the time the log entry is received.",
884+ "type": "string",
885+ "format": "google-datetime"
886+ },
887+ "insertId": {
888+ "description": "Optional. A unique ID for the log entry. If you provide this\nfield, the logging service considers other log entries in the\nsame project with the same ID as duplicates which can be removed. If\nomitted, Stackdriver Logging will generate a unique ID for this\nlog entry.",
889+ "type": "string"
890+ },
891+ "operation": {
892+ "description": "Optional. Information about an operation associated with the log entry, if\napplicable.",
893+ "$ref": "LogEntryOperation"
894+ }
895+ },
896+ "id": "LogEntry"
897+ },
898+ "LogLine": {
899+ "description": "Application log line emitted while processing a request.",
900+ "type": "object",
901+ "properties": {
902+ "time": {
903+ "description": "Approximate time when this log entry was made.",
904+ "type": "string",
905+ "format": "google-datetime"
906+ },
907+ "severity": {
908+ "description": "Severity of this log entry.",
909+ "enum": [
910+ "DEFAULT",
911+ "DEBUG",
912+ "INFO",
913+ "NOTICE",
914+ "WARNING",
915+ "ERROR",
916+ "CRITICAL",
917+ "ALERT",
918+ "EMERGENCY"
919+ ],
920+ "enumDescriptions": [
921+ "(0) The log entry has no assigned severity level.",
922+ "(100) Debug or trace information.",
923+ "(200) Routine information, such as ongoing status or performance.",
924+ "(300) Normal but significant events, such as start up, shut down, or\na configuration change.",
925+ "(400) Warning events might cause problems.",
926+ "(500) Error events are likely to cause problems.",
927+ "(600) Critical events cause more severe problems or outages.",
928+ "(700) A person must take an action immediately.",
929+ "(800) One or more systems are unusable."
930+ ],
931+ "type": "string"
932+ },
933+ "sourceLocation": {
934+ "description": "Where in the source code this log message was written.",
935+ "$ref": "SourceLocation"
936+ },
937+ "logMessage": {
938+ "description": "App-provided log message.",
939+ "type": "string"
940+ }
941+ },
942+ "id": "LogLine"
943+ },
944+ "SourceReference": {
945+ "description": "A reference to a particular snapshot of the source tree used to build and\ndeploy an application.",
946+ "type": "object",
947+ "properties": {
948+ "repository": {
949+ "description": "Optional. A URI string identifying the repository.\nExample: \"https://github.com/GoogleCloudPlatform/kubernetes.git\"",
950+ "type": "string"
951+ },
952+ "revisionId": {
953+ "description": "The canonical and persistent identifier of the deployed revision.\nExample (git): \"0035781c50ec7aa23385dc841529ce8a4b70db1b\"",
954+ "type": "string"
955+ }
956+ },
957+ "id": "SourceReference"
958+ },
959+ "MonitoredResource": {
960+ "description": "An object representing a resource that can be used for monitoring, logging,\nbilling, or other purposes. Examples include virtual machine instances,\ndatabases, and storage devices such as disks. The `type` field identifies a\nMonitoredResourceDescriptor object that describes the resource's\nschema. Information in the `labels` field identifies the actual resource and\nits attributes according to the schema. For example, a particular Compute\nEngine VM instance could be represented by the following object, because the\nMonitoredResourceDescriptor for `\"gce_instance\"` has labels\n`\"instance_id\"` and `\"zone\"`:\n\n { \"type\": \"gce_instance\",\n \"labels\": { \"instance_id\": \"12345678901234\",\n \"zone\": \"us-central1-a\" }}",
961+ "type": "object",
962+ "properties": {
963+ "labels": {
964+ "description": "Required. Values for all of the labels listed in the associated monitored\nresource descriptor. For example, Cloud SQL databases use the labels\n`\"database_id\"` and `\"zone\"`.",
965+ "additionalProperties": {
966+ "type": "string"
967+ },
968+ "type": "object"
969+ },
970+ "type": {
971+ "description": "Required. The monitored resource type. This field must match\nthe `type` field of a MonitoredResourceDescriptor object. For\nexample, the type of a Cloud SQL database is `\"cloudsql_database\"`.",
972+ "type": "string"
973+ }
974+ },
975+ "id": "MonitoredResource"
976+ },
977+ "WriteLogEntriesRequest": {
978+ "description": "The parameters to WriteLogEntries.",
979+ "type": "object",
980+ "properties": {
981+ "labels": {
982+ "description": "Optional. Default labels that are added to the `labels` field of all log\nentries in `entries`. If a log entry already has a label with the same key\nas a label in this parameter, then the log entry's label is not changed.\nSee LogEntry.",
983+ "additionalProperties": {
984+ "type": "string"
985+ },
986+ "type": "object"
987+ },
988+ "entries": {
989+ "description": "Required. The log entries to write. Values supplied for the fields\n`log_name`, `resource`, and `labels` in this `entries.write` request are\nadded to those log entries that do not provide their own values for the\nfields.\n\nTo improve throughput and to avoid exceeding the\n[quota limit](/logging/quota-policy) for calls to `entries.write`,\nyou should write multiple log entries at once rather than\ncalling this method for each individual log entry.",
990+ "type": "array",
991+ "items": {
992+ "$ref": "LogEntry"
993+ }
994+ },
995+ "logName": {
996+ "description": "Optional. A default log resource name that is assigned to all log entries\nin `entries` that do not specify a value for `log_name`. Example:\n`\"projects/my-project/logs/syslog\"`. See\nLogEntry.",
997+ "type": "string"
998+ },
999+ "partialSuccess": {
1000+ "description": "Optional. Whether valid entries should be written even if some other\nentries fail due to INVALID_ARGUMENT or PERMISSION_DENIED errors. If any\nentry is not written, the response status will be the error associated\nwith one of the failed entries and include error details in the form of\nWriteLogEntriesPartialErrors.",
1001+ "type": "boolean"
1002+ },
1003+ "resource": {
1004+ "description": "Optional. A default monitored resource object that is assigned to all log\nentries in `entries` that do not specify a value for `resource`. Example:\n\n { \"type\": \"gce_instance\",\n \"labels\": {\n \"zone\": \"us-central1-a\", \"instance_id\": \"00000000000000000000\" }}\n\nSee LogEntry.",
1005+ "$ref": "MonitoredResource"
1006+ }
1007+ },
1008+ "id": "WriteLogEntriesRequest"
1009+ },
1010+ "LabelDescriptor": {
1011+ "description": "A description of a label.",
1012+ "type": "object",
1013+ "properties": {
1014+ "description": {
1015+ "description": "A human-readable description for the label.",
1016+ "type": "string"
1017+ },
1018+ "valueType": {
1019+ "description": "The type of data that can be assigned to the label.",
1020+ "enum": [
1021+ "STRING",
1022+ "BOOL",
1023+ "INT64"
1024+ ],
1025+ "enumDescriptions": [
1026+ "A variable-length string. This is the default.",
1027+ "Boolean; true or false.",
1028+ "A 64-bit signed integer."
1029+ ],
1030+ "type": "string"
1031+ },
1032+ "key": {
1033+ "description": "The label key.",
1034+ "type": "string"
1035+ }
1036+ },
1037+ "id": "LabelDescriptor"
1038+ },
1039+ "ListLogMetricsResponse": {
1040+ "description": "Result returned from ListLogMetrics.",
1041+ "type": "object",
1042+ "properties": {
1043+ "metrics": {
1044+ "description": "A list of logs-based metrics.",
1045+ "type": "array",
1046+ "items": {
1047+ "$ref": "LogMetric"
1048+ }
1049+ },
1050+ "nextPageToken": {
1051+ "description": "If there might be more results than appear in this response, then\n`nextPageToken` is included. To get the next set of results, call this\nmethod again using the value of `nextPageToken` as `pageToken`.",
1052+ "type": "string"
1053+ }
1054+ },
1055+ "id": "ListLogMetricsResponse"
1056+ },
1057+ "MonitoredResourceDescriptor": {
1058+ "description": "An object that describes the schema of a MonitoredResource object using a\ntype name and a set of labels. For example, the monitored resource\ndescriptor for Google Compute Engine VM instances has a type of\n`\"gce_instance\"` and specifies the use of the labels `\"instance_id\"` and\n`\"zone\"` to identify particular VM instances.\n\nDifferent APIs can support different monitored resource types. APIs generally\nprovide a `list` method that returns the monitored resource descriptors used\nby the API.",
1059+ "type": "object",
1060+ "properties": {
1061+ "displayName": {
1062+ "description": "Optional. A concise name for the monitored resource type that might be\ndisplayed in user interfaces. It should be a Title Cased Noun Phrase,\nwithout any article or other determiners. For example,\n`\"Google Cloud SQL Database\"`.",
1063+ "type": "string"
1064+ },
1065+ "description": {
1066+ "description": "Optional. A detailed description of the monitored resource type that might\nbe used in documentation.",
1067+ "type": "string"
1068+ },
1069+ "labels": {
1070+ "description": "Required. A set of labels used to describe instances of this monitored\nresource type. For example, an individual Google Cloud SQL database is\nidentified by values for the labels `\"database_id\"` and `\"zone\"`.",
1071+ "type": "array",
1072+ "items": {
1073+ "$ref": "LabelDescriptor"
1074+ }
1075+ },
1076+ "type": {
1077+ "description": "Required. The monitored resource type. For example, the type\n`\"cloudsql_database\"` represents databases in Google Cloud SQL.\nThe maximum length of this value is 256 characters.",
1078+ "type": "string"
1079+ },
1080+ "name": {
1081+ "description": "Optional. The resource name of the monitored resource descriptor:\n`\"projects/{project_id}/monitoredResourceDescriptors/{type}\"` where\n{type} is the value of the `type` field in this object and\n{project_id} is a project ID that provides API-specific context for\naccessing the type. APIs that do not use project information can use the\nresource name format `\"monitoredResourceDescriptors/{type}\"`.",
1082+ "type": "string"
1083+ }
1084+ },
1085+ "id": "MonitoredResourceDescriptor"
1086+ },
1087+ "ListMonitoredResourceDescriptorsResponse": {
1088+ "description": "Result returned from ListMonitoredResourceDescriptors.",
1089+ "type": "object",
1090+ "properties": {
1091+ "nextPageToken": {
1092+ "description": "If there might be more results than appear in this response, then\n`nextPageToken` is included. To get the next set of results, call this\nmethod again using the value of `nextPageToken` as `pageToken`.",
1093+ "type": "string"
1094+ },
1095+ "resourceDescriptors": {
1096+ "description": "A list of resource descriptors.",
1097+ "type": "array",
1098+ "items": {
1099+ "$ref": "MonitoredResourceDescriptor"
1100+ }
1101+ }
1102+ },
1103+ "id": "ListMonitoredResourceDescriptorsResponse"
1104+ },
1105+ "LogEntryOperation": {
1106+ "description": "Additional information about a potentially long-running operation with which\na log entry is associated.",
1107+ "type": "object",
1108+ "properties": {
1109+ "producer": {
1110+ "description": "Optional. An arbitrary producer identifier. The combination of\n`id` and `producer` must be globally unique. Examples for `producer`:\n`\"MyDivision.MyBigCompany.com\"`, `\"github.com/MyProject/MyApplication\"`.",
1111+ "type": "string"
1112+ },
1113+ "last": {
1114+ "description": "Optional. Set this to True if this is the last log entry in the operation.",
1115+ "type": "boolean"
1116+ },
1117+ "first": {
1118+ "description": "Optional. Set this to True if this is the first log entry in the operation.",
1119+ "type": "boolean"
1120+ },
1121+ "id": {
1122+ "description": "Optional. An arbitrary operation identifier. Log entries with the\nsame identifier are assumed to be part of the same operation.",
1123+ "type": "string"
1124+ }
1125+ },
1126+ "id": "LogEntryOperation"
1127+ },
1128+ "Empty": {
1129+ "description": "A generic empty message that you can re-use to avoid defining duplicated\nempty messages in your APIs. A typical example is to use it as the request\nor the response type of an API method. For instance:\n\n service Foo {\n rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);\n }\n\nThe JSON representation for `Empty` is empty JSON object `{}`.",
1130+ "type": "object",
1131+ "properties": {},
1132+ "id": "Empty"
1133+ },
1134+ "HttpRequest": {
1135+ "description": "A common proto for logging HTTP requests. Only contains semantics\ndefined by the HTTP specification. Product-specific logging\ninformation MUST be defined in a separate message.",
1136+ "type": "object",
1137+ "properties": {
1138+ "cacheLookup": {
1139+ "description": "Whether or not a cache lookup was attempted.",
1140+ "type": "boolean"
1141+ },
1142+ "responseSize": {
1143+ "description": "The size of the HTTP response message sent back to the client, in bytes,\nincluding the response headers and the response body.",
1144+ "type": "string",
1145+ "format": "int64"
1146+ },
1147+ "status": {
1148+ "description": "The response code indicating the status of response.\nExamples: 200, 404.",
1149+ "type": "integer",
1150+ "format": "int32"
1151+ },
1152+ "cacheValidatedWithOriginServer": {
1153+ "description": "Whether or not the response was validated with the origin server before\nbeing served from cache. This field is only meaningful if `cache_hit` is\nTrue.",
1154+ "type": "boolean"
1155+ },
1156+ "referer": {
1157+ "description": "The referer URL of the request, as defined in\n[HTTP/1.1 Header Field Definitions](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html).",
1158+ "type": "string"
1159+ },
1160+ "cacheHit": {
1161+ "description": "Whether or not an entity was served from cache\n(with or without validation).",
1162+ "type": "boolean"
1163+ },
1164+ "requestUrl": {
1165+ "description": "The scheme (http, https), the host name, the path and the query\nportion of the URL that was requested.\nExample: `\"http://example.com/some/info?color=red\"`.",
1166+ "type": "string"
1167+ },
1168+ "latency": {
1169+ "description": "The request processing latency on the server, from the time the request was\nreceived until the response was sent.",
1170+ "type": "string",
1171+ "format": "google-duration"
1172+ },
1173+ "cacheFillBytes": {
1174+ "description": "The number of HTTP response bytes inserted into cache. Set only when a\ncache fill was attempted.",
1175+ "type": "string",
1176+ "format": "int64"
1177+ },
1178+ "requestMethod": {
1179+ "description": "The request method. Examples: `\"GET\"`, `\"HEAD\"`, `\"PUT\"`, `\"POST\"`.",
1180+ "type": "string"
1181+ },
1182+ "remoteIp": {
1183+ "description": "The IP address (IPv4 or IPv6) of the client that issued the HTTP\nrequest. Examples: `\"192.168.1.1\"`, `\"FE80::0202:B3FF:FE1E:8329\"`.",
1184+ "type": "string"
1185+ },
1186+ "serverIp": {
1187+ "description": "The IP address (IPv4 or IPv6) of the origin server that the request was\nsent to.",
1188+ "type": "string"
1189+ },
1190+ "userAgent": {
1191+ "description": "The user agent sent by the client. Example:\n`\"Mozilla/4.0 (compatible; MSIE 6.0; Windows 98; Q312461; .NET CLR 1.0.3705)\"`.",
1192+ "type": "string"
1193+ },
1194+ "requestSize": {
1195+ "description": "The size of the HTTP request message in bytes, including the request\nheaders and the request body.",
1196+ "type": "string",
1197+ "format": "int64"
1198+ }
1199+ },
1200+ "id": "HttpRequest"
1201+ },
1202+ "RequestLog": {
1203+ "description": "Complete log information about a single HTTP request to an App Engine\napplication.",
1204+ "type": "object",
1205+ "properties": {
1206+ "responseSize": {
1207+ "description": "Size in bytes sent back to client by request.",
1208+ "type": "string",
1209+ "format": "int64"
1210+ },
1211+ "requestId": {
1212+ "description": "Globally unique identifier for a request, which is based on the request\nstart time. Request IDs for requests which started later will compare\ngreater as strings than those for requests which started earlier.",
1213+ "type": "string"
1214+ },
1215+ "first": {
1216+ "description": "Whether this is the first RequestLog entry for this request. If an active\nrequest has several RequestLog entries written to Cloud Logging, this field\nwill be set for one of them.",
1217+ "type": "boolean"
1218+ },
1219+ "method": {
1220+ "description": "Request method. Example: `\"GET\"`, `\"HEAD\"`, `\"PUT\"`, `\"POST\"`, `\"DELETE\"`.",
1221+ "type": "string"
1222+ },
1223+ "versionId": {
1224+ "description": "Version of the application that handled this request.",
1225+ "type": "string"
1226+ },
1227+ "status": {
1228+ "description": "HTTP response status code. Example: 200, 404.",
1229+ "type": "integer",
1230+ "format": "int32"
1231+ },
1232+ "wasLoadingRequest": {
1233+ "description": "Whether this was a loading request for the instance.",
1234+ "type": "boolean"
1235+ },
1236+ "ip": {
1237+ "description": "Origin IP address.",
1238+ "type": "string"
1239+ },
1240+ "nickname": {
1241+ "description": "The logged-in user who made the request.\n\nMost likely, this is the part of the user's email before the `@` sign. The\nfield value is the same for different requests from the same user, but\ndifferent users can have similar names. This information is also\navailable to the application via the App Engine Users API.\n\nThis field will be populated starting with App Engine 1.9.21.",
1242+ "type": "string"
1243+ },
1244+ "taskQueueName": {
1245+ "description": "Queue name of the request, in the case of an offline request.",
1246+ "type": "string"
1247+ },
1248+ "pendingTime": {
1249+ "description": "Time this request spent in the pending request queue.",
1250+ "type": "string",
1251+ "format": "google-duration"
1252+ },
1253+ "instanceIndex": {
1254+ "description": "If the instance processing this request belongs to a manually scaled\nmodule, then this is the 0-based index of the instance. Otherwise, this\nvalue is -1.",
1255+ "type": "integer",
1256+ "format": "int32"
1257+ },
1258+ "sourceReference": {
1259+ "description": "Source code for the application that handled this request. There can be\nmore than one source reference per deployed application if source code is\ndistributed among multiple repositories.",
1260+ "type": "array",
1261+ "items": {
1262+ "$ref": "SourceReference"
1263+ }
1264+ },
1265+ "moduleId": {
1266+ "description": "Module of the application that handled this request.",
1267+ "type": "string"
1268+ },
1269+ "host": {
1270+ "description": "Internet host and port number of the resource being requested.",
1271+ "type": "string"
1272+ },
1273+ "latency": {
1274+ "description": "Latency of the request.",
1275+ "type": "string",
1276+ "format": "google-duration"
1277+ },
1278+ "urlMapEntry": {
1279+ "description": "File or class that handled the request.",
1280+ "type": "string"
1281+ },
1282+ "endTime": {
1283+ "description": "Time when the request finished.",
1284+ "type": "string",
1285+ "format": "google-datetime"
1286+ },
1287+ "line": {
1288+ "description": "A list of log lines emitted by the application while serving this request.",
1289+ "type": "array",
1290+ "items": {
1291+ "$ref": "LogLine"
1292+ }
1293+ },
1294+ "megaCycles": {
1295+ "description": "Number of CPU megacycles used to process request.",
1296+ "type": "string",
1297+ "format": "int64"
1298+ },
1299+ "appId": {
1300+ "description": "Application that handled this request.",
1301+ "type": "string"
1302+ },
1303+ "traceId": {
1304+ "description": "Cloud Trace identifier for this request.",
1305+ "type": "string"
1306+ },
1307+ "taskName": {
1308+ "description": "Task name of the request, in the case of an offline request.",
1309+ "type": "string"
1310+ },
1311+ "cost": {
1312+ "description": "An indication of the relative cost of serving this request.",
1313+ "type": "number",
1314+ "format": "double"
1315+ },
1316+ "instanceId": {
1317+ "description": "An identifier for the instance that handled the request.",
1318+ "type": "string"
1319+ },
1320+ "startTime": {
1321+ "description": "Time when the request started.",
1322+ "type": "string",
1323+ "format": "google-datetime"
1324+ },
1325+ "appEngineRelease": {
1326+ "description": "App Engine release version.",
1327+ "type": "string"
1328+ },
1329+ "resource": {
1330+ "description": "Contains the path and query portion of the URL that was requested. For\nexample, if the URL was \"http://example.com/app?name=val\", the resource\nwould be \"/app?name=val\". The fragment identifier, which is identified by\nthe `#` character, is not included.",
1331+ "type": "string"
1332+ },
1333+ "httpVersion": {
1334+ "description": "HTTP version of request. Example: `\"HTTP/1.1\"`.",
1335+ "type": "string"
1336+ },
1337+ "referrer": {
1338+ "description": "Referrer URL of request.",
1339+ "type": "string"
1340+ },
1341+ "userAgent": {
1342+ "description": "User agent that made the request.",
1343+ "type": "string"
1344+ },
1345+ "finished": {
1346+ "description": "Whether this request is finished or active.",
1347+ "type": "boolean"
1348+ }
1349+ },
1350+ "id": "RequestLog"
1351+ },
1352+ "WriteLogEntriesResponse": {
1353+ "description": "Result returned from WriteLogEntries.\nempty",
1354+ "type": "object",
1355+ "properties": {},
1356+ "id": "WriteLogEntriesResponse"
1357+ },
1358+ "ListLogEntriesRequest": {
1359+ "description": "The parameters to `ListLogEntries`.",
1360+ "type": "object",
1361+ "properties": {
1362+ "filter": {
1363+ "description": "Optional. A filter that chooses which log entries to return. See [Advanced\nLogs Filters](/logging/docs/view/advanced_filters). Only log entries that\nmatch the filter are returned. An empty filter matches all log entries.",
1364+ "type": "string"
1365+ },
1366+ "projectIds": {
1367+ "description": "Deprecated. One or more project identifiers or project numbers from which\nto retrieve log entries. Examples: `\"my-project-1A\"`, `\"1234567890\"`. If\npresent, these project identifiers are converted to resource format and\nadded to the list of resources in `resourceNames`. Callers should use\n`resourceNames` rather than this parameter.",
1368+ "type": "array",
1369+ "items": {
1370+ "type": "string"
1371+ }
1372+ },
1373+ "resourceNames": {
1374+ "description": "Required. One or more cloud resources from which to retrieve log entries.\nExample: `\"projects/my-project-1A\"`, `\"projects/1234567890\"`. Projects\nlisted in `projectIds` are added to this list.",
1375+ "type": "array",
1376+ "items": {
1377+ "type": "string"
1378+ }
1379+ },
1380+ "pageSize": {
1381+ "description": "Optional. The maximum number of results to return from this request.\nNon-positive values are ignored. The presence of `nextPageToken` in the\nresponse indicates that more results might be available.",
1382+ "type": "integer",
1383+ "format": "int32"
1384+ },
1385+ "orderBy": {
1386+ "description": "Optional. How the results should be sorted. Presently, the only permitted\nvalues are `\"timestamp asc\"` (default) and `\"timestamp desc\"`. The first\noption returns entries in order of increasing values of\n`LogEntry.timestamp` (oldest first), and the second option returns entries\nin order of decreasing timestamps (newest first). Entries with equal\ntimestamps are returned in order of `LogEntry.insertId`.",
1387+ "type": "string"
1388+ },
1389+ "pageToken": {
1390+ "description": "Optional. If present, then retrieve the next batch of results from the\npreceding call to this method. `pageToken` must be the value of\n`nextPageToken` from the previous response. The values of other method\nparameters should be identical to those in the previous call.",
1391+ "type": "string"
1392+ }
1393+ },
1394+ "id": "ListLogEntriesRequest"
1395+ }
1396+ },
1397+ "revision": "20161017",
1398+ "basePath": "",
1399+ "icons": {
1400+ "x32": "http://www.google.com/images/icons/product/search-32.gif",
1401+ "x16": "http://www.google.com/images/icons/product/search-16.gif"
1402+ },
1403+ "version_module": "True",
1404+ "canonicalName": "Logging",
1405+ "discoveryVersion": "v1",
1406+ "baseUrl": "https://logging.googleapis.com/",
1407+ "name": "logging",
1408+ "parameters": {
1409+ "access_token": {
1410+ "description": "OAuth access token.",
1411+ "type": "string",
1412+ "location": "query"
1413+ },
1414+ "prettyPrint": {
1415+ "description": "Returns response with indentations and line breaks.",
1416+ "default": "true",
1417+ "type": "boolean",
1418+ "location": "query"
1419+ },
1420+ "key": {
1421+ "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.",
1422+ "type": "string",
1423+ "location": "query"
1424+ },
1425+ "quotaUser": {
1426+ "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.",
1427+ "type": "string",
1428+ "location": "query"
1429+ },
1430+ "pp": {
1431+ "description": "Pretty-print response.",
1432+ "default": "true",
1433+ "type": "boolean",
1434+ "location": "query"
1435+ },
1436+ "fields": {
1437+ "description": "Selector specifying which fields to include in a partial response.",
1438+ "type": "string",
1439+ "location": "query"
1440+ },
1441+ "alt": {
1442+ "description": "Data format for response.",
1443+ "location": "query",
1444+ "enum": [
1445+ "json",
1446+ "media",
1447+ "proto"
1448+ ],
1449+ "default": "json",
1450+ "enumDescriptions": [
1451+ "Responses with Content-Type of application/json",
1452+ "Media download with context-dependent Content-Type",
1453+ "Responses with Content-Type of application/x-protobuf"
1454+ ],
1455+ "type": "string"
1456+ },
1457+ "$.xgafv": {
1458+ "description": "V1 error format.",
1459+ "enum": [
1460+ "1",
1461+ "2"
1462+ ],
1463+ "enumDescriptions": [
1464+ "v1 error format",
1465+ "v2 error format"
1466+ ],
1467+ "type": "string",
1468+ "location": "query"
1469+ },
1470+ "callback": {
1471+ "description": "JSONP",
1472+ "type": "string",
1473+ "location": "query"
1474+ },
1475+ "oauth_token": {
1476+ "description": "OAuth 2.0 token for the current user.",
1477+ "type": "string",
1478+ "location": "query"
1479+ },
1480+ "uploadType": {
1481+ "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
1482+ "type": "string",
1483+ "location": "query"
1484+ },
1485+ "bearer_token": {
1486+ "description": "OAuth bearer token.",
1487+ "type": "string",
1488+ "location": "query"
1489+ },
1490+ "upload_protocol": {
1491+ "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
1492+ "type": "string",
1493+ "location": "query"
1494+ }
1495+ },
1496+ "documentationLink": "https://cloud.google.com/logging/docs/",
1497+ "ownerDomain": "google.com",
1498+ "batchPath": "batch",
1499+ "servicePath": "",
1500+ "ownerName": "Google",
1501+ "version": "v2",
1502+ "rootUrl": "https://logging.googleapis.com/",
1503+ "kind": "discovery#restDescription"
1504+}
gen/model/logging/v2beta1/logging-api.json+1299−1159
@@ -1,1209 +1,1349 @@
11{
2− "kind": "discovery#restDescription",
3− "etag": "\"jQLIOHBVnDZie4rQHGH1WJF-INE/AGY2FGWaHRZwgyAazem2sSX20dM\"",
4− "discoveryVersion": "v1",
5− "id": "logging:v2beta1",
6− "name": "logging",
7− "version": "v2beta1",
8− "revision": "20160322",
9− "title": "Google Cloud Logging API",
10− "description": "Writes log entries and manages your logs, log sinks, and logs-based metrics.",
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/logging/docs/",
18− "protocol": "rest",
19− "baseUrl": "https://logging.googleapis.com/",
20− "basePath": "",
21− "rootUrl": "https://logging.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− "https://www.googleapis.com/auth/cloud-platform.read-only": {
111− "description": "View your data across Google Cloud Platform services"
112− },
113− "https://www.googleapis.com/auth/logging.admin": {
114− "description": "Administrate log data for your projects"
115− },
116− "https://www.googleapis.com/auth/logging.read": {
117− "description": "View log data for your projects"
118− },
119− "https://www.googleapis.com/auth/logging.write": {
120− "description": "Submit log data for your projects"
121− }
122− }
123− }
124− },
125− "schemas": {
126− "Empty": {
127− "id": "Empty",
128− "type": "object",
129− "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for `Empty` is empty JSON object `{}`."
130− },
131− "WriteLogEntriesRequest": {
132− "id": "WriteLogEntriesRequest",
133− "type": "object",
134− "description": "The parameters to WriteLogEntries.",
135− "properties": {
136− "logName": {
137− "type": "string",
138− "description": "Optional. A default log resource name for those log entries in `entries` that do not specify their own `logName`. Example: `\"projects/my-project/logs/syslog\"`. See LogEntry."
139− },
140− "resource": {
141− "$ref": "MonitoredResource",
142− "description": "Optional. A default monitored resource for those log entries in `entries` that do not specify their own `resource`."
143− },
144− "labels": {
145− "type": "object",
146− "description": "Optional. User-defined `key:value` items that are added to the `labels` field of each log entry in `entries`, except when a log entry specifies its own `key:value` item with the same key. Example: `{ \"size\": \"large\", \"color\":\"red\" }`",
147− "additionalProperties": {
148− "type": "string"
149− }
150− },
151− "entries": {
152− "type": "array",
153− "description": "Required. The log entries to write. The log entries must have values for all required fields.",
154− "items": {
155− "$ref": "LogEntry"
156− }
157− },
158− "partialSuccess": {
159− "type": "boolean",
160− "description": "Optional. Whether valid entries should be written even if some other entries fail due to INVALID_ARGUMENT or PERMISSION_DENIED errors. If any entry is not written, the response status will be the error associated with one of the failed entries and include error details in the form of WriteLogEntriesPartialErrors."
161− }
162− }
163− },
164− "MonitoredResource": {
165− "id": "MonitoredResource",
166− "type": "object",
167− "description": "An object representing a resource that can be used for monitoring, logging, billing, or other purposes. Examples include virtual machine instances, databases, and storage devices such as disks. The `type` field identifies a MonitoredResourceDescriptor object that describes the resource's schema. Information in the `labels` field identifies the actual resource and its attributes according to the schema. For example, a particular Compute Engine VM instance could be represented by the following object, because the MonitoredResourceDescriptor for `\"gce_instance\"` has labels `\"instance_id\"` and `\"zone\"`: { \"type\": \"gce_instance\", \"labels\": { \"instance_id\": \"my-instance\", \"zone\": \"us-central1-a\" }}",
168− "properties": {
169− "type": {
170− "type": "string",
171− "description": "Required. The monitored resource type. This field must match the `type` field of a MonitoredResourceDescriptor object. For example, the type of a Cloud SQL database is `\"cloudsql_database\"`."
172− },
173− "labels": {
174− "type": "object",
175− "description": "Required. Values for all of the labels listed in the associated monitored resource descriptor. For example, Cloud SQL databases use the labels `\"database_id\"` and `\"zone\"`.",
176− "additionalProperties": {
177− "type": "string"
178− }
179− }
180− }
181− },
182− "LogEntry": {
183− "id": "LogEntry",
184− "type": "object",
185− "description": "An individual entry in a log.",
186− "properties": {
187− "logName": {
188− "type": "string",
189− "description": "Required. The resource name of the log to which this log entry belongs. The format of the name is `\"projects/\n/logs/\"`. Examples: `\"projects/my-projectid/logs/syslog\"`, `\"projects/1234567890/logs/library.googleapis.com%2Fbook_log\"`. The log ID part of resource name must be less than 512 characters long and can only include the following characters: upper and lower case alphanumeric characters: [A-Za-z0-9]; and punctuation characters: forward-slash, underscore, hyphen, and period. Forward-slash (`/`) characters in the log ID must be URL-encoded."
190− },
191− "resource": {
192− "$ref": "MonitoredResource",
193− "description": "Required. The monitored resource associated with this log entry. Example: a log entry that reports a database error would be associated with the monitored resource designating the particular database that reported the error."
194− },
195− "protoPayload": {
196− "type": "object",
197− "description": "The log entry payload, represented as a protocol buffer. You can only use `protoPayload` values that belong to a set of approved types.",
198− "additionalProperties": {
199− "type": "any",
200− "description": "Properties of the object. Contains field @ype with type URL."
201− }
202− },
203− "textPayload": {
204− "type": "string",
205− "description": "The log entry payload, represented as a Unicode string (UTF-8)."
206− },
207− "jsonPayload": {
208− "type": "object",
209− "description": "The log entry payload, represented as a structure that is expressed as a JSON object.",
210− "additionalProperties": {
211− "type": "any",
212− "description": "Properties of the object."
213− }
214− },
215− "timestamp": {
216− "type": "string",
217− "description": "Optional. The time the event described by the log entry occurred. If omitted, Cloud Logging will use the time the log entry is written."
218− },
219− "severity": {
220− "type": "string",
221− "description": "Optional. The severity of the log entry. The default value is `LogSeverity.DEFAULT`.",
222− "enum": [
223− "DEFAULT",
224− "DEBUG",
225− "INFO",
226− "NOTICE",
227− "WARNING",
228− "ERROR",
229− "CRITICAL",
230− "ALERT",
231− "EMERGENCY"
232− ]
233− },
234− "insertId": {
235− "type": "string",
236− "description": "Optional. A unique ID for the log entry. If you provide this field, the logging service considers other log entries in the same log with the same ID as duplicates which can be removed. If omitted, Cloud Logging will generate a unique ID for this log entry."
237− },
238− "httpRequest": {
239− "$ref": "HttpRequest",
240− "description": "Optional. Information about the HTTP request associated with this log entry, if applicable."
241− },
242− "labels": {
243− "type": "object",
244− "description": "Optional. A set of user-defined (key, value) data that provides additional information about the log entry.",
245− "additionalProperties": {
246− "type": "string"
247− }
248− },
249− "operation": {
250− "$ref": "LogEntryOperation",
251− "description": "Optional. Information about an operation associated with the log entry, if applicable."
252− }
253− }
254− },
255− "HttpRequest": {
256− "id": "HttpRequest",
257− "type": "object",
258− "description": "A common proto for logging HTTP requests.",
259− "properties": {
260− "requestMethod": {
261− "type": "string",
262− "description": "The request method. Examples: `\"GET\"`, `\"HEAD\"`, `\"PUT\"`, `\"POST\"`."
263− },
264− "requestUrl": {
265− "type": "string",
266− "description": "The scheme (http, https), the host name, the path and the query portion of the URL that was requested. Example: `\"http://example.com/some/info?color=red\"`."
267− },
268− "requestSize": {
269− "type": "string",
270− "description": "The size of the HTTP request message in bytes, including the request headers and the request body.",
271− "format": "int64"
272− },
273− "status": {
274− "type": "integer",
275− "description": "The response code indicating the status of response. Examples: 200, 404.",
276− "format": "int32"
277− },
278− "responseSize": {
279− "type": "string",
280− "description": "The size of the HTTP response message sent back to the client, in bytes, including the response headers and the response body.",
281− "format": "int64"
282− },
283− "userAgent": {
284− "type": "string",
285− "description": "The user agent sent by the client. Example: `\"Mozilla/4.0 (compatible; MSIE 6.0; Windows 98; Q312461; .NET CLR 1.0.3705)\"`."
286− },
287− "remoteIp": {
288− "type": "string",
289− "description": "The IP address (IPv4 or IPv6) of the client that issued the HTTP request. Examples: `\"192.168.1.1\"`, `\"FE80::0202:B3FF:FE1E:8329\"`."
290− },
291− "referer": {
292− "type": "string",
293− "description": "The referer URL of the request, as defined in [HTTP/1.1 Header Field Definitions](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html)."
294− },
295− "cacheLookup": {
296− "type": "boolean",
297− "description": "Whether or not a cache lookup was attempted."
298− },
299− "cacheHit": {
300− "type": "boolean",
301− "description": "Whether or not an entity was served from cache (with or without validation)."
302− },
303− "cacheValidatedWithOriginServer": {
304− "type": "boolean",
305− "description": "Whether or not the response was validated with the origin server before being served from cache. This field is only meaningful if `cache_hit` is True."
306− },
307− "cacheFillBytes": {
308− "type": "string",
309− "description": "The number of HTTP response bytes inserted into cache. Set only when a cache fill was attempted.",
310− "format": "int64"
311− }
312− }
313− },
314− "LogEntryOperation": {
315− "id": "LogEntryOperation",
316− "type": "object",
317− "description": "Additional information about a potentially long-running operation with which a log entry is associated.",
318− "properties": {
319− "id": {
320− "type": "string",
321− "description": "Required. An arbitrary operation identifier. Log entries with the same identifier are assumed to be part of the same operation."
322− },
323− "producer": {
324− "type": "string",
325− "description": "Required. An arbitrary producer identifier. The combination of `id` and `producer` must be globally unique. Examples for `producer`: `\"MyDivision.MyBigCompany.com\"`, \"github.com/MyProject/MyApplication\"`."
326− },
327− "first": {
328− "type": "boolean",
329− "description": "Optional. Set this to True if this is the first log entry in the operation."
330− },
331− "last": {
332− "type": "boolean",
333− "description": "Optional. Set this to True if this is the last log entry in the operation."
2+ "id": "logging:v2beta1",
3+ "auth": {
4+ "oauth2": {
5+ "scopes": {
6+ "https://www.googleapis.com/auth/cloud-platform": {
7+ "description": "View and manage your data across Google Cloud Platform services"
8+ },
9+ "https://www.googleapis.com/auth/cloud-platform.read-only": {
10+ "description": "View your data across Google Cloud Platform services"
11+ },
12+ "https://www.googleapis.com/auth/logging.read": {
13+ "description": "View log data for your projects"
14+ },
15+ "https://www.googleapis.com/auth/logging.write": {
16+ "description": "Submit log data for your projects"
17+ },
18+ "https://www.googleapis.com/auth/logging.admin": {
19+ "description": "Administrate log data for your projects"
20+ }
21+ }
33422 }
335− }
336− },
337− "WriteLogEntriesResponse": {
338− "id": "WriteLogEntriesResponse",
339− "type": "object",
340− "description": "Result returned from WriteLogEntries. empty"
34123 },
342− "ListLogEntriesRequest": {
343− "id": "ListLogEntriesRequest",
344− "type": "object",
345− "description": "The parameters to `ListLogEntries`.",
346− "properties": {
347− "projectIds": {
348− "type": "array",
349− "description": "Required. One or more project IDs or project numbers from which to retrieve log entries. Examples of a project ID: `\"my-project-1A\"`, `\"1234567890\"`.",
350− "items": {
351− "type": "string"
352− }
353− },
354− "filter": {
355− "type": "string",
356− "description": "Optional. An [advanced logs filter](/logging/docs/view/advanced_filters). The filter is compared against all log entries in the projects specified by `projectIds`. Only entries that match the filter are retrieved. An empty filter matches all log entries."
357− },
358− "orderBy": {
359− "type": "string",
360− "description": "Optional. How the results should be sorted. Presently, the only permitted values are `\"timestamp asc\"` (default) and `\"timestamp desc\"`. The first option returns entries in order of increasing values of `LogEntry.timestamp` (oldest first), and the second option returns entries in order of decreasing timestamps (newest first). Entries with equal timestamps are returned in order of `LogEntry.insertId`."
361− },
362− "pageSize": {
363− "type": "integer",
364− "description": "Optional. The maximum number of results to return from this request. You must check for presence of `nextPageToken` to determine if additional results are available, which you can retrieve by passing the `nextPageToken` value as the `pageToken` parameter in the next request.",
365− "format": "int32"
24+ "description": "Writes log entries and manages your Stackdriver Logging configuration.",
25+ "protocol": "rest",
26+ "title": "Stackdriver Logging API",
27+ "resources": {
28+ "projects": {
29+ "resources": {
30+ "metrics": {
31+ "methods": {
32+ "update": {
33+ "id": "logging.projects.metrics.update",
34+ "response": {
35+ "$ref": "LogMetric"
36+ },
37+ "parameterOrder": [
38+ "metricName"
39+ ],
40+ "description": "Creates or updates a logs-based metric.",
41+ "request": {
42+ "$ref": "LogMetric"
43+ },
44+ "flatPath": "v2beta1/projects/{projectsId}/metrics/{metricsId}",
45+ "httpMethod": "PUT",
46+ "parameters": {
47+ "metricName": {
48+ "description": "The resource name of the metric to update.\nExample: `\"projects/my-project-id/metrics/my-metric-id\"`.\n\nThe updated metric must be provided in the request and have the\nsame identifier that is specified in `metricName`.\nIf the metric does not exist, it is created.",
49+ "required": true,
50+ "pattern": "^projects/[^/]+/metrics/[^/]+$",
51+ "location": "path",
52+ "type": "string"
53+ }
54+ },
55+ "path": "v2beta1/{+metricName}",
56+ "scopes": [
57+ "https://www.googleapis.com/auth/cloud-platform",
58+ "https://www.googleapis.com/auth/logging.admin",
59+ "https://www.googleapis.com/auth/logging.write"
60+ ]
61+ },
62+ "get": {
63+ "id": "logging.projects.metrics.get",
64+ "response": {
65+ "$ref": "LogMetric"
66+ },
67+ "parameterOrder": [
68+ "metricName"
69+ ],
70+ "description": "Gets a logs-based metric.",
71+ "flatPath": "v2beta1/projects/{projectsId}/metrics/{metricsId}",
72+ "httpMethod": "GET",
73+ "parameters": {
74+ "metricName": {
75+ "description": "The resource name of the desired metric.\nExample: `\"projects/my-project-id/metrics/my-metric-id\"`.",
76+ "required": true,
77+ "pattern": "^projects/[^/]+/metrics/[^/]+$",
78+ "location": "path",
79+ "type": "string"
80+ }
81+ },
82+ "path": "v2beta1/{+metricName}",
83+ "scopes": [
84+ "https://www.googleapis.com/auth/cloud-platform",
85+ "https://www.googleapis.com/auth/cloud-platform.read-only",
86+ "https://www.googleapis.com/auth/logging.admin",
87+ "https://www.googleapis.com/auth/logging.read"
88+ ]
89+ },
90+ "create": {
91+ "id": "logging.projects.metrics.create",
92+ "response": {
93+ "$ref": "LogMetric"
94+ },
95+ "parameterOrder": [
96+ "parent"
97+ ],
98+ "description": "Creates a logs-based metric.",
99+ "request": {
100+ "$ref": "LogMetric"
101+ },
102+ "flatPath": "v2beta1/projects/{projectsId}/metrics",
103+ "httpMethod": "POST",
104+ "parameters": {
105+ "parent": {
106+ "description": "The resource name of the project in which to create the metric.\nExample: `\"projects/my-project-id\"`.\n\nThe new metric must be provided in the request.",
107+ "required": true,
108+ "pattern": "^projects/[^/]+$",
109+ "location": "path",
110+ "type": "string"
111+ }
112+ },
113+ "path": "v2beta1/{+parent}/metrics",
114+ "scopes": [
115+ "https://www.googleapis.com/auth/cloud-platform",
116+ "https://www.googleapis.com/auth/logging.admin",
117+ "https://www.googleapis.com/auth/logging.write"
118+ ]
119+ },
120+ "list": {
121+ "id": "logging.projects.metrics.list",
122+ "response": {
123+ "$ref": "ListLogMetricsResponse"
124+ },
125+ "parameterOrder": [
126+ "parent"
127+ ],
128+ "description": "Lists logs-based metrics.",
129+ "flatPath": "v2beta1/projects/{projectsId}/metrics",
130+ "httpMethod": "GET",
131+ "parameters": {
132+ "pageSize": {
133+ "description": "Optional. The maximum number of results to return from this request.\nNon-positive values are ignored. The presence of `nextPageToken` in the\nresponse indicates that more results might be available.",
134+ "location": "query",
135+ "type": "integer",
136+ "format": "int32"
137+ },
138+ "parent": {
139+ "description": "Required. The resource name containing the metrics.\nExample: `\"projects/my-project-id\"`.",
140+ "required": true,
141+ "pattern": "^projects/[^/]+$",
142+ "location": "path",
143+ "type": "string"
144+ },
145+ "pageToken": {
146+ "description": "Optional. If present, then retrieve the next batch of results from the\npreceding call to this method. `pageToken` must be the value of\n`nextPageToken` from the previous response. The values of other method\nparameters should be identical to those in the previous call.",
147+ "location": "query",
148+ "type": "string"
149+ }
150+ },
151+ "path": "v2beta1/{+parent}/metrics",
152+ "scopes": [
153+ "https://www.googleapis.com/auth/cloud-platform",
154+ "https://www.googleapis.com/auth/cloud-platform.read-only",
155+ "https://www.googleapis.com/auth/logging.admin",
156+ "https://www.googleapis.com/auth/logging.read"
157+ ]
158+ },
159+ "delete": {
160+ "id": "logging.projects.metrics.delete",
161+ "response": {
162+ "$ref": "Empty"
163+ },
164+ "parameterOrder": [
165+ "metricName"
166+ ],
167+ "description": "Deletes a logs-based metric.",
168+ "flatPath": "v2beta1/projects/{projectsId}/metrics/{metricsId}",
169+ "httpMethod": "DELETE",
170+ "parameters": {
171+ "metricName": {
172+ "description": "The resource name of the metric to delete.\nExample: `\"projects/my-project-id/metrics/my-metric-id\"`.",
173+ "required": true,
174+ "pattern": "^projects/[^/]+/metrics/[^/]+$",
175+ "location": "path",
176+ "type": "string"
177+ }
178+ },
179+ "path": "v2beta1/{+metricName}",
180+ "scopes": [
181+ "https://www.googleapis.com/auth/cloud-platform",
182+ "https://www.googleapis.com/auth/logging.admin",
183+ "https://www.googleapis.com/auth/logging.write"
184+ ]
185+ }
186+ }
187+ },
188+ "logs": {
189+ "methods": {
190+ "delete": {
191+ "id": "logging.projects.logs.delete",
192+ "response": {
193+ "$ref": "Empty"
194+ },
195+ "parameterOrder": [
196+ "logName"
197+ ],
198+ "description": "Deletes a log and all its log entries.\nThe log will reappear if it receives new entries.",
199+ "flatPath": "v2beta1/projects/{projectsId}/logs/{logsId}",
200+ "httpMethod": "DELETE",
201+ "parameters": {
202+ "logName": {
203+ "description": "Required. The resource name of the log to delete. Example:\n`\"projects/my-project/logs/syslog\"`.",
204+ "required": true,
205+ "pattern": "^projects/[^/]+/logs/[^/]+$",
206+ "location": "path",
207+ "type": "string"
208+ }
209+ },
210+ "path": "v2beta1/{+logName}",
211+ "scopes": [
212+ "https://www.googleapis.com/auth/cloud-platform",
213+ "https://www.googleapis.com/auth/logging.admin"
214+ ]
215+ }
216+ }
217+ },
218+ "sinks": {
219+ "methods": {
220+ "update": {
221+ "id": "logging.projects.sinks.update",
222+ "response": {
223+ "$ref": "LogSink"
224+ },
225+ "parameterOrder": [
226+ "sinkName"
227+ ],
228+ "description": "Updates or creates a sink.",
229+ "request": {
230+ "$ref": "LogSink"
231+ },
232+ "flatPath": "v2beta1/projects/{projectsId}/sinks/{sinksId}",
233+ "httpMethod": "PUT",
234+ "parameters": {
235+ "sinkName": {
236+ "description": "Required. The resource name of the sink to update, including the parent\nresource and the sink identifier. If the sink does not exist, this method\ncreates the sink. Example: `\"projects/my-project-id/sinks/my-sink-id\"`.",
237+ "required": true,
238+ "pattern": "^projects/[^/]+/sinks/[^/]+$",
239+ "location": "path",
240+ "type": "string"
241+ }
242+ },
243+ "path": "v2beta1/{+sinkName}",
244+ "scopes": [
245+ "https://www.googleapis.com/auth/cloud-platform",
246+ "https://www.googleapis.com/auth/logging.admin"
247+ ]
248+ },
249+ "get": {
250+ "id": "logging.projects.sinks.get",
251+ "response": {
252+ "$ref": "LogSink"
253+ },
254+ "parameterOrder": [
255+ "sinkName"
256+ ],
257+ "description": "Gets a sink.",
258+ "flatPath": "v2beta1/projects/{projectsId}/sinks/{sinksId}",
259+ "httpMethod": "GET",
260+ "parameters": {
261+ "sinkName": {
262+ "description": "Required. The resource name of the sink to return.\nExample: `\"projects/my-project-id/sinks/my-sink-id\"`.",
263+ "required": true,
264+ "pattern": "^projects/[^/]+/sinks/[^/]+$",
265+ "location": "path",
266+ "type": "string"
267+ }
268+ },
269+ "path": "v2beta1/{+sinkName}",
270+ "scopes": [
271+ "https://www.googleapis.com/auth/cloud-platform",
272+ "https://www.googleapis.com/auth/cloud-platform.read-only",
273+ "https://www.googleapis.com/auth/logging.admin",
274+ "https://www.googleapis.com/auth/logging.read"
275+ ]
276+ },
277+ "create": {
278+ "id": "logging.projects.sinks.create",
279+ "response": {
280+ "$ref": "LogSink"
281+ },
282+ "parameterOrder": [
283+ "parent"
284+ ],
285+ "description": "Creates a sink.",
286+ "request": {
287+ "$ref": "LogSink"
288+ },
289+ "flatPath": "v2beta1/projects/{projectsId}/sinks",
290+ "httpMethod": "POST",
291+ "parameters": {
292+ "parent": {
293+ "description": "Required. The resource in which to create the sink.\nExample: `\"projects/my-project-id\"`.\nThe new sink must be provided in the request.",
294+ "required": true,
295+ "pattern": "^projects/[^/]+$",
296+ "location": "path",
297+ "type": "string"
298+ }
299+ },
300+ "path": "v2beta1/{+parent}/sinks",
301+ "scopes": [
302+ "https://www.googleapis.com/auth/cloud-platform",
303+ "https://www.googleapis.com/auth/logging.admin"
304+ ]
305+ },
306+ "list": {
307+ "id": "logging.projects.sinks.list",
308+ "response": {
309+ "$ref": "ListSinksResponse"
310+ },
311+ "parameterOrder": [
312+ "parent"
313+ ],
314+ "description": "Lists sinks.",
315+ "flatPath": "v2beta1/projects/{projectsId}/sinks",
316+ "httpMethod": "GET",
317+ "parameters": {
318+ "pageSize": {
319+ "description": "Optional. The maximum number of results to return from this request.\nNon-positive values are ignored. The presence of `nextPageToken` in the\nresponse indicates that more results might be available.",
320+ "location": "query",
321+ "type": "integer",
322+ "format": "int32"
323+ },
324+ "parent": {
325+ "description": "Required. The cloud resource containing the sinks.\nExample: `\"projects/my-logging-project\"`.",
326+ "required": true,
327+ "pattern": "^projects/[^/]+$",
328+ "location": "path",
329+ "type": "string"
330+ },
331+ "pageToken": {
332+ "description": "Optional. If present, then retrieve the next batch of results from the\npreceding call to this method. `pageToken` must be the value of\n`nextPageToken` from the previous response. The values of other method\nparameters should be identical to those in the previous call.",
333+ "location": "query",
334+ "type": "string"
335+ }
336+ },
337+ "path": "v2beta1/{+parent}/sinks",
338+ "scopes": [
339+ "https://www.googleapis.com/auth/cloud-platform",
340+ "https://www.googleapis.com/auth/cloud-platform.read-only",
341+ "https://www.googleapis.com/auth/logging.admin",
342+ "https://www.googleapis.com/auth/logging.read"
343+ ]
344+ },
345+ "delete": {
346+ "id": "logging.projects.sinks.delete",
347+ "response": {
348+ "$ref": "Empty"
349+ },
350+ "parameterOrder": [
351+ "sinkName"
352+ ],
353+ "description": "Deletes a sink.",
354+ "flatPath": "v2beta1/projects/{projectsId}/sinks/{sinksId}",
355+ "httpMethod": "DELETE",
356+ "parameters": {
357+ "sinkName": {
358+ "description": "Required. The resource name of the sink to delete, including the parent\nresource and the sink identifier. Example:\n`\"projects/my-project-id/sinks/my-sink-id\"`. It is an error if the sink\ndoes not exist.",
359+ "required": true,
360+ "pattern": "^projects/[^/]+/sinks/[^/]+$",
361+ "location": "path",
362+ "type": "string"
363+ }
364+ },
365+ "path": "v2beta1/{+sinkName}",
366+ "scopes": [
367+ "https://www.googleapis.com/auth/cloud-platform",
368+ "https://www.googleapis.com/auth/logging.admin"
369+ ]
370+ }
371+ }
372+ }
373+ }
366374 },
367− "pageToken": {
368− "type": "string",
369− "description": "Optional. If the `pageToken` parameter is supplied, then the next page of results is retrieved. The `pageToken` parameter must be set to the value of the `nextPageToken` from the previous response. The values of `projectIds`, `filter`, and `orderBy` must be the same as in the previous request."
375+ "organizations": {
376+ "resources": {
377+ "logs": {
378+ "methods": {
379+ "delete": {
380+ "id": "logging.organizations.logs.delete",
381+ "response": {
382+ "$ref": "Empty"
383+ },
384+ "parameterOrder": [
385+ "logName"
386+ ],
387+ "description": "Deletes a log and all its log entries.\nThe log will reappear if it receives new entries.",
388+ "flatPath": "v2beta1/organizations/{organizationsId}/logs/{logsId}",
389+ "httpMethod": "DELETE",
390+ "parameters": {
391+ "logName": {
392+ "description": "Required. The resource name of the log to delete. Example:\n`\"projects/my-project/logs/syslog\"`.",
393+ "required": true,
394+ "pattern": "^organizations/[^/]+/logs/[^/]+$",
395+ "location": "path",
396+ "type": "string"
397+ }
398+ },
399+ "path": "v2beta1/{+logName}",
400+ "scopes": [
401+ "https://www.googleapis.com/auth/cloud-platform",
402+ "https://www.googleapis.com/auth/logging.admin"
403+ ]
404+ }
405+ }
406+ }
407+ }
370408 },
371− "partialSuccess": {
372− "type": "boolean",
373− "description": "Optional. If true, read access to all projects is not required and results will be returned for the subset of projects for which read access is permitted (empty subset is permitted)."
374− }
375− }
376− },
377− "ListLogEntriesResponse": {
378− "id": "ListLogEntriesResponse",
379− "type": "object",
380− "description": "Result returned from `ListLogEntries`.",
381− "properties": {
382409 "entries": {
383− "type": "array",
384− "description": "A list of log entries.",
385− "items": {
386− "$ref": "LogEntry"
387− }
388− },
389− "nextPageToken": {
390− "type": "string",
391− "description": "If there are more results than were returned, then `nextPageToken` is included in the response. To get the next set of results, call this method again using the value of `nextPageToken` as `pageToken`."
392− },
393− "projectIdErrors": {
394− "type": "object",
395− "description": "If partial_success is true, contains the project ids that had errors and the associated errors.",
396− "additionalProperties": {
397− "$ref": "Status"
398− }
399− }
400− }
401− },
402− "Status": {
403− "id": "Status",
404− "type": "object",
405− "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.",
406− "properties": {
407− "code": {
408− "type": "integer",
409− "description": "The status code, which should be an enum value of google.rpc.Code.",
410− "format": "int32"
411− },
412− "message": {
413− "type": "string",
414− "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."
415− },
416− "details": {
417− "type": "array",
418− "description": "A list of messages that carry the error details. There will be a common set of message types for APIs to use.",
419− "items": {
420− "type": "object",
421− "additionalProperties": {
422− "type": "any",
423− "description": "Properties of the object. Contains field @ype with type URL."
410+ "methods": {
411+ "write": {
412+ "id": "logging.entries.write",
413+ "response": {
414+ "$ref": "WriteLogEntriesResponse"
415+ },
416+ "parameterOrder": [],
417+ "description": "Writes log entries to Stackdriver Logging. All log entries are\nwritten by this method.",
418+ "request": {
419+ "$ref": "WriteLogEntriesRequest"
420+ },
421+ "flatPath": "v2beta1/entries:write",
422+ "httpMethod": "POST",
423+ "parameters": {},
424+ "path": "v2beta1/entries:write",
425+ "scopes": [
426+ "https://www.googleapis.com/auth/cloud-platform",
427+ "https://www.googleapis.com/auth/logging.admin",
428+ "https://www.googleapis.com/auth/logging.write"
429+ ]
430+ },
431+ "list": {
432+ "id": "logging.entries.list",
433+ "response": {
434+ "$ref": "ListLogEntriesResponse"
435+ },
436+ "parameterOrder": [],
437+ "description": "Lists log entries. Use this method to retrieve log entries from Cloud\nLogging. For ways to export log entries, see\n[Exporting Logs](/logging/docs/export).",
438+ "request": {
439+ "$ref": "ListLogEntriesRequest"
440+ },
441+ "flatPath": "v2beta1/entries:list",
442+ "httpMethod": "POST",
443+ "parameters": {},
444+ "path": "v2beta1/entries:list",
445+ "scopes": [
446+ "https://www.googleapis.com/auth/cloud-platform",
447+ "https://www.googleapis.com/auth/cloud-platform.read-only",
448+ "https://www.googleapis.com/auth/logging.admin",
449+ "https://www.googleapis.com/auth/logging.read"
450+ ]
451+ }
424452 }
425− }
426− }
427− }
428− },
429− "ListMonitoredResourceDescriptorsResponse": {
430− "id": "ListMonitoredResourceDescriptorsResponse",
431− "type": "object",
432− "description": "Result returned from ListMonitoredResourceDescriptors.",
433− "properties": {
434− "resourceDescriptors": {
435− "type": "array",
436− "description": "A list of resource descriptors.",
437− "items": {
438− "$ref": "MonitoredResourceDescriptor"
439− }
440− },
441− "nextPageToken": {
442− "type": "string",
443− "description": "If there are more results than were returned, then `nextPageToken` is included in the response. To get the next set of results, call this method again using the value of `nextPageToken` as `pageToken`."
444− }
445− }
446− },
447− "MonitoredResourceDescriptor": {
448− "id": "MonitoredResourceDescriptor",
449− "type": "object",
450− "description": "An object that describes the schema of a MonitoredResource object using a type name and a set of labels. For example, the monitored resource descriptor for Google Compute Engine VM instances has a type of `\"gce_instance\"` and specifies the use of the labels `\"instance_id\"` and `\"zone\"` to identify particular VM instances. Different APIs can support different monitored resource types. APIs generally provide a `list` method that returns the monitored resource descriptors used by the API.",
451− "properties": {
452− "name": {
453− "type": "string",
454− "description": "Optional. The resource name of the monitored resource descriptor: `\"projects/{project_id}/monitoredResourceDescriptors/{type}\"` where {type} is the value of the `type` field in this object and {project_id} is a project ID that provides API-specific context for accessing the type. APIs that do not use project information can use the resource name format `\"monitoredResourceDescriptors/{type}\"`."
455453 },
456− "type": {
457− "type": "string",
458− "description": "Required. The monitored resource type. For example, the type `\"cloudsql_database\"` represents databases in Google Cloud SQL."
459− },
460− "displayName": {
461− "type": "string",
462− "description": "Optional. A concise name for the monitored resource type that might be displayed in user interfaces. For example, `\"Google Cloud SQL Database\"`."
463− },
464− "description": {
465− "type": "string",
466− "description": "Optional. A detailed description of the monitored resource type that might be used in documentation."
467− },
468− "labels": {
469− "type": "array",
470− "description": "Required. A set of labels used to describe instances of this monitored resource type. For example, an individual Google Cloud SQL database is identified by values for the labels `\"database_id\"` and `\"zone\"`.",
471− "items": {
472− "$ref": "LabelDescriptor"
473− }
474− }
475− }
476− },
477− "LabelDescriptor": {
478− "id": "LabelDescriptor",
479− "type": "object",
480− "description": "A description of a label.",
481− "properties": {
482− "key": {
483− "type": "string",
484− "description": "The label key."
485− },
486− "valueType": {
487− "type": "string",
488− "description": "The type of data that can be assigned to the label.",
489− "enum": [
490− "STRING",
491− "BOOL",
492− "INT64"
493− ]
494− },
495− "description": {
496− "type": "string",
497− "description": "A human-readable description for the label."
498− }
499− }
500− },
501− "ListSinksResponse": {
502− "id": "ListSinksResponse",
503− "type": "object",
504− "description": "Result returned from `ListSinks`.",
505− "properties": {
506− "sinks": {
507− "type": "array",
508− "description": "A list of sinks.",
509− "items": {
510− "$ref": "LogSink"
511− }
512− },
513− "nextPageToken": {
514− "type": "string",
515− "description": "If there are more results than were returned, then `nextPageToken` is included in the response. To get the next set of results, call this method again using the value of `nextPageToken` as `pageToken`."
516− }
517− }
518− },
519− "LogSink": {
520− "id": "LogSink",
521− "type": "object",
522− "description": "Describes a sink used to export log entries outside Cloud Logging.",
523− "properties": {
524− "name": {
525− "type": "string",
526− "description": "Required. The client-assigned sink identifier. Example: `\"my-severe-errors-to-pubsub\"`. Sink identifiers are limited to 1000 characters and can include only the following characters: `A-Z`, `a-z`, `0-9`, and the special characters `_-.`."
527− },
528− "destination": {
529− "type": "string",
530− "description": "The export destination. See [Exporting Logs With Sinks](/logging/docs/api/tasks/exporting-logs). Examples: `\"storage.googleapis.com/a-bucket\"`, `\"bigquery.googleapis.com/projects/a-project-id/datasets/a-dataset\"`."
531− },
532− "filter": {
533− "type": "string",
534− "description": "An [advanced logs filter](/logging/docs/view/advanced_filters). Only log entries matching that filter are exported. The filter must be consistent with the log entry format specified by the `outputVersionFormat` parameter, regardless of the format of the log entry that was originally written to Cloud Logging. Example (V2 format): `\"logName=projects/my-projectid/logs/syslog AND severity\u003e=ERROR\"`."
535− },
536− "outputVersionFormat": {
537− "type": "string",
538− "description": "The log entry version to use for this sink's exported log entries. This version does not have to correspond to the version of the log entry when it was written to Cloud Logging.",
539− "enum": [
540− "VERSION_FORMAT_UNSPECIFIED",
541− "V2",
542− "V1"
543− ]
544− }
545− }
546− },
547− "ListLogMetricsResponse": {
548− "id": "ListLogMetricsResponse",
549− "type": "object",
550− "description": "Result returned from ListLogMetrics.",
551− "properties": {
552− "metrics": {
553− "type": "array",
554− "description": "A list of logs-based metrics.",
555− "items": {
556− "$ref": "LogMetric"
557− }
558− },
559− "nextPageToken": {
560− "type": "string",
561− "description": "If there are more results than were returned, then `nextPageToken` is included in the response. To get the next set of results, call this method again using the value of `nextPageToken` as `pageToken`."
562− }
563− }
564− },
565− "LogMetric": {
566− "id": "LogMetric",
567− "type": "object",
568− "description": "Describes a logs-based metric. The value of the metric is the number of log entries that match a logs filter.",
569− "properties": {
570− "name": {
571− "type": "string",
572− "description": "Required. The client-assigned metric identifier. Example: `\"severe_errors\"`. Metric identifiers are limited to 1000 characters and can include only the following characters: `A-Z`, `a-z`, `0-9`, and the special characters `_-.,+!*',()%/\\`. The forward-slash character (`/`) denotes a hierarchy of name pieces, and it cannot be the first character of the name."
573− },
574− "description": {
575− "type": "string",
576− "description": "A description of this metric, which is used in documentation."
454+ "monitoredResourceDescriptors": {
455+ "methods": {
456+ "list": {
457+ "id": "logging.monitoredResourceDescriptors.list",
458+ "response": {
459+ "$ref": "ListMonitoredResourceDescriptorsResponse"
460+ },
461+ "parameterOrder": [],
462+ "description": "Lists the monitored resource descriptors used by Stackdriver Logging.",
463+ "flatPath": "v2beta1/monitoredResourceDescriptors",
464+ "httpMethod": "GET",
465+ "parameters": {
466+ "pageSize": {
467+ "description": "Optional. The maximum number of results to return from this request.\nNon-positive values are ignored. The presence of `nextPageToken` in the\nresponse indicates that more results might be available.",
468+ "location": "query",
469+ "type": "integer",
470+ "format": "int32"
471+ },
472+ "pageToken": {
473+ "description": "Optional. If present, then retrieve the next batch of results from the\npreceding call to this method. `pageToken` must be the value of\n`nextPageToken` from the previous response. The values of other method\nparameters should be identical to those in the previous call.",
474+ "location": "query",
475+ "type": "string"
476+ }
477+ },
478+ "path": "v2beta1/monitoredResourceDescriptors",
479+ "scopes": [
480+ "https://www.googleapis.com/auth/cloud-platform",
481+ "https://www.googleapis.com/auth/cloud-platform.read-only",
482+ "https://www.googleapis.com/auth/logging.admin",
483+ "https://www.googleapis.com/auth/logging.read"
484+ ]
485+ }
486+ }
577487 },
578− "filter": {
579− "type": "string",
580− "description": "An [advanced logs filter](/logging/docs/view/advanced_filters). Example: `\"logName:syslog AND severity\u003e=ERROR\"`."
488+ "billingAccounts": {
489+ "resources": {
490+ "logs": {
491+ "methods": {
492+ "delete": {
493+ "id": "logging.billingAccounts.logs.delete",
494+ "response": {
495+ "$ref": "Empty"
496+ },
497+ "parameterOrder": [
498+ "logName"
499+ ],
500+ "description": "Deletes a log and all its log entries.\nThe log will reappear if it receives new entries.",
501+ "flatPath": "v2beta1/billingAccounts/{billingAccountsId}/logs/{logsId}",
502+ "httpMethod": "DELETE",
503+ "parameters": {
504+ "logName": {
505+ "description": "Required. The resource name of the log to delete. Example:\n`\"projects/my-project/logs/syslog\"`.",
506+ "required": true,
507+ "pattern": "^billingAccounts/[^/]+/logs/[^/]+$",
508+ "location": "path",
509+ "type": "string"
510+ }
511+ },
512+ "path": "v2beta1/{+logName}",
513+ "scopes": [
514+ "https://www.googleapis.com/auth/cloud-platform",
515+ "https://www.googleapis.com/auth/logging.admin"
516+ ]
517+ }
518+ }
519+ }
520+ }
581521 }
582− }
583522 },
584− "RequestLog": {
585− "id": "RequestLog",
586− "type": "object",
587− "description": "Complete log information about a single HTTP request to an App Engine application.",
588− "properties": {
589− "appId": {
590− "type": "string",
591− "description": "Application that handled this request."
592− },
593− "moduleId": {
594− "type": "string",
595− "description": "Module of the application that handled this request."
596− },
597− "versionId": {
598− "type": "string",
599− "description": "Version of the application that handled this request."
600− },
601− "requestId": {
602− "type": "string",
603− "description": "Globally unique identifier for a request, which is based on the request start time. Request IDs for requests which started later will compare greater as strings than those for requests which started earlier."
604− },
605− "ip": {
606− "type": "string",
607− "description": "Origin IP address."
608− },
609− "startTime": {
610− "type": "string",
611− "description": "Time when the request started."
612− },
613− "endTime": {
614− "type": "string",
615− "description": "Time when the request finished."
616− },
617− "latency": {
618− "type": "string",
619− "description": "Latency of the request."
620− },
621− "megaCycles": {
622− "type": "string",
623− "description": "Number of CPU megacycles used to process request.",
624− "format": "int64"
625− },
626− "method": {
627− "type": "string",
628− "description": "Request method. Example: `\"GET\"`, `\"HEAD\"`, `\"PUT\"`, `\"POST\"`, `\"DELETE\"`."
629− },
630− "resource": {
631− "type": "string",
632− "description": "Contains the path and query portion of the URL that was requested. For example, if the URL was \"http://example.com/app?name=val\", the resource would be \"/app?name=val\". The fragment identifier, which is identified by the `#` character, is not included."
633− },
634− "httpVersion": {
635− "type": "string",
636− "description": "HTTP version of request. Example: `\"HTTP/1.1\"`."
637− },
638− "status": {
639− "type": "integer",
640− "description": "HTTP response status code. Example: 200, 404.",
641− "format": "int32"
642− },
643− "responseSize": {
644− "type": "string",
645− "description": "Size in bytes sent back to client by request.",
646− "format": "int64"
647− },
648− "referrer": {
649− "type": "string",
650− "description": "Referrer URL of request."
651− },
652− "userAgent": {
653− "type": "string",
654− "description": "User agent that made the request."
655− },
656− "nickname": {
657− "type": "string",
658− "description": "The logged-in user who made the request. Most likely, this is the part of the user's email before the `@` sign. The field value is the same for different requests from the same user, but different users can have similar names. This information is also available to the application via the App Engine Users API. This field will be populated starting with App Engine 1.9.21."
659− },
660− "urlMapEntry": {
661− "type": "string",
662− "description": "File or class that handled the request."
663− },
664− "host": {
665− "type": "string",
666− "description": "Internet host and port number of the resource being requested."
667− },
668− "cost": {
669− "type": "number",
670− "description": "An indication of the relative cost of serving this request.",
671− "format": "double"
672− },
673− "taskQueueName": {
674− "type": "string",
675− "description": "Queue name of the request, in the case of an offline request."
676− },
677− "taskName": {
678− "type": "string",
679− "description": "Task name of the request, in the case of an offline request."
680− },
681− "wasLoadingRequest": {
682− "type": "boolean",
683− "description": "Whether this was a loading request for the instance."
684− },
685− "pendingTime": {
686− "type": "string",
687− "description": "Time this request spent in the pending request queue."
688− },
689− "instanceIndex": {
690− "type": "integer",
691− "description": "If the instance processing this request belongs to a manually scaled module, then this is the 0-based index of the instance. Otherwise, this value is -1.",
692− "format": "int32"
693− },
694− "finished": {
695− "type": "boolean",
696− "description": "Whether this request is finished or active."
697− },
698− "first": {
699− "type": "boolean",
700− "description": "Whether this is the first RequestLog entry for this request. If an active request has several RequestLog entries written to Cloud Logging, this field will be set for one of them."
701− },
702− "instanceId": {
703− "type": "string",
704− "description": "An identifier for the instance that handled the request."
705− },
706− "line": {
707− "type": "array",
708− "description": "A list of log lines emitted by the application while serving this request.",
709− "items": {
710− "$ref": "LogLine"
711− }
523+ "schemas": {
524+ "ListLogEntriesResponse": {
525+ "description": "Result returned from `ListLogEntries`.",
526+ "type": "object",
527+ "properties": {
528+ "entries": {
529+ "description": "A list of log entries.",
530+ "type": "array",
531+ "items": {
532+ "$ref": "LogEntry"
533+ }
534+ },
535+ "nextPageToken": {
536+ "description": "If there might be more results than appear in this response, then\n`nextPageToken` is included. To get the next set of results, call this\nmethod again using the value of `nextPageToken` as `pageToken`.",
537+ "type": "string"
538+ }
539+ },
540+ "id": "ListLogEntriesResponse"
712541 },
713− "appEngineRelease": {
714− "type": "string",
715− "description": "App Engine release version."
542+ "ListSinksResponse": {
543+ "description": "Result returned from `ListSinks`.",
544+ "type": "object",
545+ "properties": {
546+ "nextPageToken": {
547+ "description": "If there might be more results than appear in this response, then\n`nextPageToken` is included. To get the next set of results, call the same\nmethod again using the value of `nextPageToken` as `pageToken`.",
548+ "type": "string"
549+ },
550+ "sinks": {
551+ "description": "A list of sinks.",
552+ "type": "array",
553+ "items": {
554+ "$ref": "LogSink"
555+ }
556+ }
557+ },
558+ "id": "ListSinksResponse"
716559 },
717− "traceId": {
718− "type": "string",
719− "description": "Cloud Trace identifier for this request."
560+ "SourceLocation": {
561+ "description": "Specifies a location in a source code file.",
562+ "type": "object",
563+ "properties": {
564+ "file": {
565+ "description": "Source file name. Depending on the runtime environment, this might be a\nsimple name or a fully-qualified name.",
566+ "type": "string"
567+ },
568+ "functionName": {
569+ "description": "Human-readable name of the function or method being invoked, with optional\ncontext such as the class or package name. This information is used in\ncontexts such as the logs viewer, where a file and line number are less\nmeaningful. The format can vary by language. For example:\n`qual.if.ied.Class.method` (Java), `dir/package.func` (Go), `function`\n(Python).",
570+ "type": "string"
571+ },
572+ "line": {
573+ "description": "Line within the source file.",
574+ "type": "string",
575+ "format": "int64"
576+ }
577+ },
578+ "id": "SourceLocation"
720579 },
721− "sourceReference": {
722− "type": "array",
723− "description": "Source code for the application that handled this request. There can be more than one source reference per deployed application if source code is distributed among multiple repositories.",
724− "items": {
725− "$ref": "SourceReference"
726− }
727− }
728− }
729− },
730− "LogLine": {
731− "id": "LogLine",
732− "type": "object",
733− "description": "Application log line emitted while processing a request.",
734− "properties": {
735− "time": {
736− "type": "string",
737− "description": "Approximate time when this log entry was made."
580+ "LogSink": {
581+ "description": "Describes a sink used to export log entries outside of Stackdriver Logging.",
582+ "type": "object",
583+ "properties": {
584+ "destination": {
585+ "description": "Required. The export destination. See\n[Exporting Logs With Sinks](/logging/docs/api/tasks/exporting-logs).\nExamples:\n\n \"storage.googleapis.com/my-gcs-bucket\"\n \"bigquery.googleapis.com/projects/my-project-id/datasets/my-dataset\"\n \"pubsub.googleapis.com/projects/my-project/topics/my-topic\"",
586+ "type": "string"
587+ },
588+ "filter": {
589+ "description": "Optional. An [advanced logs filter](/logging/docs/view/advanced_filters).\nOnly log entries matching the filter are exported. The filter\nmust be consistent with the log entry format specified by the\n`outputVersionFormat` parameter, regardless of the format of the\nlog entry that was originally written to Stackdriver Logging.\nExample filter (V2 format):\n\n logName=projects/my-projectid/logs/syslog AND severity\u003e=ERROR",
590+ "type": "string"
591+ },
592+ "endTime": {
593+ "description": "Optional. Time at which this sink expires.",
594+ "type": "string",
595+ "format": "google-datetime"
596+ },
597+ "name": {
598+ "description": "Required. The client-assigned sink identifier, unique within the\nproject. Example: `\"my-syslog-errors-to-pubsub\"`. Sink identifiers are\nlimited to 1000 characters and can include only the following characters:\n`A-Z`, `a-z`, `0-9`, and the special characters `_-.`. The maximum length\nof the name is 100 characters.",
599+ "type": "string"
600+ },
601+ "startTime": {
602+ "description": "Optional. Time range for which this sink is active.\nLogs are exported only if start_time \u003c= entry.timestamp \u003c end_time\nBoth start_time and end_time may be omitted to specify\n(half) infinite ranges. The start_time must be less than the end_time.",
603+ "type": "string",
604+ "format": "google-datetime"
605+ },
606+ "outputVersionFormat": {
607+ "description": "Optional. The log entry version to use for this sink's exported log\nentries. This version does not have to correspond to the version of the\nlog entry that was written to Stackdriver Logging. If omitted, the\nv2 format is used.",
608+ "enum": [
609+ "VERSION_FORMAT_UNSPECIFIED",
610+ "V2",
611+ "V1"
612+ ],
613+ "enumDescriptions": [
614+ "An unspecified version format will default to V2.",
615+ "`LogEntry` version 2 format.",
616+ "`LogEntry` version 1 format."
617+ ],
618+ "type": "string"
619+ },
620+ "writerIdentity": {
621+ "description": "Output only. The IAM identity to which the destination needs to grant write\naccess. This may be a service account or a group.\nExamples (Do not assume these specific values):\n \"serviceAccount:cloud-logs@system.gserviceaccount.com\"\n \"group:cloud-logs@google.com\"\n\n For GCS destinations, the role \"roles/owner\" is required on the bucket\n For Cloud Pubsub destinations, the role \"roles/pubsub.publisher\" is\n required on the topic\n For BigQuery, the role \"roles/editor\" is required on the dataset",
622+ "type": "string"
623+ }
624+ },
625+ "id": "LogSink"
738626 },
739− "severity": {
740− "type": "string",
741− "description": "Severity of this log entry.",
742− "enum": [
743− "DEFAULT",
744− "DEBUG",
745− "INFO",
746− "NOTICE",
747− "WARNING",
748− "ERROR",
749− "CRITICAL",
750− "ALERT",
751− "EMERGENCY"
752− ]
627+ "LogMetric": {
628+ "description": "Describes a logs-based metric. The value of the metric is the\nnumber of log entries that match a logs filter.",
629+ "type": "object",
630+ "properties": {
631+ "description": {
632+ "description": "Optional. A description of this metric, which is used in documentation.",
633+ "type": "string"
634+ },
635+ "filter": {
636+ "description": "Required. An [advanced logs filter](/logging/docs/view/advanced_filters).\nExample: `\"resource.type=gae_app AND severity\u003e=ERROR\"`.",
637+ "type": "string"
638+ },
639+ "name": {
640+ "description": "Required. The client-assigned metric identifier. Example:\n`\"severe_errors\"`. Metric identifiers are limited to 100\ncharacters and can include only the following characters: `A-Z`,\n`a-z`, `0-9`, and the special characters `_-.,+!*',()%/`. The\nforward-slash character (`/`) denotes a hierarchy of name pieces,\nand it cannot be the first character of the name. The '%' character\nis used to URL encode unsafe and reserved characters and must be\nfollowed by two hexadecimal digits according to RFC 1738.",
641+ "type": "string"
642+ },
643+ "version": {
644+ "description": "Output only. The API version that created or updated this metric.\nThe version also dictates the syntax of the filter expression. When a value\nfor this field is missing, the default value of V2 should be assumed.",
645+ "enum": [
646+ "V2",
647+ "V1"
648+ ],
649+ "enumDescriptions": [
650+ "Stackdriver Logging API v2.",
651+ "Stackdriver Logging API v1."
652+ ],
653+ "type": "string"
654+ }
655+ },
656+ "id": "LogMetric"
753657 },
754− "logMessage": {
755− "type": "string",
756− "description": "App-provided log message."
658+ "LogEntry": {
659+ "description": "An individual entry in a log.",
660+ "type": "object",
661+ "properties": {
662+ "textPayload": {
663+ "description": "The log entry payload, represented as a Unicode string (UTF-8).",
664+ "type": "string"
665+ },
666+ "httpRequest": {
667+ "description": "Optional. Information about the HTTP request associated with this\nlog entry, if applicable.",
668+ "$ref": "HttpRequest"
669+ },
670+ "jsonPayload": {
671+ "description": "The log entry payload, represented as a structure that\nis expressed as a JSON object.",
672+ "additionalProperties": {
673+ "description": "Properties of the object.",
674+ "type": "any"
675+ },
676+ "type": "object"
677+ },
678+ "labels": {
679+ "description": "Optional. A set of user-defined (key, value) data that provides additional\ninformation about the log entry.",
680+ "additionalProperties": {
681+ "type": "string"
682+ },
683+ "type": "object"
684+ },
685+ "logName": {
686+ "description": "Required. The resource name of the log to which this log entry\nbelongs. The format of the name is\n`\"projects/\u003cproject-id\u003e/logs/\u003clog-id\u003e\"`. Examples:\n`\"projects/my-projectid/logs/syslog\"`,\n`\"projects/my-projectid/logs/library.googleapis.com%2Fbook_log\"`.\n\nThe log ID part of resource name must be less than 512 characters\nlong and can only include the following characters: upper and\nlower case alphanumeric characters: [A-Za-z0-9]; and punctuation\ncharacters: forward-slash, underscore, hyphen, and period.\nForward-slash (`/`) characters in the log ID must be URL-encoded.",
687+ "type": "string"
688+ },
689+ "severity": {
690+ "description": "Optional. The severity of the log entry. The default value is\n`LogSeverity.DEFAULT`.",
691+ "enum": [
692+ "DEFAULT",
693+ "DEBUG",
694+ "INFO",
695+ "NOTICE",
696+ "WARNING",
697+ "ERROR",
698+ "CRITICAL",
699+ "ALERT",
700+ "EMERGENCY"
701+ ],
702+ "enumDescriptions": [
703+ "(0) The log entry has no assigned severity level.",
704+ "(100) Debug or trace information.",
705+ "(200) Routine information, such as ongoing status or performance.",
706+ "(300) Normal but significant events, such as start up, shut down, or\na configuration change.",
707+ "(400) Warning events might cause problems.",
708+ "(500) Error events are likely to cause problems.",
709+ "(600) Critical events cause more severe problems or outages.",
710+ "(700) A person must take an action immediately.",
711+ "(800) One or more systems are unusable."
712+ ],
713+ "type": "string"
714+ },
715+ "resource": {
716+ "description": "Required. The monitored resource associated with this log entry.\nExample: a log entry that reports a database error would be\nassociated with the monitored resource designating the particular\ndatabase that reported the error.",
717+ "$ref": "MonitoredResource"
718+ },
719+ "protoPayload": {
720+ "description": "The log entry payload, represented as a protocol buffer. Some\nGoogle Cloud Platform services use this field for their log\nentry payloads.",
721+ "additionalProperties": {
722+ "description": "Properties of the object. Contains field @type with type URL.",
723+ "type": "any"
724+ },
725+ "type": "object"
726+ },
727+ "timestamp": {
728+ "description": "Optional. The time the event described by the log entry occurred. If\nomitted, Stackdriver Logging will use the time the log entry is received.",
729+ "type": "string",
730+ "format": "google-datetime"
731+ },
732+ "insertId": {
733+ "description": "Optional. A unique ID for the log entry. If you provide this\nfield, the logging service considers other log entries in the\nsame project with the same ID as duplicates which can be removed. If\nomitted, Stackdriver Logging will generate a unique ID for this\nlog entry.",
734+ "type": "string"
735+ },
736+ "operation": {
737+ "description": "Optional. Information about an operation associated with the log entry, if\napplicable.",
738+ "$ref": "LogEntryOperation"
739+ }
740+ },
741+ "id": "LogEntry"
757742 },
758− "sourceLocation": {
759− "$ref": "SourceLocation",
760− "description": "Where in the source code this log message was written."
761− }
762− }
763− },
764− "SourceLocation": {
765− "id": "SourceLocation",
766− "type": "object",
767− "description": "Specifies a location in a source code file.",
768− "properties": {
769− "file": {
770− "type": "string",
771− "description": "Source file name. Depending on the runtime environment, this might be a simple name or a fully-qualified name."
743+ "LogLine": {
744+ "description": "Application log line emitted while processing a request.",
745+ "type": "object",
746+ "properties": {
747+ "time": {
748+ "description": "Approximate time when this log entry was made.",
749+ "type": "string",
750+ "format": "google-datetime"
751+ },
752+ "severity": {
753+ "description": "Severity of this log entry.",
754+ "enum": [
755+ "DEFAULT",
756+ "DEBUG",
757+ "INFO",
758+ "NOTICE",
759+ "WARNING",
760+ "ERROR",
761+ "CRITICAL",
762+ "ALERT",
763+ "EMERGENCY"
764+ ],
765+ "enumDescriptions": [
766+ "(0) The log entry has no assigned severity level.",
767+ "(100) Debug or trace information.",
768+ "(200) Routine information, such as ongoing status or performance.",
769+ "(300) Normal but significant events, such as start up, shut down, or\na configuration change.",
770+ "(400) Warning events might cause problems.",
771+ "(500) Error events are likely to cause problems.",
772+ "(600) Critical events cause more severe problems or outages.",
773+ "(700) A person must take an action immediately.",
774+ "(800) One or more systems are unusable."
775+ ],
776+ "type": "string"
777+ },
778+ "sourceLocation": {
779+ "description": "Where in the source code this log message was written.",
780+ "$ref": "SourceLocation"
781+ },
782+ "logMessage": {
783+ "description": "App-provided log message.",
784+ "type": "string"
785+ }
786+ },
787+ "id": "LogLine"
772788 },
773− "line": {
774− "type": "string",
775− "description": "Line within the source file.",
776− "format": "int64"
789+ "SourceReference": {
790+ "description": "A reference to a particular snapshot of the source tree used to build and\ndeploy an application.",
791+ "type": "object",
792+ "properties": {
793+ "repository": {
794+ "description": "Optional. A URI string identifying the repository.\nExample: \"https://github.com/GoogleCloudPlatform/kubernetes.git\"",
795+ "type": "string"
796+ },
797+ "revisionId": {
798+ "description": "The canonical and persistent identifier of the deployed revision.\nExample (git): \"0035781c50ec7aa23385dc841529ce8a4b70db1b\"",
799+ "type": "string"
800+ }
801+ },
802+ "id": "SourceReference"
777803 },
778− "functionName": {
779− "type": "string",
780− "description": "Human-readable name of the function or method being invoked, with optional context such as the class or package name. This information is used in contexts such as the logs viewer, where a file and line number are less meaningful. The format can vary by language. For example: `qual.if.ied.Class.method` (Java), `dir/package.func` (Go), `function` (Python)."
781− }
782− }
783− },
784− "SourceReference": {
785− "id": "SourceReference",
786− "type": "object",
787− "description": "A reference to a particular snapshot of the source tree used to build and deploy an application.",
788− "properties": {
789− "repository": {
790− "type": "string",
791− "description": "Optional. A URI string identifying the repository. Example: \"https://github.com/GoogleCloudPlatform/kubernetes.git\""
804+ "MonitoredResource": {
805+ "description": "An object representing a resource that can be used for monitoring, logging,\nbilling, or other purposes. Examples include virtual machine instances,\ndatabases, and storage devices such as disks. The `type` field identifies a\nMonitoredResourceDescriptor object that describes the resource's\nschema. Information in the `labels` field identifies the actual resource and\nits attributes according to the schema. For example, a particular Compute\nEngine VM instance could be represented by the following object, because the\nMonitoredResourceDescriptor for `\"gce_instance\"` has labels\n`\"instance_id\"` and `\"zone\"`:\n\n { \"type\": \"gce_instance\",\n \"labels\": { \"instance_id\": \"12345678901234\",\n \"zone\": \"us-central1-a\" }}",
806+ "type": "object",
807+ "properties": {
808+ "labels": {
809+ "description": "Required. Values for all of the labels listed in the associated monitored\nresource descriptor. For example, Cloud SQL databases use the labels\n`\"database_id\"` and `\"zone\"`.",
810+ "additionalProperties": {
811+ "type": "string"
812+ },
813+ "type": "object"
814+ },
815+ "type": {
816+ "description": "Required. The monitored resource type. This field must match\nthe `type` field of a MonitoredResourceDescriptor object. For\nexample, the type of a Cloud SQL database is `\"cloudsql_database\"`.",
817+ "type": "string"
818+ }
819+ },
820+ "id": "MonitoredResource"
792821 },
793− "revisionId": {
794− "type": "string",
795− "description": "The canonical and persistent identifier of the deployed revision. Example (git): \"0035781c50ec7aa23385dc841529ce8a4b70db1b\""
796− }
797− }
798− }
799− },
800− "resources": {
801− "projects": {
802− "resources": {
803− "logs": {
804− "methods": {
805− "delete": {
806− "id": "logging.projects.logs.delete",
807− "path": "v2beta1/{+logName}",
808− "httpMethod": "DELETE",
809− "description": "Deletes a log and all its log entries. The log will reappear if it receives new entries.",
810− "parameters": {
822+ "WriteLogEntriesRequest": {
823+ "description": "The parameters to WriteLogEntries.",
824+ "type": "object",
825+ "properties": {
826+ "labels": {
827+ "description": "Optional. Default labels that are added to the `labels` field of all log\nentries in `entries`. If a log entry already has a label with the same key\nas a label in this parameter, then the log entry's label is not changed.\nSee LogEntry.",
828+ "additionalProperties": {
829+ "type": "string"
830+ },
831+ "type": "object"
832+ },
833+ "entries": {
834+ "description": "Required. The log entries to write. Values supplied for the fields\n`log_name`, `resource`, and `labels` in this `entries.write` request are\nadded to those log entries that do not provide their own values for the\nfields.\n\nTo improve throughput and to avoid exceeding the\n[quota limit](/logging/quota-policy) for calls to `entries.write`,\nyou should write multiple log entries at once rather than\ncalling this method for each individual log entry.",
835+ "type": "array",
836+ "items": {
837+ "$ref": "LogEntry"
838+ }
839+ },
811840 "logName": {
812− "type": "string",
813− "description": "Required. The resource name of the log to delete. Example: `\"projects/my-project/logs/syslog\"`.",
814− "required": true,
815− "pattern": "^projects/[^/]*/logs/[^/]*$",
816− "location": "path"
841+ "description": "Optional. A default log resource name that is assigned to all log entries\nin `entries` that do not specify a value for `log_name`. Example:\n`\"projects/my-project/logs/syslog\"`. See\nLogEntry.",
842+ "type": "string"
843+ },
844+ "partialSuccess": {
845+ "description": "Optional. Whether valid entries should be written even if some other\nentries fail due to INVALID_ARGUMENT or PERMISSION_DENIED errors. If any\nentry is not written, the response status will be the error associated\nwith one of the failed entries and include error details in the form of\nWriteLogEntriesPartialErrors.",
846+ "type": "boolean"
847+ },
848+ "resource": {
849+ "description": "Optional. A default monitored resource object that is assigned to all log\nentries in `entries` that do not specify a value for `resource`. Example:\n\n { \"type\": \"gce_instance\",\n \"labels\": {\n \"zone\": \"us-central1-a\", \"instance_id\": \"00000000000000000000\" }}\n\nSee LogEntry.",
850+ "$ref": "MonitoredResource"
817851 }
818− },
819− "parameterOrder": [
820− "logName"
821− ],
822− "response": {
823− "$ref": "Empty"
824− },
825− "scopes": [
826− "https://www.googleapis.com/auth/cloud-platform",
827− "https://www.googleapis.com/auth/logging.admin"
828− ]
829− }
830− }
852+ },
853+ "id": "WriteLogEntriesRequest"
831854 },
832− "sinks": {
833− "methods": {
834− "list": {
835− "id": "logging.projects.sinks.list",
836− "path": "v2beta1/{+projectName}/sinks",
837− "httpMethod": "GET",
838− "description": "Lists sinks.",
839− "parameters": {
840− "projectName": {
841− "type": "string",
842− "description": "Required. The resource name of the project containing the sinks. Example: `\"projects/my-logging-project\"`.",
843− "required": true,
844− "pattern": "^projects/[^/]*$",
845− "location": "path"
855+ "LabelDescriptor": {
856+ "description": "A description of a label.",
857+ "type": "object",
858+ "properties": {
859+ "description": {
860+ "description": "A human-readable description for the label.",
861+ "type": "string"
846862 },
847− "pageToken": {
848− "type": "string",
849− "description": "Optional. If the `pageToken` parameter is supplied, then the next page of results is retrieved. The `pageToken` parameter must be set to the value of the `nextPageToken` from the previous response. The value of `projectName` must be the same as in the previous request.",
850− "location": "query"
863+ "valueType": {
864+ "description": "The type of data that can be assigned to the label.",
865+ "enum": [
866+ "STRING",
867+ "BOOL",
868+ "INT64"
869+ ],
870+ "enumDescriptions": [
871+ "A variable-length string. This is the default.",
872+ "Boolean; true or false.",
873+ "A 64-bit signed integer."
874+ ],
875+ "type": "string"
851876 },
852− "pageSize": {
853− "type": "integer",
854− "description": "Optional. The maximum number of results to return from this request. You must check for presence of `nextPageToken` to determine if additional results are available, which you can retrieve by passing the `nextPageToken` value as the `pageToken` parameter in the next request.",
855− "format": "int32",
856− "location": "query"
877+ "key": {
878+ "description": "The label key.",
879+ "type": "string"
857880 }
858− },
859− "parameterOrder": [
860− "projectName"
861− ],
862− "response": {
863− "$ref": "ListSinksResponse"
864− },
865− "scopes": [
866− "https://www.googleapis.com/auth/cloud-platform",
867− "https://www.googleapis.com/auth/cloud-platform.read-only",
868− "https://www.googleapis.com/auth/logging.admin",
869− "https://www.googleapis.com/auth/logging.read"
870− ]
871881 },
872− "get": {
873− "id": "logging.projects.sinks.get",
874− "path": "v2beta1/{+sinkName}",
875− "httpMethod": "GET",
876− "description": "Gets a sink.",
877− "parameters": {
878− "sinkName": {
879− "type": "string",
880− "description": "The resource name of the sink to return. Example: `\"projects/my-project-id/sinks/my-sink-id\"`.",
881− "required": true,
882− "pattern": "^projects/[^/]*/sinks/[^/]*$",
883− "location": "path"
882+ "id": "LabelDescriptor"
883+ },
884+ "ListLogMetricsResponse": {
885+ "description": "Result returned from ListLogMetrics.",
886+ "type": "object",
887+ "properties": {
888+ "metrics": {
889+ "description": "A list of logs-based metrics.",
890+ "type": "array",
891+ "items": {
892+ "$ref": "LogMetric"
893+ }
894+ },
895+ "nextPageToken": {
896+ "description": "If there might be more results than appear in this response, then\n`nextPageToken` is included. To get the next set of results, call this\nmethod again using the value of `nextPageToken` as `pageToken`.",
897+ "type": "string"
884898 }
885− },
886− "parameterOrder": [
887− "sinkName"
888− ],
889− "response": {
890− "$ref": "LogSink"
891− },
892− "scopes": [
893− "https://www.googleapis.com/auth/cloud-platform",
894− "https://www.googleapis.com/auth/cloud-platform.read-only",
895− "https://www.googleapis.com/auth/logging.admin",
896− "https://www.googleapis.com/auth/logging.read"
897− ]
898899 },
899− "create": {
900− "id": "logging.projects.sinks.create",
901− "path": "v2beta1/{+projectName}/sinks",
902− "httpMethod": "POST",
903− "description": "Creates a sink.",
904− "parameters": {
905− "projectName": {
906− "type": "string",
907− "description": "The resource name of the project in which to create the sink. Example: `\"projects/my-project-id\"`. The new sink must be provided in the request.",
908− "required": true,
909− "pattern": "^projects/[^/]*$",
910− "location": "path"
900+ "id": "ListLogMetricsResponse"
901+ },
902+ "MonitoredResourceDescriptor": {
903+ "description": "An object that describes the schema of a MonitoredResource object using a\ntype name and a set of labels. For example, the monitored resource\ndescriptor for Google Compute Engine VM instances has a type of\n`\"gce_instance\"` and specifies the use of the labels `\"instance_id\"` and\n`\"zone\"` to identify particular VM instances.\n\nDifferent APIs can support different monitored resource types. APIs generally\nprovide a `list` method that returns the monitored resource descriptors used\nby the API.",
904+ "type": "object",
905+ "properties": {
906+ "displayName": {
907+ "description": "Optional. A concise name for the monitored resource type that might be\ndisplayed in user interfaces. It should be a Title Cased Noun Phrase,\nwithout any article or other determiners. For example,\n`\"Google Cloud SQL Database\"`.",
908+ "type": "string"
909+ },
910+ "description": {
911+ "description": "Optional. A detailed description of the monitored resource type that might\nbe used in documentation.",
912+ "type": "string"
913+ },
914+ "labels": {
915+ "description": "Required. A set of labels used to describe instances of this monitored\nresource type. For example, an individual Google Cloud SQL database is\nidentified by values for the labels `\"database_id\"` and `\"zone\"`.",
916+ "type": "array",
917+ "items": {
918+ "$ref": "LabelDescriptor"
919+ }
920+ },
921+ "type": {
922+ "description": "Required. The monitored resource type. For example, the type\n`\"cloudsql_database\"` represents databases in Google Cloud SQL.\nThe maximum length of this value is 256 characters.",
923+ "type": "string"
924+ },
925+ "name": {
926+ "description": "Optional. The resource name of the monitored resource descriptor:\n`\"projects/{project_id}/monitoredResourceDescriptors/{type}\"` where\n{type} is the value of the `type` field in this object and\n{project_id} is a project ID that provides API-specific context for\naccessing the type. APIs that do not use project information can use the\nresource name format `\"monitoredResourceDescriptors/{type}\"`.",
927+ "type": "string"
911928 }
912− },
913− "parameterOrder": [
914− "projectName"
915− ],
916− "request": {
917− "$ref": "LogSink"
918− },
919− "response": {
920− "$ref": "LogSink"
921− },
922− "scopes": [
923− "https://www.googleapis.com/auth/cloud-platform",
924− "https://www.googleapis.com/auth/logging.admin"
925− ]
926929 },
927− "update": {
928− "id": "logging.projects.sinks.update",
929− "path": "v2beta1/{+sinkName}",
930− "httpMethod": "PUT",
931− "description": "Creates or updates a sink.",
932− "parameters": {
933− "sinkName": {
934− "type": "string",
935− "description": "The resource name of the sink to update. Example: `\"projects/my-project-id/sinks/my-sink-id\"`. The updated sink must be provided in the request and have the same name that is specified in `sinkName`. If the sink does not exist, it is created.",
936− "required": true,
937− "pattern": "^projects/[^/]*/sinks/[^/]*$",
938− "location": "path"
930+ "id": "MonitoredResourceDescriptor"
931+ },
932+ "ListMonitoredResourceDescriptorsResponse": {
933+ "description": "Result returned from ListMonitoredResourceDescriptors.",
934+ "type": "object",
935+ "properties": {
936+ "nextPageToken": {
937+ "description": "If there might be more results than appear in this response, then\n`nextPageToken` is included. To get the next set of results, call this\nmethod again using the value of `nextPageToken` as `pageToken`.",
938+ "type": "string"
939+ },
940+ "resourceDescriptors": {
941+ "description": "A list of resource descriptors.",
942+ "type": "array",
943+ "items": {
944+ "$ref": "MonitoredResourceDescriptor"
945+ }
939946 }
940− },
941− "parameterOrder": [
942− "sinkName"
943− ],
944− "request": {
945− "$ref": "LogSink"
946− },
947− "response": {
948− "$ref": "LogSink"
949− },
950− "scopes": [
951− "https://www.googleapis.com/auth/cloud-platform",
952− "https://www.googleapis.com/auth/logging.admin"
953− ]
954947 },
955− "delete": {
956− "id": "logging.projects.sinks.delete",
957− "path": "v2beta1/{+sinkName}",
958− "httpMethod": "DELETE",
959− "description": "Deletes a sink.",
960− "parameters": {
961− "sinkName": {
962− "type": "string",
963− "description": "The resource name of the sink to delete. Example: `\"projects/my-project-id/sinks/my-sink-id\"`.",
964− "required": true,
965− "pattern": "^projects/[^/]*/sinks/[^/]*$",
966− "location": "path"
967− }
968− },
969− "parameterOrder": [
970− "sinkName"
971− ],
972− "response": {
973− "$ref": "Empty"
974− },
975− "scopes": [
976− "https://www.googleapis.com/auth/cloud-platform",
977− "https://www.googleapis.com/auth/logging.admin"
978− ]
979− }
980− }
948+ "id": "ListMonitoredResourceDescriptorsResponse"
981949 },
982− "metrics": {
983− "methods": {
984− "list": {
985− "id": "logging.projects.metrics.list",
986− "path": "v2beta1/{+projectName}/metrics",
987− "httpMethod": "GET",
988− "description": "Lists logs-based metrics.",
989− "parameters": {
990− "projectName": {
991− "type": "string",
992− "description": "Required. The resource name of the project containing the metrics. Example: `\"projects/my-project-id\"`.",
993− "required": true,
994− "pattern": "^projects/[^/]*$",
995− "location": "path"
950+ "LogEntryOperation": {
951+ "description": "Additional information about a potentially long-running operation with which\na log entry is associated.",
952+ "type": "object",
953+ "properties": {
954+ "producer": {
955+ "description": "Optional. An arbitrary producer identifier. The combination of\n`id` and `producer` must be globally unique. Examples for `producer`:\n`\"MyDivision.MyBigCompany.com\"`, `\"github.com/MyProject/MyApplication\"`.",
956+ "type": "string"
996957 },
997− "pageToken": {
998− "type": "string",
999− "description": "Optional. If the `pageToken` parameter is supplied, then the next page of results is retrieved. The `pageToken` parameter must be set to the value of the `nextPageToken` from the previous response. The value of `projectName` must be the same as in the previous request.",
1000− "location": "query"
958+ "last": {
959+ "description": "Optional. Set this to True if this is the last log entry in the operation.",
960+ "type": "boolean"
1001961 },
1002− "pageSize": {
1003− "type": "integer",
1004− "description": "Optional. The maximum number of results to return from this request. You must check for presence of `nextPageToken` to determine if additional results are available, which you can retrieve by passing the `nextPageToken` value as the `pageToken` parameter in the next request.",
1005− "format": "int32",
1006− "location": "query"
962+ "first": {
963+ "description": "Optional. Set this to True if this is the first log entry in the operation.",
964+ "type": "boolean"
965+ },
966+ "id": {
967+ "description": "Optional. An arbitrary operation identifier. Log entries with the\nsame identifier are assumed to be part of the same operation.",
968+ "type": "string"
1007969 }
1008− },
1009− "parameterOrder": [
1010− "projectName"
1011− ],
1012− "response": {
1013− "$ref": "ListLogMetricsResponse"
1014− },
1015− "scopes": [
1016− "https://www.googleapis.com/auth/cloud-platform",
1017− "https://www.googleapis.com/auth/cloud-platform.read-only",
1018− "https://www.googleapis.com/auth/logging.admin",
1019− "https://www.googleapis.com/auth/logging.read"
1020− ]
1021970 },
1022− "get": {
1023− "id": "logging.projects.metrics.get",
1024− "path": "v2beta1/{+metricName}",
1025− "httpMethod": "GET",
1026− "description": "Gets a logs-based metric.",
1027− "parameters": {
1028− "metricName": {
1029− "type": "string",
1030− "description": "The resource name of the desired metric. Example: `\"projects/my-project-id/metrics/my-metric-id\"`.",
1031− "required": true,
1032− "pattern": "^projects/[^/]*/metrics/[^/]*$",
1033− "location": "path"
971+ "id": "LogEntryOperation"
972+ },
973+ "Empty": {
974+ "description": "A generic empty message that you can re-use to avoid defining duplicated\nempty messages in your APIs. A typical example is to use it as the request\nor the response type of an API method. For instance:\n\n service Foo {\n rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);\n }\n\nThe JSON representation for `Empty` is empty JSON object `{}`.",
975+ "type": "object",
976+ "properties": {},
977+ "id": "Empty"
978+ },
979+ "HttpRequest": {
980+ "description": "A common proto for logging HTTP requests. Only contains semantics\ndefined by the HTTP specification. Product-specific logging\ninformation MUST be defined in a separate message.",
981+ "type": "object",
982+ "properties": {
983+ "cacheLookup": {
984+ "description": "Whether or not a cache lookup was attempted.",
985+ "type": "boolean"
986+ },
987+ "responseSize": {
988+ "description": "The size of the HTTP response message sent back to the client, in bytes,\nincluding the response headers and the response body.",
989+ "type": "string",
990+ "format": "int64"
991+ },
992+ "status": {
993+ "description": "The response code indicating the status of response.\nExamples: 200, 404.",
994+ "type": "integer",
995+ "format": "int32"
996+ },
997+ "cacheValidatedWithOriginServer": {
998+ "description": "Whether or not the response was validated with the origin server before\nbeing served from cache. This field is only meaningful if `cache_hit` is\nTrue.",
999+ "type": "boolean"
1000+ },
1001+ "referer": {
1002+ "description": "The referer URL of the request, as defined in\n[HTTP/1.1 Header Field Definitions](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html).",
1003+ "type": "string"
1004+ },
1005+ "cacheHit": {
1006+ "description": "Whether or not an entity was served from cache\n(with or without validation).",
1007+ "type": "boolean"
1008+ },
1009+ "requestUrl": {
1010+ "description": "The scheme (http, https), the host name, the path and the query\nportion of the URL that was requested.\nExample: `\"http://example.com/some/info?color=red\"`.",
1011+ "type": "string"
1012+ },
1013+ "latency": {
1014+ "description": "The request processing latency on the server, from the time the request was\nreceived until the response was sent.",
1015+ "type": "string",
1016+ "format": "google-duration"
1017+ },
1018+ "cacheFillBytes": {
1019+ "description": "The number of HTTP response bytes inserted into cache. Set only when a\ncache fill was attempted.",
1020+ "type": "string",
1021+ "format": "int64"
1022+ },
1023+ "requestMethod": {
1024+ "description": "The request method. Examples: `\"GET\"`, `\"HEAD\"`, `\"PUT\"`, `\"POST\"`.",
1025+ "type": "string"
1026+ },
1027+ "remoteIp": {
1028+ "description": "The IP address (IPv4 or IPv6) of the client that issued the HTTP\nrequest. Examples: `\"192.168.1.1\"`, `\"FE80::0202:B3FF:FE1E:8329\"`.",
1029+ "type": "string"
1030+ },
1031+ "serverIp": {
1032+ "description": "The IP address (IPv4 or IPv6) of the origin server that the request was\nsent to.",
1033+ "type": "string"
1034+ },
1035+ "userAgent": {
1036+ "description": "The user agent sent by the client. Example:\n`\"Mozilla/4.0 (compatible; MSIE 6.0; Windows 98; Q312461; .NET CLR 1.0.3705)\"`.",
1037+ "type": "string"
1038+ },
1039+ "requestSize": {
1040+ "description": "The size of the HTTP request message in bytes, including the request\nheaders and the request body.",
1041+ "type": "string",
1042+ "format": "int64"
10341043 }
1035− },
1036− "parameterOrder": [
1037− "metricName"
1038− ],
1039− "response": {
1040− "$ref": "LogMetric"
1041− },
1042− "scopes": [
1043− "https://www.googleapis.com/auth/cloud-platform",
1044− "https://www.googleapis.com/auth/cloud-platform.read-only",
1045− "https://www.googleapis.com/auth/logging.admin",
1046− "https://www.googleapis.com/auth/logging.read"
1047− ]
10481044 },
1049− "create": {
1050− "id": "logging.projects.metrics.create",
1051− "path": "v2beta1/{+projectName}/metrics",
1052− "httpMethod": "POST",
1053− "description": "Creates a logs-based metric.",
1054− "parameters": {
1055− "projectName": {
1056− "type": "string",
1057− "description": "The resource name of the project in which to create the metric. Example: `\"projects/my-project-id\"`. The new metric must be provided in the request.",
1058− "required": true,
1059− "pattern": "^projects/[^/]*$",
1060− "location": "path"
1045+ "id": "HttpRequest"
1046+ },
1047+ "RequestLog": {
1048+ "description": "Complete log information about a single HTTP request to an App Engine\napplication.",
1049+ "type": "object",
1050+ "properties": {
1051+ "responseSize": {
1052+ "description": "Size in bytes sent back to client by request.",
1053+ "type": "string",
1054+ "format": "int64"
1055+ },
1056+ "requestId": {
1057+ "description": "Globally unique identifier for a request, which is based on the request\nstart time. Request IDs for requests which started later will compare\ngreater as strings than those for requests which started earlier.",
1058+ "type": "string"
1059+ },
1060+ "first": {
1061+ "description": "Whether this is the first RequestLog entry for this request. If an active\nrequest has several RequestLog entries written to Cloud Logging, this field\nwill be set for one of them.",
1062+ "type": "boolean"
1063+ },
1064+ "method": {
1065+ "description": "Request method. Example: `\"GET\"`, `\"HEAD\"`, `\"PUT\"`, `\"POST\"`, `\"DELETE\"`.",
1066+ "type": "string"
1067+ },
1068+ "versionId": {
1069+ "description": "Version of the application that handled this request.",
1070+ "type": "string"
1071+ },
1072+ "status": {
1073+ "description": "HTTP response status code. Example: 200, 404.",
1074+ "type": "integer",
1075+ "format": "int32"
1076+ },
1077+ "wasLoadingRequest": {
1078+ "description": "Whether this was a loading request for the instance.",
1079+ "type": "boolean"
1080+ },
1081+ "ip": {
1082+ "description": "Origin IP address.",
1083+ "type": "string"
1084+ },
1085+ "nickname": {
1086+ "description": "The logged-in user who made the request.\n\nMost likely, this is the part of the user's email before the `@` sign. The\nfield value is the same for different requests from the same user, but\ndifferent users can have similar names. This information is also\navailable to the application via the App Engine Users API.\n\nThis field will be populated starting with App Engine 1.9.21.",
1087+ "type": "string"
1088+ },
1089+ "taskQueueName": {
1090+ "description": "Queue name of the request, in the case of an offline request.",
1091+ "type": "string"
1092+ },
1093+ "pendingTime": {
1094+ "description": "Time this request spent in the pending request queue.",
1095+ "type": "string",
1096+ "format": "google-duration"
1097+ },
1098+ "instanceIndex": {
1099+ "description": "If the instance processing this request belongs to a manually scaled\nmodule, then this is the 0-based index of the instance. Otherwise, this\nvalue is -1.",
1100+ "type": "integer",
1101+ "format": "int32"
1102+ },
1103+ "sourceReference": {
1104+ "description": "Source code for the application that handled this request. There can be\nmore than one source reference per deployed application if source code is\ndistributed among multiple repositories.",
1105+ "type": "array",
1106+ "items": {
1107+ "$ref": "SourceReference"
1108+ }
1109+ },
1110+ "moduleId": {
1111+ "description": "Module of the application that handled this request.",
1112+ "type": "string"
1113+ },
1114+ "host": {
1115+ "description": "Internet host and port number of the resource being requested.",
1116+ "type": "string"
1117+ },
1118+ "latency": {
1119+ "description": "Latency of the request.",
1120+ "type": "string",
1121+ "format": "google-duration"
1122+ },
1123+ "urlMapEntry": {
1124+ "description": "File or class that handled the request.",
1125+ "type": "string"
1126+ },
1127+ "endTime": {
1128+ "description": "Time when the request finished.",
1129+ "type": "string",
1130+ "format": "google-datetime"
1131+ },
1132+ "line": {
1133+ "description": "A list of log lines emitted by the application while serving this request.",
1134+ "type": "array",
1135+ "items": {
1136+ "$ref": "LogLine"
1137+ }
1138+ },
1139+ "megaCycles": {
1140+ "description": "Number of CPU megacycles used to process request.",
1141+ "type": "string",
1142+ "format": "int64"
1143+ },
1144+ "appId": {
1145+ "description": "Application that handled this request.",
1146+ "type": "string"
1147+ },
1148+ "traceId": {
1149+ "description": "Cloud Trace identifier for this request.",
1150+ "type": "string"
1151+ },
1152+ "taskName": {
1153+ "description": "Task name of the request, in the case of an offline request.",
1154+ "type": "string"
1155+ },
1156+ "cost": {
1157+ "description": "An indication of the relative cost of serving this request.",
1158+ "type": "number",
1159+ "format": "double"
1160+ },
1161+ "instanceId": {
1162+ "description": "An identifier for the instance that handled the request.",
1163+ "type": "string"
1164+ },
1165+ "startTime": {
1166+ "description": "Time when the request started.",
1167+ "type": "string",
1168+ "format": "google-datetime"
1169+ },
1170+ "appEngineRelease": {
1171+ "description": "App Engine release version.",
1172+ "type": "string"
1173+ },
1174+ "resource": {
1175+ "description": "Contains the path and query portion of the URL that was requested. For\nexample, if the URL was \"http://example.com/app?name=val\", the resource\nwould be \"/app?name=val\". The fragment identifier, which is identified by\nthe `#` character, is not included.",
1176+ "type": "string"
1177+ },
1178+ "httpVersion": {
1179+ "description": "HTTP version of request. Example: `\"HTTP/1.1\"`.",
1180+ "type": "string"
1181+ },
1182+ "referrer": {
1183+ "description": "Referrer URL of request.",
1184+ "type": "string"
1185+ },
1186+ "userAgent": {
1187+ "description": "User agent that made the request.",
1188+ "type": "string"
1189+ },
1190+ "finished": {
1191+ "description": "Whether this request is finished or active.",
1192+ "type": "boolean"
10611193 }
1062− },
1063− "parameterOrder": [
1064− "projectName"
1065− ],
1066− "request": {
1067− "$ref": "LogMetric"
1068− },
1069− "response": {
1070− "$ref": "LogMetric"
1071− },
1072− "scopes": [
1073− "https://www.googleapis.com/auth/cloud-platform",
1074− "https://www.googleapis.com/auth/logging.admin",
1075− "https://www.googleapis.com/auth/logging.write"
1076− ]
10771194 },
1078− "update": {
1079− "id": "logging.projects.metrics.update",
1080− "path": "v2beta1/{+metricName}",
1081− "httpMethod": "PUT",
1082− "description": "Creates or updates a logs-based metric.",
1083− "parameters": {
1084− "metricName": {
1085− "type": "string",
1086− "description": "The resource name of the metric to update. Example: `\"projects/my-project-id/metrics/my-metric-id\"`. The updated metric must be provided in the request and have the same identifier that is specified in `metricName`. If the metric does not exist, it is created.",
1087− "required": true,
1088− "pattern": "^projects/[^/]*/metrics/[^/]*$",
1089− "location": "path"
1195+ "id": "RequestLog"
1196+ },
1197+ "WriteLogEntriesResponse": {
1198+ "description": "Result returned from WriteLogEntries.\nempty",
1199+ "type": "object",
1200+ "properties": {},
1201+ "id": "WriteLogEntriesResponse"
1202+ },
1203+ "ListLogEntriesRequest": {
1204+ "description": "The parameters to `ListLogEntries`.",
1205+ "type": "object",
1206+ "properties": {
1207+ "filter": {
1208+ "description": "Optional. A filter that chooses which log entries to return. See [Advanced\nLogs Filters](/logging/docs/view/advanced_filters). Only log entries that\nmatch the filter are returned. An empty filter matches all log entries.",
1209+ "type": "string"
1210+ },
1211+ "projectIds": {
1212+ "description": "Deprecated. One or more project identifiers or project numbers from which\nto retrieve log entries. Examples: `\"my-project-1A\"`, `\"1234567890\"`. If\npresent, these project identifiers are converted to resource format and\nadded to the list of resources in `resourceNames`. Callers should use\n`resourceNames` rather than this parameter.",
1213+ "type": "array",
1214+ "items": {
1215+ "type": "string"
1216+ }
1217+ },
1218+ "resourceNames": {
1219+ "description": "Required. One or more cloud resources from which to retrieve log entries.\nExample: `\"projects/my-project-1A\"`, `\"projects/1234567890\"`. Projects\nlisted in `projectIds` are added to this list.",
1220+ "type": "array",
1221+ "items": {
1222+ "type": "string"
1223+ }
1224+ },
1225+ "pageSize": {
1226+ "description": "Optional. The maximum number of results to return from this request.\nNon-positive values are ignored. The presence of `nextPageToken` in the\nresponse indicates that more results might be available.",
1227+ "type": "integer",
1228+ "format": "int32"
1229+ },
1230+ "orderBy": {
1231+ "description": "Optional. How the results should be sorted. Presently, the only permitted\nvalues are `\"timestamp asc\"` (default) and `\"timestamp desc\"`. The first\noption returns entries in order of increasing values of\n`LogEntry.timestamp` (oldest first), and the second option returns entries\nin order of decreasing timestamps (newest first). Entries with equal\ntimestamps are returned in order of `LogEntry.insertId`.",
1232+ "type": "string"
1233+ },
1234+ "pageToken": {
1235+ "description": "Optional. If present, then retrieve the next batch of results from the\npreceding call to this method. `pageToken` must be the value of\n`nextPageToken` from the previous response. The values of other method\nparameters should be identical to those in the previous call.",
1236+ "type": "string"
10901237 }
1091− },
1092− "parameterOrder": [
1093− "metricName"
1094− ],
1095− "request": {
1096− "$ref": "LogMetric"
1097− },
1098− "response": {
1099− "$ref": "LogMetric"
1100− },
1101− "scopes": [
1102− "https://www.googleapis.com/auth/cloud-platform",
1103− "https://www.googleapis.com/auth/logging.admin",
1104− "https://www.googleapis.com/auth/logging.write"
1105− ]
11061238 },
1107− "delete": {
1108− "id": "logging.projects.metrics.delete",
1109− "path": "v2beta1/{+metricName}",
1110− "httpMethod": "DELETE",
1111− "description": "Deletes a logs-based metric.",
1112− "parameters": {
1113− "metricName": {
1114− "type": "string",
1115− "description": "The resource name of the metric to delete. Example: `\"projects/my-project-id/metrics/my-metric-id\"`.",
1116− "required": true,
1117− "pattern": "^projects/[^/]*/metrics/[^/]*$",
1118− "location": "path"
1119− }
1120− },
1121− "parameterOrder": [
1122− "metricName"
1123− ],
1124− "response": {
1125− "$ref": "Empty"
1126− },
1127− "scopes": [
1128− "https://www.googleapis.com/auth/cloud-platform",
1129− "https://www.googleapis.com/auth/logging.admin",
1130− "https://www.googleapis.com/auth/logging.write"
1131− ]
1132− }
1133− }
1239+ "id": "ListLogEntriesRequest"
11341240 }
1135− }
11361241 },
1137− "entries": {
1138− "methods": {
1139− "write": {
1140− "id": "logging.entries.write",
1141− "path": "v2beta1/entries:write",
1142− "httpMethod": "POST",
1143− "description": "Writes log entries to Cloud Logging. All log entries in Cloud Logging are written by this method.",
1144− "request": {
1145− "$ref": "WriteLogEntriesRequest"
1146− },
1147− "response": {
1148− "$ref": "WriteLogEntriesResponse"
1149− },
1150− "scopes": [
1151− "https://www.googleapis.com/auth/cloud-platform",
1152− "https://www.googleapis.com/auth/logging.admin",
1153− "https://www.googleapis.com/auth/logging.write"
1154− ]
1242+ "revision": "20161017",
1243+ "basePath": "",
1244+ "icons": {
1245+ "x32": "http://www.google.com/images/icons/product/search-32.gif",
1246+ "x16": "http://www.google.com/images/icons/product/search-16.gif"
1247+ },
1248+ "version_module": "True",
1249+ "canonicalName": "Logging",
1250+ "discoveryVersion": "v1",
1251+ "baseUrl": "https://logging.googleapis.com/",
1252+ "name": "logging",
1253+ "parameters": {
1254+ "access_token": {
1255+ "description": "OAuth access token.",
1256+ "type": "string",
1257+ "location": "query"
1258+ },
1259+ "prettyPrint": {
1260+ "description": "Returns response with indentations and line breaks.",
1261+ "default": "true",
1262+ "type": "boolean",
1263+ "location": "query"
11551264 },
1156− "list": {
1157− "id": "logging.entries.list",
1158− "path": "v2beta1/entries:list",
1159− "httpMethod": "POST",
1160− "description": "Lists log entries. Use this method to retrieve log entries from Cloud Logging. For ways to export log entries, see [Exporting Logs](/logging/docs/export).",
1161− "request": {
1162− "$ref": "ListLogEntriesRequest"
1163− },
1164− "response": {
1165− "$ref": "ListLogEntriesResponse"
1166− },
1167− "scopes": [
1168− "https://www.googleapis.com/auth/cloud-platform",
1169− "https://www.googleapis.com/auth/cloud-platform.read-only",
1170− "https://www.googleapis.com/auth/logging.admin",
1171− "https://www.googleapis.com/auth/logging.read"
1172− ]
1265+ "key": {
1266+ "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.",
1267+ "type": "string",
1268+ "location": "query"
1269+ },
1270+ "quotaUser": {
1271+ "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.",
1272+ "type": "string",
1273+ "location": "query"
1274+ },
1275+ "pp": {
1276+ "description": "Pretty-print response.",
1277+ "default": "true",
1278+ "type": "boolean",
1279+ "location": "query"
1280+ },
1281+ "fields": {
1282+ "description": "Selector specifying which fields to include in a partial response.",
1283+ "type": "string",
1284+ "location": "query"
1285+ },
1286+ "alt": {
1287+ "description": "Data format for response.",
1288+ "location": "query",
1289+ "enum": [
1290+ "json",
1291+ "media",
1292+ "proto"
1293+ ],
1294+ "default": "json",
1295+ "enumDescriptions": [
1296+ "Responses with Content-Type of application/json",
1297+ "Media download with context-dependent Content-Type",
1298+ "Responses with Content-Type of application/x-protobuf"
1299+ ],
1300+ "type": "string"
1301+ },
1302+ "$.xgafv": {
1303+ "description": "V1 error format.",
1304+ "enum": [
1305+ "1",
1306+ "2"
1307+ ],
1308+ "enumDescriptions": [
1309+ "v1 error format",
1310+ "v2 error format"
1311+ ],
1312+ "type": "string",
1313+ "location": "query"
1314+ },
1315+ "callback": {
1316+ "description": "JSONP",
1317+ "type": "string",
1318+ "location": "query"
1319+ },
1320+ "oauth_token": {
1321+ "description": "OAuth 2.0 token for the current user.",
1322+ "type": "string",
1323+ "location": "query"
1324+ },
1325+ "uploadType": {
1326+ "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
1327+ "type": "string",
1328+ "location": "query"
1329+ },
1330+ "bearer_token": {
1331+ "description": "OAuth bearer token.",
1332+ "type": "string",
1333+ "location": "query"
1334+ },
1335+ "upload_protocol": {
1336+ "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
1337+ "type": "string",
1338+ "location": "query"
11731339 }
1174− }
11751340 },
1176− "monitoredResourceDescriptors": {
1177− "methods": {
1178− "list": {
1179− "id": "logging.monitoredResourceDescriptors.list",
1180− "path": "v2beta1/monitoredResourceDescriptors",
1181− "httpMethod": "GET",
1182− "description": "Lists monitored resource descriptors that are used by Cloud Logging.",
1183− "parameters": {
1184− "pageSize": {
1185− "type": "integer",
1186− "description": "Optional. The maximum number of results to return from this request. You must check for presence of `nextPageToken` to determine if additional results are available, which you can retrieve by passing the `nextPageToken` value as the `pageToken` parameter in the next request.",
1187− "format": "int32",
1188− "location": "query"
1189− },
1190− "pageToken": {
1191− "type": "string",
1192− "description": "Optional. If the `pageToken` parameter is supplied, then the next page of results is retrieved. The `pageToken` parameter must be set to the value of the `nextPageToken` from the previous response.",
1193− "location": "query"
1194− }
1195− },
1196− "response": {
1197− "$ref": "ListMonitoredResourceDescriptorsResponse"
1198− },
1199− "scopes": [
1200− "https://www.googleapis.com/auth/cloud-platform",
1201− "https://www.googleapis.com/auth/cloud-platform.read-only",
1202− "https://www.googleapis.com/auth/logging.admin",
1203− "https://www.googleapis.com/auth/logging.read"
1204− ]
1205− }
1206− }
1207− }
1208− }
1341+ "documentationLink": "https://cloud.google.com/logging/docs/",
1342+ "ownerDomain": "google.com",
1343+ "batchPath": "batch",
1344+ "servicePath": "",
1345+ "ownerName": "Google",
1346+ "version": "v2beta1",
1347+ "rootUrl": "https://logging.googleapis.com/",
1348+ "kind": "discovery#restDescription"
12091349}
gogol-logging/README.md+1−1
@@ -13,7 +13,7 @@
1313
1414## Description
1515
16−A client library for the Google Cloud Logging.
16+A client library for the Google Stackdriver Logging.
1717
1818
1919## Contribute
gogol-logging/gen/Network/Google/Logging.hs+63−23
@@ -13,10 +13,9 @@
1313-- Stability : auto-generated
1414-- Portability : non-portable (GHC extensions)
1515--
16−-- Writes log entries and manages your logs, log sinks, and logs-based
17−-- metrics.
16+-- Writes log entries and manages your Stackdriver Logging configuration.
1817--
19−-- /See:/ <https://cloud.google.com/logging/docs/ Google Cloud Logging API Reference>
18+-- /See:/ <https://cloud.google.com/logging/docs/ Stackdriver Logging API Reference>
2019module Network.Google.Logging
2120 (
2221 -- * Service Configuration
@@ -34,6 +33,9 @@ module Network.Google.Logging
3433
3534 -- * Resources
3635
36+ -- ** logging.billingAccounts.logs.delete
37+ , module Network.Google.Resource.Logging.BillingAccounts.Logs.Delete
38+
3739 -- ** logging.entries.list
3840 , module Network.Google.Resource.Logging.Entries.List
3941
@@ -43,6 +45,24 @@ module Network.Google.Logging
4345 -- ** logging.monitoredResourceDescriptors.list
4446 , module Network.Google.Resource.Logging.MonitoredResourceDescriptors.List
4547
48+ -- ** logging.organizations.logs.delete
49+ , module Network.Google.Resource.Logging.Organizations.Logs.Delete
50+
51+ -- ** logging.organizations.sinks.create
52+ , module Network.Google.Resource.Logging.Organizations.Sinks.Create
53+
54+ -- ** logging.organizations.sinks.delete
55+ , module Network.Google.Resource.Logging.Organizations.Sinks.Delete
56+
57+ -- ** logging.organizations.sinks.get
58+ , module Network.Google.Resource.Logging.Organizations.Sinks.Get
59+
60+ -- ** logging.organizations.sinks.list
61+ , module Network.Google.Resource.Logging.Organizations.Sinks.List
62+
63+ -- ** logging.organizations.sinks.update
64+ , module Network.Google.Resource.Logging.Organizations.Sinks.Update
65+
4666 -- ** logging.projects.logs.delete
4767 , module Network.Google.Resource.Logging.Projects.Logs.Delete
4868
@@ -87,25 +107,20 @@ module Network.Google.Logging
87107 , mrdType
88108 , mrdDescription
89109
90− -- ** Status
91− , Status
92− , status
93− , sDetails
94− , sCode
95− , sMessage
96−
97110 -- ** ListLogEntriesResponse
98111 , ListLogEntriesResponse
99112 , listLogEntriesResponse
100113 , llerNextPageToken
101114 , llerEntries
102− , llerProjectIdErrors
103115
104116 -- ** MonitoredResourceLabels
105117 , MonitoredResourceLabels
106118 , monitoredResourceLabels
107119 , mrlAddtional
108120
121+ -- ** LogMetricVersion
122+ , LogMetricVersion (..)
123+
109124 -- ** ListLogMetricsResponse
110125 , ListLogMetricsResponse
111126 , listLogMetricsResponse
@@ -121,6 +136,9 @@ module Network.Google.Logging
121136 , wlerLabels
122137 , wlerLogName
123138
139+ -- ** LogSinkOutputVersionFormat
140+ , LogSinkOutputVersionFormat (..)
141+
124142 -- ** Empty
125143 , Empty
126144 , empty
@@ -185,21 +203,22 @@ module Network.Google.Logging
185203 , LogSink
186204 , logSink
187205 , lsDestination
206+ , lsStartTime
188207 , lsOutputVersionFormat
208+ , lsWriterIdentity
189209 , lsName
210+ , lsEndTime
190211 , lsFilter
191212
192− -- ** StatusDetailsItem
193− , StatusDetailsItem
194− , statusDetailsItem
195− , sdiAddtional
196−
197213 -- ** ListMonitoredResourceDescriptorsResponse
198214 , ListMonitoredResourceDescriptorsResponse
199215 , listMonitoredResourceDescriptorsResponse
200216 , lmrdrNextPageToken
201217 , lmrdrResourceDescriptors
202218
219+ -- ** LabelDescriptorValueType
220+ , LabelDescriptorValueType (..)
221+
203222 -- ** HTTPRequest
204223 , HTTPRequest
205224 , hTTPRequest
@@ -207,6 +226,8 @@ module Network.Google.Logging
207226 , httprRequestURL
208227 , httprCacheFillBytes
209228 , httprRemoteIP
229+ , httprLatency
230+ , httprServerIP
210231 , httprRequestSize
211232 , httprCacheValidatedWithOriginServer
212233 , httprUserAgent
@@ -216,11 +237,6 @@ module Network.Google.Logging
216237 , httprCacheHit
217238 , httprReferer
218239
219− -- ** ListLogEntriesResponseProjectIdErrors
220− , ListLogEntriesResponseProjectIdErrors
221− , listLogEntriesResponseProjectIdErrors
222− , llerpieAddtional
223−
224240 -- ** WriteLogEntriesRequestLabels
225241 , WriteLogEntriesRequestLabels
226242 , writeLogEntriesRequestLabels
@@ -232,6 +248,9 @@ module Network.Google.Logging
232248 , mrLabels
233249 , mrType
234250
251+ -- ** Xgafv
252+ , Xgafv (..)
253+
235254 -- ** LogLine
236255 , LogLine
237256 , logLine
@@ -251,11 +270,11 @@ module Network.Google.Logging
251270 , ListLogEntriesRequest
252271 , listLogEntriesRequest
253272 , llerOrderBy
254− , llerPartialSuccess
255273 , llerProjectIds
256274 , llerFilter
257275 , llerPageToken
258276 , llerPageSize
277+ , llerResourceNames
259278
260279 -- ** LogEntryOperation
261280 , LogEntryOperation
@@ -269,6 +288,7 @@ module Network.Google.Logging
269288 , LogMetric
270289 , logMetric
271290 , lmName
291+ , lmVersion
272292 , lmFilter
273293 , lmDescription
274294
@@ -294,6 +314,9 @@ module Network.Google.Logging
294314 , slFunctionName
295315 , slFile
296316
317+ -- ** LogEntrySeverity
318+ , LogEntrySeverity (..)
319+
297320 -- ** SourceReference
298321 , SourceReference
299322 , sourceReference
@@ -304,13 +327,23 @@ module Network.Google.Logging
304327 , LogEntryJSONPayload
305328 , logEntryJSONPayload
306329 , lejpAddtional
330+
331+ -- ** LogLineSeverity
332+ , LogLineSeverity (..)
307333 ) where
308334
309335import Network.Google.Logging.Types
310336import Network.Google.Prelude
337+import Network.Google.Resource.Logging.BillingAccounts.Logs.Delete
311338import Network.Google.Resource.Logging.Entries.List
312339import Network.Google.Resource.Logging.Entries.Write
313340import Network.Google.Resource.Logging.MonitoredResourceDescriptors.List
341+import Network.Google.Resource.Logging.Organizations.Logs.Delete
342+import Network.Google.Resource.Logging.Organizations.Sinks.Create
343+import Network.Google.Resource.Logging.Organizations.Sinks.Delete
344+import Network.Google.Resource.Logging.Organizations.Sinks.Get
345+import Network.Google.Resource.Logging.Organizations.Sinks.List
346+import Network.Google.Resource.Logging.Organizations.Sinks.Update
314347import Network.Google.Resource.Logging.Projects.Logs.Delete
315348import Network.Google.Resource.Logging.Projects.Metrics.Create
316349import Network.Google.Resource.Logging.Projects.Metrics.Delete
@@ -327,10 +360,16 @@ import Network.Google.Resource.Logging.Projects.Sinks.Update
327360TODO
328361-}
329362
330−-- | Represents the entirety of the methods and resources available for the Google Cloud Logging API service.
363+-- | Represents the entirety of the methods and resources available for the Stackdriver Logging API service.
331364type LoggingAPI =
332365 EntriesListResource :<|> EntriesWriteResource :<|>
333366 MonitoredResourceDescriptorsListResource
367+ :<|> OrganizationsSinksListResource
368+ :<|> OrganizationsSinksGetResource
369+ :<|> OrganizationsSinksCreateResource
370+ :<|> OrganizationsSinksDeleteResource
371+ :<|> OrganizationsSinksUpdateResource
372+ :<|> OrganizationsLogsDeleteResource
334373 :<|> ProjectsSinksListResource
335374 :<|> ProjectsSinksGetResource
336375 :<|> ProjectsSinksCreateResource
@@ -342,3 +381,4 @@ type LoggingAPI =
342381 :<|> ProjectsMetricsDeleteResource
343382 :<|> ProjectsMetricsUpdateResource
344383 :<|> ProjectsLogsDeleteResource
384+ :<|> BillingAccountsLogsDeleteResource
gogol-logging/gen/Network/Google/Logging/Types.hs+27−21
@@ -35,25 +35,20 @@ module Network.Google.Logging.Types
3535 , mrdType
3636 , mrdDescription
3737
38− -- * Status
39− , Status
40− , status
41− , sDetails
42− , sCode
43− , sMessage
44−
4538 -- * ListLogEntriesResponse
4639 , ListLogEntriesResponse
4740 , listLogEntriesResponse
4841 , llerNextPageToken
4942 , llerEntries
50− , llerProjectIdErrors
5143
5244 -- * MonitoredResourceLabels
5345 , MonitoredResourceLabels
5446 , monitoredResourceLabels
5547 , mrlAddtional
5648
49+ -- * LogMetricVersion
50+ , LogMetricVersion (..)
51+
5752 -- * ListLogMetricsResponse
5853 , ListLogMetricsResponse
5954 , listLogMetricsResponse
@@ -69,6 +64,9 @@ module Network.Google.Logging.Types
6964 , wlerLabels
7065 , wlerLogName
7166
67+ -- * LogSinkOutputVersionFormat
68+ , LogSinkOutputVersionFormat (..)
69+
7270 -- * Empty
7371 , Empty
7472 , empty
@@ -133,21 +131,22 @@ module Network.Google.Logging.Types
133131 , LogSink
134132 , logSink
135133 , lsDestination
134+ , lsStartTime
136135 , lsOutputVersionFormat
136+ , lsWriterIdentity
137137 , lsName
138+ , lsEndTime
138139 , lsFilter
139140
140− -- * StatusDetailsItem
141− , StatusDetailsItem
142− , statusDetailsItem
143− , sdiAddtional
144−
145141 -- * ListMonitoredResourceDescriptorsResponse
146142 , ListMonitoredResourceDescriptorsResponse
147143 , listMonitoredResourceDescriptorsResponse
148144 , lmrdrNextPageToken
149145 , lmrdrResourceDescriptors
150146
147+ -- * LabelDescriptorValueType
148+ , LabelDescriptorValueType (..)
149+
151150 -- * HTTPRequest
152151 , HTTPRequest
153152 , hTTPRequest
@@ -155,6 +154,8 @@ module Network.Google.Logging.Types
155154 , httprRequestURL
156155 , httprCacheFillBytes
157156 , httprRemoteIP
157+ , httprLatency
158+ , httprServerIP
158159 , httprRequestSize
159160 , httprCacheValidatedWithOriginServer
160161 , httprUserAgent
@@ -164,11 +165,6 @@ module Network.Google.Logging.Types
164165 , httprCacheHit
165166 , httprReferer
166167
167− -- * ListLogEntriesResponseProjectIdErrors
168− , ListLogEntriesResponseProjectIdErrors
169− , listLogEntriesResponseProjectIdErrors
170− , llerpieAddtional
171−
172168 -- * WriteLogEntriesRequestLabels
173169 , WriteLogEntriesRequestLabels
174170 , writeLogEntriesRequestLabels
@@ -180,6 +176,9 @@ module Network.Google.Logging.Types
180176 , mrLabels
181177 , mrType
182178
179+ -- * Xgafv
180+ , Xgafv (..)
181+
183182 -- * LogLine
184183 , LogLine
185184 , logLine
@@ -199,11 +198,11 @@ module Network.Google.Logging.Types
199198 , ListLogEntriesRequest
200199 , listLogEntriesRequest
201200 , llerOrderBy
202− , llerPartialSuccess
203201 , llerProjectIds
204202 , llerFilter
205203 , llerPageToken
206204 , llerPageSize
205+ , llerResourceNames
207206
208207 -- * LogEntryOperation
209208 , LogEntryOperation
@@ -217,6 +216,7 @@ module Network.Google.Logging.Types
217216 , LogMetric
218217 , logMetric
219218 , lmName
219+ , lmVersion
220220 , lmFilter
221221 , lmDescription
222222
@@ -242,6 +242,9 @@ module Network.Google.Logging.Types
242242 , slFunctionName
243243 , slFile
244244
245+ -- * LogEntrySeverity
246+ , LogEntrySeverity (..)
247+
245248 -- * SourceReference
246249 , SourceReference
247250 , sourceReference
@@ -252,16 +255,19 @@ module Network.Google.Logging.Types
252255 , LogEntryJSONPayload
253256 , logEntryJSONPayload
254257 , lejpAddtional
258+
259+ -- * LogLineSeverity
260+ , LogLineSeverity (..)
255261 ) where
256262
257263import Network.Google.Logging.Types.Product
258264import Network.Google.Logging.Types.Sum
259265import Network.Google.Prelude
260266
261−-- | Default request referring to version 'v2beta1' of the Google Cloud Logging API. This contains the host and root path used as a starting point for constructing service requests.
267+-- | Default request referring to version 'v2' of the Stackdriver Logging API. This contains the host and root path used as a starting point for constructing service requests.
262268loggingService :: ServiceConfig
263269loggingService
264− = defaultService (ServiceId "logging:v2beta1")
270+ = defaultService (ServiceId "logging:v2")
265271 "logging.googleapis.com"
266272
267273-- | Administrate log data for your projects
gogol-logging/gen/Network/Google/Logging/Types/Product.hs+253−321
@@ -72,8 +72,9 @@ mrdName :: Lens' MonitoredResourceDescriptor (Maybe Text)
7272mrdName = lens _mrdName (\ s a -> s{_mrdName = a})
7373
7474-- | Optional. A concise name for the monitored resource type that might be
75−-- displayed in user interfaces. For example, \`\"Google Cloud SQL
76−-- Database\"\`.
75+-- displayed in user interfaces. It should be a Title Cased Noun Phrase,
76+-- without any article or other determiners. For example, \`\"Google Cloud
77+-- SQL Database\"\`.
7778mrdDisplayName :: Lens' MonitoredResourceDescriptor (Maybe Text)
7879mrdDisplayName
7980 = lens _mrdDisplayName
@@ -90,7 +91,8 @@ mrdLabels
9091 . _Coerce
9192
9293-- | Required. The monitored resource type. For example, the type
93−-- \`\"cloudsql_database\"\` represents databases in Google Cloud SQL.
94+-- \`\"cloudsql_database\"\` represents databases in Google Cloud SQL. The
95+-- maximum length of this value is 256 characters.
9496mrdType :: Lens' MonitoredResourceDescriptor (Maybe Text)
9597mrdType = lens _mrdType (\ s a -> s{_mrdType = a})
9698
@@ -121,110 +123,12 @@ instance ToJSON MonitoredResourceDescriptor where
121123 ("type" .=) <$> _mrdType,
122124 ("description" .=) <$> _mrdDescription])
123125
124−-- | The \`Status\` type defines a logical error model that is suitable for
125−-- different programming environments, including REST APIs and RPC APIs. It
126−-- is used by [gRPC](https:\/\/github.com\/grpc). The error model is
127−-- designed to be: - Simple to use and understand for most users - Flexible
128−-- enough to meet unexpected needs # Overview The \`Status\` message
129−-- contains three pieces of data: error code, error message, and error
130−-- details. The error code should be an enum value of google.rpc.Code, but
131−-- it may accept additional error codes if needed. The error message should
132−-- be a developer-facing English message that helps developers *understand*
133−-- and *resolve* the error. If a localized user-facing error message is
134−-- needed, put the localized message in the error details or localize it in
135−-- the client. The optional error details may contain arbitrary information
136−-- about the error. There is a predefined set of error detail types in the
137−-- package \`google.rpc\` which can be used for common error conditions. #
138−-- Language mapping The \`Status\` message is the logical representation of
139−-- the error model, but it is not necessarily the actual wire format. When
140−-- the \`Status\` message is exposed in different client libraries and
141−-- different wire protocols, it can be mapped differently. For example, it
142−-- will likely be mapped to some exceptions in Java, but more likely mapped
143−-- to some error codes in C. # Other uses The error model and the
144−-- \`Status\` message can be used in a variety of environments, either with
145−-- or without APIs, to provide a consistent developer experience across
146−-- different environments. Example uses of this error model include: -
147−-- Partial errors. If a service needs to return partial errors to the
148−-- client, it may embed the \`Status\` in the normal response to indicate
149−-- the partial errors. - Workflow errors. A typical workflow has multiple
150−-- steps. Each step may have a \`Status\` message for error reporting
151−-- purpose. - Batch operations. If a client uses batch request and batch
152−-- response, the \`Status\` message should be used directly inside batch
153−-- response, one for each error sub-response. - Asynchronous operations. If
154−-- an API call embeds asynchronous operation results in its response, the
155−-- status of those operations should be represented directly using the
156−-- \`Status\` message. - Logging. If some API errors are stored in logs,
157−-- the message \`Status\` could be used directly after any stripping needed
158−-- for security\/privacy reasons.
159−--
160−-- /See:/ 'status' smart constructor.
161−data Status = Status'
162− { _sDetails :: !(Maybe [StatusDetailsItem])
163− , _sCode :: !(Maybe (Textual Int32))
164− , _sMessage :: !(Maybe Text)
165− } deriving (Eq,Show,Data,Typeable,Generic)
166−
167−-- | Creates a value of 'Status' with the minimum fields required to make a request.
168−--
169−-- Use one of the following lenses to modify other fields as desired:
170−--
171−-- * 'sDetails'
172−--
173−-- * 'sCode'
174−--
175−-- * 'sMessage'
176−status
177− :: Status
178−status =
179− Status'
180− { _sDetails = Nothing
181− , _sCode = Nothing
182− , _sMessage = Nothing
183− }
184−
185−-- | A list of messages that carry the error details. There will be a common
186−-- set of message types for APIs to use.
187−sDetails :: Lens' Status [StatusDetailsItem]
188−sDetails
189− = lens _sDetails (\ s a -> s{_sDetails = a}) .
190− _Default
191− . _Coerce
192−
193−-- | The status code, which should be an enum value of google.rpc.Code.
194−sCode :: Lens' Status (Maybe Int32)
195−sCode
196− = lens _sCode (\ s a -> s{_sCode = a}) .
197− mapping _Coerce
198−
199−-- | A developer-facing error message, which should be in English. Any
200−-- user-facing error message should be localized and sent in the
201−-- google.rpc.Status.details field, or localized by the client.
202−sMessage :: Lens' Status (Maybe Text)
203−sMessage = lens _sMessage (\ s a -> s{_sMessage = a})
204−
205−instance FromJSON Status where
206− parseJSON
207− = withObject "Status"
208− (\ o ->
209− Status' <$>
210− (o .:? "details" .!= mempty) <*> (o .:? "code") <*>
211− (o .:? "message"))
212−
213−instance ToJSON Status where
214− toJSON Status'{..}
215− = object
216− (catMaybes
217− [("details" .=) <$> _sDetails,
218− ("code" .=) <$> _sCode,
219− ("message" .=) <$> _sMessage])
220−
221126-- | Result returned from \`ListLogEntries\`.
222127--
223128-- /See:/ 'listLogEntriesResponse' smart constructor.
224129data ListLogEntriesResponse = ListLogEntriesResponse'
225− { _llerNextPageToken :: !(Maybe Text)
226− , _llerEntries :: !(Maybe [LogEntry])
227− , _llerProjectIdErrors :: !(Maybe ListLogEntriesResponseProjectIdErrors)
130+ { _llerNextPageToken :: !(Maybe Text)
131+ , _llerEntries :: !(Maybe [LogEntry])
228132 } deriving (Eq,Show,Data,Typeable,Generic)
229133
230134-- | Creates a value of 'ListLogEntriesResponse' with the minimum fields required to make a request.
@@ -234,19 +138,16 @@ data ListLogEntriesResponse = ListLogEntriesResponse'
234138-- * 'llerNextPageToken'
235139--
236140-- * 'llerEntries'
237−--
238−-- * 'llerProjectIdErrors'
239141listLogEntriesResponse
240142 :: ListLogEntriesResponse
241143listLogEntriesResponse =
242144 ListLogEntriesResponse'
243145 { _llerNextPageToken = Nothing
244146 , _llerEntries = Nothing
245− , _llerProjectIdErrors = Nothing
246147 }
247148
248−-- | If there are more results than were returned, then \`nextPageToken\` is
249−-- included in the response. To get the next set of results, call this
149+-- | If there might be more results than appear in this response, then
150+-- \`nextPageToken\` is included. To get the next set of results, call this
250151-- method again using the value of \`nextPageToken\` as \`pageToken\`.
251152llerNextPageToken :: Lens' ListLogEntriesResponse (Maybe Text)
252153llerNextPageToken
@@ -260,29 +161,20 @@ llerEntries
260161 _Default
261162 . _Coerce
262163
263−-- | If partial_success is true, contains the project ids that had errors and
264−-- the associated errors.
265−llerProjectIdErrors :: Lens' ListLogEntriesResponse (Maybe ListLogEntriesResponseProjectIdErrors)
266−llerProjectIdErrors
267− = lens _llerProjectIdErrors
268− (\ s a -> s{_llerProjectIdErrors = a})
269−
270164instance FromJSON ListLogEntriesResponse where
271165 parseJSON
272166 = withObject "ListLogEntriesResponse"
273167 (\ o ->
274168 ListLogEntriesResponse' <$>
275169 (o .:? "nextPageToken") <*>
276− (o .:? "entries" .!= mempty)
277− <*> (o .:? "projectIdErrors"))
170+ (o .:? "entries" .!= mempty))
278171
279172instance ToJSON ListLogEntriesResponse where
280173 toJSON ListLogEntriesResponse'{..}
281174 = object
282175 (catMaybes
283176 [("nextPageToken" .=) <$> _llerNextPageToken,
284− ("entries" .=) <$> _llerEntries,
285− ("projectIdErrors" .=) <$> _llerProjectIdErrors])
177+ ("entries" .=) <$> _llerEntries])
286178
287179-- | Required. Values for all of the labels listed in the associated
288180-- monitored resource descriptor. For example, Cloud SQL databases use the
@@ -350,8 +242,8 @@ llmrMetrics
350242 _Default
351243 . _Coerce
352244
353−-- | If there are more results than were returned, then \`nextPageToken\` is
354−-- included in the response. To get the next set of results, call this
245+-- | If there might be more results than appear in this response, then
246+-- \`nextPageToken\` is included. To get the next set of results, call this
355247-- method again using the value of \`nextPageToken\` as \`pageToken\`.
356248llmrNextPageToken :: Lens' ListLogMetricsResponse (Maybe Text)
357249llmrNextPageToken
@@ -408,8 +300,13 @@ writeLogEntriesRequest =
408300 , _wlerLogName = Nothing
409301 }
410302
411−-- | Required. The log entries to write. The log entries must have values for
412−-- all required fields.
303+-- | Required. The log entries to write. Values supplied for the fields
304+-- \`log_name\`, \`resource\`, and \`labels\` in this \`entries.write\`
305+-- request are added to those log entries that do not provide their own
306+-- values for the fields. To improve throughput and to avoid exceeding the
307+-- [quota limit](\/logging\/quota-policy) for calls to \`entries.write\`,
308+-- you should write multiple log entries at once rather than calling this
309+-- method for each individual log entry.
413310wlerEntries :: Lens' WriteLogEntriesRequest [LogEntry]
414311wlerEntries
415312 = lens _wlerEntries (\ s a -> s{_wlerEntries = a}) .
@@ -426,23 +323,26 @@ wlerPartialSuccess
426323 = lens _wlerPartialSuccess
427324 (\ s a -> s{_wlerPartialSuccess = a})
428325
429−-- | Optional. A default monitored resource for those log entries in
430−-- \`entries\` that do not specify their own \`resource\`.
326+-- | Optional. A default monitored resource object that is assigned to all
327+-- log entries in \`entries\` that do not specify a value for \`resource\`.
328+-- Example: { \"type\": \"gce_instance\", \"labels\": { \"zone\":
329+-- \"us-central1-a\", \"instance_id\": \"00000000000000000000\" }} See
330+-- LogEntry.
431331wlerResource :: Lens' WriteLogEntriesRequest (Maybe MonitoredResource)
432332wlerResource
433333 = lens _wlerResource (\ s a -> s{_wlerResource = a})
434334
435−-- | Optional. User-defined \`key:value\` items that are added to the
436−-- \`labels\` field of each log entry in \`entries\`, except when a log
437−-- entry specifies its own \`key:value\` item with the same key. Example:
438−-- \`{ \"size\": \"large\", \"color\":\"red\" }\`
335+-- | Optional. Default labels that are added to the \`labels\` field of all
336+-- log entries in \`entries\`. If a log entry already has a label with the
337+-- same key as a label in this parameter, then the log entry\'s label is
338+-- not changed. See LogEntry.
439339wlerLabels :: Lens' WriteLogEntriesRequest (Maybe WriteLogEntriesRequestLabels)
440340wlerLabels
441341 = lens _wlerLabels (\ s a -> s{_wlerLabels = a})
442342
443−-- | Optional. A default log resource name for those log entries in
444−-- \`entries\` that do not specify their own \`logName\`. Example:
445−-- \`\"projects\/my-project\/logs\/syslog\"\`. See LogEntry.
343+-- | Optional. A default log resource name that is assigned to all log
344+-- entries in \`entries\` that do not specify a value for \`log_name\`.
345+-- Example: \`\"projects\/my-project\/logs\/syslog\"\`. See LogEntry.
446346wlerLogName :: Lens' WriteLogEntriesRequest (Maybe Text)
447347wlerLogName
448348 = lens _wlerLogName (\ s a -> s{_wlerLogName = a})
@@ -555,9 +455,9 @@ lsrSinks
555455 _Default
556456 . _Coerce
557457
558−-- | If there are more results than were returned, then \`nextPageToken\` is
559−-- included in the response. To get the next set of results, call this
560−-- method again using the value of \`nextPageToken\` as \`pageToken\`.
458+-- | If there might be more results than appear in this response, then
459+-- \`nextPageToken\` is included. To get the next set of results, call the
460+-- same method again using the value of \`nextPageToken\` as \`pageToken\`.
561461lsrNextPageToken :: Lens' ListSinksResponse (Maybe Text)
562462lsrNextPageToken
563463 = lens _lsrNextPageToken
@@ -592,11 +492,11 @@ data RequestLog = RequestLog'
592492 , _rlVersionId :: !(Maybe Text)
593493 , _rlHTTPVersion :: !(Maybe Text)
594494 , _rlTaskName :: !(Maybe Text)
595− , _rlPendingTime :: !(Maybe Text)
495+ , _rlPendingTime :: !(Maybe Duration)
596496 , _rlWasLoadingRequest :: !(Maybe Bool)
597497 , _rlFirst :: !(Maybe Bool)
598− , _rlStartTime :: !(Maybe Text)
599− , _rlLatency :: !(Maybe Text)
498+ , _rlStartTime :: !(Maybe DateTime')
499+ , _rlLatency :: !(Maybe Duration)
600500 , _rlURLMapEntry :: !(Maybe Text)
601501 , _rlCost :: !(Maybe (Textual Double))
602502 , _rlReferrer :: !(Maybe Text)
@@ -605,7 +505,7 @@ data RequestLog = RequestLog'
605505 , _rlAppId :: !(Maybe Text)
606506 , _rlMethod :: !(Maybe Text)
607507 , _rlResource :: !(Maybe Text)
608− , _rlEndTime :: !(Maybe Text)
508+ , _rlEndTime :: !(Maybe DateTime')
609509 , _rlFinished :: !(Maybe Bool)
610510 , _rlMegaCycles :: !(Maybe (Textual Int64))
611511 , _rlUserAgent :: !(Maybe Text)
@@ -776,10 +676,11 @@ rlTaskName
776676 = lens _rlTaskName (\ s a -> s{_rlTaskName = a})
777677
778678-- | Time this request spent in the pending request queue.
779−rlPendingTime :: Lens' RequestLog (Maybe Text)
679+rlPendingTime :: Lens' RequestLog (Maybe Scientific)
780680rlPendingTime
781681 = lens _rlPendingTime
782682 (\ s a -> s{_rlPendingTime = a})
683+ . mapping _Duration
783684
784685-- | Whether this was a loading request for the instance.
785686rlWasLoadingRequest :: Lens' RequestLog (Maybe Bool)
@@ -794,14 +695,16 @@ rlFirst :: Lens' RequestLog (Maybe Bool)
794695rlFirst = lens _rlFirst (\ s a -> s{_rlFirst = a})
795696
796697-- | Time when the request started.
797−rlStartTime :: Lens' RequestLog (Maybe Text)
698+rlStartTime :: Lens' RequestLog (Maybe UTCTime)
798699rlStartTime
799− = lens _rlStartTime (\ s a -> s{_rlStartTime = a})
700+ = lens _rlStartTime (\ s a -> s{_rlStartTime = a}) .
701+ mapping _DateTime
800702
801703-- | Latency of the request.
802−rlLatency :: Lens' RequestLog (Maybe Text)
704+rlLatency :: Lens' RequestLog (Maybe Scientific)
803705rlLatency
804− = lens _rlLatency (\ s a -> s{_rlLatency = a})
706+ = lens _rlLatency (\ s a -> s{_rlLatency = a}) .
707+ mapping _Duration
805708
806709-- | File or class that handled the request.
807710rlURLMapEntry :: Lens' RequestLog (Maybe Text)
@@ -849,9 +752,10 @@ rlResource
849752 = lens _rlResource (\ s a -> s{_rlResource = a})
850753
851754-- | Time when the request finished.
852−rlEndTime :: Lens' RequestLog (Maybe Text)
755+rlEndTime :: Lens' RequestLog (Maybe UTCTime)
853756rlEndTime
854− = lens _rlEndTime (\ s a -> s{_rlEndTime = a})
757+ = lens _rlEndTime (\ s a -> s{_rlEndTime = a}) .
758+ mapping _DateTime
855759
856760-- | Whether this request is finished or active.
857761rlFinished :: Lens' RequestLog (Maybe Bool)
@@ -985,8 +889,8 @@ instance ToJSON RequestLog where
985889 ("sourceReference" .=) <$> _rlSourceReference,
986890 ("appEngineRelease" .=) <$> _rlAppEngineRelease])
987891
988−-- | The log entry payload, represented as a protocol buffer. You can only
989−-- use \`protoPayload\` values that belong to a set of approved types.
892+-- | The log entry payload, represented as a protocol buffer. Some Google
893+-- Cloud Platform services use this field for their log entry payloads.
990894--
991895-- /See:/ 'logEntryProtoPayload' smart constructor.
992896newtype LogEntryProtoPayload = LogEntryProtoPayload'
@@ -1006,7 +910,7 @@ logEntryProtoPayload pLeppAddtional_ =
1006910 { _leppAddtional = _Coerce # pLeppAddtional_
1007911 }
1008912
1009−-- | Properties of the object. Contains field \'ype with type URL.
913+-- | Properties of the object. Contains field \'type with type URL.
1010914leppAddtional :: Lens' LogEntryProtoPayload (HashMap Text JSONValue)
1011915leppAddtional
1012916 = lens _leppAddtional
@@ -1043,13 +947,17 @@ instance FromJSON WriteLogEntriesResponse where
1043947instance ToJSON WriteLogEntriesResponse where
1044948 toJSON = const emptyObject
1045949
1046−-- | Describes a sink used to export log entries outside Cloud Logging.
950+-- | Describes a sink used to export log entries outside of Stackdriver
951+-- Logging.
1047952--
1048953-- /See:/ 'logSink' smart constructor.
1049954data LogSink = LogSink'
1050955 { _lsDestination :: !(Maybe Text)
1051− , _lsOutputVersionFormat :: !(Maybe Text)
956+ , _lsStartTime :: !(Maybe DateTime')
957+ , _lsOutputVersionFormat :: !(Maybe LogSinkOutputVersionFormat)
958+ , _lsWriterIdentity :: !(Maybe Text)
1052959 , _lsName :: !(Maybe Text)
960+ , _lsEndTime :: !(Maybe DateTime')
1053961 , _lsFilter :: !(Maybe Text)
1054962 } deriving (Eq,Show,Data,Typeable,Generic)
1055963
@@ -1059,52 +967,93 @@ data LogSink = LogSink'
1059967--
1060968-- * 'lsDestination'
1061969--
970+-- * 'lsStartTime'
971+--
1062972-- * 'lsOutputVersionFormat'
1063973--
974+-- * 'lsWriterIdentity'
975+--
1064976-- * 'lsName'
1065977--
978+-- * 'lsEndTime'
979+--
1066980-- * 'lsFilter'
1067981logSink
1068982 :: LogSink
1069983logSink =
1070984 LogSink'
1071985 { _lsDestination = Nothing
986+ , _lsStartTime = Nothing
1072987 , _lsOutputVersionFormat = Nothing
988+ , _lsWriterIdentity = Nothing
1073989 , _lsName = Nothing
990+ , _lsEndTime = Nothing
1074991 , _lsFilter = Nothing
1075992 }
1076993
1077−-- | The export destination. See [Exporting Logs With
994+-- | Required. The export destination. See [Exporting Logs With
1078995-- Sinks](\/logging\/docs\/api\/tasks\/exporting-logs). Examples:
1079−-- \`\"storage.googleapis.com\/a-bucket\"\`,
1080−-- \`\"bigquery.googleapis.com\/projects\/a-project-id\/datasets\/a-dataset\"\`.
996+-- \"storage.googleapis.com\/my-gcs-bucket\"
997+-- \"bigquery.googleapis.com\/projects\/my-project-id\/datasets\/my-dataset\"
998+-- \"pubsub.googleapis.com\/projects\/my-project\/topics\/my-topic\"
1081999lsDestination :: Lens' LogSink (Maybe Text)
10821000lsDestination
10831001 = lens _lsDestination
10841002 (\ s a -> s{_lsDestination = a})
10851003
1086−-- | The log entry version to use for this sink\'s exported log entries. This
1087−-- version does not have to correspond to the version of the log entry when
1088−-- it was written to Cloud Logging.
1089−lsOutputVersionFormat :: Lens' LogSink (Maybe Text)
1004+-- | Optional. Time range for which this sink is active. Logs are exported
1005+-- only if start_time \<= entry.timestamp \< end_time Both start_time and
1006+-- end_time may be omitted to specify (half) infinite ranges. The
1007+-- start_time must be less than the end_time.
1008+lsStartTime :: Lens' LogSink (Maybe UTCTime)
1009+lsStartTime
1010+ = lens _lsStartTime (\ s a -> s{_lsStartTime = a}) .
1011+ mapping _DateTime
1012+
1013+-- | Optional. The log entry version to use for this sink\'s exported log
1014+-- entries. This version does not have to correspond to the version of the
1015+-- log entry that was written to Stackdriver Logging. If omitted, the v2
1016+-- format is used.
1017+lsOutputVersionFormat :: Lens' LogSink (Maybe LogSinkOutputVersionFormat)
10901018lsOutputVersionFormat
10911019 = lens _lsOutputVersionFormat
10921020 (\ s a -> s{_lsOutputVersionFormat = a})
10931021
1094−-- | Required. The client-assigned sink identifier. Example:
1095−-- \`\"my-severe-errors-to-pubsub\"\`. Sink identifiers are limited to 1000
1096−-- characters and can include only the following characters: \`A-Z\`,
1097−-- \`a-z\`, \`0-9\`, and the special characters \`_-.\`.
1022+-- | Output only. The IAM identity to which the destination needs to grant
1023+-- write access. This may be a service account or a group. Examples (Do not
1024+-- assume these specific values):
1025+-- \"serviceAccount:cloud-logs\'system.gserviceaccount.com\"
1026+-- \"group:cloud-logs\'google.com\" For GCS destinations, the role
1027+-- \"roles\/owner\" is required on the bucket For Cloud Pubsub
1028+-- destinations, the role \"roles\/pubsub.publisher\" is required on the
1029+-- topic For BigQuery, the role \"roles\/editor\" is required on the
1030+-- dataset
1031+lsWriterIdentity :: Lens' LogSink (Maybe Text)
1032+lsWriterIdentity
1033+ = lens _lsWriterIdentity
1034+ (\ s a -> s{_lsWriterIdentity = a})
1035+
1036+-- | Required. The client-assigned sink identifier, unique within the
1037+-- project. Example: \`\"my-syslog-errors-to-pubsub\"\`. Sink identifiers
1038+-- are limited to 1000 characters and can include only the following
1039+-- characters: \`A-Z\`, \`a-z\`, \`0-9\`, and the special characters
1040+-- \`_-.\`. The maximum length of the name is 100 characters.
10981041lsName :: Lens' LogSink (Maybe Text)
10991042lsName = lens _lsName (\ s a -> s{_lsName = a})
11001043
1101−-- | An [advanced logs filter](\/logging\/docs\/view\/advanced_filters). Only
1102−-- log entries matching that filter are exported. The filter must be
1103−-- consistent with the log entry format specified by the
1104−-- \`outputVersionFormat\` parameter, regardless of the format of the log
1105−-- entry that was originally written to Cloud Logging. Example (V2 format):
1106−-- \`\"logName=projects\/my-projectid\/logs\/syslog AND
1107−-- severity>=ERROR\"\`.
1044+-- | Optional. Time at which this sink expires.
1045+lsEndTime :: Lens' LogSink (Maybe UTCTime)
1046+lsEndTime
1047+ = lens _lsEndTime (\ s a -> s{_lsEndTime = a}) .
1048+ mapping _DateTime
1049+
1050+-- | Optional. An [advanced logs
1051+-- filter](\/logging\/docs\/view\/advanced_filters). Only log entries
1052+-- matching the filter are exported. The filter must be consistent with the
1053+-- log entry format specified by the \`outputVersionFormat\` parameter,
1054+-- regardless of the format of the log entry that was originally written to
1055+-- Stackdriver Logging. Example filter (V2 format):
1056+-- logName=projects\/my-projectid\/logs\/syslog AND severity>=ERROR
11081057lsFilter :: Lens' LogSink (Maybe Text)
11091058lsFilter = lens _lsFilter (\ s a -> s{_lsFilter = a})
11101059
@@ -1113,9 +1062,11 @@ instance FromJSON LogSink where
11131062 = withObject "LogSink"
11141063 (\ o ->
11151064 LogSink' <$>
1116− (o .:? "destination") <*>
1065+ (o .:? "destination") <*> (o .:? "startTime") <*>
11171066 (o .:? "outputVersionFormat")
1067+ <*> (o .:? "writerIdentity")
11181068 <*> (o .:? "name")
1069+ <*> (o .:? "endTime")
11191070 <*> (o .:? "filter"))
11201071
11211072instance ToJSON LogSink where
@@ -1123,44 +1074,14 @@ instance ToJSON LogSink where
11231074 = object
11241075 (catMaybes
11251076 [("destination" .=) <$> _lsDestination,
1077+ ("startTime" .=) <$> _lsStartTime,
11261078 ("outputVersionFormat" .=) <$>
11271079 _lsOutputVersionFormat,
1080+ ("writerIdentity" .=) <$> _lsWriterIdentity,
11281081 ("name" .=) <$> _lsName,
1082+ ("endTime" .=) <$> _lsEndTime,
11291083 ("filter" .=) <$> _lsFilter])
11301084
1131−--
1132−-- /See:/ 'statusDetailsItem' smart constructor.
1133−newtype StatusDetailsItem = StatusDetailsItem'
1134− { _sdiAddtional :: HashMap Text JSONValue
1135− } deriving (Eq,Show,Data,Typeable,Generic)
1136−
1137−-- | Creates a value of 'StatusDetailsItem' with the minimum fields required to make a request.
1138−--
1139−-- Use one of the following lenses to modify other fields as desired:
1140−--
1141−-- * 'sdiAddtional'
1142−statusDetailsItem
1143− :: HashMap Text JSONValue -- ^ 'sdiAddtional'
1144− -> StatusDetailsItem
1145−statusDetailsItem pSdiAddtional_ =
1146− StatusDetailsItem'
1147− { _sdiAddtional = _Coerce # pSdiAddtional_
1148− }
1149−
1150−-- | Properties of the object. Contains field \'ype with type URL.
1151−sdiAddtional :: Lens' StatusDetailsItem (HashMap Text JSONValue)
1152−sdiAddtional
1153− = lens _sdiAddtional (\ s a -> s{_sdiAddtional = a})
1154− . _Coerce
1155−
1156−instance FromJSON StatusDetailsItem where
1157− parseJSON
1158− = withObject "StatusDetailsItem"
1159− (\ o -> StatusDetailsItem' <$> (parseJSONObject o))
1160−
1161−instance ToJSON StatusDetailsItem where
1162− toJSON = toJSON . _sdiAddtional
1163−
11641085-- | Result returned from ListMonitoredResourceDescriptors.
11651086--
11661087-- /See:/ 'listMonitoredResourceDescriptorsResponse' smart constructor.
@@ -1184,8 +1105,8 @@ listMonitoredResourceDescriptorsResponse =
11841105 , _lmrdrResourceDescriptors = Nothing
11851106 }
11861107
1187−-- | If there are more results than were returned, then \`nextPageToken\` is
1188−-- included in the response. To get the next set of results, call this
1108+-- | If there might be more results than appear in this response, then
1109+-- \`nextPageToken\` is included. To get the next set of results, call this
11891110-- method again using the value of \`nextPageToken\` as \`pageToken\`.
11901111lmrdrNextPageToken :: Lens' ListMonitoredResourceDescriptorsResponse (Maybe Text)
11911112lmrdrNextPageToken
@@ -1219,7 +1140,9 @@ instance ToJSON
12191140 ("resourceDescriptors" .=) <$>
12201141 _lmrdrResourceDescriptors])
12211142
1222−-- | A common proto for logging HTTP requests.
1143+-- | A common proto for logging HTTP requests. Only contains semantics
1144+-- defined by the HTTP specification. Product-specific logging information
1145+-- MUST be defined in a separate message.
12231146--
12241147-- /See:/ 'hTTPRequest' smart constructor.
12251148data HTTPRequest = HTTPRequest'
@@ -1227,6 +1150,8 @@ data HTTPRequest = HTTPRequest'
12271150 , _httprRequestURL :: !(Maybe Text)
12281151 , _httprCacheFillBytes :: !(Maybe (Textual Int64))
12291152 , _httprRemoteIP :: !(Maybe Text)
1153+ , _httprLatency :: !(Maybe Duration)
1154+ , _httprServerIP :: !(Maybe Text)
12301155 , _httprRequestSize :: !(Maybe (Textual Int64))
12311156 , _httprCacheValidatedWithOriginServer :: !(Maybe Bool)
12321157 , _httprUserAgent :: !(Maybe Text)
@@ -1249,6 +1174,10 @@ data HTTPRequest = HTTPRequest'
12491174--
12501175-- * 'httprRemoteIP'
12511176--
1177+-- * 'httprLatency'
1178+--
1179+-- * 'httprServerIP'
1180+--
12521181-- * 'httprRequestSize'
12531182--
12541183-- * 'httprCacheValidatedWithOriginServer'
@@ -1272,6 +1201,8 @@ hTTPRequest =
12721201 , _httprRequestURL = Nothing
12731202 , _httprCacheFillBytes = Nothing
12741203 , _httprRemoteIP = Nothing
1204+ , _httprLatency = Nothing
1205+ , _httprServerIP = Nothing
12751206 , _httprRequestSize = Nothing
12761207 , _httprCacheValidatedWithOriginServer = Nothing
12771208 , _httprUserAgent = Nothing
@@ -1312,6 +1243,20 @@ httprRemoteIP
13121243 = lens _httprRemoteIP
13131244 (\ s a -> s{_httprRemoteIP = a})
13141245
1246+-- | The request processing latency on the server, from the time the request
1247+-- was received until the response was sent.
1248+httprLatency :: Lens' HTTPRequest (Maybe Scientific)
1249+httprLatency
1250+ = lens _httprLatency (\ s a -> s{_httprLatency = a})
1251+ . mapping _Duration
1252+
1253+-- | The IP address (IPv4 or IPv6) of the origin server that the request was
1254+-- sent to.
1255+httprServerIP :: Lens' HTTPRequest (Maybe Text)
1256+httprServerIP
1257+ = lens _httprServerIP
1258+ (\ s a -> s{_httprServerIP = a})
1259+
13151260-- | The size of the HTTP request message in bytes, including the request
13161261-- headers and the request body.
13171262httprRequestSize :: Lens' HTTPRequest (Maybe Int64)
@@ -1378,6 +1323,8 @@ instance FromJSON HTTPRequest where
13781323 (o .:? "status") <*> (o .:? "requestUrl") <*>
13791324 (o .:? "cacheFillBytes")
13801325 <*> (o .:? "remoteIp")
1326+ <*> (o .:? "latency")
1327+ <*> (o .:? "serverIp")
13811328 <*> (o .:? "requestSize")
13821329 <*> (o .:? "cacheValidatedWithOriginServer")
13831330 <*> (o .:? "userAgent")
@@ -1395,6 +1342,8 @@ instance ToJSON HTTPRequest where
13951342 ("requestUrl" .=) <$> _httprRequestURL,
13961343 ("cacheFillBytes" .=) <$> _httprCacheFillBytes,
13971344 ("remoteIp" .=) <$> _httprRemoteIP,
1345+ ("latency" .=) <$> _httprLatency,
1346+ ("serverIp" .=) <$> _httprServerIP,
13981347 ("requestSize" .=) <$> _httprRequestSize,
13991348 ("cacheValidatedWithOriginServer" .=) <$>
14001349 _httprCacheValidatedWithOriginServer,
@@ -1405,49 +1354,10 @@ instance ToJSON HTTPRequest where
14051354 ("cacheHit" .=) <$> _httprCacheHit,
14061355 ("referer" .=) <$> _httprReferer])
14071356
1408−-- | If partial_success is true, contains the project ids that had errors and
1409−-- the associated errors.
1410−--
1411−-- /See:/ 'listLogEntriesResponseProjectIdErrors' smart constructor.
1412−newtype ListLogEntriesResponseProjectIdErrors = ListLogEntriesResponseProjectIdErrors'
1413− { _llerpieAddtional :: HashMap Text Status
1414− } deriving (Eq,Show,Data,Typeable,Generic)
1415−
1416−-- | Creates a value of 'ListLogEntriesResponseProjectIdErrors' with the minimum fields required to make a request.
1417−--
1418−-- Use one of the following lenses to modify other fields as desired:
1419−--
1420−-- * 'llerpieAddtional'
1421−listLogEntriesResponseProjectIdErrors
1422− :: HashMap Text Status -- ^ 'llerpieAddtional'
1423− -> ListLogEntriesResponseProjectIdErrors
1424−listLogEntriesResponseProjectIdErrors pLlerpieAddtional_ =
1425− ListLogEntriesResponseProjectIdErrors'
1426− { _llerpieAddtional = _Coerce # pLlerpieAddtional_
1427− }
1428−
1429−llerpieAddtional :: Lens' ListLogEntriesResponseProjectIdErrors (HashMap Text Status)
1430−llerpieAddtional
1431− = lens _llerpieAddtional
1432− (\ s a -> s{_llerpieAddtional = a})
1433− . _Coerce
1434−
1435−instance FromJSON
1436− ListLogEntriesResponseProjectIdErrors where
1437− parseJSON
1438− = withObject "ListLogEntriesResponseProjectIdErrors"
1439− (\ o ->
1440− ListLogEntriesResponseProjectIdErrors' <$>
1441− (parseJSONObject o))
1442−
1443−instance ToJSON ListLogEntriesResponseProjectIdErrors
1444− where
1445− toJSON = toJSON . _llerpieAddtional
1446−
1447−-- | Optional. User-defined \`key:value\` items that are added to the
1448−-- \`labels\` field of each log entry in \`entries\`, except when a log
1449−-- entry specifies its own \`key:value\` item with the same key. Example:
1450−-- \`{ \"size\": \"large\", \"color\":\"red\" }\`
1357+-- | Optional. Default labels that are added to the \`labels\` field of all
1358+-- log entries in \`entries\`. If a log entry already has a label with the
1359+-- same key as a label in this parameter, then the log entry\'s label is
1360+-- not changed. See LogEntry.
14511361--
14521362-- /See:/ 'writeLogEntriesRequestLabels' smart constructor.
14531363newtype WriteLogEntriesRequestLabels = WriteLogEntriesRequestLabels'
@@ -1493,7 +1403,7 @@ instance ToJSON WriteLogEntriesRequestLabels where
14931403-- following object, because the MonitoredResourceDescriptor for
14941404-- \`\"gce_instance\"\` has labels \`\"instance_id\"\` and \`\"zone\"\`: {
14951405-- \"type\": \"gce_instance\", \"labels\": { \"instance_id\":
1496−-- \"my-instance\", \"zone\": \"us-central1-a\" }}
1406+-- \"12345678901234\", \"zone\": \"us-central1-a\" }}
14971407--
14981408-- /See:/ 'monitoredResource' smart constructor.
14991409data MonitoredResource = MonitoredResource'
@@ -1546,8 +1456,8 @@ instance ToJSON MonitoredResource where
15461456--
15471457-- /See:/ 'logLine' smart constructor.
15481458data LogLine = LogLine'
1549− { _llTime :: !(Maybe Text)
1550− , _llSeverity :: !(Maybe Text)
1459+ { _llTime :: !(Maybe DateTime')
1460+ , _llSeverity :: !(Maybe LogLineSeverity)
15511461 , _llLogMessage :: !(Maybe Text)
15521462 , _llSourceLocation :: !(Maybe SourceLocation)
15531463 } deriving (Eq,Show,Data,Typeable,Generic)
@@ -1574,11 +1484,13 @@ logLine =
15741484 }
15751485
15761486-- | Approximate time when this log entry was made.
1577−llTime :: Lens' LogLine (Maybe Text)
1578−llTime = lens _llTime (\ s a -> s{_llTime = a})
1487+llTime :: Lens' LogLine (Maybe UTCTime)
1488+llTime
1489+ = lens _llTime (\ s a -> s{_llTime = a}) .
1490+ mapping _DateTime
15791491
15801492-- | Severity of this log entry.
1581−llSeverity :: Lens' LogLine (Maybe Text)
1493+llSeverity :: Lens' LogLine (Maybe LogLineSeverity)
15821494llSeverity
15831495 = lens _llSeverity (\ s a -> s{_llSeverity = a})
15841496
@@ -1616,7 +1528,7 @@ instance ToJSON LogLine where
16161528-- /See:/ 'labelDescriptor' smart constructor.
16171529data LabelDescriptor = LabelDescriptor'
16181530 { _ldKey :: !(Maybe Text)
1619− , _ldValueType :: !(Maybe Text)
1531+ , _ldValueType :: !(Maybe LabelDescriptorValueType)
16201532 , _ldDescription :: !(Maybe Text)
16211533 } deriving (Eq,Show,Data,Typeable,Generic)
16221534
@@ -1643,7 +1555,7 @@ ldKey :: Lens' LabelDescriptor (Maybe Text)
16431555ldKey = lens _ldKey (\ s a -> s{_ldKey = a})
16441556
16451557-- | The type of data that can be assigned to the label.
1646−ldValueType :: Lens' LabelDescriptor (Maybe Text)
1558+ldValueType :: Lens' LabelDescriptor (Maybe LabelDescriptorValueType)
16471559ldValueType
16481560 = lens _ldValueType (\ s a -> s{_ldValueType = a})
16491561
@@ -1673,12 +1585,12 @@ instance ToJSON LabelDescriptor where
16731585--
16741586-- /See:/ 'listLogEntriesRequest' smart constructor.
16751587data ListLogEntriesRequest = ListLogEntriesRequest'
1676− { _llerOrderBy :: !(Maybe Text)
1677− , _llerPartialSuccess :: !(Maybe Bool)
1678− , _llerProjectIds :: !(Maybe [Text])
1679− , _llerFilter :: !(Maybe Text)
1680− , _llerPageToken :: !(Maybe Text)
1681− , _llerPageSize :: !(Maybe (Textual Int32))
1588+ { _llerOrderBy :: !(Maybe Text)
1589+ , _llerProjectIds :: !(Maybe [Text])
1590+ , _llerFilter :: !(Maybe Text)
1591+ , _llerPageToken :: !(Maybe Text)
1592+ , _llerPageSize :: !(Maybe (Textual Int32))
1593+ , _llerResourceNames :: !(Maybe [Text])
16821594 } deriving (Eq,Show,Data,Typeable,Generic)
16831595
16841596-- | Creates a value of 'ListLogEntriesRequest' with the minimum fields required to make a request.
@@ -1687,8 +1599,6 @@ data ListLogEntriesRequest = ListLogEntriesRequest'
16871599--
16881600-- * 'llerOrderBy'
16891601--
1690−-- * 'llerPartialSuccess'
1691−--
16921602-- * 'llerProjectIds'
16931603--
16941604-- * 'llerFilter'
@@ -1696,16 +1606,18 @@ data ListLogEntriesRequest = ListLogEntriesRequest'
16961606-- * 'llerPageToken'
16971607--
16981608-- * 'llerPageSize'
1609+--
1610+-- * 'llerResourceNames'
16991611listLogEntriesRequest
17001612 :: ListLogEntriesRequest
17011613listLogEntriesRequest =
17021614 ListLogEntriesRequest'
17031615 { _llerOrderBy = Nothing
1704− , _llerPartialSuccess = Nothing
17051616 , _llerProjectIds = Nothing
17061617 , _llerFilter = Nothing
17071618 , _llerPageToken = Nothing
17081619 , _llerPageSize = Nothing
1620+ , _llerResourceNames = Nothing
17091621 }
17101622
17111623-- | Optional. How the results should be sorted. Presently, the only
@@ -1718,17 +1630,12 @@ llerOrderBy :: Lens' ListLogEntriesRequest (Maybe Text)
17181630llerOrderBy
17191631 = lens _llerOrderBy (\ s a -> s{_llerOrderBy = a})
17201632
1721−-- | Optional. If true, read access to all projects is not required and
1722−-- results will be returned for the subset of projects for which read
1723−-- access is permitted (empty subset is permitted).
1724−llerPartialSuccess :: Lens' ListLogEntriesRequest (Maybe Bool)
1725−llerPartialSuccess
1726− = lens _llerPartialSuccess
1727− (\ s a -> s{_llerPartialSuccess = a})
1728−
1729−-- | Required. One or more project IDs or project numbers from which to
1730−-- retrieve log entries. Examples of a project ID: \`\"my-project-1A\"\`,
1731−-- \`\"1234567890\"\`.
1633+-- | Deprecated. One or more project identifiers or project numbers from
1634+-- which to retrieve log entries. Examples: \`\"my-project-1A\"\`,
1635+-- \`\"1234567890\"\`. If present, these project identifiers are converted
1636+-- to resource format and added to the list of resources in
1637+-- \`resourceNames\`. Callers should use \`resourceNames\` rather than this
1638+-- parameter.
17321639llerProjectIds :: Lens' ListLogEntriesRequest [Text]
17331640llerProjectIds
17341641 = lens _llerProjectIds
@@ -1736,56 +1643,63 @@ llerProjectIds
17361643 . _Default
17371644 . _Coerce
17381645
1739−-- | Optional. An [advanced logs
1740−-- filter](\/logging\/docs\/view\/advanced_filters). The filter is compared
1741−-- against all log entries in the projects specified by \`projectIds\`.
1742−-- Only entries that match the filter are retrieved. An empty filter
1743−-- matches all log entries.
1646+-- | Optional. A filter that chooses which log entries to return. See
1647+-- [Advanced Logs Filters](\/logging\/docs\/view\/advanced_filters). Only
1648+-- log entries that match the filter are returned. An empty filter matches
1649+-- all log entries.
17441650llerFilter :: Lens' ListLogEntriesRequest (Maybe Text)
17451651llerFilter
17461652 = lens _llerFilter (\ s a -> s{_llerFilter = a})
17471653
1748−-- | Optional. If the \`pageToken\` parameter is supplied, then the next page
1749−-- of results is retrieved. The \`pageToken\` parameter must be set to the
1750−-- value of the \`nextPageToken\` from the previous response. The values of
1751−-- \`projectIds\`, \`filter\`, and \`orderBy\` must be the same as in the
1752−-- previous request.
1654+-- | Optional. If present, then retrieve the next batch of results from the
1655+-- preceding call to this method. \`pageToken\` must be the value of
1656+-- \`nextPageToken\` from the previous response. The values of other method
1657+-- parameters should be identical to those in the previous call.
17531658llerPageToken :: Lens' ListLogEntriesRequest (Maybe Text)
17541659llerPageToken
17551660 = lens _llerPageToken
17561661 (\ s a -> s{_llerPageToken = a})
17571662
1758−-- | Optional. The maximum number of results to return from this request. You
1759−-- must check for presence of \`nextPageToken\` to determine if additional
1760−-- results are available, which you can retrieve by passing the
1761−-- \`nextPageToken\` value as the \`pageToken\` parameter in the next
1762−-- request.
1663+-- | Optional. The maximum number of results to return from this request.
1664+-- Non-positive values are ignored. The presence of \`nextPageToken\` in
1665+-- the response indicates that more results might be available.
17631666llerPageSize :: Lens' ListLogEntriesRequest (Maybe Int32)
17641667llerPageSize
17651668 = lens _llerPageSize (\ s a -> s{_llerPageSize = a})
17661669 . mapping _Coerce
17671670
1671+-- | Required. One or more cloud resources from which to retrieve log
1672+-- entries. Example: \`\"projects\/my-project-1A\"\`,
1673+-- \`\"projects\/1234567890\"\`. Projects listed in \`projectIds\` are
1674+-- added to this list.
1675+llerResourceNames :: Lens' ListLogEntriesRequest [Text]
1676+llerResourceNames
1677+ = lens _llerResourceNames
1678+ (\ s a -> s{_llerResourceNames = a})
1679+ . _Default
1680+ . _Coerce
1681+
17681682instance FromJSON ListLogEntriesRequest where
17691683 parseJSON
17701684 = withObject "ListLogEntriesRequest"
17711685 (\ o ->
17721686 ListLogEntriesRequest' <$>
1773− (o .:? "orderBy") <*> (o .:? "partialSuccess") <*>
1774− (o .:? "projectIds" .!= mempty)
1687+ (o .:? "orderBy") <*> (o .:? "projectIds" .!= mempty)
17751688 <*> (o .:? "filter")
17761689 <*> (o .:? "pageToken")
1777− <*> (o .:? "pageSize"))
1690+ <*> (o .:? "pageSize")
1691+ <*> (o .:? "resourceNames" .!= mempty))
17781692
17791693instance ToJSON ListLogEntriesRequest where
17801694 toJSON ListLogEntriesRequest'{..}
17811695 = object
17821696 (catMaybes
17831697 [("orderBy" .=) <$> _llerOrderBy,
1784− ("partialSuccess" .=) <$> _llerPartialSuccess,
17851698 ("projectIds" .=) <$> _llerProjectIds,
17861699 ("filter" .=) <$> _llerFilter,
17871700 ("pageToken" .=) <$> _llerPageToken,
1788− ("pageSize" .=) <$> _llerPageSize])
1701+ ("pageSize" .=) <$> _llerPageSize,
1702+ ("resourceNames" .=) <$> _llerResourceNames])
17891703
17901704-- | Additional information about a potentially long-running operation with
17911705-- which a log entry is associated.
@@ -1824,10 +1738,10 @@ logEntryOperation =
18241738leoFirst :: Lens' LogEntryOperation (Maybe Bool)
18251739leoFirst = lens _leoFirst (\ s a -> s{_leoFirst = a})
18261740
1827−-- | Required. An arbitrary producer identifier. The combination of \`id\`
1741+-- | Optional. An arbitrary producer identifier. The combination of \`id\`
18281742-- and \`producer\` must be globally unique. Examples for \`producer\`:
18291743-- \`\"MyDivision.MyBigCompany.com\"\`,
1830−-- \"github.com\/MyProject\/MyApplication\"\`.
1744+-- \`\"github.com\/MyProject\/MyApplication\"\`.
18311745leoProducer :: Lens' LogEntryOperation (Maybe Text)
18321746leoProducer
18331747 = lens _leoProducer (\ s a -> s{_leoProducer = a})
@@ -1837,7 +1751,7 @@ leoProducer
18371751leoLast :: Lens' LogEntryOperation (Maybe Bool)
18381752leoLast = lens _leoLast (\ s a -> s{_leoLast = a})
18391753
1840−-- | Required. An arbitrary operation identifier. Log entries with the same
1754+-- | Optional. An arbitrary operation identifier. Log entries with the same
18411755-- identifier are assumed to be part of the same operation.
18421756leoId :: Lens' LogEntryOperation (Maybe Text)
18431757leoId = lens _leoId (\ s a -> s{_leoId = a})
@@ -1865,6 +1779,7 @@ instance ToJSON LogEntryOperation where
18651779-- /See:/ 'logMetric' smart constructor.
18661780data LogMetric = LogMetric'
18671781 { _lmName :: !(Maybe Text)
1782+ , _lmVersion :: !(Maybe LogMetricVersion)
18681783 , _lmFilter :: !(Maybe Text)
18691784 , _lmDescription :: !(Maybe Text)
18701785 } deriving (Eq,Show,Data,Typeable,Generic)
@@ -1875,6 +1790,8 @@ data LogMetric = LogMetric'
18751790--
18761791-- * 'lmName'
18771792--
1793+-- * 'lmVersion'
1794+--
18781795-- * 'lmFilter'
18791796--
18801797-- * 'lmDescription'
@@ -1883,25 +1800,36 @@ logMetric
18831800logMetric =
18841801 LogMetric'
18851802 { _lmName = Nothing
1803+ , _lmVersion = Nothing
18861804 , _lmFilter = Nothing
18871805 , _lmDescription = Nothing
18881806 }
18891807
18901808-- | Required. The client-assigned metric identifier. Example:
1891−-- \`\"severe_errors\"\`. Metric identifiers are limited to 1000 characters
1809+-- \`\"severe_errors\"\`. Metric identifiers are limited to 100 characters
18921810-- and can include only the following characters: \`A-Z\`, \`a-z\`,
1893−-- \`0-9\`, and the special characters \`_-.,+!*\',()%\/\\\`. The
1811+-- \`0-9\`, and the special characters \`_-.,+!*\',()%\/\`. The
18941812-- forward-slash character (\`\/\`) denotes a hierarchy of name pieces, and
1895−-- it cannot be the first character of the name.
1813+-- it cannot be the first character of the name. The \'%\' character is
1814+-- used to URL encode unsafe and reserved characters and must be followed
1815+-- by two hexadecimal digits according to RFC 1738.
18961816lmName :: Lens' LogMetric (Maybe Text)
18971817lmName = lens _lmName (\ s a -> s{_lmName = a})
18981818
1899−-- | An [advanced logs filter](\/logging\/docs\/view\/advanced_filters).
1900−-- Example: \`\"logName:syslog AND severity>=ERROR\"\`.
1819+-- | Output only. The API version that created or updated this metric. The
1820+-- version also dictates the syntax of the filter expression. When a value
1821+-- for this field is missing, the default value of V2 should be assumed.
1822+lmVersion :: Lens' LogMetric (Maybe LogMetricVersion)
1823+lmVersion
1824+ = lens _lmVersion (\ s a -> s{_lmVersion = a})
1825+
1826+-- | Required. An [advanced logs
1827+-- filter](\/logging\/docs\/view\/advanced_filters). Example:
1828+-- \`\"resource.type=gae_app AND severity>=ERROR\"\`.
19011829lmFilter :: Lens' LogMetric (Maybe Text)
19021830lmFilter = lens _lmFilter (\ s a -> s{_lmFilter = a})
19031831
1904−-- | A description of this metric, which is used in documentation.
1832+-- | Optional. A description of this metric, which is used in documentation.
19051833lmDescription :: Lens' LogMetric (Maybe Text)
19061834lmDescription
19071835 = lens _lmDescription
@@ -1912,14 +1840,16 @@ instance FromJSON LogMetric where
19121840 = withObject "LogMetric"
19131841 (\ o ->
19141842 LogMetric' <$>
1915− (o .:? "name") <*> (o .:? "filter") <*>
1916− (o .:? "description"))
1843+ (o .:? "name") <*> (o .:? "version") <*>
1844+ (o .:? "filter")
1845+ <*> (o .:? "description"))
19171846
19181847instance ToJSON LogMetric where
19191848 toJSON LogMetric'{..}
19201849 = object
19211850 (catMaybes
19221851 [("name" .=) <$> _lmName,
1852+ ("version" .=) <$> _lmVersion,
19231853 ("filter" .=) <$> _lmFilter,
19241854 ("description" .=) <$> _lmDescription])
19251855
@@ -1928,7 +1858,7 @@ instance ToJSON LogMetric where
19281858-- /See:/ 'logEntry' smart constructor.
19291859data LogEntry = LogEntry'
19301860 { _leOperation :: !(Maybe LogEntryOperation)
1931− , _leSeverity :: !(Maybe Text)
1861+ , _leSeverity :: !(Maybe LogEntrySeverity)
19321862 , _leTextPayload :: !(Maybe Text)
19331863 , _leJSONPayload :: !(Maybe LogEntryJSONPayload)
19341864 , _leHTTPRequest :: !(Maybe HTTPRequest)
@@ -1937,7 +1867,7 @@ data LogEntry = LogEntry'
19371867 , _leLabels :: !(Maybe LogEntryLabels)
19381868 , _leProtoPayload :: !(Maybe LogEntryProtoPayload)
19391869 , _leLogName :: !(Maybe Text)
1940− , _leTimestamp :: !(Maybe Text)
1870+ , _leTimestamp :: !(Maybe DateTime')
19411871 } deriving (Eq,Show,Data,Typeable,Generic)
19421872
19431873-- | Creates a value of 'LogEntry' with the minimum fields required to make a request.
@@ -1990,7 +1920,7 @@ leOperation
19901920
19911921-- | Optional. The severity of the log entry. The default value is
19921922-- \`LogSeverity.DEFAULT\`.
1993−leSeverity :: Lens' LogEntry (Maybe Text)
1923+leSeverity :: Lens' LogEntry (Maybe LogEntrySeverity)
19941924leSeverity
19951925 = lens _leSeverity (\ s a -> s{_leSeverity = a})
19961926
@@ -2023,9 +1953,9 @@ leResource
20231953 = lens _leResource (\ s a -> s{_leResource = a})
20241954
20251955-- | Optional. A unique ID for the log entry. If you provide this field, the
2026−-- logging service considers other log entries in the same log with the
2027−-- same ID as duplicates which can be removed. If omitted, Cloud Logging
2028−-- will generate a unique ID for this log entry.
1956+-- logging service considers other log entries in the same project with the
1957+-- same ID as duplicates which can be removed. If omitted, Stackdriver
1958+-- Logging will generate a unique ID for this log entry.
20291959leInsertId :: Lens' LogEntry (Maybe Text)
20301960leInsertId
20311961 = lens _leInsertId (\ s a -> s{_leInsertId = a})
@@ -2035,17 +1965,17 @@ leInsertId
20351965leLabels :: Lens' LogEntry (Maybe LogEntryLabels)
20361966leLabels = lens _leLabels (\ s a -> s{_leLabels = a})
20371967
2038−-- | The log entry payload, represented as a protocol buffer. You can only
2039−-- use \`protoPayload\` values that belong to a set of approved types.
1968+-- | The log entry payload, represented as a protocol buffer. Some Google
1969+-- Cloud Platform services use this field for their log entry payloads.
20401970leProtoPayload :: Lens' LogEntry (Maybe LogEntryProtoPayload)
20411971leProtoPayload
20421972 = lens _leProtoPayload
20431973 (\ s a -> s{_leProtoPayload = a})
20441974
20451975-- | Required. The resource name of the log to which this log entry belongs.
2046−-- The format of the name is \`\"projects\/ \/logs\/\"\`. Examples:
1976+-- The format of the name is \`\"projects\/\/logs\/\"\`. Examples:
20471977-- \`\"projects\/my-projectid\/logs\/syslog\"\`,
2048−-- \`\"projects\/1234567890\/logs\/library.googleapis.com%2Fbook_log\"\`.
1978+-- \`\"projects\/my-projectid\/logs\/library.googleapis.com%2Fbook_log\"\`.
20491979-- The log ID part of resource name must be less than 512 characters long
20501980-- and can only include the following characters: upper and lower case
20511981-- alphanumeric characters: [A-Za-z0-9]; and punctuation characters:
@@ -2056,10 +1986,12 @@ leLogName
20561986 = lens _leLogName (\ s a -> s{_leLogName = a})
20571987
20581988-- | Optional. The time the event described by the log entry occurred. If
2059−-- omitted, Cloud Logging will use the time the log entry is written.
2060−leTimestamp :: Lens' LogEntry (Maybe Text)
1989+-- omitted, Stackdriver Logging will use the time the log entry is
1990+-- received.
1991+leTimestamp :: Lens' LogEntry (Maybe UTCTime)
20611992leTimestamp
2062− = lens _leTimestamp (\ s a -> s{_leTimestamp = a})
1993+ = lens _leTimestamp (\ s a -> s{_leTimestamp = a}) .
1994+ mapping _DateTime
20631995
20641996instance FromJSON LogEntry where
20651997 parseJSON
gogol-logging/gen/Network/Google/Logging/Types/Sum.hs+262
@@ -17,3 +17,265 @@
1717module Network.Google.Logging.Types.Sum where
1818
1919import Network.Google.Prelude
20+
21+-- | Output only. The API version that created or updated this metric. The
22+-- version also dictates the syntax of the filter expression. When a value
23+-- for this field is missing, the default value of V2 should be assumed.
24+data LogMetricVersion
25+ = V2
26+ -- ^ @V2@
27+ -- Stackdriver Logging API v2.
28+ | V1
29+ -- ^ @V1@
30+ -- Stackdriver Logging API v1.
31+ deriving (Eq, Ord, Enum, Read, Show, Data, Typeable, Generic)
32+
33+instance Hashable LogMetricVersion
34+
35+instance FromHttpApiData LogMetricVersion where
36+ parseQueryParam = \case
37+ "V2" -> Right V2
38+ "V1" -> Right V1
39+ x -> Left ("Unable to parse LogMetricVersion from: " <> x)
40+
41+instance ToHttpApiData LogMetricVersion where
42+ toQueryParam = \case
43+ V2 -> "V2"
44+ V1 -> "V1"
45+
46+instance FromJSON LogMetricVersion where
47+ parseJSON = parseJSONText "LogMetricVersion"
48+
49+instance ToJSON LogMetricVersion where
50+ toJSON = toJSONText
51+
52+-- | Optional. The log entry version to use for this sink\'s exported log
53+-- entries. This version does not have to correspond to the version of the
54+-- log entry that was written to Stackdriver Logging. If omitted, the v2
55+-- format is used.
56+data LogSinkOutputVersionFormat
57+ = LSOVFVersionFormatUnspecified
58+ -- ^ @VERSION_FORMAT_UNSPECIFIED@
59+ -- An unspecified version format will default to V2.
60+ | LSOVFV2
61+ -- ^ @V2@
62+ -- \`LogEntry\` version 2 format.
63+ | LSOVFV1
64+ -- ^ @V1@
65+ -- \`LogEntry\` version 1 format.
66+ deriving (Eq, Ord, Enum, Read, Show, Data, Typeable, Generic)
67+
68+instance Hashable LogSinkOutputVersionFormat
69+
70+instance FromHttpApiData LogSinkOutputVersionFormat where
71+ parseQueryParam = \case
72+ "VERSION_FORMAT_UNSPECIFIED" -> Right LSOVFVersionFormatUnspecified
73+ "V2" -> Right LSOVFV2
74+ "V1" -> Right LSOVFV1
75+ x -> Left ("Unable to parse LogSinkOutputVersionFormat from: " <> x)
76+
77+instance ToHttpApiData LogSinkOutputVersionFormat where
78+ toQueryParam = \case
79+ LSOVFVersionFormatUnspecified -> "VERSION_FORMAT_UNSPECIFIED"
80+ LSOVFV2 -> "V2"
81+ LSOVFV1 -> "V1"
82+
83+instance FromJSON LogSinkOutputVersionFormat where
84+ parseJSON = parseJSONText "LogSinkOutputVersionFormat"
85+
86+instance ToJSON LogSinkOutputVersionFormat where
87+ toJSON = toJSONText
88+
89+-- | The type of data that can be assigned to the label.
90+data LabelDescriptorValueType
91+ = String
92+ -- ^ @STRING@
93+ -- A variable-length string. This is the default.
94+ | Bool
95+ -- ^ @BOOL@
96+ -- Boolean; true or false.
97+ | INT64
98+ -- ^ @INT64@
99+ -- A 64-bit signed integer.
100+ deriving (Eq, Ord, Enum, Read, Show, Data, Typeable, Generic)
101+
102+instance Hashable LabelDescriptorValueType
103+
104+instance FromHttpApiData LabelDescriptorValueType where
105+ parseQueryParam = \case
106+ "STRING" -> Right String
107+ "BOOL" -> Right Bool
108+ "INT64" -> Right INT64
109+ x -> Left ("Unable to parse LabelDescriptorValueType from: " <> x)
110+
111+instance ToHttpApiData LabelDescriptorValueType where
112+ toQueryParam = \case
113+ String -> "STRING"
114+ Bool -> "BOOL"
115+ INT64 -> "INT64"
116+
117+instance FromJSON LabelDescriptorValueType where
118+ parseJSON = parseJSONText "LabelDescriptorValueType"
119+
120+instance ToJSON LabelDescriptorValueType where
121+ toJSON = toJSONText
122+
123+-- | V1 error format.
124+data Xgafv
125+ = X1
126+ -- ^ @1@
127+ -- v1 error format
128+ | X2
129+ -- ^ @2@
130+ -- v2 error format
131+ deriving (Eq, Ord, Enum, Read, Show, Data, Typeable, Generic)
132+
133+instance Hashable Xgafv
134+
135+instance FromHttpApiData Xgafv where
136+ parseQueryParam = \case
137+ "1" -> Right X1
138+ "2" -> Right X2
139+ x -> Left ("Unable to parse Xgafv from: " <> x)
140+
141+instance ToHttpApiData Xgafv where
142+ toQueryParam = \case
143+ X1 -> "1"
144+ X2 -> "2"
145+
146+instance FromJSON Xgafv where
147+ parseJSON = parseJSONText "Xgafv"
148+
149+instance ToJSON Xgafv where
150+ toJSON = toJSONText
151+
152+-- | Optional. The severity of the log entry. The default value is
153+-- \`LogSeverity.DEFAULT\`.
154+data LogEntrySeverity
155+ = Default
156+ -- ^ @DEFAULT@
157+ -- (0) The log entry has no assigned severity level.
158+ | Debug
159+ -- ^ @DEBUG@
160+ -- (100) Debug or trace information.
161+ | Info
162+ -- ^ @INFO@
163+ -- (200) Routine information, such as ongoing status or performance.
164+ | Notice
165+ -- ^ @NOTICE@
166+ -- (300) Normal but significant events, such as start up, shut down, or a
167+ -- configuration change.
168+ | Warning
169+ -- ^ @WARNING@
170+ -- (400) Warning events might cause problems.
171+ | Error'
172+ -- ^ @ERROR@
173+ -- (500) Error events are likely to cause problems.
174+ | Critical
175+ -- ^ @CRITICAL@
176+ -- (600) Critical events cause more severe problems or outages.
177+ | Alert
178+ -- ^ @ALERT@
179+ -- (700) A person must take an action immediately.
180+ | Emergency
181+ -- ^ @EMERGENCY@
182+ -- (800) One or more systems are unusable.
183+ deriving (Eq, Ord, Enum, Read, Show, Data, Typeable, Generic)
184+
185+instance Hashable LogEntrySeverity
186+
187+instance FromHttpApiData LogEntrySeverity where
188+ parseQueryParam = \case
189+ "DEFAULT" -> Right Default
190+ "DEBUG" -> Right Debug
191+ "INFO" -> Right Info
192+ "NOTICE" -> Right Notice
193+ "WARNING" -> Right Warning
194+ "ERROR" -> Right Error'
195+ "CRITICAL" -> Right Critical
196+ "ALERT" -> Right Alert
197+ "EMERGENCY" -> Right Emergency
198+ x -> Left ("Unable to parse LogEntrySeverity from: " <> x)
199+
200+instance ToHttpApiData LogEntrySeverity where
201+ toQueryParam = \case
202+ Default -> "DEFAULT"
203+ Debug -> "DEBUG"
204+ Info -> "INFO"
205+ Notice -> "NOTICE"
206+ Warning -> "WARNING"
207+ Error' -> "ERROR"
208+ Critical -> "CRITICAL"
209+ Alert -> "ALERT"
210+ Emergency -> "EMERGENCY"
211+
212+instance FromJSON LogEntrySeverity where
213+ parseJSON = parseJSONText "LogEntrySeverity"
214+
215+instance ToJSON LogEntrySeverity where
216+ toJSON = toJSONText
217+
218+-- | Severity of this log entry.
219+data LogLineSeverity
220+ = LLSDefault
221+ -- ^ @DEFAULT@
222+ -- (0) The log entry has no assigned severity level.
223+ | LLSDebug
224+ -- ^ @DEBUG@
225+ -- (100) Debug or trace information.
226+ | LLSInfo
227+ -- ^ @INFO@
228+ -- (200) Routine information, such as ongoing status or performance.
229+ | LLSNotice
230+ -- ^ @NOTICE@
231+ -- (300) Normal but significant events, such as start up, shut down, or a
232+ -- configuration change.
233+ | LLSWarning
234+ -- ^ @WARNING@
235+ -- (400) Warning events might cause problems.
236+ | LLSError'
237+ -- ^ @ERROR@
238+ -- (500) Error events are likely to cause problems.
239+ | LLSCritical
240+ -- ^ @CRITICAL@
241+ -- (600) Critical events cause more severe problems or outages.
242+ | LLSAlert
243+ -- ^ @ALERT@
244+ -- (700) A person must take an action immediately.
245+ | LLSEmergency
246+ -- ^ @EMERGENCY@
247+ -- (800) One or more systems are unusable.
248+ deriving (Eq, Ord, Enum, Read, Show, Data, Typeable, Generic)
249+
250+instance Hashable LogLineSeverity
251+
252+instance FromHttpApiData LogLineSeverity where
253+ parseQueryParam = \case
254+ "DEFAULT" -> Right LLSDefault
255+ "DEBUG" -> Right LLSDebug
256+ "INFO" -> Right LLSInfo
257+ "NOTICE" -> Right LLSNotice
258+ "WARNING" -> Right LLSWarning
259+ "ERROR" -> Right LLSError'
260+ "CRITICAL" -> Right LLSCritical
261+ "ALERT" -> Right LLSAlert
262+ "EMERGENCY" -> Right LLSEmergency
263+ x -> Left ("Unable to parse LogLineSeverity from: " <> x)
264+
265+instance ToHttpApiData LogLineSeverity where
266+ toQueryParam = \case
267+ LLSDefault -> "DEFAULT"
268+ LLSDebug -> "DEBUG"
269+ LLSInfo -> "INFO"
270+ LLSNotice -> "NOTICE"
271+ LLSWarning -> "WARNING"
272+ LLSError' -> "ERROR"
273+ LLSCritical -> "CRITICAL"
274+ LLSAlert -> "ALERT"
275+ LLSEmergency -> "EMERGENCY"
276+
277+instance FromJSON LogLineSeverity where
278+ parseJSON = parseJSONText "LogLineSeverity"
279+
280+instance ToJSON LogLineSeverity where
281+ toJSON = toJSONText
gogol-logging/gen/Network/Google/Resource/Logging/BillingAccounts/Logs/Delete.hsnew file+175
@@ -0,0 +1,175 @@
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.Logging.BillingAccounts.Logs.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+-- Deletes a log and all its log entries. The log will reappear if it
24+-- receives new entries.
25+--
26+-- /See:/ <https://cloud.google.com/logging/docs/ Stackdriver Logging API Reference> for @logging.billingAccounts.logs.delete@.
27+module Network.Google.Resource.Logging.BillingAccounts.Logs.Delete
28+ (
29+ -- * REST Resource
30+ BillingAccountsLogsDeleteResource
31+
32+ -- * Creating a Request
33+ , billingAccountsLogsDelete
34+ , BillingAccountsLogsDelete
35+
36+ -- * Request Lenses
37+ , baldXgafv
38+ , baldUploadProtocol
39+ , baldPp
40+ , baldAccessToken
41+ , baldUploadType
42+ , baldBearerToken
43+ , baldLogName
44+ , baldCallback
45+ ) where
46+
47+import Network.Google.Logging.Types
48+import Network.Google.Prelude
49+
50+-- | A resource alias for @logging.billingAccounts.logs.delete@ method which the
51+-- 'BillingAccountsLogsDelete' request conforms to.
52+type BillingAccountsLogsDeleteResource =
53+ "v2" :>
54+ Capture "logName" Text :>
55+ QueryParam "$.xgafv" Xgafv :>
56+ QueryParam "upload_protocol" Text :>
57+ QueryParam "pp" Bool :>
58+ QueryParam "access_token" Text :>
59+ QueryParam "uploadType" Text :>
60+ QueryParam "bearer_token" Text :>
61+ QueryParam "callback" Text :>
62+ QueryParam "alt" AltJSON :> Delete '[JSON] Empty
63+
64+-- | Deletes a log and all its log entries. The log will reappear if it
65+-- receives new entries.
66+--
67+-- /See:/ 'billingAccountsLogsDelete' smart constructor.
68+data BillingAccountsLogsDelete = BillingAccountsLogsDelete'
69+ { _baldXgafv :: !(Maybe Xgafv)
70+ , _baldUploadProtocol :: !(Maybe Text)
71+ , _baldPp :: !Bool
72+ , _baldAccessToken :: !(Maybe Text)
73+ , _baldUploadType :: !(Maybe Text)
74+ , _baldBearerToken :: !(Maybe Text)
75+ , _baldLogName :: !Text
76+ , _baldCallback :: !(Maybe Text)
77+ } deriving (Eq,Show,Data,Typeable,Generic)
78+
79+-- | Creates a value of 'BillingAccountsLogsDelete' with the minimum fields required to make a request.
80+--
81+-- Use one of the following lenses to modify other fields as desired:
82+--
83+-- * 'baldXgafv'
84+--
85+-- * 'baldUploadProtocol'
86+--
87+-- * 'baldPp'
88+--
89+-- * 'baldAccessToken'
90+--
91+-- * 'baldUploadType'
92+--
93+-- * 'baldBearerToken'
94+--
95+-- * 'baldLogName'
96+--
97+-- * 'baldCallback'
98+billingAccountsLogsDelete
99+ :: Text -- ^ 'baldLogName'
100+ -> BillingAccountsLogsDelete
101+billingAccountsLogsDelete pBaldLogName_ =
102+ BillingAccountsLogsDelete'
103+ { _baldXgafv = Nothing
104+ , _baldUploadProtocol = Nothing
105+ , _baldPp = True
106+ , _baldAccessToken = Nothing
107+ , _baldUploadType = Nothing
108+ , _baldBearerToken = Nothing
109+ , _baldLogName = pBaldLogName_
110+ , _baldCallback = Nothing
111+ }
112+
113+-- | V1 error format.
114+baldXgafv :: Lens' BillingAccountsLogsDelete (Maybe Xgafv)
115+baldXgafv
116+ = lens _baldXgafv (\ s a -> s{_baldXgafv = a})
117+
118+-- | Upload protocol for media (e.g. \"raw\", \"multipart\").
119+baldUploadProtocol :: Lens' BillingAccountsLogsDelete (Maybe Text)
120+baldUploadProtocol
121+ = lens _baldUploadProtocol
122+ (\ s a -> s{_baldUploadProtocol = a})
123+
124+-- | Pretty-print response.
125+baldPp :: Lens' BillingAccountsLogsDelete Bool
126+baldPp = lens _baldPp (\ s a -> s{_baldPp = a})
127+
128+-- | OAuth access token.
129+baldAccessToken :: Lens' BillingAccountsLogsDelete (Maybe Text)
130+baldAccessToken
131+ = lens _baldAccessToken
132+ (\ s a -> s{_baldAccessToken = a})
133+
134+-- | Legacy upload protocol for media (e.g. \"media\", \"multipart\").
135+baldUploadType :: Lens' BillingAccountsLogsDelete (Maybe Text)
136+baldUploadType
137+ = lens _baldUploadType
138+ (\ s a -> s{_baldUploadType = a})
139+
140+-- | OAuth bearer token.
141+baldBearerToken :: Lens' BillingAccountsLogsDelete (Maybe Text)
142+baldBearerToken
143+ = lens _baldBearerToken
144+ (\ s a -> s{_baldBearerToken = a})
145+
146+-- | Required. The resource name of the log to delete. Example:
147+-- \`\"projects\/my-project\/logs\/syslog\"\`.
148+baldLogName :: Lens' BillingAccountsLogsDelete Text
149+baldLogName
150+ = lens _baldLogName (\ s a -> s{_baldLogName = a})
151+
152+-- | JSONP
153+baldCallback :: Lens' BillingAccountsLogsDelete (Maybe Text)
154+baldCallback
155+ = lens _baldCallback (\ s a -> s{_baldCallback = a})
156+
157+instance GoogleRequest BillingAccountsLogsDelete
158+ where
159+ type Rs BillingAccountsLogsDelete = Empty
160+ type Scopes BillingAccountsLogsDelete =
161+ '["https://www.googleapis.com/auth/cloud-platform",
162+ "https://www.googleapis.com/auth/logging.admin"]
163+ requestClient BillingAccountsLogsDelete'{..}
164+ = go _baldLogName _baldXgafv _baldUploadProtocol
165+ (Just _baldPp)
166+ _baldAccessToken
167+ _baldUploadType
168+ _baldBearerToken
169+ _baldCallback
170+ (Just AltJSON)
171+ loggingService
172+ where go
173+ = buildClient
174+ (Proxy :: Proxy BillingAccountsLogsDeleteResource)
175+ mempty
gogol-logging/gen/Network/Google/Resource/Logging/Entries/List.hs+5−5
@@ -24,7 +24,7 @@
2424-- Logging. For ways to export log entries, see [Exporting
2525-- Logs](\/logging\/docs\/export).
2626--
27−-- /See:/ <https://cloud.google.com/logging/docs/ Google Cloud Logging API Reference> for @logging.entries.list@.
27+-- /See:/ <https://cloud.google.com/logging/docs/ Stackdriver Logging API Reference> for @logging.entries.list@.
2828module Network.Google.Resource.Logging.Entries.List
2929 (
3030 -- * REST Resource
@@ -51,9 +51,9 @@ import Network.Google.Prelude
5151-- | A resource alias for @logging.entries.list@ method which the
5252-- 'EntriesList' request conforms to.
5353type EntriesListResource =
54− "v2beta1" :>
54+ "v2" :>
5555 "entries:list" :>
56− QueryParam "$.xgafv" Text :>
56+ QueryParam "$.xgafv" Xgafv :>
5757 QueryParam "upload_protocol" Text :>
5858 QueryParam "pp" Bool :>
5959 QueryParam "access_token" Text :>
@@ -70,7 +70,7 @@ type EntriesListResource =
7070--
7171-- /See:/ 'entriesList' smart constructor.
7272data EntriesList = EntriesList'
73− { _elXgafv :: !(Maybe Text)
73+ { _elXgafv :: !(Maybe Xgafv)
7474 , _elUploadProtocol :: !(Maybe Text)
7575 , _elPp :: !Bool
7676 , _elAccessToken :: !(Maybe Text)
@@ -115,7 +115,7 @@ entriesList pElPayload_ =
115115 }
116116
117117-- | V1 error format.
118−elXgafv :: Lens' EntriesList (Maybe Text)
118+elXgafv :: Lens' EntriesList (Maybe Xgafv)
119119elXgafv = lens _elXgafv (\ s a -> s{_elXgafv = a})
120120
121121-- | Upload protocol for media (e.g. \"raw\", \"multipart\").
gogol-logging/gen/Network/Google/Resource/Logging/Entries/Write.hs+9−9
@@ -20,10 +20,10 @@
2020-- Stability : auto-generated
2121-- Portability : non-portable (GHC extensions)
2222--
23−-- Writes log entries to Cloud Logging. All log entries in Cloud Logging
24−-- are written by this method.
23+-- Writes log entries to Stackdriver Logging. All log entries are written
24+-- by this method.
2525--
26−-- /See:/ <https://cloud.google.com/logging/docs/ Google Cloud Logging API Reference> for @logging.entries.write@.
26+-- /See:/ <https://cloud.google.com/logging/docs/ Stackdriver Logging API Reference> for @logging.entries.write@.
2727module Network.Google.Resource.Logging.Entries.Write
2828 (
2929 -- * REST Resource
@@ -50,9 +50,9 @@ import Network.Google.Prelude
5050-- | A resource alias for @logging.entries.write@ method which the
5151-- 'EntriesWrite' request conforms to.
5252type EntriesWriteResource =
53− "v2beta1" :>
53+ "v2" :>
5454 "entries:write" :>
55− QueryParam "$.xgafv" Text :>
55+ QueryParam "$.xgafv" Xgafv :>
5656 QueryParam "upload_protocol" Text :>
5757 QueryParam "pp" Bool :>
5858 QueryParam "access_token" Text :>
@@ -63,12 +63,12 @@ type EntriesWriteResource =
6363 ReqBody '[JSON] WriteLogEntriesRequest :>
6464 Post '[JSON] WriteLogEntriesResponse
6565
66−-- | Writes log entries to Cloud Logging. All log entries in Cloud Logging
67−-- are written by this method.
66+-- | Writes log entries to Stackdriver Logging. All log entries are written
67+-- by this method.
6868--
6969-- /See:/ 'entriesWrite' smart constructor.
7070data EntriesWrite = EntriesWrite'
71− { _ewXgafv :: !(Maybe Text)
71+ { _ewXgafv :: !(Maybe Xgafv)
7272 , _ewUploadProtocol :: !(Maybe Text)
7373 , _ewPp :: !Bool
7474 , _ewAccessToken :: !(Maybe Text)
@@ -113,7 +113,7 @@ entriesWrite pEwPayload_ =
113113 }
114114
115115-- | V1 error format.
116−ewXgafv :: Lens' EntriesWrite (Maybe Text)
116+ewXgafv :: Lens' EntriesWrite (Maybe Xgafv)
117117ewXgafv = lens _ewXgafv (\ s a -> s{_ewXgafv = a})
118118
119119-- | Upload protocol for media (e.g. \"raw\", \"multipart\").
gogol-logging/gen/Network/Google/Resource/Logging/MonitoredResourceDescriptors/List.hs+14−15
@@ -20,9 +20,9 @@
2020-- Stability : auto-generated
2121-- Portability : non-portable (GHC extensions)
2222--
23−-- Lists monitored resource descriptors that are used by Cloud Logging.
23+-- Lists the monitored resource descriptors used by Stackdriver Logging.
2424--
25−-- /See:/ <https://cloud.google.com/logging/docs/ Google Cloud Logging API Reference> for @logging.monitoredResourceDescriptors.list@.
25+-- /See:/ <https://cloud.google.com/logging/docs/ Stackdriver Logging API Reference> for @logging.monitoredResourceDescriptors.list@.
2626module Network.Google.Resource.Logging.MonitoredResourceDescriptors.List
2727 (
2828 -- * REST Resource
@@ -50,9 +50,9 @@ import Network.Google.Prelude
5050-- | A resource alias for @logging.monitoredResourceDescriptors.list@ method which the
5151-- 'MonitoredResourceDescriptorsList' request conforms to.
5252type MonitoredResourceDescriptorsListResource =
53− "v2beta1" :>
53+ "v2" :>
5454 "monitoredResourceDescriptors" :>
55− QueryParam "$.xgafv" Text :>
55+ QueryParam "$.xgafv" Xgafv :>
5656 QueryParam "upload_protocol" Text :>
5757 QueryParam "pp" Bool :>
5858 QueryParam "access_token" Text :>
@@ -65,11 +65,11 @@ type MonitoredResourceDescriptorsListResource =
6565 Get '[JSON]
6666 ListMonitoredResourceDescriptorsResponse
6767
68−-- | Lists monitored resource descriptors that are used by Cloud Logging.
68+-- | Lists the monitored resource descriptors used by Stackdriver Logging.
6969--
7070-- /See:/ 'monitoredResourceDescriptorsList' smart constructor.
7171data MonitoredResourceDescriptorsList = MonitoredResourceDescriptorsList'
72− { _mrdlXgafv :: !(Maybe Text)
72+ { _mrdlXgafv :: !(Maybe Xgafv)
7373 , _mrdlUploadProtocol :: !(Maybe Text)
7474 , _mrdlPp :: !Bool
7575 , _mrdlAccessToken :: !(Maybe Text)
@@ -117,7 +117,7 @@ monitoredResourceDescriptorsList =
117117 }
118118
119119-- | V1 error format.
120−mrdlXgafv :: Lens' MonitoredResourceDescriptorsList (Maybe Text)
120+mrdlXgafv :: Lens' MonitoredResourceDescriptorsList (Maybe Xgafv)
121121mrdlXgafv
122122 = lens _mrdlXgafv (\ s a -> s{_mrdlXgafv = a})
123123
@@ -149,19 +149,18 @@ mrdlBearerToken
149149 = lens _mrdlBearerToken
150150 (\ s a -> s{_mrdlBearerToken = a})
151151
152−-- | Optional. If the \`pageToken\` parameter is supplied, then the next page
153−-- of results is retrieved. The \`pageToken\` parameter must be set to the
154−-- value of the \`nextPageToken\` from the previous response.
152+-- | Optional. If present, then retrieve the next batch of results from the
153+-- preceding call to this method. \`pageToken\` must be the value of
154+-- \`nextPageToken\` from the previous response. The values of other method
155+-- parameters should be identical to those in the previous call.
155156mrdlPageToken :: Lens' MonitoredResourceDescriptorsList (Maybe Text)
156157mrdlPageToken
157158 = lens _mrdlPageToken
158159 (\ s a -> s{_mrdlPageToken = a})
159160
160−-- | Optional. The maximum number of results to return from this request. You
161−-- must check for presence of \`nextPageToken\` to determine if additional
162−-- results are available, which you can retrieve by passing the
163−-- \`nextPageToken\` value as the \`pageToken\` parameter in the next
164−-- request.
161+-- | Optional. The maximum number of results to return from this request.
162+-- Non-positive values are ignored. The presence of \`nextPageToken\` in
163+-- the response indicates that more results might be available.
165164mrdlPageSize :: Lens' MonitoredResourceDescriptorsList (Maybe Int32)
166165mrdlPageSize
167166 = lens _mrdlPageSize (\ s a -> s{_mrdlPageSize = a})
gogol-logging/gen/Network/Google/Resource/Logging/Organizations/Logs/Delete.hsnew file+173
@@ -0,0 +1,173 @@
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.Logging.Organizations.Logs.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+-- Deletes a log and all its log entries. The log will reappear if it
24+-- receives new entries.
25+--
26+-- /See:/ <https://cloud.google.com/logging/docs/ Stackdriver Logging API Reference> for @logging.organizations.logs.delete@.
27+module Network.Google.Resource.Logging.Organizations.Logs.Delete
28+ (
29+ -- * REST Resource
30+ OrganizationsLogsDeleteResource
31+
32+ -- * Creating a Request
33+ , organizationsLogsDelete
34+ , OrganizationsLogsDelete
35+
36+ -- * Request Lenses
37+ , oldXgafv
38+ , oldUploadProtocol
39+ , oldPp
40+ , oldAccessToken
41+ , oldUploadType
42+ , oldBearerToken
43+ , oldLogName
44+ , oldCallback
45+ ) where
46+
47+import Network.Google.Logging.Types
48+import Network.Google.Prelude
49+
50+-- | A resource alias for @logging.organizations.logs.delete@ method which the
51+-- 'OrganizationsLogsDelete' request conforms to.
52+type OrganizationsLogsDeleteResource =
53+ "v2" :>
54+ Capture "logName" Text :>
55+ QueryParam "$.xgafv" Xgafv :>
56+ QueryParam "upload_protocol" Text :>
57+ QueryParam "pp" Bool :>
58+ QueryParam "access_token" Text :>
59+ QueryParam "uploadType" Text :>
60+ QueryParam "bearer_token" Text :>
61+ QueryParam "callback" Text :>
62+ QueryParam "alt" AltJSON :> Delete '[JSON] Empty
63+
64+-- | Deletes a log and all its log entries. The log will reappear if it
65+-- receives new entries.
66+--
67+-- /See:/ 'organizationsLogsDelete' smart constructor.
68+data OrganizationsLogsDelete = OrganizationsLogsDelete'
69+ { _oldXgafv :: !(Maybe Xgafv)
70+ , _oldUploadProtocol :: !(Maybe Text)
71+ , _oldPp :: !Bool
72+ , _oldAccessToken :: !(Maybe Text)
73+ , _oldUploadType :: !(Maybe Text)
74+ , _oldBearerToken :: !(Maybe Text)
75+ , _oldLogName :: !Text
76+ , _oldCallback :: !(Maybe Text)
77+ } deriving (Eq,Show,Data,Typeable,Generic)
78+
79+-- | Creates a value of 'OrganizationsLogsDelete' with the minimum fields required to make a request.
80+--
81+-- Use one of the following lenses to modify other fields as desired:
82+--
83+-- * 'oldXgafv'
84+--
85+-- * 'oldUploadProtocol'
86+--
87+-- * 'oldPp'
88+--
89+-- * 'oldAccessToken'
90+--
91+-- * 'oldUploadType'
92+--
93+-- * 'oldBearerToken'
94+--
95+-- * 'oldLogName'
96+--
97+-- * 'oldCallback'
98+organizationsLogsDelete
99+ :: Text -- ^ 'oldLogName'
100+ -> OrganizationsLogsDelete
101+organizationsLogsDelete pOldLogName_ =
102+ OrganizationsLogsDelete'
103+ { _oldXgafv = Nothing
104+ , _oldUploadProtocol = Nothing
105+ , _oldPp = True
106+ , _oldAccessToken = Nothing
107+ , _oldUploadType = Nothing
108+ , _oldBearerToken = Nothing
109+ , _oldLogName = pOldLogName_
110+ , _oldCallback = Nothing
111+ }
112+
113+-- | V1 error format.
114+oldXgafv :: Lens' OrganizationsLogsDelete (Maybe Xgafv)
115+oldXgafv = lens _oldXgafv (\ s a -> s{_oldXgafv = a})
116+
117+-- | Upload protocol for media (e.g. \"raw\", \"multipart\").
118+oldUploadProtocol :: Lens' OrganizationsLogsDelete (Maybe Text)
119+oldUploadProtocol
120+ = lens _oldUploadProtocol
121+ (\ s a -> s{_oldUploadProtocol = a})
122+
123+-- | Pretty-print response.
124+oldPp :: Lens' OrganizationsLogsDelete Bool
125+oldPp = lens _oldPp (\ s a -> s{_oldPp = a})
126+
127+-- | OAuth access token.
128+oldAccessToken :: Lens' OrganizationsLogsDelete (Maybe Text)
129+oldAccessToken
130+ = lens _oldAccessToken
131+ (\ s a -> s{_oldAccessToken = a})
132+
133+-- | Legacy upload protocol for media (e.g. \"media\", \"multipart\").
134+oldUploadType :: Lens' OrganizationsLogsDelete (Maybe Text)
135+oldUploadType
136+ = lens _oldUploadType
137+ (\ s a -> s{_oldUploadType = a})
138+
139+-- | OAuth bearer token.
140+oldBearerToken :: Lens' OrganizationsLogsDelete (Maybe Text)
141+oldBearerToken
142+ = lens _oldBearerToken
143+ (\ s a -> s{_oldBearerToken = a})
144+
145+-- | Required. The resource name of the log to delete. Example:
146+-- \`\"projects\/my-project\/logs\/syslog\"\`.
147+oldLogName :: Lens' OrganizationsLogsDelete Text
148+oldLogName
149+ = lens _oldLogName (\ s a -> s{_oldLogName = a})
150+
151+-- | JSONP
152+oldCallback :: Lens' OrganizationsLogsDelete (Maybe Text)
153+oldCallback
154+ = lens _oldCallback (\ s a -> s{_oldCallback = a})
155+
156+instance GoogleRequest OrganizationsLogsDelete where
157+ type Rs OrganizationsLogsDelete = Empty
158+ type Scopes OrganizationsLogsDelete =
159+ '["https://www.googleapis.com/auth/cloud-platform",
160+ "https://www.googleapis.com/auth/logging.admin"]
161+ requestClient OrganizationsLogsDelete'{..}
162+ = go _oldLogName _oldXgafv _oldUploadProtocol
163+ (Just _oldPp)
164+ _oldAccessToken
165+ _oldUploadType
166+ _oldBearerToken
167+ _oldCallback
168+ (Just AltJSON)
169+ loggingService
170+ where go
171+ = buildClient
172+ (Proxy :: Proxy OrganizationsLogsDeleteResource)
173+ mempty
gogol-logging/gen/Network/Google/Resource/Logging/Organizations/Sinks/Create.hsnew file+186
@@ -0,0 +1,186 @@
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.Logging.Organizations.Sinks.Create
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+-- Creates a sink.
24+--
25+-- /See:/ <https://cloud.google.com/logging/docs/ Stackdriver Logging API Reference> for @logging.organizations.sinks.create@.
26+module Network.Google.Resource.Logging.Organizations.Sinks.Create
27+ (
28+ -- * REST Resource
29+ OrganizationsSinksCreateResource
30+
31+ -- * Creating a Request
32+ , organizationsSinksCreate
33+ , OrganizationsSinksCreate
34+
35+ -- * Request Lenses
36+ , oscParent
37+ , oscXgafv
38+ , oscUploadProtocol
39+ , oscPp
40+ , oscAccessToken
41+ , oscUploadType
42+ , oscPayload
43+ , oscBearerToken
44+ , oscCallback
45+ ) where
46+
47+import Network.Google.Logging.Types
48+import Network.Google.Prelude
49+
50+-- | A resource alias for @logging.organizations.sinks.create@ method which the
51+-- 'OrganizationsSinksCreate' request conforms to.
52+type OrganizationsSinksCreateResource =
53+ "v2" :>
54+ Capture "parent" Text :>
55+ "sinks" :>
56+ QueryParam "$.xgafv" Xgafv :>
57+ QueryParam "upload_protocol" Text :>
58+ QueryParam "pp" Bool :>
59+ QueryParam "access_token" Text :>
60+ QueryParam "uploadType" Text :>
61+ QueryParam "bearer_token" Text :>
62+ QueryParam "callback" Text :>
63+ QueryParam "alt" AltJSON :>
64+ ReqBody '[JSON] LogSink :> Post '[JSON] LogSink
65+
66+-- | Creates a sink.
67+--
68+-- /See:/ 'organizationsSinksCreate' smart constructor.
69+data OrganizationsSinksCreate = OrganizationsSinksCreate'
70+ { _oscParent :: !Text
71+ , _oscXgafv :: !(Maybe Xgafv)
72+ , _oscUploadProtocol :: !(Maybe Text)
73+ , _oscPp :: !Bool
74+ , _oscAccessToken :: !(Maybe Text)
75+ , _oscUploadType :: !(Maybe Text)
76+ , _oscPayload :: !LogSink
77+ , _oscBearerToken :: !(Maybe Text)
78+ , _oscCallback :: !(Maybe Text)
79+ } deriving (Eq,Show,Data,Typeable,Generic)
80+
81+-- | Creates a value of 'OrganizationsSinksCreate' with the minimum fields required to make a request.
82+--
83+-- Use one of the following lenses to modify other fields as desired:
84+--
85+-- * 'oscParent'
86+--
87+-- * 'oscXgafv'
88+--
89+-- * 'oscUploadProtocol'
90+--
91+-- * 'oscPp'
92+--
93+-- * 'oscAccessToken'
94+--
95+-- * 'oscUploadType'
96+--
97+-- * 'oscPayload'
98+--
99+-- * 'oscBearerToken'
100+--
101+-- * 'oscCallback'
102+organizationsSinksCreate
103+ :: Text -- ^ 'oscParent'
104+ -> LogSink -- ^ 'oscPayload'
105+ -> OrganizationsSinksCreate
106+organizationsSinksCreate pOscParent_ pOscPayload_ =
107+ OrganizationsSinksCreate'
108+ { _oscParent = pOscParent_
109+ , _oscXgafv = Nothing
110+ , _oscUploadProtocol = Nothing
111+ , _oscPp = True
112+ , _oscAccessToken = Nothing
113+ , _oscUploadType = Nothing
114+ , _oscPayload = pOscPayload_
115+ , _oscBearerToken = Nothing
116+ , _oscCallback = Nothing
117+ }
118+
119+-- | Required. The resource in which to create the sink. Example:
120+-- \`\"projects\/my-project-id\"\`. The new sink must be provided in the
121+-- request.
122+oscParent :: Lens' OrganizationsSinksCreate Text
123+oscParent
124+ = lens _oscParent (\ s a -> s{_oscParent = a})
125+
126+-- | V1 error format.
127+oscXgafv :: Lens' OrganizationsSinksCreate (Maybe Xgafv)
128+oscXgafv = lens _oscXgafv (\ s a -> s{_oscXgafv = a})
129+
130+-- | Upload protocol for media (e.g. \"raw\", \"multipart\").
131+oscUploadProtocol :: Lens' OrganizationsSinksCreate (Maybe Text)
132+oscUploadProtocol
133+ = lens _oscUploadProtocol
134+ (\ s a -> s{_oscUploadProtocol = a})
135+
136+-- | Pretty-print response.
137+oscPp :: Lens' OrganizationsSinksCreate Bool
138+oscPp = lens _oscPp (\ s a -> s{_oscPp = a})
139+
140+-- | OAuth access token.
141+oscAccessToken :: Lens' OrganizationsSinksCreate (Maybe Text)
142+oscAccessToken
143+ = lens _oscAccessToken
144+ (\ s a -> s{_oscAccessToken = a})
145+
146+-- | Legacy upload protocol for media (e.g. \"media\", \"multipart\").
147+oscUploadType :: Lens' OrganizationsSinksCreate (Maybe Text)
148+oscUploadType
149+ = lens _oscUploadType
150+ (\ s a -> s{_oscUploadType = a})
151+
152+-- | Multipart request metadata.
153+oscPayload :: Lens' OrganizationsSinksCreate LogSink
154+oscPayload
155+ = lens _oscPayload (\ s a -> s{_oscPayload = a})
156+
157+-- | OAuth bearer token.
158+oscBearerToken :: Lens' OrganizationsSinksCreate (Maybe Text)
159+oscBearerToken
160+ = lens _oscBearerToken
161+ (\ s a -> s{_oscBearerToken = a})
162+
163+-- | JSONP
164+oscCallback :: Lens' OrganizationsSinksCreate (Maybe Text)
165+oscCallback
166+ = lens _oscCallback (\ s a -> s{_oscCallback = a})
167+
168+instance GoogleRequest OrganizationsSinksCreate where
169+ type Rs OrganizationsSinksCreate = LogSink
170+ type Scopes OrganizationsSinksCreate =
171+ '["https://www.googleapis.com/auth/cloud-platform",
172+ "https://www.googleapis.com/auth/logging.admin"]
173+ requestClient OrganizationsSinksCreate'{..}
174+ = go _oscParent _oscXgafv _oscUploadProtocol
175+ (Just _oscPp)
176+ _oscAccessToken
177+ _oscUploadType
178+ _oscBearerToken
179+ _oscCallback
180+ (Just AltJSON)
181+ _oscPayload
182+ loggingService
183+ where go
184+ = buildClient
185+ (Proxy :: Proxy OrganizationsSinksCreateResource)
186+ mempty
gogol-logging/gen/Network/Google/Resource/Logging/Organizations/Sinks/Delete.hsnew file+173
@@ -0,0 +1,173 @@
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.Logging.Organizations.Sinks.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+-- Deletes a sink.
24+--
25+-- /See:/ <https://cloud.google.com/logging/docs/ Stackdriver Logging API Reference> for @logging.organizations.sinks.delete@.
26+module Network.Google.Resource.Logging.Organizations.Sinks.Delete
27+ (
28+ -- * REST Resource
29+ OrganizationsSinksDeleteResource
30+
31+ -- * Creating a Request
32+ , organizationsSinksDelete
33+ , OrganizationsSinksDelete
34+
35+ -- * Request Lenses
36+ , osdXgafv
37+ , osdUploadProtocol
38+ , osdPp
39+ , osdAccessToken
40+ , osdUploadType
41+ , osdBearerToken
42+ , osdSinkName
43+ , osdCallback
44+ ) where
45+
46+import Network.Google.Logging.Types
47+import Network.Google.Prelude
48+
49+-- | A resource alias for @logging.organizations.sinks.delete@ method which the
50+-- 'OrganizationsSinksDelete' request conforms to.
51+type OrganizationsSinksDeleteResource =
52+ "v2" :>
53+ Capture "sinkName" Text :>
54+ QueryParam "$.xgafv" Xgafv :>
55+ QueryParam "upload_protocol" Text :>
56+ QueryParam "pp" Bool :>
57+ QueryParam "access_token" Text :>
58+ QueryParam "uploadType" Text :>
59+ QueryParam "bearer_token" Text :>
60+ QueryParam "callback" Text :>
61+ QueryParam "alt" AltJSON :> Delete '[JSON] Empty
62+
63+-- | Deletes a sink.
64+--
65+-- /See:/ 'organizationsSinksDelete' smart constructor.
66+data OrganizationsSinksDelete = OrganizationsSinksDelete'
67+ { _osdXgafv :: !(Maybe Xgafv)
68+ , _osdUploadProtocol :: !(Maybe Text)
69+ , _osdPp :: !Bool
70+ , _osdAccessToken :: !(Maybe Text)
71+ , _osdUploadType :: !(Maybe Text)
72+ , _osdBearerToken :: !(Maybe Text)
73+ , _osdSinkName :: !Text
74+ , _osdCallback :: !(Maybe Text)
75+ } deriving (Eq,Show,Data,Typeable,Generic)
76+
77+-- | Creates a value of 'OrganizationsSinksDelete' with the minimum fields required to make a request.
78+--
79+-- Use one of the following lenses to modify other fields as desired:
80+--
81+-- * 'osdXgafv'
82+--
83+-- * 'osdUploadProtocol'
84+--
85+-- * 'osdPp'
86+--
87+-- * 'osdAccessToken'
88+--
89+-- * 'osdUploadType'
90+--
91+-- * 'osdBearerToken'
92+--
93+-- * 'osdSinkName'
94+--
95+-- * 'osdCallback'
96+organizationsSinksDelete
97+ :: Text -- ^ 'osdSinkName'
98+ -> OrganizationsSinksDelete
99+organizationsSinksDelete pOsdSinkName_ =
100+ OrganizationsSinksDelete'
101+ { _osdXgafv = Nothing
102+ , _osdUploadProtocol = Nothing
103+ , _osdPp = True
104+ , _osdAccessToken = Nothing
105+ , _osdUploadType = Nothing
106+ , _osdBearerToken = Nothing
107+ , _osdSinkName = pOsdSinkName_
108+ , _osdCallback = Nothing
109+ }
110+
111+-- | V1 error format.
112+osdXgafv :: Lens' OrganizationsSinksDelete (Maybe Xgafv)
113+osdXgafv = lens _osdXgafv (\ s a -> s{_osdXgafv = a})
114+
115+-- | Upload protocol for media (e.g. \"raw\", \"multipart\").
116+osdUploadProtocol :: Lens' OrganizationsSinksDelete (Maybe Text)
117+osdUploadProtocol
118+ = lens _osdUploadProtocol
119+ (\ s a -> s{_osdUploadProtocol = a})
120+
121+-- | Pretty-print response.
122+osdPp :: Lens' OrganizationsSinksDelete Bool
123+osdPp = lens _osdPp (\ s a -> s{_osdPp = a})
124+
125+-- | OAuth access token.
126+osdAccessToken :: Lens' OrganizationsSinksDelete (Maybe Text)
127+osdAccessToken
128+ = lens _osdAccessToken
129+ (\ s a -> s{_osdAccessToken = a})
130+
131+-- | Legacy upload protocol for media (e.g. \"media\", \"multipart\").
132+osdUploadType :: Lens' OrganizationsSinksDelete (Maybe Text)
133+osdUploadType
134+ = lens _osdUploadType
135+ (\ s a -> s{_osdUploadType = a})
136+
137+-- | OAuth bearer token.
138+osdBearerToken :: Lens' OrganizationsSinksDelete (Maybe Text)
139+osdBearerToken
140+ = lens _osdBearerToken
141+ (\ s a -> s{_osdBearerToken = a})
142+
143+-- | Required. The resource name of the sink to delete, including the parent
144+-- resource and the sink identifier. Example:
145+-- \`\"projects\/my-project-id\/sinks\/my-sink-id\"\`. It is an error if
146+-- the sink does not exist.
147+osdSinkName :: Lens' OrganizationsSinksDelete Text
148+osdSinkName
149+ = lens _osdSinkName (\ s a -> s{_osdSinkName = a})
150+
151+-- | JSONP
152+osdCallback :: Lens' OrganizationsSinksDelete (Maybe Text)
153+osdCallback
154+ = lens _osdCallback (\ s a -> s{_osdCallback = a})
155+
156+instance GoogleRequest OrganizationsSinksDelete where
157+ type Rs OrganizationsSinksDelete = Empty
158+ type Scopes OrganizationsSinksDelete =
159+ '["https://www.googleapis.com/auth/cloud-platform",
160+ "https://www.googleapis.com/auth/logging.admin"]
161+ requestClient OrganizationsSinksDelete'{..}
162+ = go _osdSinkName _osdXgafv _osdUploadProtocol
163+ (Just _osdPp)
164+ _osdAccessToken
165+ _osdUploadType
166+ _osdBearerToken
167+ _osdCallback
168+ (Just AltJSON)
169+ loggingService
170+ where go
171+ = buildClient
172+ (Proxy :: Proxy OrganizationsSinksDeleteResource)
173+ mempty
gogol-logging/gen/Network/Google/Resource/Logging/Organizations/Sinks/Get.hsnew file+173
@@ -0,0 +1,173 @@
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.Logging.Organizations.Sinks.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 a sink.
24+--
25+-- /See:/ <https://cloud.google.com/logging/docs/ Stackdriver Logging API Reference> for @logging.organizations.sinks.get@.
26+module Network.Google.Resource.Logging.Organizations.Sinks.Get
27+ (
28+ -- * REST Resource
29+ OrganizationsSinksGetResource
30+
31+ -- * Creating a Request
32+ , organizationsSinksGet
33+ , OrganizationsSinksGet
34+
35+ -- * Request Lenses
36+ , osgXgafv
37+ , osgUploadProtocol
38+ , osgPp
39+ , osgAccessToken
40+ , osgUploadType
41+ , osgBearerToken
42+ , osgSinkName
43+ , osgCallback
44+ ) where
45+
46+import Network.Google.Logging.Types
47+import Network.Google.Prelude
48+
49+-- | A resource alias for @logging.organizations.sinks.get@ method which the
50+-- 'OrganizationsSinksGet' request conforms to.
51+type OrganizationsSinksGetResource =
52+ "v2" :>
53+ Capture "sinkName" Text :>
54+ QueryParam "$.xgafv" Xgafv :>
55+ QueryParam "upload_protocol" Text :>
56+ QueryParam "pp" Bool :>
57+ QueryParam "access_token" Text :>
58+ QueryParam "uploadType" Text :>
59+ QueryParam "bearer_token" Text :>
60+ QueryParam "callback" Text :>
61+ QueryParam "alt" AltJSON :> Get '[JSON] LogSink
62+
63+-- | Gets a sink.
64+--
65+-- /See:/ 'organizationsSinksGet' smart constructor.
66+data OrganizationsSinksGet = OrganizationsSinksGet'
67+ { _osgXgafv :: !(Maybe Xgafv)
68+ , _osgUploadProtocol :: !(Maybe Text)
69+ , _osgPp :: !Bool
70+ , _osgAccessToken :: !(Maybe Text)
71+ , _osgUploadType :: !(Maybe Text)
72+ , _osgBearerToken :: !(Maybe Text)
73+ , _osgSinkName :: !Text
74+ , _osgCallback :: !(Maybe Text)
75+ } deriving (Eq,Show,Data,Typeable,Generic)
76+
77+-- | Creates a value of 'OrganizationsSinksGet' with the minimum fields required to make a request.
78+--
79+-- Use one of the following lenses to modify other fields as desired:
80+--
81+-- * 'osgXgafv'
82+--
83+-- * 'osgUploadProtocol'
84+--
85+-- * 'osgPp'
86+--
87+-- * 'osgAccessToken'
88+--
89+-- * 'osgUploadType'
90+--
91+-- * 'osgBearerToken'
92+--
93+-- * 'osgSinkName'
94+--
95+-- * 'osgCallback'
96+organizationsSinksGet
97+ :: Text -- ^ 'osgSinkName'
98+ -> OrganizationsSinksGet
99+organizationsSinksGet pOsgSinkName_ =
100+ OrganizationsSinksGet'
101+ { _osgXgafv = Nothing
102+ , _osgUploadProtocol = Nothing
103+ , _osgPp = True
104+ , _osgAccessToken = Nothing
105+ , _osgUploadType = Nothing
106+ , _osgBearerToken = Nothing
107+ , _osgSinkName = pOsgSinkName_
108+ , _osgCallback = Nothing
109+ }
110+
111+-- | V1 error format.
112+osgXgafv :: Lens' OrganizationsSinksGet (Maybe Xgafv)
113+osgXgafv = lens _osgXgafv (\ s a -> s{_osgXgafv = a})
114+
115+-- | Upload protocol for media (e.g. \"raw\", \"multipart\").
116+osgUploadProtocol :: Lens' OrganizationsSinksGet (Maybe Text)
117+osgUploadProtocol
118+ = lens _osgUploadProtocol
119+ (\ s a -> s{_osgUploadProtocol = a})
120+
121+-- | Pretty-print response.
122+osgPp :: Lens' OrganizationsSinksGet Bool
123+osgPp = lens _osgPp (\ s a -> s{_osgPp = a})
124+
125+-- | OAuth access token.
126+osgAccessToken :: Lens' OrganizationsSinksGet (Maybe Text)
127+osgAccessToken
128+ = lens _osgAccessToken
129+ (\ s a -> s{_osgAccessToken = a})
130+
131+-- | Legacy upload protocol for media (e.g. \"media\", \"multipart\").
132+osgUploadType :: Lens' OrganizationsSinksGet (Maybe Text)
133+osgUploadType
134+ = lens _osgUploadType
135+ (\ s a -> s{_osgUploadType = a})
136+
137+-- | OAuth bearer token.
138+osgBearerToken :: Lens' OrganizationsSinksGet (Maybe Text)
139+osgBearerToken
140+ = lens _osgBearerToken
141+ (\ s a -> s{_osgBearerToken = a})
142+
143+-- | Required. The resource name of the sink to return. Example:
144+-- \`\"projects\/my-project-id\/sinks\/my-sink-id\"\`.
145+osgSinkName :: Lens' OrganizationsSinksGet Text
146+osgSinkName
147+ = lens _osgSinkName (\ s a -> s{_osgSinkName = a})
148+
149+-- | JSONP
150+osgCallback :: Lens' OrganizationsSinksGet (Maybe Text)
151+osgCallback
152+ = lens _osgCallback (\ s a -> s{_osgCallback = a})
153+
154+instance GoogleRequest OrganizationsSinksGet where
155+ type Rs OrganizationsSinksGet = LogSink
156+ type Scopes OrganizationsSinksGet =
157+ '["https://www.googleapis.com/auth/cloud-platform",
158+ "https://www.googleapis.com/auth/cloud-platform.read-only",
159+ "https://www.googleapis.com/auth/logging.admin",
160+ "https://www.googleapis.com/auth/logging.read"]
161+ requestClient OrganizationsSinksGet'{..}
162+ = go _osgSinkName _osgXgafv _osgUploadProtocol
163+ (Just _osgPp)
164+ _osgAccessToken
165+ _osgUploadType
166+ _osgBearerToken
167+ _osgCallback
168+ (Just AltJSON)
169+ loggingService
170+ where go
171+ = buildClient
172+ (Proxy :: Proxy OrganizationsSinksGetResource)
173+ mempty
gogol-logging/gen/Network/Google/Resource/Logging/Organizations/Sinks/List.hsnew file+205
@@ -0,0 +1,205 @@
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.Logging.Organizations.Sinks.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 sinks.
24+--
25+-- /See:/ <https://cloud.google.com/logging/docs/ Stackdriver Logging API Reference> for @logging.organizations.sinks.list@.
26+module Network.Google.Resource.Logging.Organizations.Sinks.List
27+ (
28+ -- * REST Resource
29+ OrganizationsSinksListResource
30+
31+ -- * Creating a Request
32+ , organizationsSinksList
33+ , OrganizationsSinksList
34+
35+ -- * Request Lenses
36+ , oslParent
37+ , oslXgafv
38+ , oslUploadProtocol
39+ , oslPp
40+ , oslAccessToken
41+ , oslUploadType
42+ , oslBearerToken
43+ , oslPageToken
44+ , oslPageSize
45+ , oslCallback
46+ ) where
47+
48+import Network.Google.Logging.Types
49+import Network.Google.Prelude
50+
51+-- | A resource alias for @logging.organizations.sinks.list@ method which the
52+-- 'OrganizationsSinksList' request conforms to.
53+type OrganizationsSinksListResource =
54+ "v2" :>
55+ Capture "parent" Text :>
56+ "sinks" :>
57+ QueryParam "$.xgafv" Xgafv :>
58+ QueryParam "upload_protocol" Text :>
59+ QueryParam "pp" Bool :>
60+ QueryParam "access_token" Text :>
61+ QueryParam "uploadType" Text :>
62+ QueryParam "bearer_token" Text :>
63+ QueryParam "pageToken" Text :>
64+ QueryParam "pageSize" (Textual Int32) :>
65+ QueryParam "callback" Text :>
66+ QueryParam "alt" AltJSON :>
67+ Get '[JSON] ListSinksResponse
68+
69+-- | Lists sinks.
70+--
71+-- /See:/ 'organizationsSinksList' smart constructor.
72+data OrganizationsSinksList = OrganizationsSinksList'
73+ { _oslParent :: !Text
74+ , _oslXgafv :: !(Maybe Xgafv)
75+ , _oslUploadProtocol :: !(Maybe Text)
76+ , _oslPp :: !Bool
77+ , _oslAccessToken :: !(Maybe Text)
78+ , _oslUploadType :: !(Maybe Text)
79+ , _oslBearerToken :: !(Maybe Text)
80+ , _oslPageToken :: !(Maybe Text)
81+ , _oslPageSize :: !(Maybe (Textual Int32))
82+ , _oslCallback :: !(Maybe Text)
83+ } deriving (Eq,Show,Data,Typeable,Generic)
84+
85+-- | Creates a value of 'OrganizationsSinksList' 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+-- * 'oslParent'
90+--
91+-- * 'oslXgafv'
92+--
93+-- * 'oslUploadProtocol'
94+--
95+-- * 'oslPp'
96+--
97+-- * 'oslAccessToken'
98+--
99+-- * 'oslUploadType'
100+--
101+-- * 'oslBearerToken'
102+--
103+-- * 'oslPageToken'
104+--
105+-- * 'oslPageSize'
106+--
107+-- * 'oslCallback'
108+organizationsSinksList
109+ :: Text -- ^ 'oslParent'
110+ -> OrganizationsSinksList
111+organizationsSinksList pOslParent_ =
112+ OrganizationsSinksList'
113+ { _oslParent = pOslParent_
114+ , _oslXgafv = Nothing
115+ , _oslUploadProtocol = Nothing
116+ , _oslPp = True
117+ , _oslAccessToken = Nothing
118+ , _oslUploadType = Nothing
119+ , _oslBearerToken = Nothing
120+ , _oslPageToken = Nothing
121+ , _oslPageSize = Nothing
122+ , _oslCallback = Nothing
123+ }
124+
125+-- | Required. The cloud resource containing the sinks. Example:
126+-- \`\"projects\/my-logging-project\"\`.
127+oslParent :: Lens' OrganizationsSinksList Text
128+oslParent
129+ = lens _oslParent (\ s a -> s{_oslParent = a})
130+
131+-- | V1 error format.
132+oslXgafv :: Lens' OrganizationsSinksList (Maybe Xgafv)
133+oslXgafv = lens _oslXgafv (\ s a -> s{_oslXgafv = a})
134+
135+-- | Upload protocol for media (e.g. \"raw\", \"multipart\").
136+oslUploadProtocol :: Lens' OrganizationsSinksList (Maybe Text)
137+oslUploadProtocol
138+ = lens _oslUploadProtocol
139+ (\ s a -> s{_oslUploadProtocol = a})
140+
141+-- | Pretty-print response.
142+oslPp :: Lens' OrganizationsSinksList Bool
143+oslPp = lens _oslPp (\ s a -> s{_oslPp = a})
144+
145+-- | OAuth access token.
146+oslAccessToken :: Lens' OrganizationsSinksList (Maybe Text)
147+oslAccessToken
148+ = lens _oslAccessToken
149+ (\ s a -> s{_oslAccessToken = a})
150+
151+-- | Legacy upload protocol for media (e.g. \"media\", \"multipart\").
152+oslUploadType :: Lens' OrganizationsSinksList (Maybe Text)
153+oslUploadType
154+ = lens _oslUploadType
155+ (\ s a -> s{_oslUploadType = a})
156+
157+-- | OAuth bearer token.
158+oslBearerToken :: Lens' OrganizationsSinksList (Maybe Text)
159+oslBearerToken
160+ = lens _oslBearerToken
161+ (\ s a -> s{_oslBearerToken = a})
162+
163+-- | Optional. If present, then retrieve the next batch of results from the
164+-- preceding call to this method. \`pageToken\` must be the value of
165+-- \`nextPageToken\` from the previous response. The values of other method
166+-- parameters should be identical to those in the previous call.
167+oslPageToken :: Lens' OrganizationsSinksList (Maybe Text)
168+oslPageToken
169+ = lens _oslPageToken (\ s a -> s{_oslPageToken = a})
170+
171+-- | Optional. The maximum number of results to return from this request.
172+-- Non-positive values are ignored. The presence of \`nextPageToken\` in
173+-- the response indicates that more results might be available.
174+oslPageSize :: Lens' OrganizationsSinksList (Maybe Int32)
175+oslPageSize
176+ = lens _oslPageSize (\ s a -> s{_oslPageSize = a}) .
177+ mapping _Coerce
178+
179+-- | JSONP
180+oslCallback :: Lens' OrganizationsSinksList (Maybe Text)
181+oslCallback
182+ = lens _oslCallback (\ s a -> s{_oslCallback = a})
183+
184+instance GoogleRequest OrganizationsSinksList where
185+ type Rs OrganizationsSinksList = ListSinksResponse
186+ type Scopes OrganizationsSinksList =
187+ '["https://www.googleapis.com/auth/cloud-platform",
188+ "https://www.googleapis.com/auth/cloud-platform.read-only",
189+ "https://www.googleapis.com/auth/logging.admin",
190+ "https://www.googleapis.com/auth/logging.read"]
191+ requestClient OrganizationsSinksList'{..}
192+ = go _oslParent _oslXgafv _oslUploadProtocol
193+ (Just _oslPp)
194+ _oslAccessToken
195+ _oslUploadType
196+ _oslBearerToken
197+ _oslPageToken
198+ _oslPageSize
199+ _oslCallback
200+ (Just AltJSON)
201+ loggingService
202+ where go
203+ = buildClient
204+ (Proxy :: Proxy OrganizationsSinksListResource)
205+ mempty
gogol-logging/gen/Network/Google/Resource/Logging/Organizations/Sinks/Update.hsnew file+186
@@ -0,0 +1,186 @@
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.Logging.Organizations.Sinks.Update
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 or creates a sink.
24+--
25+-- /See:/ <https://cloud.google.com/logging/docs/ Stackdriver Logging API Reference> for @logging.organizations.sinks.update@.
26+module Network.Google.Resource.Logging.Organizations.Sinks.Update
27+ (
28+ -- * REST Resource
29+ OrganizationsSinksUpdateResource
30+
31+ -- * Creating a Request
32+ , organizationsSinksUpdate
33+ , OrganizationsSinksUpdate
34+
35+ -- * Request Lenses
36+ , osuXgafv
37+ , osuUploadProtocol
38+ , osuPp
39+ , osuAccessToken
40+ , osuUploadType
41+ , osuPayload
42+ , osuBearerToken
43+ , osuSinkName
44+ , osuCallback
45+ ) where
46+
47+import Network.Google.Logging.Types
48+import Network.Google.Prelude
49+
50+-- | A resource alias for @logging.organizations.sinks.update@ method which the
51+-- 'OrganizationsSinksUpdate' request conforms to.
52+type OrganizationsSinksUpdateResource =
53+ "v2" :>
54+ Capture "sinkName" Text :>
55+ QueryParam "$.xgafv" Xgafv :>
56+ QueryParam "upload_protocol" Text :>
57+ QueryParam "pp" Bool :>
58+ QueryParam "access_token" Text :>
59+ QueryParam "uploadType" Text :>
60+ QueryParam "bearer_token" Text :>
61+ QueryParam "callback" Text :>
62+ QueryParam "alt" AltJSON :>
63+ ReqBody '[JSON] LogSink :> Put '[JSON] LogSink
64+
65+-- | Updates or creates a sink.
66+--
67+-- /See:/ 'organizationsSinksUpdate' smart constructor.
68+data OrganizationsSinksUpdate = OrganizationsSinksUpdate'
69+ { _osuXgafv :: !(Maybe Xgafv)
70+ , _osuUploadProtocol :: !(Maybe Text)
71+ , _osuPp :: !Bool
72+ , _osuAccessToken :: !(Maybe Text)
73+ , _osuUploadType :: !(Maybe Text)
74+ , _osuPayload :: !LogSink
75+ , _osuBearerToken :: !(Maybe Text)
76+ , _osuSinkName :: !Text
77+ , _osuCallback :: !(Maybe Text)
78+ } deriving (Eq,Show,Data,Typeable,Generic)
79+
80+-- | Creates a value of 'OrganizationsSinksUpdate' with the minimum fields required to make a request.
81+--
82+-- Use one of the following lenses to modify other fields as desired:
83+--
84+-- * 'osuXgafv'
85+--
86+-- * 'osuUploadProtocol'
87+--
88+-- * 'osuPp'
89+--
90+-- * 'osuAccessToken'
91+--
92+-- * 'osuUploadType'
93+--
94+-- * 'osuPayload'
95+--
96+-- * 'osuBearerToken'
97+--
98+-- * 'osuSinkName'
99+--
100+-- * 'osuCallback'
101+organizationsSinksUpdate
102+ :: LogSink -- ^ 'osuPayload'
103+ -> Text -- ^ 'osuSinkName'
104+ -> OrganizationsSinksUpdate
105+organizationsSinksUpdate pOsuPayload_ pOsuSinkName_ =
106+ OrganizationsSinksUpdate'
107+ { _osuXgafv = Nothing
108+ , _osuUploadProtocol = Nothing
109+ , _osuPp = True
110+ , _osuAccessToken = Nothing
111+ , _osuUploadType = Nothing
112+ , _osuPayload = pOsuPayload_
113+ , _osuBearerToken = Nothing
114+ , _osuSinkName = pOsuSinkName_
115+ , _osuCallback = Nothing
116+ }
117+
118+-- | V1 error format.
119+osuXgafv :: Lens' OrganizationsSinksUpdate (Maybe Xgafv)
120+osuXgafv = lens _osuXgafv (\ s a -> s{_osuXgafv = a})
121+
122+-- | Upload protocol for media (e.g. \"raw\", \"multipart\").
123+osuUploadProtocol :: Lens' OrganizationsSinksUpdate (Maybe Text)
124+osuUploadProtocol
125+ = lens _osuUploadProtocol
126+ (\ s a -> s{_osuUploadProtocol = a})
127+
128+-- | Pretty-print response.
129+osuPp :: Lens' OrganizationsSinksUpdate Bool
130+osuPp = lens _osuPp (\ s a -> s{_osuPp = a})
131+
132+-- | OAuth access token.
133+osuAccessToken :: Lens' OrganizationsSinksUpdate (Maybe Text)
134+osuAccessToken
135+ = lens _osuAccessToken
136+ (\ s a -> s{_osuAccessToken = a})
137+
138+-- | Legacy upload protocol for media (e.g. \"media\", \"multipart\").
139+osuUploadType :: Lens' OrganizationsSinksUpdate (Maybe Text)
140+osuUploadType
141+ = lens _osuUploadType
142+ (\ s a -> s{_osuUploadType = a})
143+
144+-- | Multipart request metadata.
145+osuPayload :: Lens' OrganizationsSinksUpdate LogSink
146+osuPayload
147+ = lens _osuPayload (\ s a -> s{_osuPayload = a})
148+
149+-- | OAuth bearer token.
150+osuBearerToken :: Lens' OrganizationsSinksUpdate (Maybe Text)
151+osuBearerToken
152+ = lens _osuBearerToken
153+ (\ s a -> s{_osuBearerToken = a})
154+
155+-- | Required. The resource name of the sink to update, including the parent
156+-- resource and the sink identifier. If the sink does not exist, this
157+-- method creates the sink. Example:
158+-- \`\"projects\/my-project-id\/sinks\/my-sink-id\"\`.
159+osuSinkName :: Lens' OrganizationsSinksUpdate Text
160+osuSinkName
161+ = lens _osuSinkName (\ s a -> s{_osuSinkName = a})
162+
163+-- | JSONP
164+osuCallback :: Lens' OrganizationsSinksUpdate (Maybe Text)
165+osuCallback
166+ = lens _osuCallback (\ s a -> s{_osuCallback = a})
167+
168+instance GoogleRequest OrganizationsSinksUpdate where
169+ type Rs OrganizationsSinksUpdate = LogSink
170+ type Scopes OrganizationsSinksUpdate =
171+ '["https://www.googleapis.com/auth/cloud-platform",
172+ "https://www.googleapis.com/auth/logging.admin"]
173+ requestClient OrganizationsSinksUpdate'{..}
174+ = go _osuSinkName _osuXgafv _osuUploadProtocol
175+ (Just _osuPp)
176+ _osuAccessToken
177+ _osuUploadType
178+ _osuBearerToken
179+ _osuCallback
180+ (Just AltJSON)
181+ _osuPayload
182+ loggingService
183+ where go
184+ = buildClient
185+ (Proxy :: Proxy OrganizationsSinksUpdateResource)
186+ mempty
gogol-logging/gen/Network/Google/Resource/Logging/Projects/Logs/Delete.hs+5−5
@@ -23,7 +23,7 @@
2323-- Deletes a log and all its log entries. The log will reappear if it
2424-- receives new entries.
2525--
26−-- /See:/ <https://cloud.google.com/logging/docs/ Google Cloud Logging API Reference> for @logging.projects.logs.delete@.
26+-- /See:/ <https://cloud.google.com/logging/docs/ Stackdriver Logging API Reference> for @logging.projects.logs.delete@.
2727module Network.Google.Resource.Logging.Projects.Logs.Delete
2828 (
2929 -- * REST Resource
@@ -50,9 +50,9 @@ import Network.Google.Prelude
5050-- | A resource alias for @logging.projects.logs.delete@ method which the
5151-- 'ProjectsLogsDelete' request conforms to.
5252type ProjectsLogsDeleteResource =
53− "v2beta1" :>
53+ "v2" :>
5454 Capture "logName" Text :>
55− QueryParam "$.xgafv" Text :>
55+ QueryParam "$.xgafv" Xgafv :>
5656 QueryParam "upload_protocol" Text :>
5757 QueryParam "pp" Bool :>
5858 QueryParam "access_token" Text :>
@@ -66,7 +66,7 @@ type ProjectsLogsDeleteResource =
6666--
6767-- /See:/ 'projectsLogsDelete' smart constructor.
6868data ProjectsLogsDelete = ProjectsLogsDelete'
69− { _pldXgafv :: !(Maybe Text)
69+ { _pldXgafv :: !(Maybe Xgafv)
7070 , _pldUploadProtocol :: !(Maybe Text)
7171 , _pldPp :: !Bool
7272 , _pldAccessToken :: !(Maybe Text)
@@ -111,7 +111,7 @@ projectsLogsDelete pPldLogName_ =
111111 }
112112
113113-- | V1 error format.
114−pldXgafv :: Lens' ProjectsLogsDelete (Maybe Text)
114+pldXgafv :: Lens' ProjectsLogsDelete (Maybe Xgafv)
115115pldXgafv = lens _pldXgafv (\ s a -> s{_pldXgafv = a})
116116
117117-- | Upload protocol for media (e.g. \"raw\", \"multipart\").
gogol-logging/gen/Network/Google/Resource/Logging/Projects/Metrics/Create.hs+23−24
@@ -22,7 +22,7 @@
2222--
2323-- Creates a logs-based metric.
2424--
25−-- /See:/ <https://cloud.google.com/logging/docs/ Google Cloud Logging API Reference> for @logging.projects.metrics.create@.
25+-- /See:/ <https://cloud.google.com/logging/docs/ Stackdriver Logging API Reference> for @logging.projects.metrics.create@.
2626module Network.Google.Resource.Logging.Projects.Metrics.Create
2727 (
2828 -- * REST Resource
@@ -33,6 +33,7 @@ module Network.Google.Resource.Logging.Projects.Metrics.Create
3333 , ProjectsMetricsCreate
3434
3535 -- * Request Lenses
36+ , pmcParent
3637 , pmcXgafv
3738 , pmcUploadProtocol
3839 , pmcPp
@@ -40,7 +41,6 @@ module Network.Google.Resource.Logging.Projects.Metrics.Create
4041 , pmcUploadType
4142 , pmcPayload
4243 , pmcBearerToken
43− , pmcProjectName
4444 , pmcCallback
4545 ) where
4646
@@ -50,10 +50,10 @@ import Network.Google.Prelude
5050-- | A resource alias for @logging.projects.metrics.create@ method which the
5151-- 'ProjectsMetricsCreate' request conforms to.
5252type ProjectsMetricsCreateResource =
53− "v2beta1" :>
54− Capture "projectName" Text :>
53+ "v2" :>
54+ Capture "parent" Text :>
5555 "metrics" :>
56− QueryParam "$.xgafv" Text :>
56+ QueryParam "$.xgafv" Xgafv :>
5757 QueryParam "upload_protocol" Text :>
5858 QueryParam "pp" Bool :>
5959 QueryParam "access_token" Text :>
@@ -67,14 +67,14 @@ type ProjectsMetricsCreateResource =
6767--
6868-- /See:/ 'projectsMetricsCreate' smart constructor.
6969data ProjectsMetricsCreate = ProjectsMetricsCreate'
70− { _pmcXgafv :: !(Maybe Text)
70+ { _pmcParent :: !Text
71+ , _pmcXgafv :: !(Maybe Xgafv)
7172 , _pmcUploadProtocol :: !(Maybe Text)
7273 , _pmcPp :: !Bool
7374 , _pmcAccessToken :: !(Maybe Text)
7475 , _pmcUploadType :: !(Maybe Text)
7576 , _pmcPayload :: !LogMetric
7677 , _pmcBearerToken :: !(Maybe Text)
77− , _pmcProjectName :: !Text
7878 , _pmcCallback :: !(Maybe Text)
7979 } deriving (Eq,Show,Data,Typeable,Generic)
8080
@@ -82,6 +82,8 @@ data ProjectsMetricsCreate = ProjectsMetricsCreate'
8282--
8383-- Use one of the following lenses to modify other fields as desired:
8484--
85+-- * 'pmcParent'
86+--
8587-- * 'pmcXgafv'
8688--
8789-- * 'pmcUploadProtocol'
@@ -96,28 +98,33 @@ data ProjectsMetricsCreate = ProjectsMetricsCreate'
9698--
9799-- * 'pmcBearerToken'
98100--
99−-- * 'pmcProjectName'
100−--
101101-- * 'pmcCallback'
102102projectsMetricsCreate
103− :: LogMetric -- ^ 'pmcPayload'
104− -> Text -- ^ 'pmcProjectName'
103+ :: Text -- ^ 'pmcParent'
104+ -> LogMetric -- ^ 'pmcPayload'
105105 -> ProjectsMetricsCreate
106−projectsMetricsCreate pPmcPayload_ pPmcProjectName_ =
106+projectsMetricsCreate pPmcParent_ pPmcPayload_ =
107107 ProjectsMetricsCreate'
108− { _pmcXgafv = Nothing
108+ { _pmcParent = pPmcParent_
109+ , _pmcXgafv = Nothing
109110 , _pmcUploadProtocol = Nothing
110111 , _pmcPp = True
111112 , _pmcAccessToken = Nothing
112113 , _pmcUploadType = Nothing
113114 , _pmcPayload = pPmcPayload_
114115 , _pmcBearerToken = Nothing
115− , _pmcProjectName = pPmcProjectName_
116116 , _pmcCallback = Nothing
117117 }
118118
119+-- | The resource name of the project in which to create the metric. Example:
120+-- \`\"projects\/my-project-id\"\`. The new metric must be provided in the
121+-- request.
122+pmcParent :: Lens' ProjectsMetricsCreate Text
123+pmcParent
124+ = lens _pmcParent (\ s a -> s{_pmcParent = a})
125+
119126-- | V1 error format.
120−pmcXgafv :: Lens' ProjectsMetricsCreate (Maybe Text)
127+pmcXgafv :: Lens' ProjectsMetricsCreate (Maybe Xgafv)
121128pmcXgafv = lens _pmcXgafv (\ s a -> s{_pmcXgafv = a})
122129
123130-- | Upload protocol for media (e.g. \"raw\", \"multipart\").
@@ -153,14 +160,6 @@ pmcBearerToken
153160 = lens _pmcBearerToken
154161 (\ s a -> s{_pmcBearerToken = a})
155162
156−-- | The resource name of the project in which to create the metric. Example:
157−-- \`\"projects\/my-project-id\"\`. The new metric must be provided in the
158−-- request.
159−pmcProjectName :: Lens' ProjectsMetricsCreate Text
160−pmcProjectName
161− = lens _pmcProjectName
162− (\ s a -> s{_pmcProjectName = a})
163−
164163-- | JSONP
165164pmcCallback :: Lens' ProjectsMetricsCreate (Maybe Text)
166165pmcCallback
@@ -173,7 +172,7 @@ instance GoogleRequest ProjectsMetricsCreate where
173172 "https://www.googleapis.com/auth/logging.admin",
174173 "https://www.googleapis.com/auth/logging.write"]
175174 requestClient ProjectsMetricsCreate'{..}
176− = go _pmcProjectName _pmcXgafv _pmcUploadProtocol
175+ = go _pmcParent _pmcXgafv _pmcUploadProtocol
177176 (Just _pmcPp)
178177 _pmcAccessToken
179178 _pmcUploadType
gogol-logging/gen/Network/Google/Resource/Logging/Projects/Metrics/Delete.hs+5−5
@@ -22,7 +22,7 @@
2222--
2323-- Deletes a logs-based metric.
2424--
25−-- /See:/ <https://cloud.google.com/logging/docs/ Google Cloud Logging API Reference> for @logging.projects.metrics.delete@.
25+-- /See:/ <https://cloud.google.com/logging/docs/ Stackdriver Logging API Reference> for @logging.projects.metrics.delete@.
2626module Network.Google.Resource.Logging.Projects.Metrics.Delete
2727 (
2828 -- * REST Resource
@@ -49,9 +49,9 @@ import Network.Google.Prelude
4949-- | A resource alias for @logging.projects.metrics.delete@ method which the
5050-- 'ProjectsMetricsDelete' request conforms to.
5151type ProjectsMetricsDeleteResource =
52− "v2beta1" :>
52+ "v2" :>
5353 Capture "metricName" Text :>
54− QueryParam "$.xgafv" Text :>
54+ QueryParam "$.xgafv" Xgafv :>
5555 QueryParam "upload_protocol" Text :>
5656 QueryParam "pp" Bool :>
5757 QueryParam "access_token" Text :>
@@ -64,7 +64,7 @@ type ProjectsMetricsDeleteResource =
6464--
6565-- /See:/ 'projectsMetricsDelete' smart constructor.
6666data ProjectsMetricsDelete = ProjectsMetricsDelete'
67− { _pmdXgafv :: !(Maybe Text)
67+ { _pmdXgafv :: !(Maybe Xgafv)
6868 , _pmdUploadProtocol :: !(Maybe Text)
6969 , _pmdPp :: !Bool
7070 , _pmdAccessToken :: !(Maybe Text)
@@ -109,7 +109,7 @@ projectsMetricsDelete pPmdMetricName_ =
109109 }
110110
111111-- | V1 error format.
112−pmdXgafv :: Lens' ProjectsMetricsDelete (Maybe Text)
112+pmdXgafv :: Lens' ProjectsMetricsDelete (Maybe Xgafv)
113113pmdXgafv = lens _pmdXgafv (\ s a -> s{_pmdXgafv = a})
114114
115115-- | Upload protocol for media (e.g. \"raw\", \"multipart\").
gogol-logging/gen/Network/Google/Resource/Logging/Projects/Metrics/Get.hs+5−5
@@ -22,7 +22,7 @@
2222--
2323-- Gets a logs-based metric.
2424--
25−-- /See:/ <https://cloud.google.com/logging/docs/ Google Cloud Logging API Reference> for @logging.projects.metrics.get@.
25+-- /See:/ <https://cloud.google.com/logging/docs/ Stackdriver Logging API Reference> for @logging.projects.metrics.get@.
2626module Network.Google.Resource.Logging.Projects.Metrics.Get
2727 (
2828 -- * REST Resource
@@ -49,9 +49,9 @@ import Network.Google.Prelude
4949-- | A resource alias for @logging.projects.metrics.get@ method which the
5050-- 'ProjectsMetricsGet' request conforms to.
5151type ProjectsMetricsGetResource =
52− "v2beta1" :>
52+ "v2" :>
5353 Capture "metricName" Text :>
54− QueryParam "$.xgafv" Text :>
54+ QueryParam "$.xgafv" Xgafv :>
5555 QueryParam "upload_protocol" Text :>
5656 QueryParam "pp" Bool :>
5757 QueryParam "access_token" Text :>
@@ -64,7 +64,7 @@ type ProjectsMetricsGetResource =
6464--
6565-- /See:/ 'projectsMetricsGet' smart constructor.
6666data ProjectsMetricsGet = ProjectsMetricsGet'
67− { _pmgXgafv :: !(Maybe Text)
67+ { _pmgXgafv :: !(Maybe Xgafv)
6868 , _pmgUploadProtocol :: !(Maybe Text)
6969 , _pmgPp :: !Bool
7070 , _pmgAccessToken :: !(Maybe Text)
@@ -109,7 +109,7 @@ projectsMetricsGet pPmgMetricName_ =
109109 }
110110
111111-- | V1 error format.
112−pmgXgafv :: Lens' ProjectsMetricsGet (Maybe Text)
112+pmgXgafv :: Lens' ProjectsMetricsGet (Maybe Xgafv)
113113pmgXgafv = lens _pmgXgafv (\ s a -> s{_pmgXgafv = a})
114114
115115-- | Upload protocol for media (e.g. \"raw\", \"multipart\").
gogol-logging/gen/Network/Google/Resource/Logging/Projects/Metrics/List.hs+28−31
@@ -22,7 +22,7 @@
2222--
2323-- Lists logs-based metrics.
2424--
25−-- /See:/ <https://cloud.google.com/logging/docs/ Google Cloud Logging API Reference> for @logging.projects.metrics.list@.
25+-- /See:/ <https://cloud.google.com/logging/docs/ Stackdriver Logging API Reference> for @logging.projects.metrics.list@.
2626module Network.Google.Resource.Logging.Projects.Metrics.List
2727 (
2828 -- * REST Resource
@@ -33,13 +33,13 @@ module Network.Google.Resource.Logging.Projects.Metrics.List
3333 , ProjectsMetricsList
3434
3535 -- * Request Lenses
36+ , pmlParent
3637 , pmlXgafv
3738 , pmlUploadProtocol
3839 , pmlPp
3940 , pmlAccessToken
4041 , pmlUploadType
4142 , pmlBearerToken
42− , pmlProjectName
4343 , pmlPageToken
4444 , pmlPageSize
4545 , pmlCallback
@@ -51,10 +51,10 @@ import Network.Google.Prelude
5151-- | A resource alias for @logging.projects.metrics.list@ method which the
5252-- 'ProjectsMetricsList' request conforms to.
5353type ProjectsMetricsListResource =
54− "v2beta1" :>
55− Capture "projectName" Text :>
54+ "v2" :>
55+ Capture "parent" Text :>
5656 "metrics" :>
57− QueryParam "$.xgafv" Text :>
57+ QueryParam "$.xgafv" Xgafv :>
5858 QueryParam "upload_protocol" Text :>
5959 QueryParam "pp" Bool :>
6060 QueryParam "access_token" Text :>
@@ -70,13 +70,13 @@ type ProjectsMetricsListResource =
7070--
7171-- /See:/ 'projectsMetricsList' smart constructor.
7272data ProjectsMetricsList = ProjectsMetricsList'
73− { _pmlXgafv :: !(Maybe Text)
73+ { _pmlParent :: !Text
74+ , _pmlXgafv :: !(Maybe Xgafv)
7475 , _pmlUploadProtocol :: !(Maybe Text)
7576 , _pmlPp :: !Bool
7677 , _pmlAccessToken :: !(Maybe Text)
7778 , _pmlUploadType :: !(Maybe Text)
7879 , _pmlBearerToken :: !(Maybe Text)
79− , _pmlProjectName :: !Text
8080 , _pmlPageToken :: !(Maybe Text)
8181 , _pmlPageSize :: !(Maybe (Textual Int32))
8282 , _pmlCallback :: !(Maybe Text)
@@ -86,6 +86,8 @@ data ProjectsMetricsList = ProjectsMetricsList'
8686--
8787-- Use one of the following lenses to modify other fields as desired:
8888--
89+-- * 'pmlParent'
90+--
8991-- * 'pmlXgafv'
9092--
9193-- * 'pmlUploadProtocol'
@@ -98,32 +100,36 @@ data ProjectsMetricsList = ProjectsMetricsList'
98100--
99101-- * 'pmlBearerToken'
100102--
101−-- * 'pmlProjectName'
102−--
103103-- * 'pmlPageToken'
104104--
105105-- * 'pmlPageSize'
106106--
107107-- * 'pmlCallback'
108108projectsMetricsList
109− :: Text -- ^ 'pmlProjectName'
109+ :: Text -- ^ 'pmlParent'
110110 -> ProjectsMetricsList
111−projectsMetricsList pPmlProjectName_ =
111+projectsMetricsList pPmlParent_ =
112112 ProjectsMetricsList'
113− { _pmlXgafv = Nothing
113+ { _pmlParent = pPmlParent_
114+ , _pmlXgafv = Nothing
114115 , _pmlUploadProtocol = Nothing
115116 , _pmlPp = True
116117 , _pmlAccessToken = Nothing
117118 , _pmlUploadType = Nothing
118119 , _pmlBearerToken = Nothing
119− , _pmlProjectName = pPmlProjectName_
120120 , _pmlPageToken = Nothing
121121 , _pmlPageSize = Nothing
122122 , _pmlCallback = Nothing
123123 }
124124
125+-- | Required. The resource name containing the metrics. Example:
126+-- \`\"projects\/my-project-id\"\`.
127+pmlParent :: Lens' ProjectsMetricsList Text
128+pmlParent
129+ = lens _pmlParent (\ s a -> s{_pmlParent = a})
130+
125131-- | V1 error format.
126−pmlXgafv :: Lens' ProjectsMetricsList (Maybe Text)
132+pmlXgafv :: Lens' ProjectsMetricsList (Maybe Xgafv)
127133pmlXgafv = lens _pmlXgafv (\ s a -> s{_pmlXgafv = a})
128134
129135-- | Upload protocol for media (e.g. \"raw\", \"multipart\").
@@ -154,26 +160,17 @@ pmlBearerToken
154160 = lens _pmlBearerToken
155161 (\ s a -> s{_pmlBearerToken = a})
156162
157−-- | Required. The resource name of the project containing the metrics.
158−-- Example: \`\"projects\/my-project-id\"\`.
159−pmlProjectName :: Lens' ProjectsMetricsList Text
160−pmlProjectName
161− = lens _pmlProjectName
162− (\ s a -> s{_pmlProjectName = a})
163−
164−-- | Optional. If the \`pageToken\` parameter is supplied, then the next page
165−-- of results is retrieved. The \`pageToken\` parameter must be set to the
166−-- value of the \`nextPageToken\` from the previous response. The value of
167−-- \`projectName\` must be the same as in the previous request.
163+-- | Optional. If present, then retrieve the next batch of results from the
164+-- preceding call to this method. \`pageToken\` must be the value of
165+-- \`nextPageToken\` from the previous response. The values of other method
166+-- parameters should be identical to those in the previous call.
168167pmlPageToken :: Lens' ProjectsMetricsList (Maybe Text)
169168pmlPageToken
170169 = lens _pmlPageToken (\ s a -> s{_pmlPageToken = a})
171170
172−-- | Optional. The maximum number of results to return from this request. You
173−-- must check for presence of \`nextPageToken\` to determine if additional
174−-- results are available, which you can retrieve by passing the
175−-- \`nextPageToken\` value as the \`pageToken\` parameter in the next
176−-- request.
171+-- | Optional. The maximum number of results to return from this request.
172+-- Non-positive values are ignored. The presence of \`nextPageToken\` in
173+-- the response indicates that more results might be available.
177174pmlPageSize :: Lens' ProjectsMetricsList (Maybe Int32)
178175pmlPageSize
179176 = lens _pmlPageSize (\ s a -> s{_pmlPageSize = a}) .
@@ -192,7 +189,7 @@ instance GoogleRequest ProjectsMetricsList where
192189 "https://www.googleapis.com/auth/logging.admin",
193190 "https://www.googleapis.com/auth/logging.read"]
194191 requestClient ProjectsMetricsList'{..}
195− = go _pmlProjectName _pmlXgafv _pmlUploadProtocol
192+ = go _pmlParent _pmlXgafv _pmlUploadProtocol
196193 (Just _pmlPp)
197194 _pmlAccessToken
198195 _pmlUploadType
gogol-logging/gen/Network/Google/Resource/Logging/Projects/Metrics/Update.hs+5−5
@@ -22,7 +22,7 @@
2222--
2323-- Creates or updates a logs-based metric.
2424--
25−-- /See:/ <https://cloud.google.com/logging/docs/ Google Cloud Logging API Reference> for @logging.projects.metrics.update@.
25+-- /See:/ <https://cloud.google.com/logging/docs/ Stackdriver Logging API Reference> for @logging.projects.metrics.update@.
2626module Network.Google.Resource.Logging.Projects.Metrics.Update
2727 (
2828 -- * REST Resource
@@ -50,9 +50,9 @@ import Network.Google.Prelude
5050-- | A resource alias for @logging.projects.metrics.update@ method which the
5151-- 'ProjectsMetricsUpdate' request conforms to.
5252type ProjectsMetricsUpdateResource =
53− "v2beta1" :>
53+ "v2" :>
5454 Capture "metricName" Text :>
55− QueryParam "$.xgafv" Text :>
55+ QueryParam "$.xgafv" Xgafv :>
5656 QueryParam "upload_protocol" Text :>
5757 QueryParam "pp" Bool :>
5858 QueryParam "access_token" Text :>
@@ -66,7 +66,7 @@ type ProjectsMetricsUpdateResource =
6666--
6767-- /See:/ 'projectsMetricsUpdate' smart constructor.
6868data ProjectsMetricsUpdate = ProjectsMetricsUpdate'
69− { _pmuXgafv :: !(Maybe Text)
69+ { _pmuXgafv :: !(Maybe Xgafv)
7070 , _pmuUploadProtocol :: !(Maybe Text)
7171 , _pmuPp :: !Bool
7272 , _pmuAccessToken :: !(Maybe Text)
@@ -116,7 +116,7 @@ projectsMetricsUpdate pPmuMetricName_ pPmuPayload_ =
116116 }
117117
118118-- | V1 error format.
119−pmuXgafv :: Lens' ProjectsMetricsUpdate (Maybe Text)
119+pmuXgafv :: Lens' ProjectsMetricsUpdate (Maybe Xgafv)
120120pmuXgafv = lens _pmuXgafv (\ s a -> s{_pmuXgafv = a})
121121
122122-- | Upload protocol for media (e.g. \"raw\", \"multipart\").
gogol-logging/gen/Network/Google/Resource/Logging/Projects/Sinks/Create.hs+23−24
@@ -22,7 +22,7 @@
2222--
2323-- Creates a sink.
2424--
25−-- /See:/ <https://cloud.google.com/logging/docs/ Google Cloud Logging API Reference> for @logging.projects.sinks.create@.
25+-- /See:/ <https://cloud.google.com/logging/docs/ Stackdriver Logging API Reference> for @logging.projects.sinks.create@.
2626module Network.Google.Resource.Logging.Projects.Sinks.Create
2727 (
2828 -- * REST Resource
@@ -33,6 +33,7 @@ module Network.Google.Resource.Logging.Projects.Sinks.Create
3333 , ProjectsSinksCreate
3434
3535 -- * Request Lenses
36+ , pscParent
3637 , pscXgafv
3738 , pscUploadProtocol
3839 , pscPp
@@ -40,7 +41,6 @@ module Network.Google.Resource.Logging.Projects.Sinks.Create
4041 , pscUploadType
4142 , pscPayload
4243 , pscBearerToken
43− , pscProjectName
4444 , pscCallback
4545 ) where
4646
@@ -50,10 +50,10 @@ import Network.Google.Prelude
5050-- | A resource alias for @logging.projects.sinks.create@ method which the
5151-- 'ProjectsSinksCreate' request conforms to.
5252type ProjectsSinksCreateResource =
53− "v2beta1" :>
54− Capture "projectName" Text :>
53+ "v2" :>
54+ Capture "parent" Text :>
5555 "sinks" :>
56− QueryParam "$.xgafv" Text :>
56+ QueryParam "$.xgafv" Xgafv :>
5757 QueryParam "upload_protocol" Text :>
5858 QueryParam "pp" Bool :>
5959 QueryParam "access_token" Text :>
@@ -67,14 +67,14 @@ type ProjectsSinksCreateResource =
6767--
6868-- /See:/ 'projectsSinksCreate' smart constructor.
6969data ProjectsSinksCreate = ProjectsSinksCreate'
70− { _pscXgafv :: !(Maybe Text)
70+ { _pscParent :: !Text
71+ , _pscXgafv :: !(Maybe Xgafv)
7172 , _pscUploadProtocol :: !(Maybe Text)
7273 , _pscPp :: !Bool
7374 , _pscAccessToken :: !(Maybe Text)
7475 , _pscUploadType :: !(Maybe Text)
7576 , _pscPayload :: !LogSink
7677 , _pscBearerToken :: !(Maybe Text)
77− , _pscProjectName :: !Text
7878 , _pscCallback :: !(Maybe Text)
7979 } deriving (Eq,Show,Data,Typeable,Generic)
8080
@@ -82,6 +82,8 @@ data ProjectsSinksCreate = ProjectsSinksCreate'
8282--
8383-- Use one of the following lenses to modify other fields as desired:
8484--
85+-- * 'pscParent'
86+--
8587-- * 'pscXgafv'
8688--
8789-- * 'pscUploadProtocol'
@@ -96,28 +98,33 @@ data ProjectsSinksCreate = ProjectsSinksCreate'
9698--
9799-- * 'pscBearerToken'
98100--
99−-- * 'pscProjectName'
100−--
101101-- * 'pscCallback'
102102projectsSinksCreate
103− :: LogSink -- ^ 'pscPayload'
104− -> Text -- ^ 'pscProjectName'
103+ :: Text -- ^ 'pscParent'
104+ -> LogSink -- ^ 'pscPayload'
105105 -> ProjectsSinksCreate
106−projectsSinksCreate pPscPayload_ pPscProjectName_ =
106+projectsSinksCreate pPscParent_ pPscPayload_ =
107107 ProjectsSinksCreate'
108− { _pscXgafv = Nothing
108+ { _pscParent = pPscParent_
109+ , _pscXgafv = Nothing
109110 , _pscUploadProtocol = Nothing
110111 , _pscPp = True
111112 , _pscAccessToken = Nothing
112113 , _pscUploadType = Nothing
113114 , _pscPayload = pPscPayload_
114115 , _pscBearerToken = Nothing
115− , _pscProjectName = pPscProjectName_
116116 , _pscCallback = Nothing
117117 }
118118
119+-- | Required. The resource in which to create the sink. Example:
120+-- \`\"projects\/my-project-id\"\`. The new sink must be provided in the
121+-- request.
122+pscParent :: Lens' ProjectsSinksCreate Text
123+pscParent
124+ = lens _pscParent (\ s a -> s{_pscParent = a})
125+
119126-- | V1 error format.
120−pscXgafv :: Lens' ProjectsSinksCreate (Maybe Text)
127+pscXgafv :: Lens' ProjectsSinksCreate (Maybe Xgafv)
121128pscXgafv = lens _pscXgafv (\ s a -> s{_pscXgafv = a})
122129
123130-- | Upload protocol for media (e.g. \"raw\", \"multipart\").
@@ -153,14 +160,6 @@ pscBearerToken
153160 = lens _pscBearerToken
154161 (\ s a -> s{_pscBearerToken = a})
155162
156−-- | The resource name of the project in which to create the sink. Example:
157−-- \`\"projects\/my-project-id\"\`. The new sink must be provided in the
158−-- request.
159−pscProjectName :: Lens' ProjectsSinksCreate Text
160−pscProjectName
161− = lens _pscProjectName
162− (\ s a -> s{_pscProjectName = a})
163−
164163-- | JSONP
165164pscCallback :: Lens' ProjectsSinksCreate (Maybe Text)
166165pscCallback
@@ -172,7 +171,7 @@ instance GoogleRequest ProjectsSinksCreate where
172171 '["https://www.googleapis.com/auth/cloud-platform",
173172 "https://www.googleapis.com/auth/logging.admin"]
174173 requestClient ProjectsSinksCreate'{..}
175− = go _pscProjectName _pscXgafv _pscUploadProtocol
174+ = go _pscParent _pscXgafv _pscUploadProtocol
176175 (Just _pscPp)
177176 _pscAccessToken
178177 _pscUploadType
gogol-logging/gen/Network/Google/Resource/Logging/Projects/Sinks/Delete.hs+9−7
@@ -22,7 +22,7 @@
2222--
2323-- Deletes a sink.
2424--
25−-- /See:/ <https://cloud.google.com/logging/docs/ Google Cloud Logging API Reference> for @logging.projects.sinks.delete@.
25+-- /See:/ <https://cloud.google.com/logging/docs/ Stackdriver Logging API Reference> for @logging.projects.sinks.delete@.
2626module Network.Google.Resource.Logging.Projects.Sinks.Delete
2727 (
2828 -- * REST Resource
@@ -49,9 +49,9 @@ import Network.Google.Prelude
4949-- | A resource alias for @logging.projects.sinks.delete@ method which the
5050-- 'ProjectsSinksDelete' request conforms to.
5151type ProjectsSinksDeleteResource =
52− "v2beta1" :>
52+ "v2" :>
5353 Capture "sinkName" Text :>
54− QueryParam "$.xgafv" Text :>
54+ QueryParam "$.xgafv" Xgafv :>
5555 QueryParam "upload_protocol" Text :>
5656 QueryParam "pp" Bool :>
5757 QueryParam "access_token" Text :>
@@ -64,7 +64,7 @@ type ProjectsSinksDeleteResource =
6464--
6565-- /See:/ 'projectsSinksDelete' smart constructor.
6666data ProjectsSinksDelete = ProjectsSinksDelete'
67− { _psdXgafv :: !(Maybe Text)
67+ { _psdXgafv :: !(Maybe Xgafv)
6868 , _psdUploadProtocol :: !(Maybe Text)
6969 , _psdPp :: !Bool
7070 , _psdAccessToken :: !(Maybe Text)
@@ -109,7 +109,7 @@ projectsSinksDelete pPsdSinkName_ =
109109 }
110110
111111-- | V1 error format.
112−psdXgafv :: Lens' ProjectsSinksDelete (Maybe Text)
112+psdXgafv :: Lens' ProjectsSinksDelete (Maybe Xgafv)
113113psdXgafv = lens _psdXgafv (\ s a -> s{_psdXgafv = a})
114114
115115-- | Upload protocol for media (e.g. \"raw\", \"multipart\").
@@ -140,8 +140,10 @@ psdBearerToken
140140 = lens _psdBearerToken
141141 (\ s a -> s{_psdBearerToken = a})
142142
143−-- | The resource name of the sink to delete. Example:
144−-- \`\"projects\/my-project-id\/sinks\/my-sink-id\"\`.
143+-- | Required. The resource name of the sink to delete, including the parent
144+-- resource and the sink identifier. Example:
145+-- \`\"projects\/my-project-id\/sinks\/my-sink-id\"\`. It is an error if
146+-- the sink does not exist.
145147psdSinkName :: Lens' ProjectsSinksDelete Text
146148psdSinkName
147149 = lens _psdSinkName (\ s a -> s{_psdSinkName = a})
gogol-logging/gen/Network/Google/Resource/Logging/Projects/Sinks/Get.hs+6−6
@@ -22,7 +22,7 @@
2222--
2323-- Gets a sink.
2424--
25−-- /See:/ <https://cloud.google.com/logging/docs/ Google Cloud Logging API Reference> for @logging.projects.sinks.get@.
25+-- /See:/ <https://cloud.google.com/logging/docs/ Stackdriver Logging API Reference> for @logging.projects.sinks.get@.
2626module Network.Google.Resource.Logging.Projects.Sinks.Get
2727 (
2828 -- * REST Resource
@@ -49,9 +49,9 @@ import Network.Google.Prelude
4949-- | A resource alias for @logging.projects.sinks.get@ method which the
5050-- 'ProjectsSinksGet' request conforms to.
5151type ProjectsSinksGetResource =
52− "v2beta1" :>
52+ "v2" :>
5353 Capture "sinkName" Text :>
54− QueryParam "$.xgafv" Text :>
54+ QueryParam "$.xgafv" Xgafv :>
5555 QueryParam "upload_protocol" Text :>
5656 QueryParam "pp" Bool :>
5757 QueryParam "access_token" Text :>
@@ -64,7 +64,7 @@ type ProjectsSinksGetResource =
6464--
6565-- /See:/ 'projectsSinksGet' smart constructor.
6666data ProjectsSinksGet = ProjectsSinksGet'
67− { _psgXgafv :: !(Maybe Text)
67+ { _psgXgafv :: !(Maybe Xgafv)
6868 , _psgUploadProtocol :: !(Maybe Text)
6969 , _psgPp :: !Bool
7070 , _psgAccessToken :: !(Maybe Text)
@@ -109,7 +109,7 @@ projectsSinksGet pPsgSinkName_ =
109109 }
110110
111111-- | V1 error format.
112−psgXgafv :: Lens' ProjectsSinksGet (Maybe Text)
112+psgXgafv :: Lens' ProjectsSinksGet (Maybe Xgafv)
113113psgXgafv = lens _psgXgafv (\ s a -> s{_psgXgafv = a})
114114
115115-- | Upload protocol for media (e.g. \"raw\", \"multipart\").
@@ -140,7 +140,7 @@ psgBearerToken
140140 = lens _psgBearerToken
141141 (\ s a -> s{_psgBearerToken = a})
142142
143−-- | The resource name of the sink to return. Example:
143+-- | Required. The resource name of the sink to return. Example:
144144-- \`\"projects\/my-project-id\/sinks\/my-sink-id\"\`.
145145psgSinkName :: Lens' ProjectsSinksGet Text
146146psgSinkName
gogol-logging/gen/Network/Google/Resource/Logging/Projects/Sinks/List.hs+28−31
@@ -22,7 +22,7 @@
2222--
2323-- Lists sinks.
2424--
25−-- /See:/ <https://cloud.google.com/logging/docs/ Google Cloud Logging API Reference> for @logging.projects.sinks.list@.
25+-- /See:/ <https://cloud.google.com/logging/docs/ Stackdriver Logging API Reference> for @logging.projects.sinks.list@.
2626module Network.Google.Resource.Logging.Projects.Sinks.List
2727 (
2828 -- * REST Resource
@@ -33,13 +33,13 @@ module Network.Google.Resource.Logging.Projects.Sinks.List
3333 , ProjectsSinksList
3434
3535 -- * Request Lenses
36+ , pslParent
3637 , pslXgafv
3738 , pslUploadProtocol
3839 , pslPp
3940 , pslAccessToken
4041 , pslUploadType
4142 , pslBearerToken
42− , pslProjectName
4343 , pslPageToken
4444 , pslPageSize
4545 , pslCallback
@@ -51,10 +51,10 @@ import Network.Google.Prelude
5151-- | A resource alias for @logging.projects.sinks.list@ method which the
5252-- 'ProjectsSinksList' request conforms to.
5353type ProjectsSinksListResource =
54− "v2beta1" :>
55− Capture "projectName" Text :>
54+ "v2" :>
55+ Capture "parent" Text :>
5656 "sinks" :>
57− QueryParam "$.xgafv" Text :>
57+ QueryParam "$.xgafv" Xgafv :>
5858 QueryParam "upload_protocol" Text :>
5959 QueryParam "pp" Bool :>
6060 QueryParam "access_token" Text :>
@@ -70,13 +70,13 @@ type ProjectsSinksListResource =
7070--
7171-- /See:/ 'projectsSinksList' smart constructor.
7272data ProjectsSinksList = ProjectsSinksList'
73− { _pslXgafv :: !(Maybe Text)
73+ { _pslParent :: !Text
74+ , _pslXgafv :: !(Maybe Xgafv)
7475 , _pslUploadProtocol :: !(Maybe Text)
7576 , _pslPp :: !Bool
7677 , _pslAccessToken :: !(Maybe Text)
7778 , _pslUploadType :: !(Maybe Text)
7879 , _pslBearerToken :: !(Maybe Text)
79− , _pslProjectName :: !Text
8080 , _pslPageToken :: !(Maybe Text)
8181 , _pslPageSize :: !(Maybe (Textual Int32))
8282 , _pslCallback :: !(Maybe Text)
@@ -86,6 +86,8 @@ data ProjectsSinksList = ProjectsSinksList'
8686--
8787-- Use one of the following lenses to modify other fields as desired:
8888--
89+-- * 'pslParent'
90+--
8991-- * 'pslXgafv'
9092--
9193-- * 'pslUploadProtocol'
@@ -98,32 +100,36 @@ data ProjectsSinksList = ProjectsSinksList'
98100--
99101-- * 'pslBearerToken'
100102--
101−-- * 'pslProjectName'
102−--
103103-- * 'pslPageToken'
104104--
105105-- * 'pslPageSize'
106106--
107107-- * 'pslCallback'
108108projectsSinksList
109− :: Text -- ^ 'pslProjectName'
109+ :: Text -- ^ 'pslParent'
110110 -> ProjectsSinksList
111−projectsSinksList pPslProjectName_ =
111+projectsSinksList pPslParent_ =
112112 ProjectsSinksList'
113− { _pslXgafv = Nothing
113+ { _pslParent = pPslParent_
114+ , _pslXgafv = Nothing
114115 , _pslUploadProtocol = Nothing
115116 , _pslPp = True
116117 , _pslAccessToken = Nothing
117118 , _pslUploadType = Nothing
118119 , _pslBearerToken = Nothing
119− , _pslProjectName = pPslProjectName_
120120 , _pslPageToken = Nothing
121121 , _pslPageSize = Nothing
122122 , _pslCallback = Nothing
123123 }
124124
125+-- | Required. The cloud resource containing the sinks. Example:
126+-- \`\"projects\/my-logging-project\"\`.
127+pslParent :: Lens' ProjectsSinksList Text
128+pslParent
129+ = lens _pslParent (\ s a -> s{_pslParent = a})
130+
125131-- | V1 error format.
126−pslXgafv :: Lens' ProjectsSinksList (Maybe Text)
132+pslXgafv :: Lens' ProjectsSinksList (Maybe Xgafv)
127133pslXgafv = lens _pslXgafv (\ s a -> s{_pslXgafv = a})
128134
129135-- | Upload protocol for media (e.g. \"raw\", \"multipart\").
@@ -154,26 +160,17 @@ pslBearerToken
154160 = lens _pslBearerToken
155161 (\ s a -> s{_pslBearerToken = a})
156162
157−-- | Required. The resource name of the project containing the sinks.
158−-- Example: \`\"projects\/my-logging-project\"\`.
159−pslProjectName :: Lens' ProjectsSinksList Text
160−pslProjectName
161− = lens _pslProjectName
162− (\ s a -> s{_pslProjectName = a})
163−
164−-- | Optional. If the \`pageToken\` parameter is supplied, then the next page
165−-- of results is retrieved. The \`pageToken\` parameter must be set to the
166−-- value of the \`nextPageToken\` from the previous response. The value of
167−-- \`projectName\` must be the same as in the previous request.
163+-- | Optional. If present, then retrieve the next batch of results from the
164+-- preceding call to this method. \`pageToken\` must be the value of
165+-- \`nextPageToken\` from the previous response. The values of other method
166+-- parameters should be identical to those in the previous call.
168167pslPageToken :: Lens' ProjectsSinksList (Maybe Text)
169168pslPageToken
170169 = lens _pslPageToken (\ s a -> s{_pslPageToken = a})
171170
172−-- | Optional. The maximum number of results to return from this request. You
173−-- must check for presence of \`nextPageToken\` to determine if additional
174−-- results are available, which you can retrieve by passing the
175−-- \`nextPageToken\` value as the \`pageToken\` parameter in the next
176−-- request.
171+-- | Optional. The maximum number of results to return from this request.
172+-- Non-positive values are ignored. The presence of \`nextPageToken\` in
173+-- the response indicates that more results might be available.
177174pslPageSize :: Lens' ProjectsSinksList (Maybe Int32)
178175pslPageSize
179176 = lens _pslPageSize (\ s a -> s{_pslPageSize = a}) .
@@ -192,7 +189,7 @@ instance GoogleRequest ProjectsSinksList where
192189 "https://www.googleapis.com/auth/logging.admin",
193190 "https://www.googleapis.com/auth/logging.read"]
194191 requestClient ProjectsSinksList'{..}
195− = go _pslProjectName _pslXgafv _pslUploadProtocol
192+ = go _pslParent _pslXgafv _pslUploadProtocol
196193 (Just _pslPp)
197194 _pslAccessToken
198195 _pslUploadType
gogol-logging/gen/Network/Google/Resource/Logging/Projects/Sinks/Update.hs+11−11
@@ -20,9 +20,9 @@
2020-- Stability : auto-generated
2121-- Portability : non-portable (GHC extensions)
2222--
23−-- Creates or updates a sink.
23+-- Updates or creates a sink.
2424--
25−-- /See:/ <https://cloud.google.com/logging/docs/ Google Cloud Logging API Reference> for @logging.projects.sinks.update@.
25+-- /See:/ <https://cloud.google.com/logging/docs/ Stackdriver Logging API Reference> for @logging.projects.sinks.update@.
2626module Network.Google.Resource.Logging.Projects.Sinks.Update
2727 (
2828 -- * REST Resource
@@ -50,9 +50,9 @@ import Network.Google.Prelude
5050-- | A resource alias for @logging.projects.sinks.update@ method which the
5151-- 'ProjectsSinksUpdate' request conforms to.
5252type ProjectsSinksUpdateResource =
53− "v2beta1" :>
53+ "v2" :>
5454 Capture "sinkName" Text :>
55− QueryParam "$.xgafv" Text :>
55+ QueryParam "$.xgafv" Xgafv :>
5656 QueryParam "upload_protocol" Text :>
5757 QueryParam "pp" Bool :>
5858 QueryParam "access_token" Text :>
@@ -62,11 +62,11 @@ type ProjectsSinksUpdateResource =
6262 QueryParam "alt" AltJSON :>
6363 ReqBody '[JSON] LogSink :> Put '[JSON] LogSink
6464
65−-- | Creates or updates a sink.
65+-- | Updates or creates a sink.
6666--
6767-- /See:/ 'projectsSinksUpdate' smart constructor.
6868data ProjectsSinksUpdate = ProjectsSinksUpdate'
69− { _psuXgafv :: !(Maybe Text)
69+ { _psuXgafv :: !(Maybe Xgafv)
7070 , _psuUploadProtocol :: !(Maybe Text)
7171 , _psuPp :: !Bool
7272 , _psuAccessToken :: !(Maybe Text)
@@ -116,7 +116,7 @@ projectsSinksUpdate pPsuPayload_ pPsuSinkName_ =
116116 }
117117
118118-- | V1 error format.
119−psuXgafv :: Lens' ProjectsSinksUpdate (Maybe Text)
119+psuXgafv :: Lens' ProjectsSinksUpdate (Maybe Xgafv)
120120psuXgafv = lens _psuXgafv (\ s a -> s{_psuXgafv = a})
121121
122122-- | Upload protocol for media (e.g. \"raw\", \"multipart\").
@@ -152,10 +152,10 @@ psuBearerToken
152152 = lens _psuBearerToken
153153 (\ s a -> s{_psuBearerToken = a})
154154
155−-- | The resource name of the sink to update. Example:
156−-- \`\"projects\/my-project-id\/sinks\/my-sink-id\"\`. The updated sink
157−-- must be provided in the request and have the same name that is specified
158−-- in \`sinkName\`. If the sink does not exist, it is created.
155+-- | Required. The resource name of the sink to update, including the parent
156+-- resource and the sink identifier. If the sink does not exist, this
157+-- method creates the sink. Example:
158+-- \`\"projects\/my-project-id\/sinks\/my-sink-id\"\`.
159159psuSinkName :: Lens' ProjectsSinksUpdate Text
160160psuSinkName
161161 = lens _psuSinkName (\ s a -> s{_psuSinkName = a})
gogol-logging/gogol-logging.cabal+10−4
@@ -1,6 +1,6 @@
11name: gogol-logging
22version: 0.1.0
3−synopsis: Google Cloud Logging SDK.
3+synopsis: Google Stackdriver Logging SDK.
44homepage: https://github.com/brendanhay/gogol
55bug-reports: https://github.com/brendanhay/gogol/issues
66license: OtherLicense
@@ -14,13 +14,12 @@ cabal-version: >= 1.10
1414extra-source-files: README.md
1515
1616description:
17− Writes log entries and manages your logs, log sinks, and logs-based
18− metrics.
17+ Writes log entries and manages your Stackdriver Logging configuration.
1918 .
2019 /Warning:/ This is an experimental prototype/preview release which is still
2120 under exploratory development and not intended for public use, caveat emptor!
2221 .
23− This library is compatible with version @v2beta1@
22+ This library is compatible with version @v2@
2423 of the API.
2524
2625source-repository head
@@ -36,9 +35,16 @@ library
3635 exposed-modules:
3736 Network.Google.Logging
3837 , Network.Google.Logging.Types
38+ , Network.Google.Resource.Logging.BillingAccounts.Logs.Delete
3939 , Network.Google.Resource.Logging.Entries.List
4040 , Network.Google.Resource.Logging.Entries.Write
4141 , Network.Google.Resource.Logging.MonitoredResourceDescriptors.List
42+ , Network.Google.Resource.Logging.Organizations.Logs.Delete
43+ , Network.Google.Resource.Logging.Organizations.Sinks.Create
44+ , Network.Google.Resource.Logging.Organizations.Sinks.Delete
45+ , Network.Google.Resource.Logging.Organizations.Sinks.Get
46+ , Network.Google.Resource.Logging.Organizations.Sinks.List
47+ , Network.Google.Resource.Logging.Organizations.Sinks.Update
4248 , Network.Google.Resource.Logging.Projects.Logs.Delete
4349 , Network.Google.Resource.Logging.Projects.Metrics.Create
4450 , Network.Google.Resource.Logging.Projects.Metrics.Delete