google-api-client 0.10.2 → 0.10.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (248) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +25 -0
  3. data/MIGRATING.md +22 -7
  4. data/README.md +4 -8
  5. data/api_names.yaml +1210 -37815
  6. data/generated/google/apis/acceleratedmobilepageurl_v1.rb +32 -0
  7. data/generated/google/apis/acceleratedmobilepageurl_v1/classes.rb +144 -0
  8. data/generated/google/apis/acceleratedmobilepageurl_v1/representations.rb +86 -0
  9. data/generated/google/apis/acceleratedmobilepageurl_v1/service.rb +90 -0
  10. data/generated/google/apis/adexchangebuyer2_v2beta1.rb +1 -1
  11. data/generated/google/apis/adexchangebuyer2_v2beta1/classes.rb +764 -764
  12. data/generated/google/apis/adexchangebuyer2_v2beta1/representations.rb +180 -180
  13. data/generated/google/apis/adexchangebuyer2_v2beta1/service.rb +421 -421
  14. data/generated/google/apis/adexchangebuyer_v1_4/classes.rb +1 -0
  15. data/generated/google/apis/admin_directory_v1/classes.rb +1 -0
  16. data/generated/google/apis/admin_reports_v1.rb +1 -1
  17. data/generated/google/apis/adsense_v1_4.rb +1 -1
  18. data/generated/google/apis/adsensehost_v4_1.rb +1 -1
  19. data/generated/google/apis/analyticsreporting_v4/classes.rb +187 -187
  20. data/generated/google/apis/analyticsreporting_v4/representations.rb +42 -42
  21. data/generated/google/apis/appengine_v1.rb +40 -0
  22. data/generated/google/apis/appengine_v1/classes.rb +2251 -0
  23. data/generated/google/apis/appengine_v1/representations.rb +858 -0
  24. data/generated/google/apis/appengine_v1/service.rb +894 -0
  25. data/generated/google/apis/bigquery_v2.rb +1 -1
  26. data/generated/google/apis/bigquery_v2/classes.rb +11 -6
  27. data/generated/google/apis/books_v1.rb +1 -1
  28. data/generated/google/apis/books_v1/classes.rb +26 -0
  29. data/generated/google/apis/books_v1/representations.rb +15 -0
  30. data/generated/google/apis/books_v1/service.rb +4 -1
  31. data/generated/google/apis/calendar_v3.rb +1 -1
  32. data/generated/google/apis/classroom_v1.rb +1 -1
  33. data/generated/google/apis/cloudbuild_v1.rb +1 -1
  34. data/generated/google/apis/cloudbuild_v1/classes.rb +638 -637
  35. data/generated/google/apis/cloudbuild_v1/representations.rb +110 -110
  36. data/generated/google/apis/cloudbuild_v1/service.rb +139 -139
  37. data/generated/google/apis/clouddebugger_v2.rb +3 -3
  38. data/generated/google/apis/clouddebugger_v2/classes.rb +131 -131
  39. data/generated/google/apis/clouddebugger_v2/representations.rb +25 -25
  40. data/generated/google/apis/clouderrorreporting_v1beta1.rb +36 -0
  41. data/generated/google/apis/clouderrorreporting_v1beta1/classes.rb +590 -0
  42. data/generated/google/apis/clouderrorreporting_v1beta1/representations.rb +252 -0
  43. data/generated/google/apis/clouderrorreporting_v1beta1/service.rb +350 -0
  44. data/generated/google/apis/cloudfunctions_v1.rb +35 -0
  45. data/generated/google/apis/cloudfunctions_v1/classes.rb +98 -0
  46. data/generated/google/apis/cloudfunctions_v1/representations.rb +57 -0
  47. data/generated/google/apis/cloudfunctions_v1/service.rb +89 -0
  48. data/generated/google/apis/cloudkms_v1/classes.rb +277 -270
  49. data/generated/google/apis/cloudkms_v1/representations.rb +73 -73
  50. data/generated/google/apis/cloudkms_v1/service.rb +194 -194
  51. data/generated/google/apis/cloudresourcemanager_v1.rb +1 -1
  52. data/generated/google/apis/cloudresourcemanager_v1/classes.rb +1147 -1144
  53. data/generated/google/apis/cloudresourcemanager_v1/representations.rb +188 -188
  54. data/generated/google/apis/cloudresourcemanager_v1/service.rb +513 -936
  55. data/generated/google/apis/cloudresourcemanager_v1beta1.rb +1 -1
  56. data/generated/google/apis/cloudresourcemanager_v1beta1/classes.rb +307 -916
  57. data/generated/google/apis/cloudresourcemanager_v1beta1/representations.rb +63 -285
  58. data/generated/google/apis/cloudresourcemanager_v1beta1/service.rb +333 -681
  59. data/generated/google/apis/cloudtrace_v1/classes.rb +38 -38
  60. data/generated/google/apis/cloudtrace_v1/representations.rb +13 -13
  61. data/generated/google/apis/cloudtrace_v1/service.rb +16 -16
  62. data/generated/google/apis/compute_beta.rb +1 -1
  63. data/generated/google/apis/compute_beta/classes.rb +32 -7
  64. data/generated/google/apis/compute_beta/representations.rb +2 -0
  65. data/generated/google/apis/compute_beta/service.rb +11 -11
  66. data/generated/google/apis/compute_v1.rb +1 -1
  67. data/generated/google/apis/compute_v1/classes.rb +95 -2
  68. data/generated/google/apis/compute_v1/representations.rb +33 -0
  69. data/generated/google/apis/dataflow_v1b3/classes.rb +3333 -3333
  70. data/generated/google/apis/dataflow_v1b3/representations.rb +759 -759
  71. data/generated/google/apis/dataflow_v1b3/service.rb +154 -154
  72. data/generated/google/apis/dataproc_v1.rb +1 -1
  73. data/generated/google/apis/dataproc_v1/classes.rb +1097 -1097
  74. data/generated/google/apis/dataproc_v1/representations.rb +200 -200
  75. data/generated/google/apis/dataproc_v1/service.rb +356 -356
  76. data/generated/google/apis/datastore_v1.rb +4 -4
  77. data/generated/google/apis/datastore_v1/classes.rb +701 -690
  78. data/generated/google/apis/datastore_v1/representations.rb +160 -160
  79. data/generated/google/apis/datastore_v1/service.rb +52 -52
  80. data/generated/google/apis/deploymentmanager_v2/classes.rb +4 -0
  81. data/generated/google/apis/doubleclicksearch_v2.rb +1 -1
  82. data/generated/google/apis/drive_v2.rb +1 -1
  83. data/generated/google/apis/drive_v2/classes.rb +158 -35
  84. data/generated/google/apis/drive_v2/representations.rb +39 -0
  85. data/generated/google/apis/drive_v2/service.rb +4 -4
  86. data/generated/google/apis/drive_v3.rb +1 -1
  87. data/generated/google/apis/drive_v3/classes.rb +162 -33
  88. data/generated/google/apis/drive_v3/representations.rb +39 -0
  89. data/generated/google/apis/drive_v3/service.rb +4 -4
  90. data/generated/google/apis/firebasedynamiclinks_v1.rb +35 -0
  91. data/generated/google/apis/firebasedynamiclinks_v1/classes.rb +466 -0
  92. data/generated/google/apis/firebasedynamiclinks_v1/representations.rb +222 -0
  93. data/generated/google/apis/firebasedynamiclinks_v1/service.rb +95 -0
  94. data/generated/google/apis/firebaserules_v1.rb +41 -0
  95. data/generated/google/apis/firebaserules_v1/classes.rb +425 -0
  96. data/generated/google/apis/firebaserules_v1/representations.rb +222 -0
  97. data/generated/google/apis/firebaserules_v1/service.rb +495 -0
  98. data/generated/google/apis/games_v1/classes.rb +4 -0
  99. data/generated/google/apis/genomics_v1.rb +7 -7
  100. data/generated/google/apis/genomics_v1/classes.rb +2336 -2335
  101. data/generated/google/apis/genomics_v1/representations.rb +387 -387
  102. data/generated/google/apis/genomics_v1/service.rb +1187 -1187
  103. data/generated/google/apis/gmail_v1/classes.rb +3 -0
  104. data/generated/google/apis/iam_v1.rb +1 -1
  105. data/generated/google/apis/iam_v1/classes.rb +123 -117
  106. data/generated/google/apis/iam_v1/representations.rb +33 -33
  107. data/generated/google/apis/iam_v1/service.rb +109 -109
  108. data/generated/google/apis/identitytoolkit_v3/classes.rb +5 -0
  109. data/generated/google/apis/kgsearch_v1/classes.rb +6 -6
  110. data/generated/google/apis/kgsearch_v1/representations.rb +1 -1
  111. data/generated/google/apis/kgsearch_v1/service.rb +4 -4
  112. data/generated/google/apis/language_v1.rb +36 -0
  113. data/generated/google/apis/language_v1/classes.rb +757 -0
  114. data/generated/google/apis/language_v1/representations.rb +338 -0
  115. data/generated/google/apis/language_v1/service.rb +185 -0
  116. data/generated/google/apis/language_v1beta1/classes.rb +407 -407
  117. data/generated/google/apis/language_v1beta1/representations.rb +103 -103
  118. data/generated/google/apis/language_v1beta1/service.rb +45 -45
  119. data/generated/google/apis/logging_v2.rb +46 -0
  120. data/generated/google/apis/logging_v2/classes.rb +1271 -0
  121. data/generated/google/apis/logging_v2/representations.rb +421 -0
  122. data/generated/google/apis/logging_v2/service.rb +1569 -0
  123. data/generated/google/apis/logging_v2beta1.rb +1 -1
  124. data/generated/google/apis/logging_v2beta1/classes.rb +886 -886
  125. data/generated/google/apis/logging_v2beta1/representations.rb +132 -132
  126. data/generated/google/apis/logging_v2beta1/service.rb +235 -235
  127. data/generated/google/apis/manufacturers_v1/classes.rb +147 -147
  128. data/generated/google/apis/manufacturers_v1/representations.rb +29 -29
  129. data/generated/google/apis/ml_v1.rb +34 -0
  130. data/generated/google/apis/ml_v1/classes.rb +1617 -0
  131. data/generated/google/apis/ml_v1/representations.rb +498 -0
  132. data/generated/google/apis/ml_v1/service.rb +769 -0
  133. data/generated/google/apis/monitoring_v3.rb +4 -4
  134. data/generated/google/apis/monitoring_v3/classes.rb +630 -630
  135. data/generated/google/apis/monitoring_v3/representations.rb +134 -134
  136. data/generated/google/apis/monitoring_v3/service.rb +240 -240
  137. data/generated/google/apis/pagespeedonline_v2/classes.rb +1 -0
  138. data/generated/google/apis/partners_v2.rb +1 -1
  139. data/generated/google/apis/partners_v2/classes.rb +639 -639
  140. data/generated/google/apis/partners_v2/representations.rb +168 -168
  141. data/generated/google/apis/partners_v2/service.rb +381 -381
  142. data/generated/google/apis/people_v1.rb +10 -10
  143. data/generated/google/apis/people_v1/classes.rb +524 -524
  144. data/generated/google/apis/people_v1/representations.rb +143 -143
  145. data/generated/google/apis/people_v1/service.rb +30 -30
  146. data/generated/google/apis/plus_domains_v1.rb +1 -1
  147. data/generated/google/apis/plus_v1.rb +1 -1
  148. data/generated/google/apis/proximitybeacon_v1beta1/classes.rb +454 -444
  149. data/generated/google/apis/proximitybeacon_v1beta1/representations.rb +90 -90
  150. data/generated/google/apis/proximitybeacon_v1beta1/service.rb +110 -110
  151. data/generated/google/apis/pubsub_v1/classes.rb +175 -173
  152. data/generated/google/apis/pubsub_v1/representations.rb +53 -53
  153. data/generated/google/apis/pubsub_v1/service.rb +210 -210
  154. data/generated/google/apis/replicapool_v1beta2/classes.rb +2 -0
  155. data/generated/google/apis/runtimeconfig_v1.rb +38 -0
  156. data/generated/google/apis/runtimeconfig_v1/classes.rb +252 -0
  157. data/generated/google/apis/runtimeconfig_v1/representations.rb +98 -0
  158. data/generated/google/apis/runtimeconfig_v1/service.rb +176 -0
  159. data/generated/google/apis/script_v1.rb +1 -1
  160. data/generated/google/apis/script_v1/classes.rb +6 -6
  161. data/generated/google/apis/script_v1/representations.rb +1 -1
  162. data/generated/google/apis/searchconsole_v1.rb +31 -0
  163. data/generated/google/apis/searchconsole_v1/classes.rb +205 -0
  164. data/generated/google/apis/searchconsole_v1/representations.rb +129 -0
  165. data/generated/google/apis/searchconsole_v1/service.rb +88 -0
  166. data/generated/google/apis/servicecontrol_v1.rb +38 -0
  167. data/generated/google/apis/servicecontrol_v1/classes.rb +1675 -0
  168. data/generated/google/apis/servicecontrol_v1/representations.rb +601 -0
  169. data/generated/google/apis/servicecontrol_v1/service.rb +337 -0
  170. data/generated/google/apis/servicemanagement_v1.rb +45 -0
  171. data/generated/google/apis/servicemanagement_v1/classes.rb +4934 -0
  172. data/generated/google/apis/servicemanagement_v1/representations.rb +1526 -0
  173. data/generated/google/apis/servicemanagement_v1/service.rb +860 -0
  174. data/generated/google/apis/serviceuser_v1.rb +42 -0
  175. data/generated/google/apis/serviceuser_v1/classes.rb +3746 -0
  176. data/generated/google/apis/serviceuser_v1/representations.rb +1041 -0
  177. data/generated/google/apis/serviceuser_v1/service.rb +214 -0
  178. data/generated/google/apis/sheets_v4.rb +3 -3
  179. data/generated/google/apis/sheets_v4/classes.rb +4390 -4390
  180. data/generated/google/apis/sheets_v4/representations.rb +381 -381
  181. data/generated/google/apis/sheets_v4/service.rb +48 -48
  182. data/generated/google/apis/slides_v1.rb +3 -3
  183. data/generated/google/apis/slides_v1/classes.rb +2860 -2860
  184. data/generated/google/apis/slides_v1/representations.rb +693 -693
  185. data/generated/google/apis/slides_v1/service.rb +30 -30
  186. data/generated/google/apis/sourcerepo_v1.rb +34 -0
  187. data/generated/google/apis/sourcerepo_v1/classes.rb +687 -0
  188. data/generated/google/apis/sourcerepo_v1/representations.rb +285 -0
  189. data/generated/google/apis/sourcerepo_v1/service.rb +291 -0
  190. data/generated/google/apis/spanner_v1.rb +35 -0
  191. data/generated/google/apis/spanner_v1/classes.rb +3294 -0
  192. data/generated/google/apis/spanner_v1/representations.rb +984 -0
  193. data/generated/google/apis/spanner_v1/service.rb +1504 -0
  194. data/generated/google/apis/speech_v1beta1.rb +1 -1
  195. data/generated/google/apis/speech_v1beta1/classes.rb +197 -196
  196. data/generated/google/apis/speech_v1beta1/representations.rb +53 -53
  197. data/generated/google/apis/speech_v1beta1/service.rb +27 -27
  198. data/generated/google/apis/storage_v1.rb +1 -1
  199. data/generated/google/apis/storage_v1/classes.rb +131 -0
  200. data/generated/google/apis/storage_v1/representations.rb +51 -0
  201. data/generated/google/apis/storage_v1/service.rb +182 -0
  202. data/generated/google/apis/storagetransfer_v1.rb +1 -1
  203. data/generated/google/apis/storagetransfer_v1/classes.rb +732 -661
  204. data/generated/google/apis/storagetransfer_v1/representations.rb +132 -132
  205. data/generated/google/apis/storagetransfer_v1/service.rb +174 -197
  206. data/generated/google/apis/surveys_v2.rb +40 -0
  207. data/generated/google/apis/surveys_v2/classes.rb +806 -0
  208. data/generated/google/apis/surveys_v2/representations.rb +347 -0
  209. data/generated/google/apis/surveys_v2/service.rb +477 -0
  210. data/generated/google/apis/tagmanager_v2.rb +52 -0
  211. data/generated/google/apis/tagmanager_v2/classes.rb +2435 -0
  212. data/generated/google/apis/tagmanager_v2/representations.rb +993 -0
  213. data/generated/google/apis/tagmanager_v2/service.rb +2865 -0
  214. data/generated/google/apis/toolresults_v1beta3.rb +34 -0
  215. data/generated/google/apis/toolresults_v1beta3/classes.rb +2160 -0
  216. data/generated/google/apis/toolresults_v1beta3/representations.rb +729 -0
  217. data/generated/google/apis/toolresults_v1beta3/service.rb +1236 -0
  218. data/generated/google/apis/tracing_v1.rb +40 -0
  219. data/generated/google/apis/tracing_v1/classes.rb +664 -0
  220. data/generated/google/apis/tracing_v1/representations.rb +279 -0
  221. data/generated/google/apis/tracing_v1/service.rb +225 -0
  222. data/generated/google/apis/vision_v1.rb +1 -1
  223. data/generated/google/apis/vision_v1/classes.rb +1223 -1222
  224. data/generated/google/apis/vision_v1/representations.rb +234 -234
  225. data/generated/google/apis/vision_v1/service.rb +10 -10
  226. data/generated/google/apis/webfonts_v1.rb +33 -0
  227. data/generated/google/apis/webfonts_v1/classes.rb +113 -0
  228. data/generated/google/apis/webfonts_v1/representations.rb +62 -0
  229. data/generated/google/apis/webfonts_v1/service.rb +102 -0
  230. data/generated/google/apis/youtube_analytics_v1.rb +1 -1
  231. data/generated/google/apis/youtube_partner_v1.rb +1 -1
  232. data/generated/google/apis/youtube_partner_v1/classes.rb +31 -0
  233. data/generated/google/apis/youtube_partner_v1/representations.rb +6 -0
  234. data/generated/google/apis/youtube_partner_v1/service.rb +41 -0
  235. data/generated/google/apis/youtube_v3/classes.rb +1 -0
  236. data/generated/google/apis/youtubereporting_v1.rb +4 -4
  237. data/generated/google/apis/youtubereporting_v1/classes.rb +76 -76
  238. data/generated/google/apis/youtubereporting_v1/representations.rb +25 -25
  239. data/generated/google/apis/youtubereporting_v1/service.rb +95 -95
  240. data/lib/google/apis/generator/annotator.rb +5 -4
  241. data/lib/google/apis/generator/templates/_class.tmpl +3 -0
  242. data/lib/google/apis/version.rb +1 -1
  243. data/samples/cli/lib/samples/adsense.rb +99 -0
  244. data/samples/cli/lib/samples/analytics.rb +18 -0
  245. data/samples/cli/lib/samples/gmail.rb +33 -0
  246. data/samples/cli/lib/samples/vision.rb +69 -0
  247. metadata +89 -4
  248. data/sync.rb +0 -71
@@ -0,0 +1,421 @@
1
+ # Copyright 2015 Google Inc.
2
+ #
3
+ # Licensed under the Apache License, Version 2.0 (the "License");
4
+ # you may not use this file except in compliance with the License.
5
+ # You may obtain a copy of the License at
6
+ #
7
+ # http://www.apache.org/licenses/LICENSE-2.0
8
+ #
9
+ # Unless required by applicable law or agreed to in writing, software
10
+ # distributed under the License is distributed on an "AS IS" BASIS,
11
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
+ # See the License for the specific language governing permissions and
13
+ # limitations under the License.
14
+
15
+ require 'date'
16
+ require 'google/apis/core/base_service'
17
+ require 'google/apis/core/json_representation'
18
+ require 'google/apis/core/hashable'
19
+ require 'google/apis/errors'
20
+
21
+ module Google
22
+ module Apis
23
+ module LoggingV2
24
+
25
+ class ListLogsResponse
26
+ class Representation < Google::Apis::Core::JsonRepresentation; end
27
+
28
+ include Google::Apis::Core::JsonObjectSupport
29
+ end
30
+
31
+ class ListSinksResponse
32
+ class Representation < Google::Apis::Core::JsonRepresentation; end
33
+
34
+ include Google::Apis::Core::JsonObjectSupport
35
+ end
36
+
37
+ class HttpRequest
38
+ class Representation < Google::Apis::Core::JsonRepresentation; end
39
+
40
+ include Google::Apis::Core::JsonObjectSupport
41
+ end
42
+
43
+ class LabelDescriptor
44
+ class Representation < Google::Apis::Core::JsonRepresentation; end
45
+
46
+ include Google::Apis::Core::JsonObjectSupport
47
+ end
48
+
49
+ class MonitoredResourceDescriptor
50
+ class Representation < Google::Apis::Core::JsonRepresentation; end
51
+
52
+ include Google::Apis::Core::JsonObjectSupport
53
+ end
54
+
55
+ class LogEntrySourceLocation
56
+ class Representation < Google::Apis::Core::JsonRepresentation; end
57
+
58
+ include Google::Apis::Core::JsonObjectSupport
59
+ end
60
+
61
+ class ListLogEntriesResponse
62
+ class Representation < Google::Apis::Core::JsonRepresentation; end
63
+
64
+ include Google::Apis::Core::JsonObjectSupport
65
+ end
66
+
67
+ class LogLine
68
+ class Representation < Google::Apis::Core::JsonRepresentation; end
69
+
70
+ include Google::Apis::Core::JsonObjectSupport
71
+ end
72
+
73
+ class ListLogMetricsResponse
74
+ class Representation < Google::Apis::Core::JsonRepresentation; end
75
+
76
+ include Google::Apis::Core::JsonObjectSupport
77
+ end
78
+
79
+ class Empty
80
+ class Representation < Google::Apis::Core::JsonRepresentation; end
81
+
82
+ include Google::Apis::Core::JsonObjectSupport
83
+ end
84
+
85
+ class LogEntry
86
+ class Representation < Google::Apis::Core::JsonRepresentation; end
87
+
88
+ include Google::Apis::Core::JsonObjectSupport
89
+ end
90
+
91
+ class SourceLocation
92
+ class Representation < Google::Apis::Core::JsonRepresentation; end
93
+
94
+ include Google::Apis::Core::JsonObjectSupport
95
+ end
96
+
97
+ class ListLogEntriesRequest
98
+ class Representation < Google::Apis::Core::JsonRepresentation; end
99
+
100
+ include Google::Apis::Core::JsonObjectSupport
101
+ end
102
+
103
+ class RequestLog
104
+ class Representation < Google::Apis::Core::JsonRepresentation; end
105
+
106
+ include Google::Apis::Core::JsonObjectSupport
107
+ end
108
+
109
+ class ListMonitoredResourceDescriptorsResponse
110
+ class Representation < Google::Apis::Core::JsonRepresentation; end
111
+
112
+ include Google::Apis::Core::JsonObjectSupport
113
+ end
114
+
115
+ class SourceReference
116
+ class Representation < Google::Apis::Core::JsonRepresentation; end
117
+
118
+ include Google::Apis::Core::JsonObjectSupport
119
+ end
120
+
121
+ class LogMetric
122
+ class Representation < Google::Apis::Core::JsonRepresentation; end
123
+
124
+ include Google::Apis::Core::JsonObjectSupport
125
+ end
126
+
127
+ class LogEntryOperation
128
+ class Representation < Google::Apis::Core::JsonRepresentation; end
129
+
130
+ include Google::Apis::Core::JsonObjectSupport
131
+ end
132
+
133
+ class WriteLogEntriesResponse
134
+ class Representation < Google::Apis::Core::JsonRepresentation; end
135
+
136
+ include Google::Apis::Core::JsonObjectSupport
137
+ end
138
+
139
+ class MonitoredResource
140
+ class Representation < Google::Apis::Core::JsonRepresentation; end
141
+
142
+ include Google::Apis::Core::JsonObjectSupport
143
+ end
144
+
145
+ class LogSink
146
+ class Representation < Google::Apis::Core::JsonRepresentation; end
147
+
148
+ include Google::Apis::Core::JsonObjectSupport
149
+ end
150
+
151
+ class WriteLogEntriesRequest
152
+ class Representation < Google::Apis::Core::JsonRepresentation; end
153
+
154
+ include Google::Apis::Core::JsonObjectSupport
155
+ end
156
+
157
+ class ListLogsResponse
158
+ # @private
159
+ class Representation < Google::Apis::Core::JsonRepresentation
160
+ collection :log_names, as: 'logNames'
161
+ property :next_page_token, as: 'nextPageToken'
162
+ end
163
+ end
164
+
165
+ class ListSinksResponse
166
+ # @private
167
+ class Representation < Google::Apis::Core::JsonRepresentation
168
+ collection :sinks, as: 'sinks', class: Google::Apis::LoggingV2::LogSink, decorator: Google::Apis::LoggingV2::LogSink::Representation
169
+
170
+ property :next_page_token, as: 'nextPageToken'
171
+ end
172
+ end
173
+
174
+ class HttpRequest
175
+ # @private
176
+ class Representation < Google::Apis::Core::JsonRepresentation
177
+ property :cache_validated_with_origin_server, as: 'cacheValidatedWithOriginServer'
178
+ property :status, as: 'status'
179
+ property :referer, as: 'referer'
180
+ property :user_agent, as: 'userAgent'
181
+ property :latency, as: 'latency'
182
+ property :cache_fill_bytes, as: 'cacheFillBytes'
183
+ property :request_method, as: 'requestMethod'
184
+ property :response_size, as: 'responseSize'
185
+ property :request_size, as: 'requestSize'
186
+ property :request_url, as: 'requestUrl'
187
+ property :remote_ip, as: 'remoteIp'
188
+ property :server_ip, as: 'serverIp'
189
+ property :cache_lookup, as: 'cacheLookup'
190
+ property :cache_hit, as: 'cacheHit'
191
+ end
192
+ end
193
+
194
+ class LabelDescriptor
195
+ # @private
196
+ class Representation < Google::Apis::Core::JsonRepresentation
197
+ property :key, as: 'key'
198
+ property :description, as: 'description'
199
+ property :value_type, as: 'valueType'
200
+ end
201
+ end
202
+
203
+ class MonitoredResourceDescriptor
204
+ # @private
205
+ class Representation < Google::Apis::Core::JsonRepresentation
206
+ collection :labels, as: 'labels', class: Google::Apis::LoggingV2::LabelDescriptor, decorator: Google::Apis::LoggingV2::LabelDescriptor::Representation
207
+
208
+ property :name, as: 'name'
209
+ property :display_name, as: 'displayName'
210
+ property :description, as: 'description'
211
+ property :type, as: 'type'
212
+ end
213
+ end
214
+
215
+ class LogEntrySourceLocation
216
+ # @private
217
+ class Representation < Google::Apis::Core::JsonRepresentation
218
+ property :file, as: 'file'
219
+ property :function, as: 'function'
220
+ property :line, as: 'line'
221
+ end
222
+ end
223
+
224
+ class ListLogEntriesResponse
225
+ # @private
226
+ class Representation < Google::Apis::Core::JsonRepresentation
227
+ collection :entries, as: 'entries', class: Google::Apis::LoggingV2::LogEntry, decorator: Google::Apis::LoggingV2::LogEntry::Representation
228
+
229
+ property :next_page_token, as: 'nextPageToken'
230
+ end
231
+ end
232
+
233
+ class LogLine
234
+ # @private
235
+ class Representation < Google::Apis::Core::JsonRepresentation
236
+ property :severity, as: 'severity'
237
+ property :log_message, as: 'logMessage'
238
+ property :source_location, as: 'sourceLocation', class: Google::Apis::LoggingV2::SourceLocation, decorator: Google::Apis::LoggingV2::SourceLocation::Representation
239
+
240
+ property :time, as: 'time'
241
+ end
242
+ end
243
+
244
+ class ListLogMetricsResponse
245
+ # @private
246
+ class Representation < Google::Apis::Core::JsonRepresentation
247
+ collection :metrics, as: 'metrics', class: Google::Apis::LoggingV2::LogMetric, decorator: Google::Apis::LoggingV2::LogMetric::Representation
248
+
249
+ property :next_page_token, as: 'nextPageToken'
250
+ end
251
+ end
252
+
253
+ class Empty
254
+ # @private
255
+ class Representation < Google::Apis::Core::JsonRepresentation
256
+ end
257
+ end
258
+
259
+ class LogEntry
260
+ # @private
261
+ class Representation < Google::Apis::Core::JsonRepresentation
262
+ property :text_payload, as: 'textPayload'
263
+ hash :proto_payload, as: 'protoPayload'
264
+ property :trace, as: 'trace'
265
+ hash :labels, as: 'labels'
266
+ property :severity, as: 'severity'
267
+ property :source_location, as: 'sourceLocation', class: Google::Apis::LoggingV2::LogEntrySourceLocation, decorator: Google::Apis::LoggingV2::LogEntrySourceLocation::Representation
268
+
269
+ property :timestamp, as: 'timestamp'
270
+ property :log_name, as: 'logName'
271
+ property :http_request, as: 'httpRequest', class: Google::Apis::LoggingV2::HttpRequest, decorator: Google::Apis::LoggingV2::HttpRequest::Representation
272
+
273
+ property :resource, as: 'resource', class: Google::Apis::LoggingV2::MonitoredResource, decorator: Google::Apis::LoggingV2::MonitoredResource::Representation
274
+
275
+ hash :json_payload, as: 'jsonPayload'
276
+ property :insert_id, as: 'insertId'
277
+ property :operation, as: 'operation', class: Google::Apis::LoggingV2::LogEntryOperation, decorator: Google::Apis::LoggingV2::LogEntryOperation::Representation
278
+
279
+ end
280
+ end
281
+
282
+ class SourceLocation
283
+ # @private
284
+ class Representation < Google::Apis::Core::JsonRepresentation
285
+ property :file, as: 'file'
286
+ property :function_name, as: 'functionName'
287
+ property :line, as: 'line'
288
+ end
289
+ end
290
+
291
+ class ListLogEntriesRequest
292
+ # @private
293
+ class Representation < Google::Apis::Core::JsonRepresentation
294
+ collection :project_ids, as: 'projectIds'
295
+ property :filter, as: 'filter'
296
+ property :page_token, as: 'pageToken'
297
+ property :page_size, as: 'pageSize'
298
+ property :order_by, as: 'orderBy'
299
+ collection :resource_names, as: 'resourceNames'
300
+ end
301
+ end
302
+
303
+ class RequestLog
304
+ # @private
305
+ class Representation < Google::Apis::Core::JsonRepresentation
306
+ property :module_id, as: 'moduleId'
307
+ property :end_time, as: 'endTime'
308
+ property :user_agent, as: 'userAgent'
309
+ property :was_loading_request, as: 'wasLoadingRequest'
310
+ collection :source_reference, as: 'sourceReference', class: Google::Apis::LoggingV2::SourceReference, decorator: Google::Apis::LoggingV2::SourceReference::Representation
311
+
312
+ property :response_size, as: 'responseSize'
313
+ property :trace_id, as: 'traceId'
314
+ collection :line, as: 'line', class: Google::Apis::LoggingV2::LogLine, decorator: Google::Apis::LoggingV2::LogLine::Representation
315
+
316
+ property :task_queue_name, as: 'taskQueueName'
317
+ property :referrer, as: 'referrer'
318
+ property :request_id, as: 'requestId'
319
+ property :nickname, as: 'nickname'
320
+ property :pending_time, as: 'pendingTime'
321
+ property :resource, as: 'resource'
322
+ property :status, as: 'status'
323
+ property :task_name, as: 'taskName'
324
+ property :url_map_entry, as: 'urlMapEntry'
325
+ property :instance_index, as: 'instanceIndex'
326
+ property :host, as: 'host'
327
+ property :finished, as: 'finished'
328
+ property :http_version, as: 'httpVersion'
329
+ property :start_time, as: 'startTime'
330
+ property :latency, as: 'latency'
331
+ property :ip, as: 'ip'
332
+ property :app_id, as: 'appId'
333
+ property :app_engine_release, as: 'appEngineRelease'
334
+ property :method_prop, as: 'method'
335
+ property :cost, as: 'cost'
336
+ property :instance_id, as: 'instanceId'
337
+ property :mega_cycles, as: 'megaCycles'
338
+ property :first, as: 'first'
339
+ property :version_id, as: 'versionId'
340
+ end
341
+ end
342
+
343
+ class ListMonitoredResourceDescriptorsResponse
344
+ # @private
345
+ class Representation < Google::Apis::Core::JsonRepresentation
346
+ collection :resource_descriptors, as: 'resourceDescriptors', class: Google::Apis::LoggingV2::MonitoredResourceDescriptor, decorator: Google::Apis::LoggingV2::MonitoredResourceDescriptor::Representation
347
+
348
+ property :next_page_token, as: 'nextPageToken'
349
+ end
350
+ end
351
+
352
+ class SourceReference
353
+ # @private
354
+ class Representation < Google::Apis::Core::JsonRepresentation
355
+ property :repository, as: 'repository'
356
+ property :revision_id, as: 'revisionId'
357
+ end
358
+ end
359
+
360
+ class LogMetric
361
+ # @private
362
+ class Representation < Google::Apis::Core::JsonRepresentation
363
+ property :version, as: 'version'
364
+ property :filter, as: 'filter'
365
+ property :name, as: 'name'
366
+ property :description, as: 'description'
367
+ end
368
+ end
369
+
370
+ class LogEntryOperation
371
+ # @private
372
+ class Representation < Google::Apis::Core::JsonRepresentation
373
+ property :last, as: 'last'
374
+ property :id, as: 'id'
375
+ property :producer, as: 'producer'
376
+ property :first, as: 'first'
377
+ end
378
+ end
379
+
380
+ class WriteLogEntriesResponse
381
+ # @private
382
+ class Representation < Google::Apis::Core::JsonRepresentation
383
+ end
384
+ end
385
+
386
+ class MonitoredResource
387
+ # @private
388
+ class Representation < Google::Apis::Core::JsonRepresentation
389
+ property :type, as: 'type'
390
+ hash :labels, as: 'labels'
391
+ end
392
+ end
393
+
394
+ class LogSink
395
+ # @private
396
+ class Representation < Google::Apis::Core::JsonRepresentation
397
+ property :name, as: 'name'
398
+ property :filter, as: 'filter'
399
+ property :destination, as: 'destination'
400
+ property :end_time, as: 'endTime'
401
+ property :writer_identity, as: 'writerIdentity'
402
+ property :start_time, as: 'startTime'
403
+ property :output_version_format, as: 'outputVersionFormat'
404
+ end
405
+ end
406
+
407
+ class WriteLogEntriesRequest
408
+ # @private
409
+ class Representation < Google::Apis::Core::JsonRepresentation
410
+ property :log_name, as: 'logName'
411
+ collection :entries, as: 'entries', class: Google::Apis::LoggingV2::LogEntry, decorator: Google::Apis::LoggingV2::LogEntry::Representation
412
+
413
+ property :partial_success, as: 'partialSuccess'
414
+ hash :labels, as: 'labels'
415
+ property :resource, as: 'resource', class: Google::Apis::LoggingV2::MonitoredResource, decorator: Google::Apis::LoggingV2::MonitoredResource::Representation
416
+
417
+ end
418
+ end
419
+ end
420
+ end
421
+ end
@@ -0,0 +1,1569 @@
1
+ # Copyright 2015 Google Inc.
2
+ #
3
+ # Licensed under the Apache License, Version 2.0 (the "License");
4
+ # you may not use this file except in compliance with the License.
5
+ # You may obtain a copy of the License at
6
+ #
7
+ # http://www.apache.org/licenses/LICENSE-2.0
8
+ #
9
+ # Unless required by applicable law or agreed to in writing, software
10
+ # distributed under the License is distributed on an "AS IS" BASIS,
11
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
+ # See the License for the specific language governing permissions and
13
+ # limitations under the License.
14
+
15
+ require 'google/apis/core/base_service'
16
+ require 'google/apis/core/json_representation'
17
+ require 'google/apis/core/hashable'
18
+ require 'google/apis/errors'
19
+
20
+ module Google
21
+ module Apis
22
+ module LoggingV2
23
+ # Stackdriver Logging API
24
+ #
25
+ # Writes log entries and manages your Stackdriver Logging configuration.
26
+ #
27
+ # @example
28
+ # require 'google/apis/logging_v2'
29
+ #
30
+ # Logging = Google::Apis::LoggingV2 # Alias the module
31
+ # service = Logging::LoggingService.new
32
+ #
33
+ # @see https://cloud.google.com/logging/docs/
34
+ class LoggingService < Google::Apis::Core::BaseService
35
+ # @return [String]
36
+ # API key. Your API key identifies your project and provides you with API access,
37
+ # quota, and reports. Required unless you provide an OAuth 2.0 token.
38
+ attr_accessor :key
39
+
40
+ # @return [String]
41
+ # Available to use for quota purposes for server-side applications. Can be any
42
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
43
+ attr_accessor :quota_user
44
+
45
+ def initialize
46
+ super('https://logging.googleapis.com/', '')
47
+ end
48
+
49
+ # Lists logs-based metrics.
50
+ # @param [String] parent
51
+ # Required. The name of the project containing the metrics:
52
+ # "projects/[PROJECT_ID]"
53
+ # @param [String] page_token
54
+ # Optional. If present, then retrieve the next batch of results from the
55
+ # preceding call to this method. pageToken must be the value of nextPageToken
56
+ # from the previous response. The values of other method parameters should be
57
+ # identical to those in the previous call.
58
+ # @param [Fixnum] page_size
59
+ # Optional. The maximum number of results to return from this request. Non-
60
+ # positive values are ignored. The presence of nextPageToken in the response
61
+ # indicates that more results might be available.
62
+ # @param [String] fields
63
+ # Selector specifying which fields to include in a partial response.
64
+ # @param [String] quota_user
65
+ # Available to use for quota purposes for server-side applications. Can be any
66
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
67
+ # @param [Google::Apis::RequestOptions] options
68
+ # Request-specific options
69
+ #
70
+ # @yield [result, err] Result & error if block supplied
71
+ # @yieldparam result [Google::Apis::LoggingV2::ListLogMetricsResponse] parsed result object
72
+ # @yieldparam err [StandardError] error object if request failed
73
+ #
74
+ # @return [Google::Apis::LoggingV2::ListLogMetricsResponse]
75
+ #
76
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
77
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
78
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
79
+ def list_project_metrics(parent, page_token: nil, page_size: nil, fields: nil, quota_user: nil, options: nil, &block)
80
+ command = make_simple_command(:get, 'v2/{+parent}/metrics', options)
81
+ command.response_representation = Google::Apis::LoggingV2::ListLogMetricsResponse::Representation
82
+ command.response_class = Google::Apis::LoggingV2::ListLogMetricsResponse
83
+ command.params['parent'] = parent unless parent.nil?
84
+ command.query['pageToken'] = page_token unless page_token.nil?
85
+ command.query['pageSize'] = page_size unless page_size.nil?
86
+ command.query['fields'] = fields unless fields.nil?
87
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
88
+ execute_or_queue_command(command, &block)
89
+ end
90
+
91
+ # Gets a logs-based metric.
92
+ # @param [String] metric_name
93
+ # The resource name of the desired metric:
94
+ # "projects/[PROJECT_ID]/metrics/[METRIC_ID]"
95
+ # @param [String] fields
96
+ # Selector specifying which fields to include in a partial response.
97
+ # @param [String] quota_user
98
+ # Available to use for quota purposes for server-side applications. Can be any
99
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
100
+ # @param [Google::Apis::RequestOptions] options
101
+ # Request-specific options
102
+ #
103
+ # @yield [result, err] Result & error if block supplied
104
+ # @yieldparam result [Google::Apis::LoggingV2::LogMetric] parsed result object
105
+ # @yieldparam err [StandardError] error object if request failed
106
+ #
107
+ # @return [Google::Apis::LoggingV2::LogMetric]
108
+ #
109
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
110
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
111
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
112
+ def get_project_metric(metric_name, fields: nil, quota_user: nil, options: nil, &block)
113
+ command = make_simple_command(:get, 'v2/{+metricName}', options)
114
+ command.response_representation = Google::Apis::LoggingV2::LogMetric::Representation
115
+ command.response_class = Google::Apis::LoggingV2::LogMetric
116
+ command.params['metricName'] = metric_name unless metric_name.nil?
117
+ command.query['fields'] = fields unless fields.nil?
118
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
119
+ execute_or_queue_command(command, &block)
120
+ end
121
+
122
+ # Creates or updates a logs-based metric.
123
+ # @param [String] metric_name
124
+ # The resource name of the metric to update:
125
+ # "projects/[PROJECT_ID]/metrics/[METRIC_ID]"
126
+ # The updated metric must be provided in the request and it's name field must be
127
+ # the same as [METRIC_ID] If the metric does not exist in [PROJECT_ID], then a
128
+ # new metric is created.
129
+ # @param [Google::Apis::LoggingV2::LogMetric] log_metric_object
130
+ # @param [String] fields
131
+ # Selector specifying which fields to include in a partial response.
132
+ # @param [String] quota_user
133
+ # Available to use for quota purposes for server-side applications. Can be any
134
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
135
+ # @param [Google::Apis::RequestOptions] options
136
+ # Request-specific options
137
+ #
138
+ # @yield [result, err] Result & error if block supplied
139
+ # @yieldparam result [Google::Apis::LoggingV2::LogMetric] parsed result object
140
+ # @yieldparam err [StandardError] error object if request failed
141
+ #
142
+ # @return [Google::Apis::LoggingV2::LogMetric]
143
+ #
144
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
145
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
146
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
147
+ def update_project_metric(metric_name, log_metric_object = nil, fields: nil, quota_user: nil, options: nil, &block)
148
+ command = make_simple_command(:put, 'v2/{+metricName}', options)
149
+ command.request_representation = Google::Apis::LoggingV2::LogMetric::Representation
150
+ command.request_object = log_metric_object
151
+ command.response_representation = Google::Apis::LoggingV2::LogMetric::Representation
152
+ command.response_class = Google::Apis::LoggingV2::LogMetric
153
+ command.params['metricName'] = metric_name unless metric_name.nil?
154
+ command.query['fields'] = fields unless fields.nil?
155
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
156
+ execute_or_queue_command(command, &block)
157
+ end
158
+
159
+ # Creates a logs-based metric.
160
+ # @param [String] parent
161
+ # The resource name of the project in which to create the metric:
162
+ # "projects/[PROJECT_ID]"
163
+ # The new metric must be provided in the request.
164
+ # @param [Google::Apis::LoggingV2::LogMetric] log_metric_object
165
+ # @param [String] fields
166
+ # Selector specifying which fields to include in a partial response.
167
+ # @param [String] quota_user
168
+ # Available to use for quota purposes for server-side applications. Can be any
169
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
170
+ # @param [Google::Apis::RequestOptions] options
171
+ # Request-specific options
172
+ #
173
+ # @yield [result, err] Result & error if block supplied
174
+ # @yieldparam result [Google::Apis::LoggingV2::LogMetric] parsed result object
175
+ # @yieldparam err [StandardError] error object if request failed
176
+ #
177
+ # @return [Google::Apis::LoggingV2::LogMetric]
178
+ #
179
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
180
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
181
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
182
+ def create_project_metric(parent, log_metric_object = nil, fields: nil, quota_user: nil, options: nil, &block)
183
+ command = make_simple_command(:post, 'v2/{+parent}/metrics', options)
184
+ command.request_representation = Google::Apis::LoggingV2::LogMetric::Representation
185
+ command.request_object = log_metric_object
186
+ command.response_representation = Google::Apis::LoggingV2::LogMetric::Representation
187
+ command.response_class = Google::Apis::LoggingV2::LogMetric
188
+ command.params['parent'] = parent unless parent.nil?
189
+ command.query['fields'] = fields unless fields.nil?
190
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
191
+ execute_or_queue_command(command, &block)
192
+ end
193
+
194
+ # Deletes a logs-based metric.
195
+ # @param [String] metric_name
196
+ # The resource name of the metric to delete:
197
+ # "projects/[PROJECT_ID]/metrics/[METRIC_ID]"
198
+ # @param [String] fields
199
+ # Selector specifying which fields to include in a partial response.
200
+ # @param [String] quota_user
201
+ # Available to use for quota purposes for server-side applications. Can be any
202
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
203
+ # @param [Google::Apis::RequestOptions] options
204
+ # Request-specific options
205
+ #
206
+ # @yield [result, err] Result & error if block supplied
207
+ # @yieldparam result [Google::Apis::LoggingV2::Empty] parsed result object
208
+ # @yieldparam err [StandardError] error object if request failed
209
+ #
210
+ # @return [Google::Apis::LoggingV2::Empty]
211
+ #
212
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
213
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
214
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
215
+ def delete_project_metric(metric_name, fields: nil, quota_user: nil, options: nil, &block)
216
+ command = make_simple_command(:delete, 'v2/{+metricName}', options)
217
+ command.response_representation = Google::Apis::LoggingV2::Empty::Representation
218
+ command.response_class = Google::Apis::LoggingV2::Empty
219
+ command.params['metricName'] = metric_name unless metric_name.nil?
220
+ command.query['fields'] = fields unless fields.nil?
221
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
222
+ execute_or_queue_command(command, &block)
223
+ end
224
+
225
+ # Deletes all the log entries in a log. The log reappears if it receives new
226
+ # entries. Log entries written shortly before the delete operation might not be
227
+ # deleted.
228
+ # @param [String] log_name
229
+ # Required. The resource name of the log to delete:
230
+ # "projects/[PROJECT_ID]/logs/[LOG_ID]"
231
+ # "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
232
+ # "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
233
+ # "folders/[FOLDER_ID]/logs/[LOG_ID]"
234
+ # [LOG_ID] must be URL-encoded. For example, "projects/my-project-id/logs/syslog"
235
+ # , "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%
236
+ # 2Factivity". For more information about log names, see LogEntry.
237
+ # @param [String] fields
238
+ # Selector specifying which fields to include in a partial response.
239
+ # @param [String] quota_user
240
+ # Available to use for quota purposes for server-side applications. Can be any
241
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
242
+ # @param [Google::Apis::RequestOptions] options
243
+ # Request-specific options
244
+ #
245
+ # @yield [result, err] Result & error if block supplied
246
+ # @yieldparam result [Google::Apis::LoggingV2::Empty] parsed result object
247
+ # @yieldparam err [StandardError] error object if request failed
248
+ #
249
+ # @return [Google::Apis::LoggingV2::Empty]
250
+ #
251
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
252
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
253
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
254
+ def delete_project_log(log_name, fields: nil, quota_user: nil, options: nil, &block)
255
+ command = make_simple_command(:delete, 'v2/{+logName}', options)
256
+ command.response_representation = Google::Apis::LoggingV2::Empty::Representation
257
+ command.response_class = Google::Apis::LoggingV2::Empty
258
+ command.params['logName'] = log_name unless log_name.nil?
259
+ command.query['fields'] = fields unless fields.nil?
260
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
261
+ execute_or_queue_command(command, &block)
262
+ end
263
+
264
+ # Lists the logs in projects, organizations, folders, or billing accounts. Only
265
+ # logs that have entries are listed.
266
+ # @param [String] parent
267
+ # Required. The resource name that owns the logs:
268
+ # "projects/[PROJECT_ID]"
269
+ # "organizations/[ORGANIZATION_ID]"
270
+ # "billingAccounts/[BILLING_ACCOUNT_ID]"
271
+ # "folders/[FOLDER_ID]"
272
+ # @param [String] page_token
273
+ # Optional. If present, then retrieve the next batch of results from the
274
+ # preceding call to this method. pageToken must be the value of nextPageToken
275
+ # from the previous response. The values of other method parameters should be
276
+ # identical to those in the previous call.
277
+ # @param [Fixnum] page_size
278
+ # Optional. The maximum number of results to return from this request. Non-
279
+ # positive values are ignored. The presence of nextPageToken in the response
280
+ # indicates that more results might be available.
281
+ # @param [String] fields
282
+ # Selector specifying which fields to include in a partial response.
283
+ # @param [String] quota_user
284
+ # Available to use for quota purposes for server-side applications. Can be any
285
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
286
+ # @param [Google::Apis::RequestOptions] options
287
+ # Request-specific options
288
+ #
289
+ # @yield [result, err] Result & error if block supplied
290
+ # @yieldparam result [Google::Apis::LoggingV2::ListLogsResponse] parsed result object
291
+ # @yieldparam err [StandardError] error object if request failed
292
+ #
293
+ # @return [Google::Apis::LoggingV2::ListLogsResponse]
294
+ #
295
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
296
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
297
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
298
+ def list_project_logs(parent, page_token: nil, page_size: nil, fields: nil, quota_user: nil, options: nil, &block)
299
+ command = make_simple_command(:get, 'v2/{+parent}/logs', options)
300
+ command.response_representation = Google::Apis::LoggingV2::ListLogsResponse::Representation
301
+ command.response_class = Google::Apis::LoggingV2::ListLogsResponse
302
+ command.params['parent'] = parent unless parent.nil?
303
+ command.query['pageToken'] = page_token unless page_token.nil?
304
+ command.query['pageSize'] = page_size unless page_size.nil?
305
+ command.query['fields'] = fields unless fields.nil?
306
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
307
+ execute_or_queue_command(command, &block)
308
+ end
309
+
310
+ # Deletes a sink. If the sink has a unique writer_identity, then that service
311
+ # account is also deleted.
312
+ # @param [String] sink_name
313
+ # Required. The full resource name of the sink to delete, including the parent
314
+ # resource and the sink identifier:
315
+ # "projects/[PROJECT_ID]/sinks/[SINK_ID]"
316
+ # "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
317
+ # "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
318
+ # "folders/[FOLDER_ID]/sinks/[SINK_ID]"
319
+ # Example: "projects/my-project-id/sinks/my-sink-id".
320
+ # @param [String] fields
321
+ # Selector specifying which fields to include in a partial response.
322
+ # @param [String] quota_user
323
+ # Available to use for quota purposes for server-side applications. Can be any
324
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
325
+ # @param [Google::Apis::RequestOptions] options
326
+ # Request-specific options
327
+ #
328
+ # @yield [result, err] Result & error if block supplied
329
+ # @yieldparam result [Google::Apis::LoggingV2::Empty] parsed result object
330
+ # @yieldparam err [StandardError] error object if request failed
331
+ #
332
+ # @return [Google::Apis::LoggingV2::Empty]
333
+ #
334
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
335
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
336
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
337
+ def delete_project_sink(sink_name, fields: nil, quota_user: nil, options: nil, &block)
338
+ command = make_simple_command(:delete, 'v2/{+sinkName}', options)
339
+ command.response_representation = Google::Apis::LoggingV2::Empty::Representation
340
+ command.response_class = Google::Apis::LoggingV2::Empty
341
+ command.params['sinkName'] = sink_name unless sink_name.nil?
342
+ command.query['fields'] = fields unless fields.nil?
343
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
344
+ execute_or_queue_command(command, &block)
345
+ end
346
+
347
+ # Lists sinks.
348
+ # @param [String] parent
349
+ # Required. The parent resource whose sinks are to be listed:
350
+ # "projects/[PROJECT_ID]"
351
+ # "organizations/[ORGANIZATION_ID]"
352
+ # "billingAccounts/[BILLING_ACCOUNT_ID]"
353
+ # "folders/[FOLDER_ID]"
354
+ # @param [String] page_token
355
+ # Optional. If present, then retrieve the next batch of results from the
356
+ # preceding call to this method. pageToken must be the value of nextPageToken
357
+ # from the previous response. The values of other method parameters should be
358
+ # identical to those in the previous call.
359
+ # @param [Fixnum] page_size
360
+ # Optional. The maximum number of results to return from this request. Non-
361
+ # positive values are ignored. The presence of nextPageToken in the response
362
+ # indicates that more results might be available.
363
+ # @param [String] fields
364
+ # Selector specifying which fields to include in a partial response.
365
+ # @param [String] quota_user
366
+ # Available to use for quota purposes for server-side applications. Can be any
367
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
368
+ # @param [Google::Apis::RequestOptions] options
369
+ # Request-specific options
370
+ #
371
+ # @yield [result, err] Result & error if block supplied
372
+ # @yieldparam result [Google::Apis::LoggingV2::ListSinksResponse] parsed result object
373
+ # @yieldparam err [StandardError] error object if request failed
374
+ #
375
+ # @return [Google::Apis::LoggingV2::ListSinksResponse]
376
+ #
377
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
378
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
379
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
380
+ def list_project_sinks(parent, page_token: nil, page_size: nil, fields: nil, quota_user: nil, options: nil, &block)
381
+ command = make_simple_command(:get, 'v2/{+parent}/sinks', options)
382
+ command.response_representation = Google::Apis::LoggingV2::ListSinksResponse::Representation
383
+ command.response_class = Google::Apis::LoggingV2::ListSinksResponse
384
+ command.params['parent'] = parent unless parent.nil?
385
+ command.query['pageToken'] = page_token unless page_token.nil?
386
+ command.query['pageSize'] = page_size unless page_size.nil?
387
+ command.query['fields'] = fields unless fields.nil?
388
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
389
+ execute_or_queue_command(command, &block)
390
+ end
391
+
392
+ # Gets a sink.
393
+ # @param [String] sink_name
394
+ # Required. The resource name of the sink:
395
+ # "projects/[PROJECT_ID]/sinks/[SINK_ID]"
396
+ # "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
397
+ # "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
398
+ # "folders/[FOLDER_ID]/sinks/[SINK_ID]"
399
+ # Example: "projects/my-project-id/sinks/my-sink-id".
400
+ # @param [String] fields
401
+ # Selector specifying which fields to include in a partial response.
402
+ # @param [String] quota_user
403
+ # Available to use for quota purposes for server-side applications. Can be any
404
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
405
+ # @param [Google::Apis::RequestOptions] options
406
+ # Request-specific options
407
+ #
408
+ # @yield [result, err] Result & error if block supplied
409
+ # @yieldparam result [Google::Apis::LoggingV2::LogSink] parsed result object
410
+ # @yieldparam err [StandardError] error object if request failed
411
+ #
412
+ # @return [Google::Apis::LoggingV2::LogSink]
413
+ #
414
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
415
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
416
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
417
+ def get_project_sink(sink_name, fields: nil, quota_user: nil, options: nil, &block)
418
+ command = make_simple_command(:get, 'v2/{+sinkName}', options)
419
+ command.response_representation = Google::Apis::LoggingV2::LogSink::Representation
420
+ command.response_class = Google::Apis::LoggingV2::LogSink
421
+ command.params['sinkName'] = sink_name unless sink_name.nil?
422
+ command.query['fields'] = fields unless fields.nil?
423
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
424
+ execute_or_queue_command(command, &block)
425
+ end
426
+
427
+ # Updates a sink. If the named sink doesn't exist, then this method is identical
428
+ # to sinks.create. If the named sink does exist, then this method replaces the
429
+ # following fields in the existing sink with values from the new sink:
430
+ # destination, filter, output_version_format, start_time, and end_time. The
431
+ # updated filter might also have a new writer_identity; see the
432
+ # unique_writer_identity field.
433
+ # @param [String] sink_name
434
+ # Required. The full resource name of the sink to update, including the parent
435
+ # resource and the sink identifier:
436
+ # "projects/[PROJECT_ID]/sinks/[SINK_ID]"
437
+ # "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
438
+ # "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
439
+ # "folders/[FOLDER_ID]/sinks/[SINK_ID]"
440
+ # Example: "projects/my-project-id/sinks/my-sink-id".
441
+ # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
442
+ # @param [Boolean] unique_writer_identity
443
+ # Optional. See sinks.create for a description of this field. When updating a
444
+ # sink, the effect of this field on the value of writer_identity in the updated
445
+ # sink depends on both the old and new values of this field:
446
+ # If the old and new values of this field are both false or both true, then
447
+ # there is no change to the sink's writer_identity.
448
+ # If the old value is false and the new value is true, then writer_identity is
449
+ # changed to a unique service account.
450
+ # It is an error if the old value is true and the new value is false.
451
+ # @param [String] fields
452
+ # Selector specifying which fields to include in a partial response.
453
+ # @param [String] quota_user
454
+ # Available to use for quota purposes for server-side applications. Can be any
455
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
456
+ # @param [Google::Apis::RequestOptions] options
457
+ # Request-specific options
458
+ #
459
+ # @yield [result, err] Result & error if block supplied
460
+ # @yieldparam result [Google::Apis::LoggingV2::LogSink] parsed result object
461
+ # @yieldparam err [StandardError] error object if request failed
462
+ #
463
+ # @return [Google::Apis::LoggingV2::LogSink]
464
+ #
465
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
466
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
467
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
468
+ def update_project_sink(sink_name, log_sink_object = nil, unique_writer_identity: nil, fields: nil, quota_user: nil, options: nil, &block)
469
+ command = make_simple_command(:put, 'v2/{+sinkName}', options)
470
+ command.request_representation = Google::Apis::LoggingV2::LogSink::Representation
471
+ command.request_object = log_sink_object
472
+ command.response_representation = Google::Apis::LoggingV2::LogSink::Representation
473
+ command.response_class = Google::Apis::LoggingV2::LogSink
474
+ command.params['sinkName'] = sink_name unless sink_name.nil?
475
+ command.query['uniqueWriterIdentity'] = unique_writer_identity unless unique_writer_identity.nil?
476
+ command.query['fields'] = fields unless fields.nil?
477
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
478
+ execute_or_queue_command(command, &block)
479
+ end
480
+
481
+ # Creates a sink that exports specified log entries to a destination. The export
482
+ # of newly-ingested log entries begins immediately, unless the current time is
483
+ # outside the sink's start and end times or the sink's writer_identity is not
484
+ # permitted to write to the destination. A sink can export log entries only from
485
+ # the resource owning the sink.
486
+ # @param [String] parent
487
+ # Required. The resource in which to create the sink:
488
+ # "projects/[PROJECT_ID]"
489
+ # "organizations/[ORGANIZATION_ID]"
490
+ # "billingAccounts/[BILLING_ACCOUNT_ID]"
491
+ # "folders/[FOLDER_ID]"
492
+ # Examples: "projects/my-logging-project", "organizations/123456789".
493
+ # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
494
+ # @param [Boolean] unique_writer_identity
495
+ # Optional. Determines the kind of IAM identity returned as writer_identity in
496
+ # the new sink. If this value is omitted or set to false, and if the sink's
497
+ # parent is a project, then the value returned as writer_identity is the same
498
+ # group or service account used by Stackdriver Logging before the addition of
499
+ # writer identities to this API. The sink's destination must be in the same
500
+ # project as the sink itself.If this field is set to true, or if the sink is
501
+ # owned by a non-project resource such as an organization, then the value of
502
+ # writer_identity will be a unique service account used only for exports from
503
+ # the new sink. For more information, see writer_identity in LogSink.
504
+ # @param [String] fields
505
+ # Selector specifying which fields to include in a partial response.
506
+ # @param [String] quota_user
507
+ # Available to use for quota purposes for server-side applications. Can be any
508
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
509
+ # @param [Google::Apis::RequestOptions] options
510
+ # Request-specific options
511
+ #
512
+ # @yield [result, err] Result & error if block supplied
513
+ # @yieldparam result [Google::Apis::LoggingV2::LogSink] parsed result object
514
+ # @yieldparam err [StandardError] error object if request failed
515
+ #
516
+ # @return [Google::Apis::LoggingV2::LogSink]
517
+ #
518
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
519
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
520
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
521
+ def create_project_sink(parent, log_sink_object = nil, unique_writer_identity: nil, fields: nil, quota_user: nil, options: nil, &block)
522
+ command = make_simple_command(:post, 'v2/{+parent}/sinks', options)
523
+ command.request_representation = Google::Apis::LoggingV2::LogSink::Representation
524
+ command.request_object = log_sink_object
525
+ command.response_representation = Google::Apis::LoggingV2::LogSink::Representation
526
+ command.response_class = Google::Apis::LoggingV2::LogSink
527
+ command.params['parent'] = parent unless parent.nil?
528
+ command.query['uniqueWriterIdentity'] = unique_writer_identity unless unique_writer_identity.nil?
529
+ command.query['fields'] = fields unless fields.nil?
530
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
531
+ execute_or_queue_command(command, &block)
532
+ end
533
+
534
+ # Deletes all the log entries in a log. The log reappears if it receives new
535
+ # entries. Log entries written shortly before the delete operation might not be
536
+ # deleted.
537
+ # @param [String] log_name
538
+ # Required. The resource name of the log to delete:
539
+ # "projects/[PROJECT_ID]/logs/[LOG_ID]"
540
+ # "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
541
+ # "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
542
+ # "folders/[FOLDER_ID]/logs/[LOG_ID]"
543
+ # [LOG_ID] must be URL-encoded. For example, "projects/my-project-id/logs/syslog"
544
+ # , "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%
545
+ # 2Factivity". For more information about log names, see LogEntry.
546
+ # @param [String] fields
547
+ # Selector specifying which fields to include in a partial response.
548
+ # @param [String] quota_user
549
+ # Available to use for quota purposes for server-side applications. Can be any
550
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
551
+ # @param [Google::Apis::RequestOptions] options
552
+ # Request-specific options
553
+ #
554
+ # @yield [result, err] Result & error if block supplied
555
+ # @yieldparam result [Google::Apis::LoggingV2::Empty] parsed result object
556
+ # @yieldparam err [StandardError] error object if request failed
557
+ #
558
+ # @return [Google::Apis::LoggingV2::Empty]
559
+ #
560
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
561
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
562
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
563
+ def delete_billing_account_log(log_name, fields: nil, quota_user: nil, options: nil, &block)
564
+ command = make_simple_command(:delete, 'v2/{+logName}', options)
565
+ command.response_representation = Google::Apis::LoggingV2::Empty::Representation
566
+ command.response_class = Google::Apis::LoggingV2::Empty
567
+ command.params['logName'] = log_name unless log_name.nil?
568
+ command.query['fields'] = fields unless fields.nil?
569
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
570
+ execute_or_queue_command(command, &block)
571
+ end
572
+
573
+ # Lists the logs in projects, organizations, folders, or billing accounts. Only
574
+ # logs that have entries are listed.
575
+ # @param [String] parent
576
+ # Required. The resource name that owns the logs:
577
+ # "projects/[PROJECT_ID]"
578
+ # "organizations/[ORGANIZATION_ID]"
579
+ # "billingAccounts/[BILLING_ACCOUNT_ID]"
580
+ # "folders/[FOLDER_ID]"
581
+ # @param [String] page_token
582
+ # Optional. If present, then retrieve the next batch of results from the
583
+ # preceding call to this method. pageToken must be the value of nextPageToken
584
+ # from the previous response. The values of other method parameters should be
585
+ # identical to those in the previous call.
586
+ # @param [Fixnum] page_size
587
+ # Optional. The maximum number of results to return from this request. Non-
588
+ # positive values are ignored. The presence of nextPageToken in the response
589
+ # indicates that more results might be available.
590
+ # @param [String] fields
591
+ # Selector specifying which fields to include in a partial response.
592
+ # @param [String] quota_user
593
+ # Available to use for quota purposes for server-side applications. Can be any
594
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
595
+ # @param [Google::Apis::RequestOptions] options
596
+ # Request-specific options
597
+ #
598
+ # @yield [result, err] Result & error if block supplied
599
+ # @yieldparam result [Google::Apis::LoggingV2::ListLogsResponse] parsed result object
600
+ # @yieldparam err [StandardError] error object if request failed
601
+ #
602
+ # @return [Google::Apis::LoggingV2::ListLogsResponse]
603
+ #
604
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
605
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
606
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
607
+ def list_billing_account_logs(parent, page_token: nil, page_size: nil, fields: nil, quota_user: nil, options: nil, &block)
608
+ command = make_simple_command(:get, 'v2/{+parent}/logs', options)
609
+ command.response_representation = Google::Apis::LoggingV2::ListLogsResponse::Representation
610
+ command.response_class = Google::Apis::LoggingV2::ListLogsResponse
611
+ command.params['parent'] = parent unless parent.nil?
612
+ command.query['pageToken'] = page_token unless page_token.nil?
613
+ command.query['pageSize'] = page_size unless page_size.nil?
614
+ command.query['fields'] = fields unless fields.nil?
615
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
616
+ execute_or_queue_command(command, &block)
617
+ end
618
+
619
+ # Deletes a sink. If the sink has a unique writer_identity, then that service
620
+ # account is also deleted.
621
+ # @param [String] sink_name
622
+ # Required. The full resource name of the sink to delete, including the parent
623
+ # resource and the sink identifier:
624
+ # "projects/[PROJECT_ID]/sinks/[SINK_ID]"
625
+ # "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
626
+ # "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
627
+ # "folders/[FOLDER_ID]/sinks/[SINK_ID]"
628
+ # Example: "projects/my-project-id/sinks/my-sink-id".
629
+ # @param [String] fields
630
+ # Selector specifying which fields to include in a partial response.
631
+ # @param [String] quota_user
632
+ # Available to use for quota purposes for server-side applications. Can be any
633
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
634
+ # @param [Google::Apis::RequestOptions] options
635
+ # Request-specific options
636
+ #
637
+ # @yield [result, err] Result & error if block supplied
638
+ # @yieldparam result [Google::Apis::LoggingV2::Empty] parsed result object
639
+ # @yieldparam err [StandardError] error object if request failed
640
+ #
641
+ # @return [Google::Apis::LoggingV2::Empty]
642
+ #
643
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
644
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
645
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
646
+ def delete_billing_account_sink(sink_name, fields: nil, quota_user: nil, options: nil, &block)
647
+ command = make_simple_command(:delete, 'v2/{+sinkName}', options)
648
+ command.response_representation = Google::Apis::LoggingV2::Empty::Representation
649
+ command.response_class = Google::Apis::LoggingV2::Empty
650
+ command.params['sinkName'] = sink_name unless sink_name.nil?
651
+ command.query['fields'] = fields unless fields.nil?
652
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
653
+ execute_or_queue_command(command, &block)
654
+ end
655
+
656
+ # Lists sinks.
657
+ # @param [String] parent
658
+ # Required. The parent resource whose sinks are to be listed:
659
+ # "projects/[PROJECT_ID]"
660
+ # "organizations/[ORGANIZATION_ID]"
661
+ # "billingAccounts/[BILLING_ACCOUNT_ID]"
662
+ # "folders/[FOLDER_ID]"
663
+ # @param [String] page_token
664
+ # Optional. If present, then retrieve the next batch of results from the
665
+ # preceding call to this method. pageToken must be the value of nextPageToken
666
+ # from the previous response. The values of other method parameters should be
667
+ # identical to those in the previous call.
668
+ # @param [Fixnum] page_size
669
+ # Optional. The maximum number of results to return from this request. Non-
670
+ # positive values are ignored. The presence of nextPageToken in the response
671
+ # indicates that more results might be available.
672
+ # @param [String] fields
673
+ # Selector specifying which fields to include in a partial response.
674
+ # @param [String] quota_user
675
+ # Available to use for quota purposes for server-side applications. Can be any
676
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
677
+ # @param [Google::Apis::RequestOptions] options
678
+ # Request-specific options
679
+ #
680
+ # @yield [result, err] Result & error if block supplied
681
+ # @yieldparam result [Google::Apis::LoggingV2::ListSinksResponse] parsed result object
682
+ # @yieldparam err [StandardError] error object if request failed
683
+ #
684
+ # @return [Google::Apis::LoggingV2::ListSinksResponse]
685
+ #
686
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
687
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
688
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
689
+ def list_billing_account_sinks(parent, page_token: nil, page_size: nil, fields: nil, quota_user: nil, options: nil, &block)
690
+ command = make_simple_command(:get, 'v2/{+parent}/sinks', options)
691
+ command.response_representation = Google::Apis::LoggingV2::ListSinksResponse::Representation
692
+ command.response_class = Google::Apis::LoggingV2::ListSinksResponse
693
+ command.params['parent'] = parent unless parent.nil?
694
+ command.query['pageToken'] = page_token unless page_token.nil?
695
+ command.query['pageSize'] = page_size unless page_size.nil?
696
+ command.query['fields'] = fields unless fields.nil?
697
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
698
+ execute_or_queue_command(command, &block)
699
+ end
700
+
701
+ # Gets a sink.
702
+ # @param [String] sink_name
703
+ # Required. The resource name of the sink:
704
+ # "projects/[PROJECT_ID]/sinks/[SINK_ID]"
705
+ # "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
706
+ # "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
707
+ # "folders/[FOLDER_ID]/sinks/[SINK_ID]"
708
+ # Example: "projects/my-project-id/sinks/my-sink-id".
709
+ # @param [String] fields
710
+ # Selector specifying which fields to include in a partial response.
711
+ # @param [String] quota_user
712
+ # Available to use for quota purposes for server-side applications. Can be any
713
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
714
+ # @param [Google::Apis::RequestOptions] options
715
+ # Request-specific options
716
+ #
717
+ # @yield [result, err] Result & error if block supplied
718
+ # @yieldparam result [Google::Apis::LoggingV2::LogSink] parsed result object
719
+ # @yieldparam err [StandardError] error object if request failed
720
+ #
721
+ # @return [Google::Apis::LoggingV2::LogSink]
722
+ #
723
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
724
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
725
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
726
+ def get_billing_account_sink(sink_name, fields: nil, quota_user: nil, options: nil, &block)
727
+ command = make_simple_command(:get, 'v2/{+sinkName}', options)
728
+ command.response_representation = Google::Apis::LoggingV2::LogSink::Representation
729
+ command.response_class = Google::Apis::LoggingV2::LogSink
730
+ command.params['sinkName'] = sink_name unless sink_name.nil?
731
+ command.query['fields'] = fields unless fields.nil?
732
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
733
+ execute_or_queue_command(command, &block)
734
+ end
735
+
736
+ # Updates a sink. If the named sink doesn't exist, then this method is identical
737
+ # to sinks.create. If the named sink does exist, then this method replaces the
738
+ # following fields in the existing sink with values from the new sink:
739
+ # destination, filter, output_version_format, start_time, and end_time. The
740
+ # updated filter might also have a new writer_identity; see the
741
+ # unique_writer_identity field.
742
+ # @param [String] sink_name
743
+ # Required. The full resource name of the sink to update, including the parent
744
+ # resource and the sink identifier:
745
+ # "projects/[PROJECT_ID]/sinks/[SINK_ID]"
746
+ # "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
747
+ # "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
748
+ # "folders/[FOLDER_ID]/sinks/[SINK_ID]"
749
+ # Example: "projects/my-project-id/sinks/my-sink-id".
750
+ # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
751
+ # @param [Boolean] unique_writer_identity
752
+ # Optional. See sinks.create for a description of this field. When updating a
753
+ # sink, the effect of this field on the value of writer_identity in the updated
754
+ # sink depends on both the old and new values of this field:
755
+ # If the old and new values of this field are both false or both true, then
756
+ # there is no change to the sink's writer_identity.
757
+ # If the old value is false and the new value is true, then writer_identity is
758
+ # changed to a unique service account.
759
+ # It is an error if the old value is true and the new value is false.
760
+ # @param [String] fields
761
+ # Selector specifying which fields to include in a partial response.
762
+ # @param [String] quota_user
763
+ # Available to use for quota purposes for server-side applications. Can be any
764
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
765
+ # @param [Google::Apis::RequestOptions] options
766
+ # Request-specific options
767
+ #
768
+ # @yield [result, err] Result & error if block supplied
769
+ # @yieldparam result [Google::Apis::LoggingV2::LogSink] parsed result object
770
+ # @yieldparam err [StandardError] error object if request failed
771
+ #
772
+ # @return [Google::Apis::LoggingV2::LogSink]
773
+ #
774
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
775
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
776
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
777
+ def update_billing_account_sink(sink_name, log_sink_object = nil, unique_writer_identity: nil, fields: nil, quota_user: nil, options: nil, &block)
778
+ command = make_simple_command(:put, 'v2/{+sinkName}', options)
779
+ command.request_representation = Google::Apis::LoggingV2::LogSink::Representation
780
+ command.request_object = log_sink_object
781
+ command.response_representation = Google::Apis::LoggingV2::LogSink::Representation
782
+ command.response_class = Google::Apis::LoggingV2::LogSink
783
+ command.params['sinkName'] = sink_name unless sink_name.nil?
784
+ command.query['uniqueWriterIdentity'] = unique_writer_identity unless unique_writer_identity.nil?
785
+ command.query['fields'] = fields unless fields.nil?
786
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
787
+ execute_or_queue_command(command, &block)
788
+ end
789
+
790
+ # Creates a sink that exports specified log entries to a destination. The export
791
+ # of newly-ingested log entries begins immediately, unless the current time is
792
+ # outside the sink's start and end times or the sink's writer_identity is not
793
+ # permitted to write to the destination. A sink can export log entries only from
794
+ # the resource owning the sink.
795
+ # @param [String] parent
796
+ # Required. The resource in which to create the sink:
797
+ # "projects/[PROJECT_ID]"
798
+ # "organizations/[ORGANIZATION_ID]"
799
+ # "billingAccounts/[BILLING_ACCOUNT_ID]"
800
+ # "folders/[FOLDER_ID]"
801
+ # Examples: "projects/my-logging-project", "organizations/123456789".
802
+ # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
803
+ # @param [Boolean] unique_writer_identity
804
+ # Optional. Determines the kind of IAM identity returned as writer_identity in
805
+ # the new sink. If this value is omitted or set to false, and if the sink's
806
+ # parent is a project, then the value returned as writer_identity is the same
807
+ # group or service account used by Stackdriver Logging before the addition of
808
+ # writer identities to this API. The sink's destination must be in the same
809
+ # project as the sink itself.If this field is set to true, or if the sink is
810
+ # owned by a non-project resource such as an organization, then the value of
811
+ # writer_identity will be a unique service account used only for exports from
812
+ # the new sink. For more information, see writer_identity in LogSink.
813
+ # @param [String] fields
814
+ # Selector specifying which fields to include in a partial response.
815
+ # @param [String] quota_user
816
+ # Available to use for quota purposes for server-side applications. Can be any
817
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
818
+ # @param [Google::Apis::RequestOptions] options
819
+ # Request-specific options
820
+ #
821
+ # @yield [result, err] Result & error if block supplied
822
+ # @yieldparam result [Google::Apis::LoggingV2::LogSink] parsed result object
823
+ # @yieldparam err [StandardError] error object if request failed
824
+ #
825
+ # @return [Google::Apis::LoggingV2::LogSink]
826
+ #
827
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
828
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
829
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
830
+ def create_billing_account_sink(parent, log_sink_object = nil, unique_writer_identity: nil, fields: nil, quota_user: nil, options: nil, &block)
831
+ command = make_simple_command(:post, 'v2/{+parent}/sinks', options)
832
+ command.request_representation = Google::Apis::LoggingV2::LogSink::Representation
833
+ command.request_object = log_sink_object
834
+ command.response_representation = Google::Apis::LoggingV2::LogSink::Representation
835
+ command.response_class = Google::Apis::LoggingV2::LogSink
836
+ command.params['parent'] = parent unless parent.nil?
837
+ command.query['uniqueWriterIdentity'] = unique_writer_identity unless unique_writer_identity.nil?
838
+ command.query['fields'] = fields unless fields.nil?
839
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
840
+ execute_or_queue_command(command, &block)
841
+ end
842
+
843
+ # Deletes all the log entries in a log. The log reappears if it receives new
844
+ # entries. Log entries written shortly before the delete operation might not be
845
+ # deleted.
846
+ # @param [String] log_name
847
+ # Required. The resource name of the log to delete:
848
+ # "projects/[PROJECT_ID]/logs/[LOG_ID]"
849
+ # "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
850
+ # "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
851
+ # "folders/[FOLDER_ID]/logs/[LOG_ID]"
852
+ # [LOG_ID] must be URL-encoded. For example, "projects/my-project-id/logs/syslog"
853
+ # , "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%
854
+ # 2Factivity". For more information about log names, see LogEntry.
855
+ # @param [String] fields
856
+ # Selector specifying which fields to include in a partial response.
857
+ # @param [String] quota_user
858
+ # Available to use for quota purposes for server-side applications. Can be any
859
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
860
+ # @param [Google::Apis::RequestOptions] options
861
+ # Request-specific options
862
+ #
863
+ # @yield [result, err] Result & error if block supplied
864
+ # @yieldparam result [Google::Apis::LoggingV2::Empty] parsed result object
865
+ # @yieldparam err [StandardError] error object if request failed
866
+ #
867
+ # @return [Google::Apis::LoggingV2::Empty]
868
+ #
869
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
870
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
871
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
872
+ def delete_folder_log(log_name, fields: nil, quota_user: nil, options: nil, &block)
873
+ command = make_simple_command(:delete, 'v2/{+logName}', options)
874
+ command.response_representation = Google::Apis::LoggingV2::Empty::Representation
875
+ command.response_class = Google::Apis::LoggingV2::Empty
876
+ command.params['logName'] = log_name unless log_name.nil?
877
+ command.query['fields'] = fields unless fields.nil?
878
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
879
+ execute_or_queue_command(command, &block)
880
+ end
881
+
882
+ # Lists the logs in projects, organizations, folders, or billing accounts. Only
883
+ # logs that have entries are listed.
884
+ # @param [String] parent
885
+ # Required. The resource name that owns the logs:
886
+ # "projects/[PROJECT_ID]"
887
+ # "organizations/[ORGANIZATION_ID]"
888
+ # "billingAccounts/[BILLING_ACCOUNT_ID]"
889
+ # "folders/[FOLDER_ID]"
890
+ # @param [String] page_token
891
+ # Optional. If present, then retrieve the next batch of results from the
892
+ # preceding call to this method. pageToken must be the value of nextPageToken
893
+ # from the previous response. The values of other method parameters should be
894
+ # identical to those in the previous call.
895
+ # @param [Fixnum] page_size
896
+ # Optional. The maximum number of results to return from this request. Non-
897
+ # positive values are ignored. The presence of nextPageToken in the response
898
+ # indicates that more results might be available.
899
+ # @param [String] fields
900
+ # Selector specifying which fields to include in a partial response.
901
+ # @param [String] quota_user
902
+ # Available to use for quota purposes for server-side applications. Can be any
903
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
904
+ # @param [Google::Apis::RequestOptions] options
905
+ # Request-specific options
906
+ #
907
+ # @yield [result, err] Result & error if block supplied
908
+ # @yieldparam result [Google::Apis::LoggingV2::ListLogsResponse] parsed result object
909
+ # @yieldparam err [StandardError] error object if request failed
910
+ #
911
+ # @return [Google::Apis::LoggingV2::ListLogsResponse]
912
+ #
913
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
914
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
915
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
916
+ def list_folder_logs(parent, page_token: nil, page_size: nil, fields: nil, quota_user: nil, options: nil, &block)
917
+ command = make_simple_command(:get, 'v2/{+parent}/logs', options)
918
+ command.response_representation = Google::Apis::LoggingV2::ListLogsResponse::Representation
919
+ command.response_class = Google::Apis::LoggingV2::ListLogsResponse
920
+ command.params['parent'] = parent unless parent.nil?
921
+ command.query['pageToken'] = page_token unless page_token.nil?
922
+ command.query['pageSize'] = page_size unless page_size.nil?
923
+ command.query['fields'] = fields unless fields.nil?
924
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
925
+ execute_or_queue_command(command, &block)
926
+ end
927
+
928
+ # Updates a sink. If the named sink doesn't exist, then this method is identical
929
+ # to sinks.create. If the named sink does exist, then this method replaces the
930
+ # following fields in the existing sink with values from the new sink:
931
+ # destination, filter, output_version_format, start_time, and end_time. The
932
+ # updated filter might also have a new writer_identity; see the
933
+ # unique_writer_identity field.
934
+ # @param [String] sink_name
935
+ # Required. The full resource name of the sink to update, including the parent
936
+ # resource and the sink identifier:
937
+ # "projects/[PROJECT_ID]/sinks/[SINK_ID]"
938
+ # "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
939
+ # "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
940
+ # "folders/[FOLDER_ID]/sinks/[SINK_ID]"
941
+ # Example: "projects/my-project-id/sinks/my-sink-id".
942
+ # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
943
+ # @param [Boolean] unique_writer_identity
944
+ # Optional. See sinks.create for a description of this field. When updating a
945
+ # sink, the effect of this field on the value of writer_identity in the updated
946
+ # sink depends on both the old and new values of this field:
947
+ # If the old and new values of this field are both false or both true, then
948
+ # there is no change to the sink's writer_identity.
949
+ # If the old value is false and the new value is true, then writer_identity is
950
+ # changed to a unique service account.
951
+ # It is an error if the old value is true and the new value is false.
952
+ # @param [String] fields
953
+ # Selector specifying which fields to include in a partial response.
954
+ # @param [String] quota_user
955
+ # Available to use for quota purposes for server-side applications. Can be any
956
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
957
+ # @param [Google::Apis::RequestOptions] options
958
+ # Request-specific options
959
+ #
960
+ # @yield [result, err] Result & error if block supplied
961
+ # @yieldparam result [Google::Apis::LoggingV2::LogSink] parsed result object
962
+ # @yieldparam err [StandardError] error object if request failed
963
+ #
964
+ # @return [Google::Apis::LoggingV2::LogSink]
965
+ #
966
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
967
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
968
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
969
+ def update_folder_sink(sink_name, log_sink_object = nil, unique_writer_identity: nil, fields: nil, quota_user: nil, options: nil, &block)
970
+ command = make_simple_command(:put, 'v2/{+sinkName}', options)
971
+ command.request_representation = Google::Apis::LoggingV2::LogSink::Representation
972
+ command.request_object = log_sink_object
973
+ command.response_representation = Google::Apis::LoggingV2::LogSink::Representation
974
+ command.response_class = Google::Apis::LoggingV2::LogSink
975
+ command.params['sinkName'] = sink_name unless sink_name.nil?
976
+ command.query['uniqueWriterIdentity'] = unique_writer_identity unless unique_writer_identity.nil?
977
+ command.query['fields'] = fields unless fields.nil?
978
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
979
+ execute_or_queue_command(command, &block)
980
+ end
981
+
982
+ # Creates a sink that exports specified log entries to a destination. The export
983
+ # of newly-ingested log entries begins immediately, unless the current time is
984
+ # outside the sink's start and end times or the sink's writer_identity is not
985
+ # permitted to write to the destination. A sink can export log entries only from
986
+ # the resource owning the sink.
987
+ # @param [String] parent
988
+ # Required. The resource in which to create the sink:
989
+ # "projects/[PROJECT_ID]"
990
+ # "organizations/[ORGANIZATION_ID]"
991
+ # "billingAccounts/[BILLING_ACCOUNT_ID]"
992
+ # "folders/[FOLDER_ID]"
993
+ # Examples: "projects/my-logging-project", "organizations/123456789".
994
+ # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
995
+ # @param [Boolean] unique_writer_identity
996
+ # Optional. Determines the kind of IAM identity returned as writer_identity in
997
+ # the new sink. If this value is omitted or set to false, and if the sink's
998
+ # parent is a project, then the value returned as writer_identity is the same
999
+ # group or service account used by Stackdriver Logging before the addition of
1000
+ # writer identities to this API. The sink's destination must be in the same
1001
+ # project as the sink itself.If this field is set to true, or if the sink is
1002
+ # owned by a non-project resource such as an organization, then the value of
1003
+ # writer_identity will be a unique service account used only for exports from
1004
+ # the new sink. For more information, see writer_identity in LogSink.
1005
+ # @param [String] fields
1006
+ # Selector specifying which fields to include in a partial response.
1007
+ # @param [String] quota_user
1008
+ # Available to use for quota purposes for server-side applications. Can be any
1009
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1010
+ # @param [Google::Apis::RequestOptions] options
1011
+ # Request-specific options
1012
+ #
1013
+ # @yield [result, err] Result & error if block supplied
1014
+ # @yieldparam result [Google::Apis::LoggingV2::LogSink] parsed result object
1015
+ # @yieldparam err [StandardError] error object if request failed
1016
+ #
1017
+ # @return [Google::Apis::LoggingV2::LogSink]
1018
+ #
1019
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1020
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1021
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1022
+ def create_folder_sink(parent, log_sink_object = nil, unique_writer_identity: nil, fields: nil, quota_user: nil, options: nil, &block)
1023
+ command = make_simple_command(:post, 'v2/{+parent}/sinks', options)
1024
+ command.request_representation = Google::Apis::LoggingV2::LogSink::Representation
1025
+ command.request_object = log_sink_object
1026
+ command.response_representation = Google::Apis::LoggingV2::LogSink::Representation
1027
+ command.response_class = Google::Apis::LoggingV2::LogSink
1028
+ command.params['parent'] = parent unless parent.nil?
1029
+ command.query['uniqueWriterIdentity'] = unique_writer_identity unless unique_writer_identity.nil?
1030
+ command.query['fields'] = fields unless fields.nil?
1031
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1032
+ execute_or_queue_command(command, &block)
1033
+ end
1034
+
1035
+ # Deletes a sink. If the sink has a unique writer_identity, then that service
1036
+ # account is also deleted.
1037
+ # @param [String] sink_name
1038
+ # Required. The full resource name of the sink to delete, including the parent
1039
+ # resource and the sink identifier:
1040
+ # "projects/[PROJECT_ID]/sinks/[SINK_ID]"
1041
+ # "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
1042
+ # "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
1043
+ # "folders/[FOLDER_ID]/sinks/[SINK_ID]"
1044
+ # Example: "projects/my-project-id/sinks/my-sink-id".
1045
+ # @param [String] fields
1046
+ # Selector specifying which fields to include in a partial response.
1047
+ # @param [String] quota_user
1048
+ # Available to use for quota purposes for server-side applications. Can be any
1049
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1050
+ # @param [Google::Apis::RequestOptions] options
1051
+ # Request-specific options
1052
+ #
1053
+ # @yield [result, err] Result & error if block supplied
1054
+ # @yieldparam result [Google::Apis::LoggingV2::Empty] parsed result object
1055
+ # @yieldparam err [StandardError] error object if request failed
1056
+ #
1057
+ # @return [Google::Apis::LoggingV2::Empty]
1058
+ #
1059
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1060
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1061
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1062
+ def delete_folder_sink(sink_name, fields: nil, quota_user: nil, options: nil, &block)
1063
+ command = make_simple_command(:delete, 'v2/{+sinkName}', options)
1064
+ command.response_representation = Google::Apis::LoggingV2::Empty::Representation
1065
+ command.response_class = Google::Apis::LoggingV2::Empty
1066
+ command.params['sinkName'] = sink_name unless sink_name.nil?
1067
+ command.query['fields'] = fields unless fields.nil?
1068
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1069
+ execute_or_queue_command(command, &block)
1070
+ end
1071
+
1072
+ # Lists sinks.
1073
+ # @param [String] parent
1074
+ # Required. The parent resource whose sinks are to be listed:
1075
+ # "projects/[PROJECT_ID]"
1076
+ # "organizations/[ORGANIZATION_ID]"
1077
+ # "billingAccounts/[BILLING_ACCOUNT_ID]"
1078
+ # "folders/[FOLDER_ID]"
1079
+ # @param [String] page_token
1080
+ # Optional. If present, then retrieve the next batch of results from the
1081
+ # preceding call to this method. pageToken must be the value of nextPageToken
1082
+ # from the previous response. The values of other method parameters should be
1083
+ # identical to those in the previous call.
1084
+ # @param [Fixnum] page_size
1085
+ # Optional. The maximum number of results to return from this request. Non-
1086
+ # positive values are ignored. The presence of nextPageToken in the response
1087
+ # indicates that more results might be available.
1088
+ # @param [String] fields
1089
+ # Selector specifying which fields to include in a partial response.
1090
+ # @param [String] quota_user
1091
+ # Available to use for quota purposes for server-side applications. Can be any
1092
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1093
+ # @param [Google::Apis::RequestOptions] options
1094
+ # Request-specific options
1095
+ #
1096
+ # @yield [result, err] Result & error if block supplied
1097
+ # @yieldparam result [Google::Apis::LoggingV2::ListSinksResponse] parsed result object
1098
+ # @yieldparam err [StandardError] error object if request failed
1099
+ #
1100
+ # @return [Google::Apis::LoggingV2::ListSinksResponse]
1101
+ #
1102
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1103
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1104
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1105
+ def list_folder_sinks(parent, page_token: nil, page_size: nil, fields: nil, quota_user: nil, options: nil, &block)
1106
+ command = make_simple_command(:get, 'v2/{+parent}/sinks', options)
1107
+ command.response_representation = Google::Apis::LoggingV2::ListSinksResponse::Representation
1108
+ command.response_class = Google::Apis::LoggingV2::ListSinksResponse
1109
+ command.params['parent'] = parent unless parent.nil?
1110
+ command.query['pageToken'] = page_token unless page_token.nil?
1111
+ command.query['pageSize'] = page_size unless page_size.nil?
1112
+ command.query['fields'] = fields unless fields.nil?
1113
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1114
+ execute_or_queue_command(command, &block)
1115
+ end
1116
+
1117
+ # Gets a sink.
1118
+ # @param [String] sink_name
1119
+ # Required. The resource name of the sink:
1120
+ # "projects/[PROJECT_ID]/sinks/[SINK_ID]"
1121
+ # "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
1122
+ # "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
1123
+ # "folders/[FOLDER_ID]/sinks/[SINK_ID]"
1124
+ # Example: "projects/my-project-id/sinks/my-sink-id".
1125
+ # @param [String] fields
1126
+ # Selector specifying which fields to include in a partial response.
1127
+ # @param [String] quota_user
1128
+ # Available to use for quota purposes for server-side applications. Can be any
1129
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1130
+ # @param [Google::Apis::RequestOptions] options
1131
+ # Request-specific options
1132
+ #
1133
+ # @yield [result, err] Result & error if block supplied
1134
+ # @yieldparam result [Google::Apis::LoggingV2::LogSink] parsed result object
1135
+ # @yieldparam err [StandardError] error object if request failed
1136
+ #
1137
+ # @return [Google::Apis::LoggingV2::LogSink]
1138
+ #
1139
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1140
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1141
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1142
+ def get_folder_sink(sink_name, fields: nil, quota_user: nil, options: nil, &block)
1143
+ command = make_simple_command(:get, 'v2/{+sinkName}', options)
1144
+ command.response_representation = Google::Apis::LoggingV2::LogSink::Representation
1145
+ command.response_class = Google::Apis::LoggingV2::LogSink
1146
+ command.params['sinkName'] = sink_name unless sink_name.nil?
1147
+ command.query['fields'] = fields unless fields.nil?
1148
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1149
+ execute_or_queue_command(command, &block)
1150
+ end
1151
+
1152
+ # Lists the descriptors for monitored resource types used by Stackdriver Logging.
1153
+ # @param [String] page_token
1154
+ # Optional. If present, then retrieve the next batch of results from the
1155
+ # preceding call to this method. pageToken must be the value of nextPageToken
1156
+ # from the previous response. The values of other method parameters should be
1157
+ # identical to those in the previous call.
1158
+ # @param [Fixnum] page_size
1159
+ # Optional. The maximum number of results to return from this request. Non-
1160
+ # positive values are ignored. The presence of nextPageToken in the response
1161
+ # indicates that more results might be available.
1162
+ # @param [String] fields
1163
+ # Selector specifying which fields to include in a partial response.
1164
+ # @param [String] quota_user
1165
+ # Available to use for quota purposes for server-side applications. Can be any
1166
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1167
+ # @param [Google::Apis::RequestOptions] options
1168
+ # Request-specific options
1169
+ #
1170
+ # @yield [result, err] Result & error if block supplied
1171
+ # @yieldparam result [Google::Apis::LoggingV2::ListMonitoredResourceDescriptorsResponse] parsed result object
1172
+ # @yieldparam err [StandardError] error object if request failed
1173
+ #
1174
+ # @return [Google::Apis::LoggingV2::ListMonitoredResourceDescriptorsResponse]
1175
+ #
1176
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1177
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1178
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1179
+ def list_monitored_resource_descriptors(page_token: nil, page_size: nil, fields: nil, quota_user: nil, options: nil, &block)
1180
+ command = make_simple_command(:get, 'v2/monitoredResourceDescriptors', options)
1181
+ command.response_representation = Google::Apis::LoggingV2::ListMonitoredResourceDescriptorsResponse::Representation
1182
+ command.response_class = Google::Apis::LoggingV2::ListMonitoredResourceDescriptorsResponse
1183
+ command.query['pageToken'] = page_token unless page_token.nil?
1184
+ command.query['pageSize'] = page_size unless page_size.nil?
1185
+ command.query['fields'] = fields unless fields.nil?
1186
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1187
+ execute_or_queue_command(command, &block)
1188
+ end
1189
+
1190
+ # Deletes all the log entries in a log. The log reappears if it receives new
1191
+ # entries. Log entries written shortly before the delete operation might not be
1192
+ # deleted.
1193
+ # @param [String] log_name
1194
+ # Required. The resource name of the log to delete:
1195
+ # "projects/[PROJECT_ID]/logs/[LOG_ID]"
1196
+ # "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
1197
+ # "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
1198
+ # "folders/[FOLDER_ID]/logs/[LOG_ID]"
1199
+ # [LOG_ID] must be URL-encoded. For example, "projects/my-project-id/logs/syslog"
1200
+ # , "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%
1201
+ # 2Factivity". For more information about log names, see LogEntry.
1202
+ # @param [String] fields
1203
+ # Selector specifying which fields to include in a partial response.
1204
+ # @param [String] quota_user
1205
+ # Available to use for quota purposes for server-side applications. Can be any
1206
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1207
+ # @param [Google::Apis::RequestOptions] options
1208
+ # Request-specific options
1209
+ #
1210
+ # @yield [result, err] Result & error if block supplied
1211
+ # @yieldparam result [Google::Apis::LoggingV2::Empty] parsed result object
1212
+ # @yieldparam err [StandardError] error object if request failed
1213
+ #
1214
+ # @return [Google::Apis::LoggingV2::Empty]
1215
+ #
1216
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1217
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1218
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1219
+ def delete_organization_log(log_name, fields: nil, quota_user: nil, options: nil, &block)
1220
+ command = make_simple_command(:delete, 'v2/{+logName}', options)
1221
+ command.response_representation = Google::Apis::LoggingV2::Empty::Representation
1222
+ command.response_class = Google::Apis::LoggingV2::Empty
1223
+ command.params['logName'] = log_name unless log_name.nil?
1224
+ command.query['fields'] = fields unless fields.nil?
1225
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1226
+ execute_or_queue_command(command, &block)
1227
+ end
1228
+
1229
+ # Lists the logs in projects, organizations, folders, or billing accounts. Only
1230
+ # logs that have entries are listed.
1231
+ # @param [String] parent
1232
+ # Required. The resource name that owns the logs:
1233
+ # "projects/[PROJECT_ID]"
1234
+ # "organizations/[ORGANIZATION_ID]"
1235
+ # "billingAccounts/[BILLING_ACCOUNT_ID]"
1236
+ # "folders/[FOLDER_ID]"
1237
+ # @param [String] page_token
1238
+ # Optional. If present, then retrieve the next batch of results from the
1239
+ # preceding call to this method. pageToken must be the value of nextPageToken
1240
+ # from the previous response. The values of other method parameters should be
1241
+ # identical to those in the previous call.
1242
+ # @param [Fixnum] page_size
1243
+ # Optional. The maximum number of results to return from this request. Non-
1244
+ # positive values are ignored. The presence of nextPageToken in the response
1245
+ # indicates that more results might be available.
1246
+ # @param [String] fields
1247
+ # Selector specifying which fields to include in a partial response.
1248
+ # @param [String] quota_user
1249
+ # Available to use for quota purposes for server-side applications. Can be any
1250
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1251
+ # @param [Google::Apis::RequestOptions] options
1252
+ # Request-specific options
1253
+ #
1254
+ # @yield [result, err] Result & error if block supplied
1255
+ # @yieldparam result [Google::Apis::LoggingV2::ListLogsResponse] parsed result object
1256
+ # @yieldparam err [StandardError] error object if request failed
1257
+ #
1258
+ # @return [Google::Apis::LoggingV2::ListLogsResponse]
1259
+ #
1260
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1261
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1262
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1263
+ def list_organization_logs(parent, page_token: nil, page_size: nil, fields: nil, quota_user: nil, options: nil, &block)
1264
+ command = make_simple_command(:get, 'v2/{+parent}/logs', options)
1265
+ command.response_representation = Google::Apis::LoggingV2::ListLogsResponse::Representation
1266
+ command.response_class = Google::Apis::LoggingV2::ListLogsResponse
1267
+ command.params['parent'] = parent unless parent.nil?
1268
+ command.query['pageToken'] = page_token unless page_token.nil?
1269
+ command.query['pageSize'] = page_size unless page_size.nil?
1270
+ command.query['fields'] = fields unless fields.nil?
1271
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1272
+ execute_or_queue_command(command, &block)
1273
+ end
1274
+
1275
+ # Deletes a sink. If the sink has a unique writer_identity, then that service
1276
+ # account is also deleted.
1277
+ # @param [String] sink_name
1278
+ # Required. The full resource name of the sink to delete, including the parent
1279
+ # resource and the sink identifier:
1280
+ # "projects/[PROJECT_ID]/sinks/[SINK_ID]"
1281
+ # "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
1282
+ # "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
1283
+ # "folders/[FOLDER_ID]/sinks/[SINK_ID]"
1284
+ # Example: "projects/my-project-id/sinks/my-sink-id".
1285
+ # @param [String] fields
1286
+ # Selector specifying which fields to include in a partial response.
1287
+ # @param [String] quota_user
1288
+ # Available to use for quota purposes for server-side applications. Can be any
1289
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1290
+ # @param [Google::Apis::RequestOptions] options
1291
+ # Request-specific options
1292
+ #
1293
+ # @yield [result, err] Result & error if block supplied
1294
+ # @yieldparam result [Google::Apis::LoggingV2::Empty] parsed result object
1295
+ # @yieldparam err [StandardError] error object if request failed
1296
+ #
1297
+ # @return [Google::Apis::LoggingV2::Empty]
1298
+ #
1299
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1300
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1301
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1302
+ def delete_organization_sink(sink_name, fields: nil, quota_user: nil, options: nil, &block)
1303
+ command = make_simple_command(:delete, 'v2/{+sinkName}', options)
1304
+ command.response_representation = Google::Apis::LoggingV2::Empty::Representation
1305
+ command.response_class = Google::Apis::LoggingV2::Empty
1306
+ command.params['sinkName'] = sink_name unless sink_name.nil?
1307
+ command.query['fields'] = fields unless fields.nil?
1308
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1309
+ execute_or_queue_command(command, &block)
1310
+ end
1311
+
1312
+ # Lists sinks.
1313
+ # @param [String] parent
1314
+ # Required. The parent resource whose sinks are to be listed:
1315
+ # "projects/[PROJECT_ID]"
1316
+ # "organizations/[ORGANIZATION_ID]"
1317
+ # "billingAccounts/[BILLING_ACCOUNT_ID]"
1318
+ # "folders/[FOLDER_ID]"
1319
+ # @param [String] page_token
1320
+ # Optional. If present, then retrieve the next batch of results from the
1321
+ # preceding call to this method. pageToken must be the value of nextPageToken
1322
+ # from the previous response. The values of other method parameters should be
1323
+ # identical to those in the previous call.
1324
+ # @param [Fixnum] page_size
1325
+ # Optional. The maximum number of results to return from this request. Non-
1326
+ # positive values are ignored. The presence of nextPageToken in the response
1327
+ # indicates that more results might be available.
1328
+ # @param [String] fields
1329
+ # Selector specifying which fields to include in a partial response.
1330
+ # @param [String] quota_user
1331
+ # Available to use for quota purposes for server-side applications. Can be any
1332
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1333
+ # @param [Google::Apis::RequestOptions] options
1334
+ # Request-specific options
1335
+ #
1336
+ # @yield [result, err] Result & error if block supplied
1337
+ # @yieldparam result [Google::Apis::LoggingV2::ListSinksResponse] parsed result object
1338
+ # @yieldparam err [StandardError] error object if request failed
1339
+ #
1340
+ # @return [Google::Apis::LoggingV2::ListSinksResponse]
1341
+ #
1342
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1343
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1344
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1345
+ def list_organization_sinks(parent, page_token: nil, page_size: nil, fields: nil, quota_user: nil, options: nil, &block)
1346
+ command = make_simple_command(:get, 'v2/{+parent}/sinks', options)
1347
+ command.response_representation = Google::Apis::LoggingV2::ListSinksResponse::Representation
1348
+ command.response_class = Google::Apis::LoggingV2::ListSinksResponse
1349
+ command.params['parent'] = parent unless parent.nil?
1350
+ command.query['pageToken'] = page_token unless page_token.nil?
1351
+ command.query['pageSize'] = page_size unless page_size.nil?
1352
+ command.query['fields'] = fields unless fields.nil?
1353
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1354
+ execute_or_queue_command(command, &block)
1355
+ end
1356
+
1357
+ # Gets a sink.
1358
+ # @param [String] sink_name
1359
+ # Required. The resource name of the sink:
1360
+ # "projects/[PROJECT_ID]/sinks/[SINK_ID]"
1361
+ # "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
1362
+ # "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
1363
+ # "folders/[FOLDER_ID]/sinks/[SINK_ID]"
1364
+ # Example: "projects/my-project-id/sinks/my-sink-id".
1365
+ # @param [String] fields
1366
+ # Selector specifying which fields to include in a partial response.
1367
+ # @param [String] quota_user
1368
+ # Available to use for quota purposes for server-side applications. Can be any
1369
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1370
+ # @param [Google::Apis::RequestOptions] options
1371
+ # Request-specific options
1372
+ #
1373
+ # @yield [result, err] Result & error if block supplied
1374
+ # @yieldparam result [Google::Apis::LoggingV2::LogSink] parsed result object
1375
+ # @yieldparam err [StandardError] error object if request failed
1376
+ #
1377
+ # @return [Google::Apis::LoggingV2::LogSink]
1378
+ #
1379
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1380
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1381
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1382
+ def get_organization_sink(sink_name, fields: nil, quota_user: nil, options: nil, &block)
1383
+ command = make_simple_command(:get, 'v2/{+sinkName}', options)
1384
+ command.response_representation = Google::Apis::LoggingV2::LogSink::Representation
1385
+ command.response_class = Google::Apis::LoggingV2::LogSink
1386
+ command.params['sinkName'] = sink_name unless sink_name.nil?
1387
+ command.query['fields'] = fields unless fields.nil?
1388
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1389
+ execute_or_queue_command(command, &block)
1390
+ end
1391
+
1392
+ # Updates a sink. If the named sink doesn't exist, then this method is identical
1393
+ # to sinks.create. If the named sink does exist, then this method replaces the
1394
+ # following fields in the existing sink with values from the new sink:
1395
+ # destination, filter, output_version_format, start_time, and end_time. The
1396
+ # updated filter might also have a new writer_identity; see the
1397
+ # unique_writer_identity field.
1398
+ # @param [String] sink_name
1399
+ # Required. The full resource name of the sink to update, including the parent
1400
+ # resource and the sink identifier:
1401
+ # "projects/[PROJECT_ID]/sinks/[SINK_ID]"
1402
+ # "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
1403
+ # "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
1404
+ # "folders/[FOLDER_ID]/sinks/[SINK_ID]"
1405
+ # Example: "projects/my-project-id/sinks/my-sink-id".
1406
+ # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
1407
+ # @param [Boolean] unique_writer_identity
1408
+ # Optional. See sinks.create for a description of this field. When updating a
1409
+ # sink, the effect of this field on the value of writer_identity in the updated
1410
+ # sink depends on both the old and new values of this field:
1411
+ # If the old and new values of this field are both false or both true, then
1412
+ # there is no change to the sink's writer_identity.
1413
+ # If the old value is false and the new value is true, then writer_identity is
1414
+ # changed to a unique service account.
1415
+ # It is an error if the old value is true and the new value is false.
1416
+ # @param [String] fields
1417
+ # Selector specifying which fields to include in a partial response.
1418
+ # @param [String] quota_user
1419
+ # Available to use for quota purposes for server-side applications. Can be any
1420
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1421
+ # @param [Google::Apis::RequestOptions] options
1422
+ # Request-specific options
1423
+ #
1424
+ # @yield [result, err] Result & error if block supplied
1425
+ # @yieldparam result [Google::Apis::LoggingV2::LogSink] parsed result object
1426
+ # @yieldparam err [StandardError] error object if request failed
1427
+ #
1428
+ # @return [Google::Apis::LoggingV2::LogSink]
1429
+ #
1430
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1431
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1432
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1433
+ def update_organization_sink(sink_name, log_sink_object = nil, unique_writer_identity: nil, fields: nil, quota_user: nil, options: nil, &block)
1434
+ command = make_simple_command(:put, 'v2/{+sinkName}', options)
1435
+ command.request_representation = Google::Apis::LoggingV2::LogSink::Representation
1436
+ command.request_object = log_sink_object
1437
+ command.response_representation = Google::Apis::LoggingV2::LogSink::Representation
1438
+ command.response_class = Google::Apis::LoggingV2::LogSink
1439
+ command.params['sinkName'] = sink_name unless sink_name.nil?
1440
+ command.query['uniqueWriterIdentity'] = unique_writer_identity unless unique_writer_identity.nil?
1441
+ command.query['fields'] = fields unless fields.nil?
1442
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1443
+ execute_or_queue_command(command, &block)
1444
+ end
1445
+
1446
+ # Creates a sink that exports specified log entries to a destination. The export
1447
+ # of newly-ingested log entries begins immediately, unless the current time is
1448
+ # outside the sink's start and end times or the sink's writer_identity is not
1449
+ # permitted to write to the destination. A sink can export log entries only from
1450
+ # the resource owning the sink.
1451
+ # @param [String] parent
1452
+ # Required. The resource in which to create the sink:
1453
+ # "projects/[PROJECT_ID]"
1454
+ # "organizations/[ORGANIZATION_ID]"
1455
+ # "billingAccounts/[BILLING_ACCOUNT_ID]"
1456
+ # "folders/[FOLDER_ID]"
1457
+ # Examples: "projects/my-logging-project", "organizations/123456789".
1458
+ # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
1459
+ # @param [Boolean] unique_writer_identity
1460
+ # Optional. Determines the kind of IAM identity returned as writer_identity in
1461
+ # the new sink. If this value is omitted or set to false, and if the sink's
1462
+ # parent is a project, then the value returned as writer_identity is the same
1463
+ # group or service account used by Stackdriver Logging before the addition of
1464
+ # writer identities to this API. The sink's destination must be in the same
1465
+ # project as the sink itself.If this field is set to true, or if the sink is
1466
+ # owned by a non-project resource such as an organization, then the value of
1467
+ # writer_identity will be a unique service account used only for exports from
1468
+ # the new sink. For more information, see writer_identity in LogSink.
1469
+ # @param [String] fields
1470
+ # Selector specifying which fields to include in a partial response.
1471
+ # @param [String] quota_user
1472
+ # Available to use for quota purposes for server-side applications. Can be any
1473
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1474
+ # @param [Google::Apis::RequestOptions] options
1475
+ # Request-specific options
1476
+ #
1477
+ # @yield [result, err] Result & error if block supplied
1478
+ # @yieldparam result [Google::Apis::LoggingV2::LogSink] parsed result object
1479
+ # @yieldparam err [StandardError] error object if request failed
1480
+ #
1481
+ # @return [Google::Apis::LoggingV2::LogSink]
1482
+ #
1483
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1484
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1485
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1486
+ def create_organization_sink(parent, log_sink_object = nil, unique_writer_identity: nil, fields: nil, quota_user: nil, options: nil, &block)
1487
+ command = make_simple_command(:post, 'v2/{+parent}/sinks', options)
1488
+ command.request_representation = Google::Apis::LoggingV2::LogSink::Representation
1489
+ command.request_object = log_sink_object
1490
+ command.response_representation = Google::Apis::LoggingV2::LogSink::Representation
1491
+ command.response_class = Google::Apis::LoggingV2::LogSink
1492
+ command.params['parent'] = parent unless parent.nil?
1493
+ command.query['uniqueWriterIdentity'] = unique_writer_identity unless unique_writer_identity.nil?
1494
+ command.query['fields'] = fields unless fields.nil?
1495
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1496
+ execute_or_queue_command(command, &block)
1497
+ end
1498
+
1499
+ # Lists log entries. Use this method to retrieve log entries from Stackdriver
1500
+ # Logging. For ways to export log entries, see Exporting Logs.
1501
+ # @param [Google::Apis::LoggingV2::ListLogEntriesRequest] list_log_entries_request_object
1502
+ # @param [String] fields
1503
+ # Selector specifying which fields to include in a partial response.
1504
+ # @param [String] quota_user
1505
+ # Available to use for quota purposes for server-side applications. Can be any
1506
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1507
+ # @param [Google::Apis::RequestOptions] options
1508
+ # Request-specific options
1509
+ #
1510
+ # @yield [result, err] Result & error if block supplied
1511
+ # @yieldparam result [Google::Apis::LoggingV2::ListLogEntriesResponse] parsed result object
1512
+ # @yieldparam err [StandardError] error object if request failed
1513
+ #
1514
+ # @return [Google::Apis::LoggingV2::ListLogEntriesResponse]
1515
+ #
1516
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1517
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1518
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1519
+ def list_entry_log_entries(list_log_entries_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1520
+ command = make_simple_command(:post, 'v2/entries:list', options)
1521
+ command.request_representation = Google::Apis::LoggingV2::ListLogEntriesRequest::Representation
1522
+ command.request_object = list_log_entries_request_object
1523
+ command.response_representation = Google::Apis::LoggingV2::ListLogEntriesResponse::Representation
1524
+ command.response_class = Google::Apis::LoggingV2::ListLogEntriesResponse
1525
+ command.query['fields'] = fields unless fields.nil?
1526
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1527
+ execute_or_queue_command(command, &block)
1528
+ end
1529
+
1530
+ # Writes log entries to Stackdriver Logging.
1531
+ # @param [Google::Apis::LoggingV2::WriteLogEntriesRequest] write_log_entries_request_object
1532
+ # @param [String] fields
1533
+ # Selector specifying which fields to include in a partial response.
1534
+ # @param [String] quota_user
1535
+ # Available to use for quota purposes for server-side applications. Can be any
1536
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1537
+ # @param [Google::Apis::RequestOptions] options
1538
+ # Request-specific options
1539
+ #
1540
+ # @yield [result, err] Result & error if block supplied
1541
+ # @yieldparam result [Google::Apis::LoggingV2::WriteLogEntriesResponse] parsed result object
1542
+ # @yieldparam err [StandardError] error object if request failed
1543
+ #
1544
+ # @return [Google::Apis::LoggingV2::WriteLogEntriesResponse]
1545
+ #
1546
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1547
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1548
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1549
+ def write_entry_log_entries(write_log_entries_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1550
+ command = make_simple_command(:post, 'v2/entries:write', options)
1551
+ command.request_representation = Google::Apis::LoggingV2::WriteLogEntriesRequest::Representation
1552
+ command.request_object = write_log_entries_request_object
1553
+ command.response_representation = Google::Apis::LoggingV2::WriteLogEntriesResponse::Representation
1554
+ command.response_class = Google::Apis::LoggingV2::WriteLogEntriesResponse
1555
+ command.query['fields'] = fields unless fields.nil?
1556
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1557
+ execute_or_queue_command(command, &block)
1558
+ end
1559
+
1560
+ protected
1561
+
1562
+ def apply_command_defaults(command)
1563
+ command.query['key'] = key unless key.nil?
1564
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1565
+ end
1566
+ end
1567
+ end
1568
+ end
1569
+ end