google-api-client 0.9.25 → 0.9.26

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 (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