google-api-client 0.9.25 → 0.9.26

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