google-apis-observability_v1 0.1.0 → 0.13.0

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.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: b75c1d3351583bf292342505ad47623b6aa94f414add84b4cac0dc667646bc1a
4
- data.tar.gz: 00dae5b0bc5d87afc72a39dbb05fa9177d796ac708393ecd5a9870aad32cf233
3
+ metadata.gz: a5d95a5e804ce67cc2df299a143981bc6ab35e6f60230c3b3924b4d95ccaac58
4
+ data.tar.gz: 31142323380f8cda1cc11fd713f02ed27c8c1077f90607daf1db39b9bb9d6b31
5
5
  SHA512:
6
- metadata.gz: c56c0022e01e3719cce7530258783c34faf8adc28509b7c94af7e4884dfd914959cfa7e0511cdf4265f806bddaa662c46788ed03eefd1f012580854ab3fe770b
7
- data.tar.gz: 2f97ba266456085124f545188fc3d3d7c1b839ee5e40c8e43dfa65f074209740ef02e20ca70b1f40c3c3c233798e8fd96b7416a8cc52c5d790b1499ff0e11ff9
6
+ metadata.gz: 126069c6ea9967569d0a5ba9f82225430c8d3722025976b3c6abbb5b2d3ad9d72ba93f78a76bd557ebe3bfaf628e3938492e193b4a4725abe92726514b748636
7
+ data.tar.gz: 25d94a3167eaca655d0d943e618faf8371c58c04ba598abaa912509242de9ac5b300886d48dced3050848859ecfe9ba67ba149aa8ed8c1d2135b83544bc846bd
data/CHANGELOG.md CHANGED
@@ -1,5 +1,54 @@
1
1
  # Release history for google-apis-observability_v1
2
2
 
3
+ ### v0.13.0 (2026-02-01)
4
+
5
+ * Regenerated from discovery document revision 20260122
6
+
7
+ ### v0.12.0 (2025-12-21)
8
+
9
+ * Regenerated from discovery document revision 20251211
10
+
11
+ ### v0.11.0 (2025-12-14)
12
+
13
+ * Regenerated from discovery document revision 20251204
14
+
15
+ ### v0.10.0 (2025-11-23)
16
+
17
+ * Regenerated from discovery document revision 20251113
18
+
19
+ ### v0.9.0 (2025-11-02)
20
+
21
+ * Regenerated from discovery document revision 20251023
22
+
23
+ ### v0.8.0 (2025-10-05)
24
+
25
+ * Regenerated from discovery document revision 20250925
26
+
27
+ ### v0.7.0 (2025-09-14)
28
+
29
+ * Regenerated from discovery document revision 20250904
30
+
31
+ ### v0.6.0 (2025-08-31)
32
+
33
+ * Regenerated from discovery document revision 20250822
34
+
35
+ ### v0.5.0 (2025-08-24)
36
+
37
+ * Regenerated from discovery document revision 20250814
38
+ * Regenerated using generator version 0.18.0
39
+
40
+ ### v0.4.0 (2025-05-04)
41
+
42
+ * Regenerated using generator version 0.17.0
43
+
44
+ ### v0.3.0 (2025-04-27)
45
+
46
+ * Regenerated from discovery document revision 20250417
47
+
48
+ ### v0.2.0 (2025-03-30)
49
+
50
+ * Regenerated from discovery document revision 20250320
51
+
3
52
  ### v0.1.0 (2025-03-23)
4
53
 
5
54
  * Regenerated from discovery document revision 20250313
data/OVERVIEW.md CHANGED
@@ -79,11 +79,11 @@ Gem names for modern clients are often of the form `google-cloud-<service_name>`
79
79
 
80
80
  **For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure.
81
81
 
82
- The [product documentation]() may provide guidance regarding the preferred client library to use.
82
+ The [product documentation](https://cloud.google.com/stackdriver/docs/) may provide guidance regarding the preferred client library to use.
83
83
 
84
84
  ## Supported Ruby versions
85
85
 
86
- This library is supported on Ruby 2.7+.
86
+ This library is supported on Ruby 3.1+.
87
87
 
88
88
  Google provides official support for Ruby versions that are actively supported by Ruby Core -- that is, Ruby versions that are either in normal maintenance or in security maintenance, and not end of life. Older versions of Ruby _may_ still work, but are unsupported and not recommended. See https://www.ruby-lang.org/en/downloads/branches/ for details about the Ruby support schedule.
89
89
 
@@ -90,6 +90,14 @@ module Google
90
90
  # @return [Array<Google::Apis::ObservabilityV1::Operation>]
91
91
  attr_accessor :operations
92
92
 
93
+ # Unordered list. Unreachable resources. Populated when the request sets `
94
+ # ListOperationsRequest.return_partial_success` and reads across collections.
95
+ # For example, when attempting to list all resources across all supported
96
+ # locations.
97
+ # Corresponds to the JSON property `unreachable`
98
+ # @return [Array<String>]
99
+ attr_accessor :unreachable
100
+
93
101
  def initialize(**args)
94
102
  update!(**args)
95
103
  end
@@ -98,6 +106,34 @@ module Google
98
106
  def update!(**args)
99
107
  @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
100
108
  @operations = args[:operations] if args.key?(:operations)
109
+ @unreachable = args[:unreachable] if args.key?(:unreachable)
110
+ end
111
+ end
112
+
113
+ # Response for listing TraceScopes.
114
+ class ListTraceScopesResponse
115
+ include Google::Apis::Core::Hashable
116
+
117
+ # Optional. If there might be more results than appear in this response, then `
118
+ # next_page_token` is included. To get the next set of results, call the same
119
+ # method again using the value of `next_page_token` as `page_token`.
120
+ # Corresponds to the JSON property `nextPageToken`
121
+ # @return [String]
122
+ attr_accessor :next_page_token
123
+
124
+ # Optional. A list of trace scopes.
125
+ # Corresponds to the JSON property `traceScopes`
126
+ # @return [Array<Google::Apis::ObservabilityV1::TraceScope>]
127
+ attr_accessor :trace_scopes
128
+
129
+ def initialize(**args)
130
+ update!(**args)
131
+ end
132
+
133
+ # Update properties of this object
134
+ def update!(**args)
135
+ @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
136
+ @trace_scopes = args[:trace_scopes] if args.key?(:trace_scopes)
101
137
  end
102
138
  end
103
139
 
@@ -286,6 +322,12 @@ module Google
286
322
  # @return [String]
287
323
  attr_accessor :name
288
324
 
325
+ # Required. The resource name of the `TraceScope`. For example: projects/
326
+ # myproject/locations/global/traceScopes/my-trace-scope
327
+ # Corresponds to the JSON property `traceScope`
328
+ # @return [String]
329
+ attr_accessor :trace_scope
330
+
289
331
  # Output only. Update timestamp. Note: The Update timestamp for the default
290
332
  # scope is initially unset.
291
333
  # Corresponds to the JSON property `updateTime`
@@ -300,6 +342,7 @@ module Google
300
342
  def update!(**args)
301
343
  @log_scope = args[:log_scope] if args.key?(:log_scope)
302
344
  @name = args[:name] if args.key?(:name)
345
+ @trace_scope = args[:trace_scope] if args.key?(:trace_scope)
303
346
  @update_time = args[:update_time] if args.key?(:update_time)
304
347
  end
305
348
  end
@@ -342,6 +385,52 @@ module Google
342
385
  @message = args[:message] if args.key?(:message)
343
386
  end
344
387
  end
388
+
389
+ # A trace scope is a collection of resources whose traces are queried together.
390
+ class TraceScope
391
+ include Google::Apis::Core::Hashable
392
+
393
+ # Output only. The creation timestamp of the trace scope.
394
+ # Corresponds to the JSON property `createTime`
395
+ # @return [String]
396
+ attr_accessor :create_time
397
+
398
+ # Optional. Describes this trace scope. The maximum length of the description is
399
+ # 8000 characters.
400
+ # Corresponds to the JSON property `description`
401
+ # @return [String]
402
+ attr_accessor :description
403
+
404
+ # Identifier. The resource name of the trace scope. For example: projects/my-
405
+ # project/locations/global/traceScopes/my-trace-scope
406
+ # Corresponds to the JSON property `name`
407
+ # @return [String]
408
+ attr_accessor :name
409
+
410
+ # Required. Names of the projects that are included in this trace scope. * `
411
+ # projects/[PROJECT_ID]` A trace scope can include a maximum of 20 projects.
412
+ # Corresponds to the JSON property `resourceNames`
413
+ # @return [Array<String>]
414
+ attr_accessor :resource_names
415
+
416
+ # Output only. The last update timestamp of the trace scope.
417
+ # Corresponds to the JSON property `updateTime`
418
+ # @return [String]
419
+ attr_accessor :update_time
420
+
421
+ def initialize(**args)
422
+ update!(**args)
423
+ end
424
+
425
+ # Update properties of this object
426
+ def update!(**args)
427
+ @create_time = args[:create_time] if args.key?(:create_time)
428
+ @description = args[:description] if args.key?(:description)
429
+ @name = args[:name] if args.key?(:name)
430
+ @resource_names = args[:resource_names] if args.key?(:resource_names)
431
+ @update_time = args[:update_time] if args.key?(:update_time)
432
+ end
433
+ end
345
434
  end
346
435
  end
347
436
  end
@@ -16,13 +16,13 @@ module Google
16
16
  module Apis
17
17
  module ObservabilityV1
18
18
  # Version of the google-apis-observability_v1 gem
19
- GEM_VERSION = "0.1.0"
19
+ GEM_VERSION = "0.13.0"
20
20
 
21
21
  # Version of the code generator used to generate this client
22
- GENERATOR_VERSION = "0.16.0"
22
+ GENERATOR_VERSION = "0.18.0"
23
23
 
24
24
  # Revision of the discovery document this client was generated from
25
- REVISION = "20250313"
25
+ REVISION = "20260122"
26
26
  end
27
27
  end
28
28
  end
@@ -46,6 +46,12 @@ module Google
46
46
  include Google::Apis::Core::JsonObjectSupport
47
47
  end
48
48
 
49
+ class ListTraceScopesResponse
50
+ class Representation < Google::Apis::Core::JsonRepresentation; end
51
+
52
+ include Google::Apis::Core::JsonObjectSupport
53
+ end
54
+
49
55
  class Location
50
56
  class Representation < Google::Apis::Core::JsonRepresentation; end
51
57
 
@@ -76,6 +82,12 @@ module Google
76
82
  include Google::Apis::Core::JsonObjectSupport
77
83
  end
78
84
 
85
+ class TraceScope
86
+ class Representation < Google::Apis::Core::JsonRepresentation; end
87
+
88
+ include Google::Apis::Core::JsonObjectSupport
89
+ end
90
+
79
91
  class CancelOperationRequest
80
92
  # @private
81
93
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -103,6 +115,16 @@ module Google
103
115
  property :next_page_token, as: 'nextPageToken'
104
116
  collection :operations, as: 'operations', class: Google::Apis::ObservabilityV1::Operation, decorator: Google::Apis::ObservabilityV1::Operation::Representation
105
117
 
118
+ collection :unreachable, as: 'unreachable'
119
+ end
120
+ end
121
+
122
+ class ListTraceScopesResponse
123
+ # @private
124
+ class Representation < Google::Apis::Core::JsonRepresentation
125
+ property :next_page_token, as: 'nextPageToken'
126
+ collection :trace_scopes, as: 'traceScopes', class: Google::Apis::ObservabilityV1::TraceScope, decorator: Google::Apis::ObservabilityV1::TraceScope::Representation
127
+
106
128
  end
107
129
  end
108
130
 
@@ -147,6 +169,7 @@ module Google
147
169
  class Representation < Google::Apis::Core::JsonRepresentation
148
170
  property :log_scope, as: 'logScope'
149
171
  property :name, as: 'name'
172
+ property :trace_scope, as: 'traceScope'
150
173
  property :update_time, as: 'updateTime'
151
174
  end
152
175
  end
@@ -159,6 +182,17 @@ module Google
159
182
  property :message, as: 'message'
160
183
  end
161
184
  end
185
+
186
+ class TraceScope
187
+ # @private
188
+ class Representation < Google::Apis::Core::JsonRepresentation
189
+ property :create_time, as: 'createTime'
190
+ property :description, as: 'description'
191
+ property :name, as: 'name'
192
+ collection :resource_names, as: 'resourceNames'
193
+ property :update_time, as: 'updateTime'
194
+ end
195
+ end
162
196
  end
163
197
  end
164
198
  end
@@ -22,7 +22,8 @@ module Google
22
22
  module ObservabilityV1
23
23
  # Observability API
24
24
  #
25
- #
25
+ # Provides functionality for configuring the observability scope, which controls
26
+ # the log, metric, and trace data that you can view.
26
27
  #
27
28
  # @example
28
29
  # require 'google/apis/observability_v1'
@@ -30,7 +31,7 @@ module Google
30
31
  # Observability = Google::Apis::ObservabilityV1 # Alias the module
31
32
  # service = Observability::CloudObservabilityService.new
32
33
  #
33
- # @see
34
+ # @see https://cloud.google.com/stackdriver/docs/
34
35
  class CloudObservabilityService < Google::Apis::Core::BaseService
35
36
  DEFAULT_ENDPOINT_TEMPLATE = "https://observability.$UNIVERSE_DOMAIN$/"
36
37
 
@@ -51,6 +52,466 @@ module Google
51
52
  @batch_path = 'batch'
52
53
  end
53
54
 
55
+ # Gets information about a location.
56
+ # @param [String] name
57
+ # Resource name for the location.
58
+ # @param [String] fields
59
+ # Selector specifying which fields to include in a partial response.
60
+ # @param [String] quota_user
61
+ # Available to use for quota purposes for server-side applications. Can be any
62
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
63
+ # @param [Google::Apis::RequestOptions] options
64
+ # Request-specific options
65
+ #
66
+ # @yield [result, err] Result & error if block supplied
67
+ # @yieldparam result [Google::Apis::ObservabilityV1::Location] parsed result object
68
+ # @yieldparam err [StandardError] error object if request failed
69
+ #
70
+ # @return [Google::Apis::ObservabilityV1::Location]
71
+ #
72
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
73
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
74
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
75
+ def get_folder_location(name, fields: nil, quota_user: nil, options: nil, &block)
76
+ command = make_simple_command(:get, 'v1/{+name}', options)
77
+ command.response_representation = Google::Apis::ObservabilityV1::Location::Representation
78
+ command.response_class = Google::Apis::ObservabilityV1::Location
79
+ command.params['name'] = name unless name.nil?
80
+ command.query['fields'] = fields unless fields.nil?
81
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
82
+ execute_or_queue_command(command, &block)
83
+ end
84
+
85
+ # Lists information about the supported locations for this service.
86
+ # @param [String] name
87
+ # The resource that owns the locations collection, if applicable.
88
+ # @param [Array<String>, String] extra_location_types
89
+ # Optional. Do not use this field. It is unsupported and is ignored unless
90
+ # explicitly documented otherwise. This is primarily for internal usage.
91
+ # @param [String] filter
92
+ # A filter to narrow down results to a preferred subset. The filtering language
93
+ # accepts strings like `"displayName=tokyo"`, and is documented in more detail
94
+ # in [AIP-160](https://google.aip.dev/160).
95
+ # @param [Fixnum] page_size
96
+ # The maximum number of results to return. If not set, the service selects a
97
+ # default.
98
+ # @param [String] page_token
99
+ # A page token received from the `next_page_token` field in the response. Send
100
+ # that page token to receive the subsequent page.
101
+ # @param [String] fields
102
+ # Selector specifying which fields to include in a partial response.
103
+ # @param [String] quota_user
104
+ # Available to use for quota purposes for server-side applications. Can be any
105
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
106
+ # @param [Google::Apis::RequestOptions] options
107
+ # Request-specific options
108
+ #
109
+ # @yield [result, err] Result & error if block supplied
110
+ # @yieldparam result [Google::Apis::ObservabilityV1::ListLocationsResponse] parsed result object
111
+ # @yieldparam err [StandardError] error object if request failed
112
+ #
113
+ # @return [Google::Apis::ObservabilityV1::ListLocationsResponse]
114
+ #
115
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
116
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
117
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
118
+ def list_folder_locations(name, extra_location_types: nil, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
119
+ command = make_simple_command(:get, 'v1/{+name}/locations', options)
120
+ command.response_representation = Google::Apis::ObservabilityV1::ListLocationsResponse::Representation
121
+ command.response_class = Google::Apis::ObservabilityV1::ListLocationsResponse
122
+ command.params['name'] = name unless name.nil?
123
+ command.query['extraLocationTypes'] = extra_location_types unless extra_location_types.nil?
124
+ command.query['filter'] = filter unless filter.nil?
125
+ command.query['pageSize'] = page_size unless page_size.nil?
126
+ command.query['pageToken'] = page_token unless page_token.nil?
127
+ command.query['fields'] = fields unless fields.nil?
128
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
129
+ execute_or_queue_command(command, &block)
130
+ end
131
+
132
+ # Starts asynchronous cancellation on a long-running operation. The server makes
133
+ # a best effort to cancel the operation, but success is not guaranteed. If the
134
+ # server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.
135
+ # Clients can use Operations.GetOperation or other methods to check whether the
136
+ # cancellation succeeded or whether the operation completed despite cancellation.
137
+ # On successful cancellation, the operation is not deleted; instead, it becomes
138
+ # an operation with an Operation.error value with a google.rpc.Status.code of `1`
139
+ # , corresponding to `Code.CANCELLED`.
140
+ # @param [String] name
141
+ # The name of the operation resource to be cancelled.
142
+ # @param [Google::Apis::ObservabilityV1::CancelOperationRequest] cancel_operation_request_object
143
+ # @param [String] fields
144
+ # Selector specifying which fields to include in a partial response.
145
+ # @param [String] quota_user
146
+ # Available to use for quota purposes for server-side applications. Can be any
147
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
148
+ # @param [Google::Apis::RequestOptions] options
149
+ # Request-specific options
150
+ #
151
+ # @yield [result, err] Result & error if block supplied
152
+ # @yieldparam result [Google::Apis::ObservabilityV1::Empty] parsed result object
153
+ # @yieldparam err [StandardError] error object if request failed
154
+ #
155
+ # @return [Google::Apis::ObservabilityV1::Empty]
156
+ #
157
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
158
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
159
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
160
+ def cancel_folder_location_operation(name, cancel_operation_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
161
+ command = make_simple_command(:post, 'v1/{+name}:cancel', options)
162
+ command.request_representation = Google::Apis::ObservabilityV1::CancelOperationRequest::Representation
163
+ command.request_object = cancel_operation_request_object
164
+ command.response_representation = Google::Apis::ObservabilityV1::Empty::Representation
165
+ command.response_class = Google::Apis::ObservabilityV1::Empty
166
+ command.params['name'] = name unless name.nil?
167
+ command.query['fields'] = fields unless fields.nil?
168
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
169
+ execute_or_queue_command(command, &block)
170
+ end
171
+
172
+ # Deletes a long-running operation. This method indicates that the client is no
173
+ # longer interested in the operation result. It does not cancel the operation.
174
+ # If the server doesn't support this method, it returns `google.rpc.Code.
175
+ # UNIMPLEMENTED`.
176
+ # @param [String] name
177
+ # The name of the operation resource to be deleted.
178
+ # @param [String] fields
179
+ # Selector specifying which fields to include in a partial response.
180
+ # @param [String] quota_user
181
+ # Available to use for quota purposes for server-side applications. Can be any
182
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
183
+ # @param [Google::Apis::RequestOptions] options
184
+ # Request-specific options
185
+ #
186
+ # @yield [result, err] Result & error if block supplied
187
+ # @yieldparam result [Google::Apis::ObservabilityV1::Empty] parsed result object
188
+ # @yieldparam err [StandardError] error object if request failed
189
+ #
190
+ # @return [Google::Apis::ObservabilityV1::Empty]
191
+ #
192
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
193
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
194
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
195
+ def delete_folder_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
196
+ command = make_simple_command(:delete, 'v1/{+name}', options)
197
+ command.response_representation = Google::Apis::ObservabilityV1::Empty::Representation
198
+ command.response_class = Google::Apis::ObservabilityV1::Empty
199
+ command.params['name'] = name unless name.nil?
200
+ command.query['fields'] = fields unless fields.nil?
201
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
202
+ execute_or_queue_command(command, &block)
203
+ end
204
+
205
+ # Gets the latest state of a long-running operation. Clients can use this method
206
+ # to poll the operation result at intervals as recommended by the API service.
207
+ # @param [String] name
208
+ # The name of the operation resource.
209
+ # @param [String] fields
210
+ # Selector specifying which fields to include in a partial response.
211
+ # @param [String] quota_user
212
+ # Available to use for quota purposes for server-side applications. Can be any
213
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
214
+ # @param [Google::Apis::RequestOptions] options
215
+ # Request-specific options
216
+ #
217
+ # @yield [result, err] Result & error if block supplied
218
+ # @yieldparam result [Google::Apis::ObservabilityV1::Operation] parsed result object
219
+ # @yieldparam err [StandardError] error object if request failed
220
+ #
221
+ # @return [Google::Apis::ObservabilityV1::Operation]
222
+ #
223
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
224
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
225
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
226
+ def get_folder_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
227
+ command = make_simple_command(:get, 'v1/{+name}', options)
228
+ command.response_representation = Google::Apis::ObservabilityV1::Operation::Representation
229
+ command.response_class = Google::Apis::ObservabilityV1::Operation
230
+ command.params['name'] = name unless name.nil?
231
+ command.query['fields'] = fields unless fields.nil?
232
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
233
+ execute_or_queue_command(command, &block)
234
+ end
235
+
236
+ # Lists operations that match the specified filter in the request. If the server
237
+ # doesn't support this method, it returns `UNIMPLEMENTED`.
238
+ # @param [String] name
239
+ # The name of the operation's parent resource.
240
+ # @param [String] filter
241
+ # The standard list filter.
242
+ # @param [Fixnum] page_size
243
+ # The standard list page size.
244
+ # @param [String] page_token
245
+ # The standard list page token.
246
+ # @param [Boolean] return_partial_success
247
+ # When set to `true`, operations that are reachable are returned as normal, and
248
+ # those that are unreachable are returned in the ListOperationsResponse.
249
+ # unreachable field. This can only be `true` when reading across collections.
250
+ # For example, when `parent` is set to `"projects/example/locations/-"`. This
251
+ # field is not supported by default and will result in an `UNIMPLEMENTED` error
252
+ # if set unless explicitly documented otherwise in service or product specific
253
+ # documentation.
254
+ # @param [String] fields
255
+ # Selector specifying which fields to include in a partial response.
256
+ # @param [String] quota_user
257
+ # Available to use for quota purposes for server-side applications. Can be any
258
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
259
+ # @param [Google::Apis::RequestOptions] options
260
+ # Request-specific options
261
+ #
262
+ # @yield [result, err] Result & error if block supplied
263
+ # @yieldparam result [Google::Apis::ObservabilityV1::ListOperationsResponse] parsed result object
264
+ # @yieldparam err [StandardError] error object if request failed
265
+ #
266
+ # @return [Google::Apis::ObservabilityV1::ListOperationsResponse]
267
+ #
268
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
269
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
270
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
271
+ def list_folder_location_operations(name, filter: nil, page_size: nil, page_token: nil, return_partial_success: nil, fields: nil, quota_user: nil, options: nil, &block)
272
+ command = make_simple_command(:get, 'v1/{+name}/operations', options)
273
+ command.response_representation = Google::Apis::ObservabilityV1::ListOperationsResponse::Representation
274
+ command.response_class = Google::Apis::ObservabilityV1::ListOperationsResponse
275
+ command.params['name'] = name unless name.nil?
276
+ command.query['filter'] = filter unless filter.nil?
277
+ command.query['pageSize'] = page_size unless page_size.nil?
278
+ command.query['pageToken'] = page_token unless page_token.nil?
279
+ command.query['returnPartialSuccess'] = return_partial_success unless return_partial_success.nil?
280
+ command.query['fields'] = fields unless fields.nil?
281
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
282
+ execute_or_queue_command(command, &block)
283
+ end
284
+
285
+ # Gets information about a location.
286
+ # @param [String] name
287
+ # Resource name for the location.
288
+ # @param [String] fields
289
+ # Selector specifying which fields to include in a partial response.
290
+ # @param [String] quota_user
291
+ # Available to use for quota purposes for server-side applications. Can be any
292
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
293
+ # @param [Google::Apis::RequestOptions] options
294
+ # Request-specific options
295
+ #
296
+ # @yield [result, err] Result & error if block supplied
297
+ # @yieldparam result [Google::Apis::ObservabilityV1::Location] parsed result object
298
+ # @yieldparam err [StandardError] error object if request failed
299
+ #
300
+ # @return [Google::Apis::ObservabilityV1::Location]
301
+ #
302
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
303
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
304
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
305
+ def get_organization_location(name, fields: nil, quota_user: nil, options: nil, &block)
306
+ command = make_simple_command(:get, 'v1/{+name}', options)
307
+ command.response_representation = Google::Apis::ObservabilityV1::Location::Representation
308
+ command.response_class = Google::Apis::ObservabilityV1::Location
309
+ command.params['name'] = name unless name.nil?
310
+ command.query['fields'] = fields unless fields.nil?
311
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
312
+ execute_or_queue_command(command, &block)
313
+ end
314
+
315
+ # Lists information about the supported locations for this service.
316
+ # @param [String] name
317
+ # The resource that owns the locations collection, if applicable.
318
+ # @param [Array<String>, String] extra_location_types
319
+ # Optional. Do not use this field. It is unsupported and is ignored unless
320
+ # explicitly documented otherwise. This is primarily for internal usage.
321
+ # @param [String] filter
322
+ # A filter to narrow down results to a preferred subset. The filtering language
323
+ # accepts strings like `"displayName=tokyo"`, and is documented in more detail
324
+ # in [AIP-160](https://google.aip.dev/160).
325
+ # @param [Fixnum] page_size
326
+ # The maximum number of results to return. If not set, the service selects a
327
+ # default.
328
+ # @param [String] page_token
329
+ # A page token received from the `next_page_token` field in the response. Send
330
+ # that page token to receive the subsequent page.
331
+ # @param [String] fields
332
+ # Selector specifying which fields to include in a partial response.
333
+ # @param [String] quota_user
334
+ # Available to use for quota purposes for server-side applications. Can be any
335
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
336
+ # @param [Google::Apis::RequestOptions] options
337
+ # Request-specific options
338
+ #
339
+ # @yield [result, err] Result & error if block supplied
340
+ # @yieldparam result [Google::Apis::ObservabilityV1::ListLocationsResponse] parsed result object
341
+ # @yieldparam err [StandardError] error object if request failed
342
+ #
343
+ # @return [Google::Apis::ObservabilityV1::ListLocationsResponse]
344
+ #
345
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
346
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
347
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
348
+ def list_organization_locations(name, extra_location_types: nil, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
349
+ command = make_simple_command(:get, 'v1/{+name}/locations', options)
350
+ command.response_representation = Google::Apis::ObservabilityV1::ListLocationsResponse::Representation
351
+ command.response_class = Google::Apis::ObservabilityV1::ListLocationsResponse
352
+ command.params['name'] = name unless name.nil?
353
+ command.query['extraLocationTypes'] = extra_location_types unless extra_location_types.nil?
354
+ command.query['filter'] = filter unless filter.nil?
355
+ command.query['pageSize'] = page_size unless page_size.nil?
356
+ command.query['pageToken'] = page_token unless page_token.nil?
357
+ command.query['fields'] = fields unless fields.nil?
358
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
359
+ execute_or_queue_command(command, &block)
360
+ end
361
+
362
+ # Starts asynchronous cancellation on a long-running operation. The server makes
363
+ # a best effort to cancel the operation, but success is not guaranteed. If the
364
+ # server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.
365
+ # Clients can use Operations.GetOperation or other methods to check whether the
366
+ # cancellation succeeded or whether the operation completed despite cancellation.
367
+ # On successful cancellation, the operation is not deleted; instead, it becomes
368
+ # an operation with an Operation.error value with a google.rpc.Status.code of `1`
369
+ # , corresponding to `Code.CANCELLED`.
370
+ # @param [String] name
371
+ # The name of the operation resource to be cancelled.
372
+ # @param [Google::Apis::ObservabilityV1::CancelOperationRequest] cancel_operation_request_object
373
+ # @param [String] fields
374
+ # Selector specifying which fields to include in a partial response.
375
+ # @param [String] quota_user
376
+ # Available to use for quota purposes for server-side applications. Can be any
377
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
378
+ # @param [Google::Apis::RequestOptions] options
379
+ # Request-specific options
380
+ #
381
+ # @yield [result, err] Result & error if block supplied
382
+ # @yieldparam result [Google::Apis::ObservabilityV1::Empty] parsed result object
383
+ # @yieldparam err [StandardError] error object if request failed
384
+ #
385
+ # @return [Google::Apis::ObservabilityV1::Empty]
386
+ #
387
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
388
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
389
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
390
+ def cancel_organization_location_operation(name, cancel_operation_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
391
+ command = make_simple_command(:post, 'v1/{+name}:cancel', options)
392
+ command.request_representation = Google::Apis::ObservabilityV1::CancelOperationRequest::Representation
393
+ command.request_object = cancel_operation_request_object
394
+ command.response_representation = Google::Apis::ObservabilityV1::Empty::Representation
395
+ command.response_class = Google::Apis::ObservabilityV1::Empty
396
+ command.params['name'] = name unless name.nil?
397
+ command.query['fields'] = fields unless fields.nil?
398
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
399
+ execute_or_queue_command(command, &block)
400
+ end
401
+
402
+ # Deletes a long-running operation. This method indicates that the client is no
403
+ # longer interested in the operation result. It does not cancel the operation.
404
+ # If the server doesn't support this method, it returns `google.rpc.Code.
405
+ # UNIMPLEMENTED`.
406
+ # @param [String] name
407
+ # The name of the operation resource to be deleted.
408
+ # @param [String] fields
409
+ # Selector specifying which fields to include in a partial response.
410
+ # @param [String] quota_user
411
+ # Available to use for quota purposes for server-side applications. Can be any
412
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
413
+ # @param [Google::Apis::RequestOptions] options
414
+ # Request-specific options
415
+ #
416
+ # @yield [result, err] Result & error if block supplied
417
+ # @yieldparam result [Google::Apis::ObservabilityV1::Empty] parsed result object
418
+ # @yieldparam err [StandardError] error object if request failed
419
+ #
420
+ # @return [Google::Apis::ObservabilityV1::Empty]
421
+ #
422
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
423
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
424
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
425
+ def delete_organization_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
426
+ command = make_simple_command(:delete, 'v1/{+name}', options)
427
+ command.response_representation = Google::Apis::ObservabilityV1::Empty::Representation
428
+ command.response_class = Google::Apis::ObservabilityV1::Empty
429
+ command.params['name'] = name unless name.nil?
430
+ command.query['fields'] = fields unless fields.nil?
431
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
432
+ execute_or_queue_command(command, &block)
433
+ end
434
+
435
+ # Gets the latest state of a long-running operation. Clients can use this method
436
+ # to poll the operation result at intervals as recommended by the API service.
437
+ # @param [String] name
438
+ # The name of the operation resource.
439
+ # @param [String] fields
440
+ # Selector specifying which fields to include in a partial response.
441
+ # @param [String] quota_user
442
+ # Available to use for quota purposes for server-side applications. Can be any
443
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
444
+ # @param [Google::Apis::RequestOptions] options
445
+ # Request-specific options
446
+ #
447
+ # @yield [result, err] Result & error if block supplied
448
+ # @yieldparam result [Google::Apis::ObservabilityV1::Operation] parsed result object
449
+ # @yieldparam err [StandardError] error object if request failed
450
+ #
451
+ # @return [Google::Apis::ObservabilityV1::Operation]
452
+ #
453
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
454
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
455
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
456
+ def get_organization_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
457
+ command = make_simple_command(:get, 'v1/{+name}', options)
458
+ command.response_representation = Google::Apis::ObservabilityV1::Operation::Representation
459
+ command.response_class = Google::Apis::ObservabilityV1::Operation
460
+ command.params['name'] = name unless name.nil?
461
+ command.query['fields'] = fields unless fields.nil?
462
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
463
+ execute_or_queue_command(command, &block)
464
+ end
465
+
466
+ # Lists operations that match the specified filter in the request. If the server
467
+ # doesn't support this method, it returns `UNIMPLEMENTED`.
468
+ # @param [String] name
469
+ # The name of the operation's parent resource.
470
+ # @param [String] filter
471
+ # The standard list filter.
472
+ # @param [Fixnum] page_size
473
+ # The standard list page size.
474
+ # @param [String] page_token
475
+ # The standard list page token.
476
+ # @param [Boolean] return_partial_success
477
+ # When set to `true`, operations that are reachable are returned as normal, and
478
+ # those that are unreachable are returned in the ListOperationsResponse.
479
+ # unreachable field. This can only be `true` when reading across collections.
480
+ # For example, when `parent` is set to `"projects/example/locations/-"`. This
481
+ # field is not supported by default and will result in an `UNIMPLEMENTED` error
482
+ # if set unless explicitly documented otherwise in service or product specific
483
+ # documentation.
484
+ # @param [String] fields
485
+ # Selector specifying which fields to include in a partial response.
486
+ # @param [String] quota_user
487
+ # Available to use for quota purposes for server-side applications. Can be any
488
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
489
+ # @param [Google::Apis::RequestOptions] options
490
+ # Request-specific options
491
+ #
492
+ # @yield [result, err] Result & error if block supplied
493
+ # @yieldparam result [Google::Apis::ObservabilityV1::ListOperationsResponse] parsed result object
494
+ # @yieldparam err [StandardError] error object if request failed
495
+ #
496
+ # @return [Google::Apis::ObservabilityV1::ListOperationsResponse]
497
+ #
498
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
499
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
500
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
501
+ def list_organization_location_operations(name, filter: nil, page_size: nil, page_token: nil, return_partial_success: nil, fields: nil, quota_user: nil, options: nil, &block)
502
+ command = make_simple_command(:get, 'v1/{+name}/operations', options)
503
+ command.response_representation = Google::Apis::ObservabilityV1::ListOperationsResponse::Representation
504
+ command.response_class = Google::Apis::ObservabilityV1::ListOperationsResponse
505
+ command.params['name'] = name unless name.nil?
506
+ command.query['filter'] = filter unless filter.nil?
507
+ command.query['pageSize'] = page_size unless page_size.nil?
508
+ command.query['pageToken'] = page_token unless page_token.nil?
509
+ command.query['returnPartialSuccess'] = return_partial_success unless return_partial_success.nil?
510
+ command.query['fields'] = fields unless fields.nil?
511
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
512
+ execute_or_queue_command(command, &block)
513
+ end
514
+
54
515
  # Gets information about a location.
55
516
  # @param [String] name
56
517
  # Resource name for the location.
@@ -84,6 +545,9 @@ module Google
84
545
  # Lists information about the supported locations for this service.
85
546
  # @param [String] name
86
547
  # The resource that owns the locations collection, if applicable.
548
+ # @param [Array<String>, String] extra_location_types
549
+ # Optional. Do not use this field. It is unsupported and is ignored unless
550
+ # explicitly documented otherwise. This is primarily for internal usage.
87
551
  # @param [String] filter
88
552
  # A filter to narrow down results to a preferred subset. The filtering language
89
553
  # accepts strings like `"displayName=tokyo"`, and is documented in more detail
@@ -111,11 +575,12 @@ module Google
111
575
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
112
576
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
113
577
  # @raise [Google::Apis::AuthorizationError] Authorization is required
114
- def list_project_locations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
578
+ def list_project_locations(name, extra_location_types: nil, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
115
579
  command = make_simple_command(:get, 'v1/{+name}/locations', options)
116
580
  command.response_representation = Google::Apis::ObservabilityV1::ListLocationsResponse::Representation
117
581
  command.response_class = Google::Apis::ObservabilityV1::ListLocationsResponse
118
582
  command.params['name'] = name unless name.nil?
583
+ command.query['extraLocationTypes'] = extra_location_types unless extra_location_types.nil?
119
584
  command.query['filter'] = filter unless filter.nil?
120
585
  command.query['pageSize'] = page_size unless page_size.nil?
121
586
  command.query['pageToken'] = page_token unless page_token.nil?
@@ -238,6 +703,14 @@ module Google
238
703
  # The standard list page size.
239
704
  # @param [String] page_token
240
705
  # The standard list page token.
706
+ # @param [Boolean] return_partial_success
707
+ # When set to `true`, operations that are reachable are returned as normal, and
708
+ # those that are unreachable are returned in the ListOperationsResponse.
709
+ # unreachable field. This can only be `true` when reading across collections.
710
+ # For example, when `parent` is set to `"projects/example/locations/-"`. This
711
+ # field is not supported by default and will result in an `UNIMPLEMENTED` error
712
+ # if set unless explicitly documented otherwise in service or product specific
713
+ # documentation.
241
714
  # @param [String] fields
242
715
  # Selector specifying which fields to include in a partial response.
243
716
  # @param [String] quota_user
@@ -255,7 +728,7 @@ module Google
255
728
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
256
729
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
257
730
  # @raise [Google::Apis::AuthorizationError] Authorization is required
258
- def list_project_location_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
731
+ def list_project_location_operations(name, filter: nil, page_size: nil, page_token: nil, return_partial_success: nil, fields: nil, quota_user: nil, options: nil, &block)
259
732
  command = make_simple_command(:get, 'v1/{+name}/operations', options)
260
733
  command.response_representation = Google::Apis::ObservabilityV1::ListOperationsResponse::Representation
261
734
  command.response_class = Google::Apis::ObservabilityV1::ListOperationsResponse
@@ -263,6 +736,7 @@ module Google
263
736
  command.query['filter'] = filter unless filter.nil?
264
737
  command.query['pageSize'] = page_size unless page_size.nil?
265
738
  command.query['pageToken'] = page_token unless page_token.nil?
739
+ command.query['returnPartialSuccess'] = return_partial_success unless return_partial_success.nil?
266
740
  command.query['fields'] = fields unless fields.nil?
267
741
  command.query['quotaUser'] = quota_user unless quota_user.nil?
268
742
  execute_or_queue_command(command, &block)
@@ -309,9 +783,9 @@ module Google
309
783
  # @param [String] update_mask
310
784
  # Optional. Field mask is used to specify the fields to be overwritten in the
311
785
  # Scope resource by the update. The fields specified in the update_mask are
312
- # relative to the resource, not the full request. A field will be overwritten if
313
- # it is in the mask. If the user does not provide a mask then all fields present
314
- # in the request will be overwritten.
786
+ # relative to the resource, not the full request. A field is overwritten when it
787
+ # is in the mask. If the user does not provide a mask, then all fields present
788
+ # in the request are overwritten.
315
789
  # @param [String] fields
316
790
  # Selector specifying which fields to include in a partial response.
317
791
  # @param [String] quota_user
@@ -341,6 +815,188 @@ module Google
341
815
  command.query['quotaUser'] = quota_user unless quota_user.nil?
342
816
  execute_or_queue_command(command, &block)
343
817
  end
818
+
819
+ # Create a new TraceScope.
820
+ # @param [String] parent
821
+ # Required. The full resource name of the location where the trace scope should
822
+ # be created projects/[PROJECT_ID]/locations/[LOCATION_ID] For example: projects/
823
+ # my-project/locations/global
824
+ # @param [Google::Apis::ObservabilityV1::TraceScope] trace_scope_object
825
+ # @param [String] trace_scope_id
826
+ # Required. A client-assigned identifier for the trace scope.
827
+ # @param [String] fields
828
+ # Selector specifying which fields to include in a partial response.
829
+ # @param [String] quota_user
830
+ # Available to use for quota purposes for server-side applications. Can be any
831
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
832
+ # @param [Google::Apis::RequestOptions] options
833
+ # Request-specific options
834
+ #
835
+ # @yield [result, err] Result & error if block supplied
836
+ # @yieldparam result [Google::Apis::ObservabilityV1::TraceScope] parsed result object
837
+ # @yieldparam err [StandardError] error object if request failed
838
+ #
839
+ # @return [Google::Apis::ObservabilityV1::TraceScope]
840
+ #
841
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
842
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
843
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
844
+ def create_project_location_trace_scope(parent, trace_scope_object = nil, trace_scope_id: nil, fields: nil, quota_user: nil, options: nil, &block)
845
+ command = make_simple_command(:post, 'v1/{+parent}/traceScopes', options)
846
+ command.request_representation = Google::Apis::ObservabilityV1::TraceScope::Representation
847
+ command.request_object = trace_scope_object
848
+ command.response_representation = Google::Apis::ObservabilityV1::TraceScope::Representation
849
+ command.response_class = Google::Apis::ObservabilityV1::TraceScope
850
+ command.params['parent'] = parent unless parent.nil?
851
+ command.query['traceScopeId'] = trace_scope_id unless trace_scope_id.nil?
852
+ command.query['fields'] = fields unless fields.nil?
853
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
854
+ execute_or_queue_command(command, &block)
855
+ end
856
+
857
+ # Delete a TraceScope.
858
+ # @param [String] name
859
+ # Required. The full resource name of the trace scope to delete: projects/[
860
+ # PROJECT_ID]/locations/[LOCATION_ID]/traceScopes/[TRACE_SCOPE_ID] For example:
861
+ # projects/my-project/locations/global/traceScopes/my-trace-scope
862
+ # @param [String] fields
863
+ # Selector specifying which fields to include in a partial response.
864
+ # @param [String] quota_user
865
+ # Available to use for quota purposes for server-side applications. Can be any
866
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
867
+ # @param [Google::Apis::RequestOptions] options
868
+ # Request-specific options
869
+ #
870
+ # @yield [result, err] Result & error if block supplied
871
+ # @yieldparam result [Google::Apis::ObservabilityV1::Empty] parsed result object
872
+ # @yieldparam err [StandardError] error object if request failed
873
+ #
874
+ # @return [Google::Apis::ObservabilityV1::Empty]
875
+ #
876
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
877
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
878
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
879
+ def delete_project_location_trace_scope(name, fields: nil, quota_user: nil, options: nil, &block)
880
+ command = make_simple_command(:delete, 'v1/{+name}', options)
881
+ command.response_representation = Google::Apis::ObservabilityV1::Empty::Representation
882
+ command.response_class = Google::Apis::ObservabilityV1::Empty
883
+ command.params['name'] = name unless name.nil?
884
+ command.query['fields'] = fields unless fields.nil?
885
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
886
+ execute_or_queue_command(command, &block)
887
+ end
888
+
889
+ # Get TraceScope resource.
890
+ # @param [String] name
891
+ # Required. The resource name of the trace scope: projects/[PROJECT_ID]/
892
+ # locations/[LOCATION_ID]/traceScopes/[TRACE_SCOPE_ID] For example: projects/my-
893
+ # project/locations/global/traceScopes/my-trace-scope
894
+ # @param [String] fields
895
+ # Selector specifying which fields to include in a partial response.
896
+ # @param [String] quota_user
897
+ # Available to use for quota purposes for server-side applications. Can be any
898
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
899
+ # @param [Google::Apis::RequestOptions] options
900
+ # Request-specific options
901
+ #
902
+ # @yield [result, err] Result & error if block supplied
903
+ # @yieldparam result [Google::Apis::ObservabilityV1::TraceScope] parsed result object
904
+ # @yieldparam err [StandardError] error object if request failed
905
+ #
906
+ # @return [Google::Apis::ObservabilityV1::TraceScope]
907
+ #
908
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
909
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
910
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
911
+ def get_project_location_trace_scope(name, fields: nil, quota_user: nil, options: nil, &block)
912
+ command = make_simple_command(:get, 'v1/{+name}', options)
913
+ command.response_representation = Google::Apis::ObservabilityV1::TraceScope::Representation
914
+ command.response_class = Google::Apis::ObservabilityV1::TraceScope
915
+ command.params['name'] = name unless name.nil?
916
+ command.query['fields'] = fields unless fields.nil?
917
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
918
+ execute_or_queue_command(command, &block)
919
+ end
920
+
921
+ # List TraceScopes of a project in a particular location.
922
+ # @param [String] parent
923
+ # Required. The full resource name of the location to look for trace scopes:
924
+ # projects/[PROJECT_ID]/locations/[LOCATION_ID] For example: projects/my-project/
925
+ # locations/global
926
+ # @param [Fixnum] page_size
927
+ # Optional. The maximum number of results to return from this request. Non-
928
+ # positive values are ignored. The presence of `next_page_token` in the response
929
+ # indicates that more results might be available.
930
+ # @param [String] page_token
931
+ # Optional. If present, then retrieve the next batch of results from the
932
+ # preceding call to this method. `page_token` must be the value of `
933
+ # next_page_token` from the previous response. The values of other method
934
+ # parameters should be identical to those in the previous call.
935
+ # @param [String] fields
936
+ # Selector specifying which fields to include in a partial response.
937
+ # @param [String] quota_user
938
+ # Available to use for quota purposes for server-side applications. Can be any
939
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
940
+ # @param [Google::Apis::RequestOptions] options
941
+ # Request-specific options
942
+ #
943
+ # @yield [result, err] Result & error if block supplied
944
+ # @yieldparam result [Google::Apis::ObservabilityV1::ListTraceScopesResponse] parsed result object
945
+ # @yieldparam err [StandardError] error object if request failed
946
+ #
947
+ # @return [Google::Apis::ObservabilityV1::ListTraceScopesResponse]
948
+ #
949
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
950
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
951
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
952
+ def list_project_location_trace_scopes(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
953
+ command = make_simple_command(:get, 'v1/{+parent}/traceScopes', options)
954
+ command.response_representation = Google::Apis::ObservabilityV1::ListTraceScopesResponse::Representation
955
+ command.response_class = Google::Apis::ObservabilityV1::ListTraceScopesResponse
956
+ command.params['parent'] = parent unless parent.nil?
957
+ command.query['pageSize'] = page_size unless page_size.nil?
958
+ command.query['pageToken'] = page_token unless page_token.nil?
959
+ command.query['fields'] = fields unless fields.nil?
960
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
961
+ execute_or_queue_command(command, &block)
962
+ end
963
+
964
+ # Update a TraceScope.
965
+ # @param [String] name
966
+ # Identifier. The resource name of the trace scope. For example: projects/my-
967
+ # project/locations/global/traceScopes/my-trace-scope
968
+ # @param [Google::Apis::ObservabilityV1::TraceScope] trace_scope_object
969
+ # @param [String] update_mask
970
+ # Optional. The list of fields to update.
971
+ # @param [String] fields
972
+ # Selector specifying which fields to include in a partial response.
973
+ # @param [String] quota_user
974
+ # Available to use for quota purposes for server-side applications. Can be any
975
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
976
+ # @param [Google::Apis::RequestOptions] options
977
+ # Request-specific options
978
+ #
979
+ # @yield [result, err] Result & error if block supplied
980
+ # @yieldparam result [Google::Apis::ObservabilityV1::TraceScope] parsed result object
981
+ # @yieldparam err [StandardError] error object if request failed
982
+ #
983
+ # @return [Google::Apis::ObservabilityV1::TraceScope]
984
+ #
985
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
986
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
987
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
988
+ def patch_project_location_trace_scope(name, trace_scope_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
989
+ command = make_simple_command(:patch, 'v1/{+name}', options)
990
+ command.request_representation = Google::Apis::ObservabilityV1::TraceScope::Representation
991
+ command.request_object = trace_scope_object
992
+ command.response_representation = Google::Apis::ObservabilityV1::TraceScope::Representation
993
+ command.response_class = Google::Apis::ObservabilityV1::TraceScope
994
+ command.params['name'] = name unless name.nil?
995
+ command.query['updateMask'] = update_mask unless update_mask.nil?
996
+ command.query['fields'] = fields unless fields.nil?
997
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
998
+ execute_or_queue_command(command, &block)
999
+ end
344
1000
 
345
1001
  protected
346
1002
 
@@ -21,9 +21,10 @@ module Google
21
21
  module Apis
22
22
  # Observability API
23
23
  #
24
- #
24
+ # Provides functionality for configuring the observability scope, which controls
25
+ # the log, metric, and trace data that you can view.
25
26
  #
26
- # @see
27
+ # @see https://cloud.google.com/stackdriver/docs/
27
28
  module ObservabilityV1
28
29
  # Version of the Observability API this client connects to.
29
30
  # This is NOT the gem version.
metadata CHANGED
@@ -1,13 +1,13 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-apis-observability_v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.1.0
4
+ version: 0.13.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  bindir: bin
9
9
  cert_chain: []
10
- date: 2025-03-23 00:00:00.000000000 Z
10
+ date: 1980-01-02 00:00:00.000000000 Z
11
11
  dependencies:
12
12
  - !ruby/object:Gem::Dependency
13
13
  name: google-apis-core
@@ -57,7 +57,7 @@ licenses:
57
57
  metadata:
58
58
  bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
59
59
  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-observability_v1/CHANGELOG.md
60
- documentation_uri: https://googleapis.dev/ruby/google-apis-observability_v1/v0.1.0
60
+ documentation_uri: https://googleapis.dev/ruby/google-apis-observability_v1/v0.13.0
61
61
  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-observability_v1
62
62
  rdoc_options: []
63
63
  require_paths:
@@ -66,14 +66,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
66
66
  requirements:
67
67
  - - ">="
68
68
  - !ruby/object:Gem::Version
69
- version: '2.7'
69
+ version: '3.1'
70
70
  required_rubygems_version: !ruby/object:Gem::Requirement
71
71
  requirements:
72
72
  - - ">="
73
73
  - !ruby/object:Gem::Version
74
74
  version: '0'
75
75
  requirements: []
76
- rubygems_version: 3.6.5
76
+ rubygems_version: 3.6.9
77
77
  specification_version: 4
78
78
  summary: Simple REST client for Observability API V1
79
79
  test_files: []