google-api-client 0.9.8 → 0.9.20

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 (238) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +37 -0
  3. data/Gemfile +9 -1
  4. data/README.md +10 -2
  5. data/api_names.yaml +63 -110
  6. data/generated/google/apis/adexchangebuyer2_v2beta1.rb +35 -0
  7. data/generated/google/apis/adexchangebuyer2_v2beta1/classes.rb +298 -0
  8. data/generated/google/apis/adexchangebuyer2_v2beta1/representations.rb +122 -0
  9. data/generated/google/apis/adexchangebuyer2_v2beta1/service.rb +458 -0
  10. data/generated/google/apis/adexchangebuyer_v1_4.rb +1 -1
  11. data/generated/google/apis/adexchangebuyer_v1_4/classes.rb +260 -13
  12. data/generated/google/apis/adexchangebuyer_v1_4/representations.rb +81 -0
  13. data/generated/google/apis/adexchangebuyer_v1_4/service.rb +60 -8
  14. data/generated/google/apis/adexchangeseller_v2_0.rb +2 -3
  15. data/generated/google/apis/adexchangeseller_v2_0/service.rb +1 -2
  16. data/generated/google/apis/admin_directory_v1.rb +1 -1
  17. data/generated/google/apis/admin_directory_v1/classes.rb +86 -0
  18. data/generated/google/apis/admin_directory_v1/representations.rb +24 -0
  19. data/generated/google/apis/admin_directory_v1/service.rb +41 -2
  20. data/generated/google/apis/admin_reports_v1.rb +3 -3
  21. data/generated/google/apis/admin_reports_v1/service.rb +2 -2
  22. data/generated/google/apis/adsense_v1_4.rb +1 -1
  23. data/generated/google/apis/adsense_v1_4/classes.rb +1 -1
  24. data/generated/google/apis/adsensehost_v4_1.rb +1 -1
  25. data/generated/google/apis/adsensehost_v4_1/classes.rb +1 -2
  26. data/generated/google/apis/analytics_v3.rb +1 -1
  27. data/generated/google/apis/analytics_v3/classes.rb +379 -3
  28. data/generated/google/apis/analytics_v3/representations.rb +136 -0
  29. data/generated/google/apis/analytics_v3/service.rb +217 -0
  30. data/generated/google/apis/analyticsreporting_v4.rb +1 -1
  31. data/generated/google/apis/analyticsreporting_v4/classes.rb +50 -22
  32. data/generated/google/apis/androidenterprise_v1.rb +1 -1
  33. data/generated/google/apis/androidenterprise_v1/classes.rb +813 -49
  34. data/generated/google/apis/androidenterprise_v1/representations.rb +336 -0
  35. data/generated/google/apis/androidenterprise_v1/service.rb +1234 -145
  36. data/generated/google/apis/androidpublisher_v2.rb +1 -1
  37. data/generated/google/apis/androidpublisher_v2/classes.rb +47 -8
  38. data/generated/google/apis/androidpublisher_v2/representations.rb +27 -0
  39. data/generated/google/apis/androidpublisher_v2/service.rb +55 -0
  40. data/generated/google/apis/appengine_v1beta5.rb +7 -1
  41. data/generated/google/apis/appengine_v1beta5/classes.rb +516 -313
  42. data/generated/google/apis/appengine_v1beta5/representations.rb +115 -22
  43. data/generated/google/apis/appengine_v1beta5/service.rb +329 -33
  44. data/generated/google/apis/appsactivity_v1.rb +1 -1
  45. data/generated/google/apis/appsactivity_v1/classes.rb +7 -0
  46. data/generated/google/apis/appsactivity_v1/representations.rb +1 -0
  47. data/generated/google/apis/appstate_v1.rb +1 -1
  48. data/generated/google/apis/bigquery_v2.rb +1 -1
  49. data/generated/google/apis/bigquery_v2/classes.rb +277 -20
  50. data/generated/google/apis/bigquery_v2/representations.rb +86 -0
  51. data/generated/google/apis/bigquery_v2/service.rb +8 -2
  52. data/generated/google/apis/books_v1.rb +2 -2
  53. data/generated/google/apis/books_v1/classes.rb +79 -1
  54. data/generated/google/apis/books_v1/representations.rb +34 -0
  55. data/generated/google/apis/books_v1/service.rb +7 -3
  56. data/generated/google/apis/calendar_v3.rb +1 -1
  57. data/generated/google/apis/civicinfo_v2.rb +3 -2
  58. data/generated/google/apis/civicinfo_v2/classes.rb +377 -5
  59. data/generated/google/apis/civicinfo_v2/representations.rb +149 -0
  60. data/generated/google/apis/civicinfo_v2/service.rb +27 -6
  61. data/generated/google/apis/classroom_v1.rb +1 -1
  62. data/generated/google/apis/classroom_v1/classes.rb +183 -37
  63. data/generated/google/apis/classroom_v1/representations.rb +74 -9
  64. data/generated/google/apis/classroom_v1/service.rb +403 -38
  65. data/generated/google/apis/cloudbuild_v1.rb +1 -1
  66. data/generated/google/apis/cloudbuild_v1/classes.rb +381 -17
  67. data/generated/google/apis/cloudbuild_v1/representations.rb +137 -2
  68. data/generated/google/apis/cloudbuild_v1/service.rb +174 -1
  69. data/generated/google/apis/clouddebugger_v2.rb +3 -6
  70. data/generated/google/apis/clouddebugger_v2/service.rb +4 -4
  71. data/generated/google/apis/cloudmonitoring_v2beta2.rb +1 -1
  72. data/generated/google/apis/cloudresourcemanager_v1.rb +1 -1
  73. data/generated/google/apis/cloudresourcemanager_v1/classes.rb +502 -111
  74. data/generated/google/apis/cloudresourcemanager_v1/representations.rb +162 -24
  75. data/generated/google/apis/cloudresourcemanager_v1/service.rb +274 -30
  76. data/generated/google/apis/cloudresourcemanager_v1beta1.rb +1 -1
  77. data/generated/google/apis/cloudresourcemanager_v1beta1/classes.rb +121 -9
  78. data/generated/google/apis/cloudresourcemanager_v1beta1/representations.rb +46 -0
  79. data/generated/google/apis/cloudresourcemanager_v1beta1/service.rb +71 -58
  80. data/generated/google/apis/compute_beta.rb +1 -1
  81. data/generated/google/apis/compute_beta/classes.rb +2299 -434
  82. data/generated/google/apis/compute_beta/representations.rb +752 -33
  83. data/generated/google/apis/compute_beta/service.rb +6067 -3153
  84. data/generated/google/apis/compute_v1.rb +1 -1
  85. data/generated/google/apis/compute_v1/classes.rb +1681 -207
  86. data/generated/google/apis/compute_v1/representations.rb +552 -0
  87. data/generated/google/apis/compute_v1/service.rb +2797 -1171
  88. data/generated/google/apis/content_v2.rb +1 -1
  89. data/generated/google/apis/content_v2/classes.rb +757 -1
  90. data/generated/google/apis/content_v2/representations.rb +337 -0
  91. data/generated/google/apis/content_v2/service.rb +244 -0
  92. data/generated/google/apis/dataflow_v1b3.rb +38 -0
  93. data/generated/google/apis/dataflow_v1b3/classes.rb +4053 -0
  94. data/generated/google/apis/dataflow_v1b3/representations.rb +1736 -0
  95. data/generated/google/apis/dataflow_v1b3/service.rb +875 -0
  96. data/generated/google/apis/dataproc_v1.rb +2 -2
  97. data/generated/google/apis/dataproc_v1/classes.rb +213 -68
  98. data/generated/google/apis/dataproc_v1/representations.rb +38 -0
  99. data/generated/google/apis/dataproc_v1/service.rb +78 -48
  100. data/generated/google/apis/datastore_v1.rb +38 -0
  101. data/generated/google/apis/datastore_v1/classes.rb +1284 -0
  102. data/generated/google/apis/datastore_v1/representations.rb +572 -0
  103. data/generated/google/apis/datastore_v1/service.rb +259 -0
  104. data/generated/google/apis/datastore_v1beta3.rb +38 -0
  105. data/generated/google/apis/datastore_v1beta3/classes.rb +1284 -0
  106. data/generated/google/apis/datastore_v1beta3/representations.rb +572 -0
  107. data/generated/google/apis/datastore_v1beta3/service.rb +259 -0
  108. data/generated/google/apis/deploymentmanager_v2.rb +1 -1
  109. data/generated/google/apis/deploymentmanager_v2/classes.rb +384 -2
  110. data/generated/google/apis/deploymentmanager_v2/representations.rb +161 -0
  111. data/generated/google/apis/deploymentmanager_v2/service.rb +217 -55
  112. data/generated/google/apis/dfareporting_v2_5.rb +40 -0
  113. data/generated/google/apis/dfareporting_v2_5/classes.rb +11225 -0
  114. data/generated/google/apis/dfareporting_v2_5/representations.rb +3982 -0
  115. data/generated/google/apis/dfareporting_v2_5/service.rb +8755 -0
  116. data/generated/google/apis/dfareporting_v2_6.rb +40 -0
  117. data/generated/google/apis/dfareporting_v2_6/classes.rb +11586 -0
  118. data/generated/google/apis/dfareporting_v2_6/representations.rb +4119 -0
  119. data/generated/google/apis/dfareporting_v2_6/service.rb +9025 -0
  120. data/generated/google/apis/dns_v1.rb +1 -1
  121. data/generated/google/apis/dns_v1/classes.rb +1 -1
  122. data/generated/google/apis/doubleclickbidmanager_v1.rb +1 -1
  123. data/generated/google/apis/doubleclickbidmanager_v1/classes.rb +79 -86
  124. data/generated/google/apis/doubleclickbidmanager_v1/representations.rb +25 -28
  125. data/generated/google/apis/doubleclickbidmanager_v1/service.rb +10 -8
  126. data/generated/google/apis/doubleclicksearch_v2.rb +1 -1
  127. data/generated/google/apis/drive_v2.rb +1 -1
  128. data/generated/google/apis/drive_v2/classes.rb +27 -3
  129. data/generated/google/apis/drive_v2/representations.rb +4 -0
  130. data/generated/google/apis/drive_v2/service.rb +16 -3
  131. data/generated/google/apis/drive_v3.rb +1 -1
  132. data/generated/google/apis/drive_v3/classes.rb +50 -16
  133. data/generated/google/apis/drive_v3/representations.rb +4 -0
  134. data/generated/google/apis/drive_v3/service.rb +12 -2
  135. data/generated/google/apis/fitness_v1.rb +8 -2
  136. data/generated/google/apis/fitness_v1/classes.rb +64 -6
  137. data/generated/google/apis/fitness_v1/representations.rb +20 -0
  138. data/generated/google/apis/fitness_v1/service.rb +17 -18
  139. data/generated/google/apis/fusiontables_v2.rb +1 -1
  140. data/generated/google/apis/fusiontables_v2/classes.rb +4 -3
  141. data/generated/google/apis/games_configuration_v1configuration.rb +1 -1
  142. data/generated/google/apis/games_management_v1management.rb +1 -1
  143. data/generated/google/apis/games_v1.rb +1 -1
  144. data/generated/google/apis/genomics_v1.rb +2 -4
  145. data/generated/google/apis/genomics_v1/classes.rb +143 -34
  146. data/generated/google/apis/genomics_v1/representations.rb +48 -11
  147. data/generated/google/apis/genomics_v1/service.rb +35 -37
  148. data/generated/google/apis/gmail_v1.rb +10 -1
  149. data/generated/google/apis/gmail_v1/classes.rb +542 -4
  150. data/generated/google/apis/gmail_v1/representations.rb +213 -0
  151. data/generated/google/apis/gmail_v1/service.rb +898 -1
  152. data/generated/google/apis/groupssettings_v1.rb +1 -1
  153. data/generated/google/apis/groupssettings_v1/classes.rb +12 -0
  154. data/generated/google/apis/groupssettings_v1/representations.rb +2 -0
  155. data/generated/google/apis/iam_v1.rb +2 -2
  156. data/generated/google/apis/iam_v1/classes.rb +181 -206
  157. data/generated/google/apis/iam_v1/representations.rb +36 -45
  158. data/generated/google/apis/iam_v1/service.rb +101 -67
  159. data/generated/google/apis/identitytoolkit_v3.rb +4 -1
  160. data/generated/google/apis/identitytoolkit_v3/classes.rb +171 -1
  161. data/generated/google/apis/identitytoolkit_v3/representations.rb +26 -0
  162. data/generated/google/apis/language_v1beta1.rb +36 -0
  163. data/generated/google/apis/language_v1beta1/classes.rb +599 -0
  164. data/generated/google/apis/language_v1beta1/representations.rb +289 -0
  165. data/generated/google/apis/language_v1beta1/service.rb +152 -0
  166. data/generated/google/apis/logging_v2beta1.rb +6 -6
  167. data/generated/google/apis/logging_v2beta1/classes.rb +760 -731
  168. data/generated/google/apis/logging_v2beta1/representations.rb +136 -147
  169. data/generated/google/apis/logging_v2beta1/service.rb +290 -209
  170. data/generated/google/apis/mirror_v1.rb +2 -2
  171. data/generated/google/apis/mirror_v1/service.rb +1 -1
  172. data/generated/google/apis/monitoring_v3.rb +45 -0
  173. data/generated/google/apis/monitoring_v3/classes.rb +1337 -0
  174. data/generated/google/apis/monitoring_v3/representations.rb +516 -0
  175. data/generated/google/apis/monitoring_v3/service.rb +711 -0
  176. data/generated/google/apis/oauth2_v2.rb +1 -1
  177. data/generated/google/apis/pagespeedonline_v2.rb +1 -1
  178. data/generated/google/apis/plus_domains_v1.rb +1 -1
  179. data/generated/google/apis/plus_v1.rb +1 -1
  180. data/generated/google/apis/pubsub_v1.rb +1 -1
  181. data/generated/google/apis/pubsub_v1/classes.rb +10 -9
  182. data/generated/google/apis/pubsub_v1/service.rb +128 -27
  183. data/generated/google/apis/qpx_express_v1.rb +1 -1
  184. data/generated/google/apis/qpx_express_v1/classes.rb +6 -0
  185. data/generated/google/apis/qpx_express_v1/representations.rb +1 -0
  186. data/generated/google/apis/replicapool_v1beta2.rb +1 -1
  187. data/generated/google/apis/replicapoolupdater_v1beta1.rb +4 -2
  188. data/generated/google/apis/replicapoolupdater_v1beta1/service.rb +3 -1
  189. data/generated/google/apis/script_v1.rb +1 -1
  190. data/generated/google/apis/script_v1/classes.rb +6 -0
  191. data/generated/google/apis/script_v1/representations.rb +1 -0
  192. data/generated/google/apis/sheets_v4.rb +1 -1
  193. data/generated/google/apis/sheets_v4/classes.rb +910 -89
  194. data/generated/google/apis/sheets_v4/representations.rb +194 -10
  195. data/generated/google/apis/sheets_v4/service.rb +216 -49
  196. data/generated/google/apis/slides_v1.rb +49 -0
  197. data/generated/google/apis/slides_v1/classes.rb +3926 -0
  198. data/generated/google/apis/slides_v1/representations.rb +1722 -0
  199. data/generated/google/apis/slides_v1/service.rb +202 -0
  200. data/generated/google/apis/speech_v1beta1.rb +34 -0
  201. data/generated/google/apis/speech_v1beta1/classes.rb +511 -0
  202. data/generated/google/apis/speech_v1beta1/representations.rb +218 -0
  203. data/generated/google/apis/speech_v1beta1/service.rb +271 -0
  204. data/generated/google/apis/sqladmin_v1beta4.rb +1 -1
  205. data/generated/google/apis/sqladmin_v1beta4/classes.rb +32 -8
  206. data/generated/google/apis/sqladmin_v1beta4/representations.rb +3 -0
  207. data/generated/google/apis/sqladmin_v1beta4/service.rb +42 -0
  208. data/generated/google/apis/storage_v1.rb +1 -1
  209. data/generated/google/apis/storage_v1/classes.rb +43 -18
  210. data/generated/google/apis/storage_v1/representations.rb +4 -1
  211. data/generated/google/apis/storage_v1/service.rb +5 -2
  212. data/generated/google/apis/translate_v2.rb +2 -2
  213. data/generated/google/apis/translate_v2/service.rb +1 -1
  214. data/generated/google/apis/vision_v1.rb +1 -1
  215. data/generated/google/apis/vision_v1/classes.rb +12 -11
  216. data/generated/google/apis/youtube_analytics_v1.rb +1 -1
  217. data/generated/google/apis/youtube_partner_v1.rb +1 -1
  218. data/generated/google/apis/youtube_partner_v1/classes.rb +6 -0
  219. data/generated/google/apis/youtube_partner_v1/representations.rb +2 -0
  220. data/generated/google/apis/youtube_partner_v1/service.rb +15 -3
  221. data/generated/google/apis/youtube_v3.rb +1 -1
  222. data/generated/google/apis/youtube_v3/classes.rb +183 -21
  223. data/generated/google/apis/youtube_v3/representations.rb +85 -4
  224. data/generated/google/apis/youtube_v3/service.rb +41 -5
  225. data/generated/google/apis/youtubereporting_v1.rb +1 -1
  226. data/google-api-client.gemspec +2 -1
  227. data/lib/google/apis/core/api_command.rb +4 -0
  228. data/lib/google/apis/core/base_service.rb +10 -4
  229. data/lib/google/apis/core/download.rb +7 -2
  230. data/lib/google/apis/core/http_command.rb +5 -1
  231. data/lib/google/apis/core/upload.rb +7 -1
  232. data/lib/google/apis/errors.rb +2 -2
  233. data/lib/google/apis/generator/annotator.rb +6 -0
  234. data/lib/google/apis/version.rb +1 -1
  235. data/samples/cli/lib/samples/bigquery.rb +101 -0
  236. data/samples/cli/lib/samples/sheets.rb +61 -0
  237. data/sync.rb +71 -0
  238. metadata +55 -13
@@ -0,0 +1,711 @@
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 MonitoringV3
23
+ # Stackdriver Monitoring API
24
+ #
25
+ # Manages your Stackdriver Monitoring data and configurations. Most projects
26
+ # must be associated with a Stackdriver account, with a few exceptions as noted
27
+ # on the individual method pages.
28
+ #
29
+ # @example
30
+ # require 'google/apis/monitoring_v3'
31
+ #
32
+ # Monitoring = Google::Apis::MonitoringV3 # Alias the module
33
+ # service = Monitoring::MonitoringService.new
34
+ #
35
+ # @see https://cloud.google.com/monitoring/api/
36
+ class MonitoringService < Google::Apis::Core::BaseService
37
+ # @return [String]
38
+ # API key. Your API key identifies your project and provides you with API access,
39
+ # quota, and reports. Required unless you provide an OAuth 2.0 token.
40
+ attr_accessor :key
41
+
42
+ # @return [String]
43
+ # Available to use for quota purposes for server-side applications. Can be any
44
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
45
+ attr_accessor :quota_user
46
+
47
+ def initialize
48
+ super('https://monitoring.googleapis.com/', '')
49
+ end
50
+
51
+ # Stackdriver Monitoring Agent only: Creates a new time series.<aside class="
52
+ # caution">This method is only for use by the Stackdriver Monitoring Agent. Use
53
+ # projects.timeSeries.create instead.</aside>
54
+ # @param [String] name
55
+ # The project in which to create the time series. The format is &quot;projects/
56
+ # PROJECT_ID_OR_NUMBER&quot;.
57
+ # @param [Google::Apis::MonitoringV3::CreateCollectdTimeSeriesRequest] create_collectd_time_series_request_object
58
+ # @param [String] quota_user
59
+ # Available to use for quota purposes for server-side applications. Can be any
60
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
61
+ # @param [String] fields
62
+ # Selector specifying which fields to include in a partial response.
63
+ # @param [Google::Apis::RequestOptions] options
64
+ # Request-specific options
65
+ #
66
+ # @yield [result, err] Result & error if block supplied
67
+ # @yieldparam result [Google::Apis::MonitoringV3::Empty] parsed result object
68
+ # @yieldparam err [StandardError] error object if request failed
69
+ #
70
+ # @return [Google::Apis::MonitoringV3::Empty]
71
+ #
72
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
73
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
74
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
75
+ def create_collectd_time_series(name, create_collectd_time_series_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
76
+ command = make_simple_command(:post, 'v3/{+name}/collectdTimeSeries', options)
77
+ command.request_representation = Google::Apis::MonitoringV3::CreateCollectdTimeSeriesRequest::Representation
78
+ command.request_object = create_collectd_time_series_request_object
79
+ command.response_representation = Google::Apis::MonitoringV3::Empty::Representation
80
+ command.response_class = Google::Apis::MonitoringV3::Empty
81
+ command.params['name'] = name unless name.nil?
82
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
83
+ command.query['fields'] = fields unless fields.nil?
84
+ execute_or_queue_command(command, &block)
85
+ end
86
+
87
+ # Updates an existing group. You can change any group attributes except name.
88
+ # @param [String] name
89
+ # Output only. The name of this group. The format is &quot;projects/`
90
+ # project_id_or_number`/groups/`group_id`&quot;. When creating a group, this
91
+ # field is ignored and a new name is created consisting of the project specified
92
+ # in the call to CreateGroup and a unique `group_id` that is generated
93
+ # automatically.
94
+ # @param [Google::Apis::MonitoringV3::Group] group_object
95
+ # @param [Boolean] validate_only
96
+ # If true, validate this request but do not update the existing group.
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 [String] fields
101
+ # Selector specifying which fields to include in a partial response.
102
+ # @param [Google::Apis::RequestOptions] options
103
+ # Request-specific options
104
+ #
105
+ # @yield [result, err] Result & error if block supplied
106
+ # @yieldparam result [Google::Apis::MonitoringV3::Group] parsed result object
107
+ # @yieldparam err [StandardError] error object if request failed
108
+ #
109
+ # @return [Google::Apis::MonitoringV3::Group]
110
+ #
111
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
112
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
113
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
114
+ def update_project_group(name, group_object = nil, validate_only: nil, quota_user: nil, fields: nil, options: nil, &block)
115
+ command = make_simple_command(:put, 'v3/{+name}', options)
116
+ command.request_representation = Google::Apis::MonitoringV3::Group::Representation
117
+ command.request_object = group_object
118
+ command.response_representation = Google::Apis::MonitoringV3::Group::Representation
119
+ command.response_class = Google::Apis::MonitoringV3::Group
120
+ command.params['name'] = name unless name.nil?
121
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
122
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
123
+ command.query['fields'] = fields unless fields.nil?
124
+ execute_or_queue_command(command, &block)
125
+ end
126
+
127
+ # Gets a single group.
128
+ # @param [String] name
129
+ # The group to retrieve. The format is &quot;projects/`project_id_or_number`/
130
+ # groups/`group_id`&quot;.
131
+ # @param [String] quota_user
132
+ # Available to use for quota purposes for server-side applications. Can be any
133
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
134
+ # @param [String] fields
135
+ # Selector specifying which fields to include in a partial response.
136
+ # @param [Google::Apis::RequestOptions] options
137
+ # Request-specific options
138
+ #
139
+ # @yield [result, err] Result & error if block supplied
140
+ # @yieldparam result [Google::Apis::MonitoringV3::Group] parsed result object
141
+ # @yieldparam err [StandardError] error object if request failed
142
+ #
143
+ # @return [Google::Apis::MonitoringV3::Group]
144
+ #
145
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
146
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
147
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
148
+ def get_project_group(name, quota_user: nil, fields: nil, options: nil, &block)
149
+ command = make_simple_command(:get, 'v3/{+name}', options)
150
+ command.response_representation = Google::Apis::MonitoringV3::Group::Representation
151
+ command.response_class = Google::Apis::MonitoringV3::Group
152
+ command.params['name'] = name unless name.nil?
153
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
154
+ command.query['fields'] = fields unless fields.nil?
155
+ execute_or_queue_command(command, &block)
156
+ end
157
+
158
+ # Creates a new group.
159
+ # @param [String] name
160
+ # The project in which to create the group. The format is &quot;projects/`
161
+ # project_id_or_number`&quot;.
162
+ # @param [Google::Apis::MonitoringV3::Group] group_object
163
+ # @param [Boolean] validate_only
164
+ # If true, validate this request but do not create the group.
165
+ # @param [String] quota_user
166
+ # Available to use for quota purposes for server-side applications. Can be any
167
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
168
+ # @param [String] fields
169
+ # Selector specifying which fields to include in a partial response.
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::MonitoringV3::Group] parsed result object
175
+ # @yieldparam err [StandardError] error object if request failed
176
+ #
177
+ # @return [Google::Apis::MonitoringV3::Group]
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_group(name, group_object = nil, validate_only: nil, quota_user: nil, fields: nil, options: nil, &block)
183
+ command = make_simple_command(:post, 'v3/{+name}/groups', options)
184
+ command.request_representation = Google::Apis::MonitoringV3::Group::Representation
185
+ command.request_object = group_object
186
+ command.response_representation = Google::Apis::MonitoringV3::Group::Representation
187
+ command.response_class = Google::Apis::MonitoringV3::Group
188
+ command.params['name'] = name unless name.nil?
189
+ command.query['validateOnly'] = validate_only unless validate_only.nil?
190
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
191
+ command.query['fields'] = fields unless fields.nil?
192
+ execute_or_queue_command(command, &block)
193
+ end
194
+
195
+ # Lists the existing groups.
196
+ # @param [String] name
197
+ # The project whose groups are to be listed. The format is &quot;projects/`
198
+ # project_id_or_number`&quot;.
199
+ # @param [String] descendants_of_group
200
+ # A group name: &quot;projects/`project_id_or_number`/groups/`group_id`&quot;.
201
+ # Returns the descendants of the specified group. This is a superset of the
202
+ # results returned by the childrenOfGroup filter, and includes children-of-
203
+ # children, and so forth.
204
+ # @param [Fixnum] page_size
205
+ # A positive number that is the maximum number of results to return.
206
+ # @param [String] children_of_group
207
+ # A group name: &quot;projects/`project_id_or_number`/groups/`group_id`&quot;.
208
+ # Returns groups whose parentName field contains the group name. If no groups
209
+ # have this parent, the results are empty.
210
+ # @param [String] ancestors_of_group
211
+ # A group name: &quot;projects/`project_id_or_number`/groups/`group_id`&quot;.
212
+ # Returns groups that are ancestors of the specified group. The groups are
213
+ # returned in order, starting with the immediate parent and ending with the most
214
+ # distant ancestor. If the specified group has no immediate parent, the results
215
+ # are empty.
216
+ # @param [String] page_token
217
+ # If this field is not empty then it must contain the nextPageToken value
218
+ # returned by a previous call to this method. Using this field causes the method
219
+ # to return additional results from the previous method call.
220
+ # @param [String] quota_user
221
+ # Available to use for quota purposes for server-side applications. Can be any
222
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
223
+ # @param [String] fields
224
+ # Selector specifying which fields to include in a partial response.
225
+ # @param [Google::Apis::RequestOptions] options
226
+ # Request-specific options
227
+ #
228
+ # @yield [result, err] Result & error if block supplied
229
+ # @yieldparam result [Google::Apis::MonitoringV3::ListGroupsResponse] parsed result object
230
+ # @yieldparam err [StandardError] error object if request failed
231
+ #
232
+ # @return [Google::Apis::MonitoringV3::ListGroupsResponse]
233
+ #
234
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
235
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
236
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
237
+ def list_project_groups(name, descendants_of_group: nil, page_size: nil, children_of_group: nil, ancestors_of_group: nil, page_token: nil, quota_user: nil, fields: nil, options: nil, &block)
238
+ command = make_simple_command(:get, 'v3/{+name}/groups', options)
239
+ command.response_representation = Google::Apis::MonitoringV3::ListGroupsResponse::Representation
240
+ command.response_class = Google::Apis::MonitoringV3::ListGroupsResponse
241
+ command.params['name'] = name unless name.nil?
242
+ command.query['descendantsOfGroup'] = descendants_of_group unless descendants_of_group.nil?
243
+ command.query['pageSize'] = page_size unless page_size.nil?
244
+ command.query['childrenOfGroup'] = children_of_group unless children_of_group.nil?
245
+ command.query['ancestorsOfGroup'] = ancestors_of_group unless ancestors_of_group.nil?
246
+ command.query['pageToken'] = page_token unless page_token.nil?
247
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
248
+ command.query['fields'] = fields unless fields.nil?
249
+ execute_or_queue_command(command, &block)
250
+ end
251
+
252
+ # Deletes an existing group.
253
+ # @param [String] name
254
+ # The group to delete. The format is &quot;projects/`project_id_or_number`/
255
+ # groups/`group_id`&quot;.
256
+ # @param [String] quota_user
257
+ # Available to use for quota purposes for server-side applications. Can be any
258
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
259
+ # @param [String] fields
260
+ # Selector specifying which fields to include in a partial response.
261
+ # @param [Google::Apis::RequestOptions] options
262
+ # Request-specific options
263
+ #
264
+ # @yield [result, err] Result & error if block supplied
265
+ # @yieldparam result [Google::Apis::MonitoringV3::Empty] parsed result object
266
+ # @yieldparam err [StandardError] error object if request failed
267
+ #
268
+ # @return [Google::Apis::MonitoringV3::Empty]
269
+ #
270
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
271
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
272
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
273
+ def delete_project_group(name, quota_user: nil, fields: nil, options: nil, &block)
274
+ command = make_simple_command(:delete, 'v3/{+name}', options)
275
+ command.response_representation = Google::Apis::MonitoringV3::Empty::Representation
276
+ command.response_class = Google::Apis::MonitoringV3::Empty
277
+ command.params['name'] = name unless name.nil?
278
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
279
+ command.query['fields'] = fields unless fields.nil?
280
+ execute_or_queue_command(command, &block)
281
+ end
282
+
283
+ # Lists the monitored resources that are members of a group.
284
+ # @param [String] name
285
+ # The group whose members are listed. The format is &quot;projects/`
286
+ # project_id_or_number`/groups/`group_id`&quot;.
287
+ # @param [String] filter
288
+ # An optional list filter (/monitoring/api/learn_more#filtering) describing the
289
+ # members to be returned. The filter may reference the type, labels, and
290
+ # metadata of monitored resources that comprise the group. For example, to
291
+ # return only resources representing Compute Engine VM instances, use this
292
+ # filter:
293
+ # resource.type = &quot;gce_instance&quot;
294
+ # @param [String] interval_end_time
295
+ # Required. The end of the time interval.
296
+ # @param [String] interval_start_time
297
+ # Optional. The beginning of the time interval. The default value for the start
298
+ # time is the end time. The start time must not be later than the end time.
299
+ # @param [Fixnum] page_size
300
+ # A positive number that is the maximum number of results to return.
301
+ # @param [String] page_token
302
+ # If this field is not empty then it must contain the nextPageToken value
303
+ # returned by a previous call to this method. Using this field causes the method
304
+ # to return additional results from the previous method call.
305
+ # @param [String] quota_user
306
+ # Available to use for quota purposes for server-side applications. Can be any
307
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
308
+ # @param [String] fields
309
+ # Selector specifying which fields to include in a partial response.
310
+ # @param [Google::Apis::RequestOptions] options
311
+ # Request-specific options
312
+ #
313
+ # @yield [result, err] Result & error if block supplied
314
+ # @yieldparam result [Google::Apis::MonitoringV3::ListGroupMembersResponse] parsed result object
315
+ # @yieldparam err [StandardError] error object if request failed
316
+ #
317
+ # @return [Google::Apis::MonitoringV3::ListGroupMembersResponse]
318
+ #
319
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
320
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
321
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
322
+ def list_project_group_members(name, filter: nil, interval_end_time: nil, interval_start_time: nil, page_size: nil, page_token: nil, quota_user: nil, fields: nil, options: nil, &block)
323
+ command = make_simple_command(:get, 'v3/{+name}/members', options)
324
+ command.response_representation = Google::Apis::MonitoringV3::ListGroupMembersResponse::Representation
325
+ command.response_class = Google::Apis::MonitoringV3::ListGroupMembersResponse
326
+ command.params['name'] = name unless name.nil?
327
+ command.query['filter'] = filter unless filter.nil?
328
+ command.query['interval.endTime'] = interval_end_time unless interval_end_time.nil?
329
+ command.query['interval.startTime'] = interval_start_time unless interval_start_time.nil?
330
+ command.query['pageSize'] = page_size unless page_size.nil?
331
+ command.query['pageToken'] = page_token unless page_token.nil?
332
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
333
+ command.query['fields'] = fields unless fields.nil?
334
+ execute_or_queue_command(command, &block)
335
+ end
336
+
337
+ # Gets a single metric descriptor. This method does not require a Stackdriver
338
+ # account.
339
+ # @param [String] name
340
+ # The metric descriptor on which to execute the request. The format is &quot;
341
+ # projects/`project_id_or_number`/metricDescriptors/`metric_id`&quot;. An
342
+ # example value of `metric_id` is &quot;compute.googleapis.com/instance/disk/
343
+ # read_bytes_count&quot;.
344
+ # @param [String] quota_user
345
+ # Available to use for quota purposes for server-side applications. Can be any
346
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
347
+ # @param [String] fields
348
+ # Selector specifying which fields to include in a partial response.
349
+ # @param [Google::Apis::RequestOptions] options
350
+ # Request-specific options
351
+ #
352
+ # @yield [result, err] Result & error if block supplied
353
+ # @yieldparam result [Google::Apis::MonitoringV3::MetricDescriptor] parsed result object
354
+ # @yieldparam err [StandardError] error object if request failed
355
+ #
356
+ # @return [Google::Apis::MonitoringV3::MetricDescriptor]
357
+ #
358
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
359
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
360
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
361
+ def get_project_metric_descriptor(name, quota_user: nil, fields: nil, options: nil, &block)
362
+ command = make_simple_command(:get, 'v3/{+name}', options)
363
+ command.response_representation = Google::Apis::MonitoringV3::MetricDescriptor::Representation
364
+ command.response_class = Google::Apis::MonitoringV3::MetricDescriptor
365
+ command.params['name'] = name unless name.nil?
366
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
367
+ command.query['fields'] = fields unless fields.nil?
368
+ execute_or_queue_command(command, &block)
369
+ end
370
+
371
+ # Creates a new metric descriptor. User-created metric descriptors define custom
372
+ # metrics (/monitoring/custom-metrics).
373
+ # @param [String] name
374
+ # The project on which to execute the request. The format is &quot;projects/`
375
+ # project_id_or_number`&quot;.
376
+ # @param [Google::Apis::MonitoringV3::MetricDescriptor] metric_descriptor_object
377
+ # @param [String] quota_user
378
+ # Available to use for quota purposes for server-side applications. Can be any
379
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
380
+ # @param [String] fields
381
+ # Selector specifying which fields to include in a partial response.
382
+ # @param [Google::Apis::RequestOptions] options
383
+ # Request-specific options
384
+ #
385
+ # @yield [result, err] Result & error if block supplied
386
+ # @yieldparam result [Google::Apis::MonitoringV3::MetricDescriptor] parsed result object
387
+ # @yieldparam err [StandardError] error object if request failed
388
+ #
389
+ # @return [Google::Apis::MonitoringV3::MetricDescriptor]
390
+ #
391
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
392
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
393
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
394
+ def create_project_metric_descriptor(name, metric_descriptor_object = nil, quota_user: nil, fields: nil, options: nil, &block)
395
+ command = make_simple_command(:post, 'v3/{+name}/metricDescriptors', options)
396
+ command.request_representation = Google::Apis::MonitoringV3::MetricDescriptor::Representation
397
+ command.request_object = metric_descriptor_object
398
+ command.response_representation = Google::Apis::MonitoringV3::MetricDescriptor::Representation
399
+ command.response_class = Google::Apis::MonitoringV3::MetricDescriptor
400
+ command.params['name'] = name unless name.nil?
401
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
402
+ command.query['fields'] = fields unless fields.nil?
403
+ execute_or_queue_command(command, &block)
404
+ end
405
+
406
+ # Lists metric descriptors that match a filter. This method does not require a
407
+ # Stackdriver account.
408
+ # @param [String] name
409
+ # The project on which to execute the request. The format is &quot;projects/`
410
+ # project_id_or_number`&quot;.
411
+ # @param [Fixnum] page_size
412
+ # A positive number that is the maximum number of results to return.
413
+ # @param [String] filter
414
+ # If this field is empty, all custom and system-defined metric descriptors are
415
+ # returned. Otherwise, the filter (/monitoring/api/v3/filters) specifies which
416
+ # metric descriptors are to be returned. For example, the following filter
417
+ # matches all custom metrics (/monitoring/custom-metrics):
418
+ # metric.type = starts_with(&quot;custom.googleapis.com/&quot;)
419
+ # @param [String] page_token
420
+ # If this field is not empty then it must contain the nextPageToken value
421
+ # returned by a previous call to this method. Using this field causes the method
422
+ # to return additional results from the previous method call.
423
+ # @param [String] quota_user
424
+ # Available to use for quota purposes for server-side applications. Can be any
425
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
426
+ # @param [String] fields
427
+ # Selector specifying which fields to include in a partial response.
428
+ # @param [Google::Apis::RequestOptions] options
429
+ # Request-specific options
430
+ #
431
+ # @yield [result, err] Result & error if block supplied
432
+ # @yieldparam result [Google::Apis::MonitoringV3::ListMetricDescriptorsResponse] parsed result object
433
+ # @yieldparam err [StandardError] error object if request failed
434
+ #
435
+ # @return [Google::Apis::MonitoringV3::ListMetricDescriptorsResponse]
436
+ #
437
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
438
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
439
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
440
+ def list_project_metric_descriptors(name, page_size: nil, filter: nil, page_token: nil, quota_user: nil, fields: nil, options: nil, &block)
441
+ command = make_simple_command(:get, 'v3/{+name}/metricDescriptors', options)
442
+ command.response_representation = Google::Apis::MonitoringV3::ListMetricDescriptorsResponse::Representation
443
+ command.response_class = Google::Apis::MonitoringV3::ListMetricDescriptorsResponse
444
+ command.params['name'] = name unless name.nil?
445
+ command.query['pageSize'] = page_size unless page_size.nil?
446
+ command.query['filter'] = filter unless filter.nil?
447
+ command.query['pageToken'] = page_token unless page_token.nil?
448
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
449
+ command.query['fields'] = fields unless fields.nil?
450
+ execute_or_queue_command(command, &block)
451
+ end
452
+
453
+ # Deletes a metric descriptor. Only user-created custom metrics (/monitoring/
454
+ # custom-metrics) can be deleted.
455
+ # @param [String] name
456
+ # The metric descriptor on which to execute the request. The format is &quot;
457
+ # projects/`project_id_or_number`/metricDescriptors/`metric_id`&quot;. An
458
+ # example of `metric_id` is: &quot;custom.googleapis.com/my_test_metric&quot;.
459
+ # @param [String] quota_user
460
+ # Available to use for quota purposes for server-side applications. Can be any
461
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
462
+ # @param [String] fields
463
+ # Selector specifying which fields to include in a partial response.
464
+ # @param [Google::Apis::RequestOptions] options
465
+ # Request-specific options
466
+ #
467
+ # @yield [result, err] Result & error if block supplied
468
+ # @yieldparam result [Google::Apis::MonitoringV3::Empty] parsed result object
469
+ # @yieldparam err [StandardError] error object if request failed
470
+ #
471
+ # @return [Google::Apis::MonitoringV3::Empty]
472
+ #
473
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
474
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
475
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
476
+ def delete_project_metric_descriptor(name, quota_user: nil, fields: nil, options: nil, &block)
477
+ command = make_simple_command(:delete, 'v3/{+name}', options)
478
+ command.response_representation = Google::Apis::MonitoringV3::Empty::Representation
479
+ command.response_class = Google::Apis::MonitoringV3::Empty
480
+ command.params['name'] = name unless name.nil?
481
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
482
+ command.query['fields'] = fields unless fields.nil?
483
+ execute_or_queue_command(command, &block)
484
+ end
485
+
486
+ # Creates or adds data to one or more time series. The response is empty if all
487
+ # time series in the request were written. If any time series could not be
488
+ # written, a corresponding failure message is included in the error response.
489
+ # @param [String] name
490
+ # The project on which to execute the request. The format is &quot;projects/`
491
+ # project_id_or_number`&quot;.
492
+ # @param [Google::Apis::MonitoringV3::CreateTimeSeriesRequest] create_time_series_request_object
493
+ # @param [String] quota_user
494
+ # Available to use for quota purposes for server-side applications. Can be any
495
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
496
+ # @param [String] fields
497
+ # Selector specifying which fields to include in a partial response.
498
+ # @param [Google::Apis::RequestOptions] options
499
+ # Request-specific options
500
+ #
501
+ # @yield [result, err] Result & error if block supplied
502
+ # @yieldparam result [Google::Apis::MonitoringV3::Empty] parsed result object
503
+ # @yieldparam err [StandardError] error object if request failed
504
+ #
505
+ # @return [Google::Apis::MonitoringV3::Empty]
506
+ #
507
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
508
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
509
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
510
+ def create_time_series(name, create_time_series_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
511
+ command = make_simple_command(:post, 'v3/{+name}/timeSeries', options)
512
+ command.request_representation = Google::Apis::MonitoringV3::CreateTimeSeriesRequest::Representation
513
+ command.request_object = create_time_series_request_object
514
+ command.response_representation = Google::Apis::MonitoringV3::Empty::Representation
515
+ command.response_class = Google::Apis::MonitoringV3::Empty
516
+ command.params['name'] = name unless name.nil?
517
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
518
+ command.query['fields'] = fields unless fields.nil?
519
+ execute_or_queue_command(command, &block)
520
+ end
521
+
522
+ # Lists time series that match a filter. This method does not require a
523
+ # Stackdriver account.
524
+ # @param [String] name
525
+ # The project on which to execute the request. The format is "projects/`
526
+ # project_id_or_number`".
527
+ # @param [String] filter
528
+ # A monitoring filter (/monitoring/api/v3/filters) that specifies which time
529
+ # series should be returned. The filter must specify a single metric type, and
530
+ # can additionally specify metric labels and other information. For example:
531
+ # metric.type = &quot;compute.googleapis.com/instance/cpu/usage_time&quot; AND
532
+ # metric.label.instance_name = &quot;my-instance-name&quot;
533
+ # @param [Array<String>, String] aggregation_group_by_fields
534
+ # The set of fields to preserve when crossSeriesReducer is specified. The
535
+ # groupByFields determine how the time series are partitioned into subsets prior
536
+ # to applying the aggregation function. Each subset contains time series that
537
+ # have the same value for each of the grouping fields. Each individual time
538
+ # series is a member of exactly one subset. The crossSeriesReducer is applied to
539
+ # each subset of time series. Fields not specified in groupByFields are
540
+ # aggregated away. If groupByFields is not specified, the time series are
541
+ # aggregated into a single output time series. If crossSeriesReducer is not
542
+ # defined, this field is ignored.
543
+ # @param [String] aggregation_cross_series_reducer
544
+ # The approach to be used to combine time series. Not all reducer functions may
545
+ # be applied to all time series, depending on the metric type and the value type
546
+ # of the original time series. Reduction may change the metric type of value
547
+ # type of the time series.Time series data must be aligned in order to perform
548
+ # cross-time series reduction. If crossSeriesReducer is specified, then
549
+ # perSeriesAligner must be specified and not equal ALIGN_NONE and
550
+ # alignmentPeriod must be specified; otherwise, an error is returned.
551
+ # @param [String] interval_end_time
552
+ # Required. The end of the time interval.
553
+ # @param [String] interval_start_time
554
+ # Optional. The beginning of the time interval. The default value for the start
555
+ # time is the end time. The start time must not be later than the end time.
556
+ # @param [Fixnum] page_size
557
+ # A positive number that is the maximum number of results to return. When view
558
+ # field sets to FULL, it limits the number of Points server will return; if view
559
+ # field is HEADERS, it limits the number of TimeSeries server will return.
560
+ # @param [String] view
561
+ # Specifies which information is returned about the time series.
562
+ # @param [String] aggregation_alignment_period
563
+ # The alignment period for per-time series alignment. If present,
564
+ # alignmentPeriod must be at least 60 seconds. After per-time series alignment,
565
+ # each time series will contain data points only on the period boundaries. If
566
+ # perSeriesAligner is not specified or equals ALIGN_NONE, then this field is
567
+ # ignored. If perSeriesAligner is specified and does not equal ALIGN_NONE, then
568
+ # this field must be defined; otherwise an error is returned.
569
+ # @param [String] aggregation_per_series_aligner
570
+ # The approach to be used to align individual time series. Not all alignment
571
+ # functions may be applied to all time series, depending on the metric type and
572
+ # value type of the original time series. Alignment may change the metric type
573
+ # or the value type of the time series.Time series data must be aligned in order
574
+ # to perform cross-time series reduction. If crossSeriesReducer is specified,
575
+ # then perSeriesAligner must be specified and not equal ALIGN_NONE and
576
+ # alignmentPeriod must be specified; otherwise, an error is returned.
577
+ # @param [String] order_by
578
+ # Specifies the order in which the points of the time series should be returned.
579
+ # By default, results are not ordered. Currently, this field must be left blank.
580
+ # @param [String] page_token
581
+ # If this field is not empty then it must contain the nextPageToken value
582
+ # returned by a previous call to this method. Using this field causes the method
583
+ # to return additional results from the previous method call.
584
+ # @param [String] quota_user
585
+ # Available to use for quota purposes for server-side applications. Can be any
586
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
587
+ # @param [String] fields
588
+ # Selector specifying which fields to include in a partial response.
589
+ # @param [Google::Apis::RequestOptions] options
590
+ # Request-specific options
591
+ #
592
+ # @yield [result, err] Result & error if block supplied
593
+ # @yieldparam result [Google::Apis::MonitoringV3::ListTimeSeriesResponse] parsed result object
594
+ # @yieldparam err [StandardError] error object if request failed
595
+ #
596
+ # @return [Google::Apis::MonitoringV3::ListTimeSeriesResponse]
597
+ #
598
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
599
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
600
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
601
+ def list_project_time_series(name, filter: nil, aggregation_group_by_fields: nil, aggregation_cross_series_reducer: nil, interval_end_time: nil, interval_start_time: nil, page_size: nil, view: nil, aggregation_alignment_period: nil, aggregation_per_series_aligner: nil, order_by: nil, page_token: nil, quota_user: nil, fields: nil, options: nil, &block)
602
+ command = make_simple_command(:get, 'v3/{+name}/timeSeries', options)
603
+ command.response_representation = Google::Apis::MonitoringV3::ListTimeSeriesResponse::Representation
604
+ command.response_class = Google::Apis::MonitoringV3::ListTimeSeriesResponse
605
+ command.params['name'] = name unless name.nil?
606
+ command.query['filter'] = filter unless filter.nil?
607
+ command.query['aggregation.groupByFields'] = aggregation_group_by_fields unless aggregation_group_by_fields.nil?
608
+ command.query['aggregation.crossSeriesReducer'] = aggregation_cross_series_reducer unless aggregation_cross_series_reducer.nil?
609
+ command.query['interval.endTime'] = interval_end_time unless interval_end_time.nil?
610
+ command.query['interval.startTime'] = interval_start_time unless interval_start_time.nil?
611
+ command.query['pageSize'] = page_size unless page_size.nil?
612
+ command.query['view'] = view unless view.nil?
613
+ command.query['aggregation.alignmentPeriod'] = aggregation_alignment_period unless aggregation_alignment_period.nil?
614
+ command.query['aggregation.perSeriesAligner'] = aggregation_per_series_aligner unless aggregation_per_series_aligner.nil?
615
+ command.query['orderBy'] = order_by unless order_by.nil?
616
+ command.query['pageToken'] = page_token unless page_token.nil?
617
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
618
+ command.query['fields'] = fields unless fields.nil?
619
+ execute_or_queue_command(command, &block)
620
+ end
621
+
622
+ # Gets a single monitored resource descriptor. This method does not require a
623
+ # Stackdriver account.
624
+ # @param [String] name
625
+ # The monitored resource descriptor to get. The format is &quot;projects/`
626
+ # project_id_or_number`/monitoredResourceDescriptors/`resource_type`&quot;. The `
627
+ # resource_type` is a predefined type, such as cloudsql_database.
628
+ # @param [String] quota_user
629
+ # Available to use for quota purposes for server-side applications. Can be any
630
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
631
+ # @param [String] fields
632
+ # Selector specifying which fields to include in a partial response.
633
+ # @param [Google::Apis::RequestOptions] options
634
+ # Request-specific options
635
+ #
636
+ # @yield [result, err] Result & error if block supplied
637
+ # @yieldparam result [Google::Apis::MonitoringV3::MonitoredResourceDescriptor] parsed result object
638
+ # @yieldparam err [StandardError] error object if request failed
639
+ #
640
+ # @return [Google::Apis::MonitoringV3::MonitoredResourceDescriptor]
641
+ #
642
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
643
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
644
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
645
+ def get_project_monitored_resource_descriptor(name, quota_user: nil, fields: nil, options: nil, &block)
646
+ command = make_simple_command(:get, 'v3/{+name}', options)
647
+ command.response_representation = Google::Apis::MonitoringV3::MonitoredResourceDescriptor::Representation
648
+ command.response_class = Google::Apis::MonitoringV3::MonitoredResourceDescriptor
649
+ command.params['name'] = name unless name.nil?
650
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
651
+ command.query['fields'] = fields unless fields.nil?
652
+ execute_or_queue_command(command, &block)
653
+ end
654
+
655
+ # Lists monitored resource descriptors that match a filter. This method does not
656
+ # require a Stackdriver account.
657
+ # @param [String] name
658
+ # The project on which to execute the request. The format is &quot;projects/`
659
+ # project_id_or_number`&quot;.
660
+ # @param [Fixnum] page_size
661
+ # A positive number that is the maximum number of results to return.
662
+ # @param [String] filter
663
+ # An optional filter (/monitoring/api/v3/filters) describing the descriptors to
664
+ # be returned. The filter can reference the descriptor's type and labels. For
665
+ # example, the following filter returns only Google Compute Engine descriptors
666
+ # that have an id label:
667
+ # resource.type = starts_with(&quot;gce_&quot;) AND resource.label:id
668
+ # @param [String] page_token
669
+ # If this field is not empty then it must contain the nextPageToken value
670
+ # returned by a previous call to this method. Using this field causes the method
671
+ # to return additional results from the previous method call.
672
+ # @param [String] quota_user
673
+ # Available to use for quota purposes for server-side applications. Can be any
674
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
675
+ # @param [String] fields
676
+ # Selector specifying which fields to include in a partial response.
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::MonitoringV3::ListMonitoredResourceDescriptorsResponse] parsed result object
682
+ # @yieldparam err [StandardError] error object if request failed
683
+ #
684
+ # @return [Google::Apis::MonitoringV3::ListMonitoredResourceDescriptorsResponse]
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_project_monitored_resource_descriptors(name, page_size: nil, filter: nil, page_token: nil, quota_user: nil, fields: nil, options: nil, &block)
690
+ command = make_simple_command(:get, 'v3/{+name}/monitoredResourceDescriptors', options)
691
+ command.response_representation = Google::Apis::MonitoringV3::ListMonitoredResourceDescriptorsResponse::Representation
692
+ command.response_class = Google::Apis::MonitoringV3::ListMonitoredResourceDescriptorsResponse
693
+ command.params['name'] = name unless name.nil?
694
+ command.query['pageSize'] = page_size unless page_size.nil?
695
+ command.query['filter'] = filter unless filter.nil?
696
+ command.query['pageToken'] = page_token unless page_token.nil?
697
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
698
+ command.query['fields'] = fields unless fields.nil?
699
+ execute_or_queue_command(command, &block)
700
+ end
701
+
702
+ protected
703
+
704
+ def apply_command_defaults(command)
705
+ command.query['key'] = key unless key.nil?
706
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
707
+ end
708
+ end
709
+ end
710
+ end
711
+ end