google-cloud-asset-v1 0.2.1 → 0.4.1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (31) hide show
  1. checksums.yaml +4 -4
  2. data/AUTHENTICATION.md +6 -6
  3. data/README.md +1 -1
  4. data/lib/google/cloud/asset/v1.rb +1 -1
  5. data/lib/google/cloud/asset/v1/asset_service.rb +1 -1
  6. data/lib/google/cloud/asset/v1/asset_service/client.rb +456 -169
  7. data/lib/google/cloud/asset/v1/asset_service/credentials.rb +1 -1
  8. data/lib/google/cloud/asset/v1/asset_service/operations.rb +108 -102
  9. data/lib/google/cloud/asset/v1/asset_service/paths.rb +5 -5
  10. data/lib/google/cloud/asset/v1/asset_service_pb.rb +26 -0
  11. data/lib/google/cloud/asset/v1/asset_service_services_pb.rb +13 -2
  12. data/lib/google/cloud/asset/v1/assets_pb.rb +29 -1
  13. data/lib/google/cloud/asset/v1/version.rb +1 -1
  14. data/proto_docs/google/api/resource.rb +12 -12
  15. data/proto_docs/google/cloud/asset/v1/asset_service.rb +235 -74
  16. data/proto_docs/google/cloud/asset/v1/assets.rb +217 -28
  17. data/proto_docs/google/cloud/orgpolicy/v1/orgpolicy.rb +21 -21
  18. data/proto_docs/google/iam/v1/policy.rb +26 -26
  19. data/proto_docs/google/identity/accesscontextmanager/v1/access_level.rb +37 -37
  20. data/proto_docs/google/identity/accesscontextmanager/v1/access_policy.rb +8 -8
  21. data/proto_docs/google/identity/accesscontextmanager/v1/service_perimeter.rb +21 -21
  22. data/proto_docs/google/longrunning/operations.rb +30 -30
  23. data/proto_docs/google/protobuf/any.rb +4 -4
  24. data/proto_docs/google/protobuf/empty.rb +2 -2
  25. data/proto_docs/google/protobuf/field_mask.rb +3 -3
  26. data/proto_docs/google/protobuf/struct.rb +18 -18
  27. data/proto_docs/google/protobuf/timestamp.rb +4 -4
  28. data/proto_docs/google/rpc/status.rb +6 -6
  29. data/proto_docs/google/type/expr.rb +6 -6
  30. metadata +32 -5
  31. data/lib/google/cloud/common_resources_pb.rb +0 -15
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: fbb4372d981825e8ce3c0a7f02a6fb309b80d5eb0461a19cfe96f6993582a5f1
4
- data.tar.gz: 021a0bc123388102bae0d73a8c633af50850e73a4663db5096941e30cdbfc758
3
+ metadata.gz: 4cd675722292c39ebd65ef783e6c66b16e1da00d186e2cdc38075353a4cb2040
4
+ data.tar.gz: d3799a1c1f4c8cdddbd754b0b0d57937b389e8cf94a8965bb65772f84295ce1b
5
5
  SHA512:
6
- metadata.gz: 005d22cb6b6d3e92d266862a0e320a39693dd6c5a6fd2836a402c8e46a9af925b67a48e7078466634fd5230b639b643578d64667cbe91ca26d3bfcd0876da57d
7
- data.tar.gz: b1e71821afea9caea0d4ab1e97cbb4c97cca95ae4f35d21fe3bd7e5c25c876e3e818b729b4a588c85d413c89cc6d0eef98af8744b40e9c6791034f1d505d3f20
6
+ metadata.gz: fe1e023fe812625b51f399ffffd5fc4f0004caea5fb6f84bd56c367053678efd17f4131e7a93511a18ff1e680dd78f71fabf300e6a0c50c0a765eda0de7b6f51
7
+ data.tar.gz: af1344a7910432823015326c3b72a143280523bd3e2ef53d02f5c5408e6474c3f50e61573ccea3f38cdbefcdd396113500a1dd27e1d7f3da8151d268f2d54807
data/AUTHENTICATION.md CHANGED
@@ -27,7 +27,7 @@ export ASSET_CREDENTIALS=path/to/keyfile.json
27
27
  ```ruby
28
28
  require "google/cloud/asset/v1"
29
29
 
30
- client = Google::Cloud::Asset::V1::AssetService::Client.new
30
+ client = ::Google::Cloud::Asset::V1::AssetService::Client.new
31
31
  ```
32
32
 
33
33
  ## Credential Lookup
@@ -64,7 +64,7 @@ containers where writing files is difficult or not encouraged.
64
64
 
65
65
  The environment variables that google-cloud-asset-v1
66
66
  checks for credentials are configured on the service Credentials class (such as
67
- {Google::Cloud::Asset::V1::AssetService::Credentials}):
67
+ {::Google::Cloud::Asset::V1::AssetService::Credentials}):
68
68
 
69
69
  1. `ASSET_CREDENTIALS` - Path to JSON file, or JSON contents
70
70
  2. `ASSET_KEYFILE` - Path to JSON file, or JSON contents
@@ -77,7 +77,7 @@ require "google/cloud/asset/v1"
77
77
 
78
78
  ENV["ASSET_CREDENTIALS"] = "path/to/keyfile.json"
79
79
 
80
- client = Google::Cloud::Asset::V1::AssetService::Client.new
80
+ client = ::Google::Cloud::Asset::V1::AssetService::Client.new
81
81
  ```
82
82
 
83
83
  ### Configuration
@@ -88,7 +88,7 @@ environment variables. Either on an individual client initialization:
88
88
  ```ruby
89
89
  require "google/cloud/asset/v1"
90
90
 
91
- client = Google::Cloud::Asset::V1::AssetService::Client.new do |config|
91
+ client = ::Google::Cloud::Asset::V1::AssetService::Client.new do |config|
92
92
  config.credentials = "path/to/keyfile.json"
93
93
  end
94
94
  ```
@@ -98,11 +98,11 @@ Or configured globally for all clients:
98
98
  ```ruby
99
99
  require "google/cloud/asset/v1"
100
100
 
101
- Google::Cloud::Asset::V1::AssetService::Client.configure do |config|
101
+ ::Google::Cloud::Asset::V1::AssetService::Client.configure do |config|
102
102
  config.credentials = "path/to/keyfile.json"
103
103
  end
104
104
 
105
- client = Google::Cloud::Asset::V1::AssetService::Client.new
105
+ client = ::Google::Cloud::Asset::V1::AssetService::Client.new
106
106
  ```
107
107
 
108
108
  ### Cloud SDK
data/README.md CHANGED
@@ -25,7 +25,7 @@ In order to use this library, you first need to go through the following steps:
25
25
  ```ruby
26
26
  require "google/cloud/asset/v1"
27
27
 
28
- client = Google::Cloud::Asset::V1::AssetService::Client.new
28
+ client = ::Google::Cloud::Asset::V1::AssetService::Client.new
29
29
  request = my_create_request
30
30
  response = client.export_assets request
31
31
  ```
data/lib/google/cloud/asset/v1.rb CHANGED
@@ -26,7 +26,7 @@ module Google
26
26
  # To load this package, including all its services, and instantiate a client:
27
27
  #
28
28
  # require "google/cloud/asset/v1"
29
- # client = Google::Cloud::Asset::V1::AssetService::Client.new
29
+ # client = ::Google::Cloud::Asset::V1::AssetService::Client.new
30
30
  #
31
31
  module V1
32
32
  end
data/lib/google/cloud/asset/v1/asset_service.rb CHANGED
@@ -37,7 +37,7 @@ module Google
37
37
  # To load this service and instantiate a client:
38
38
  #
39
39
  # require "google/cloud/asset/v1/asset_service"
40
- # client = Google::Cloud::Asset::V1::AssetService::Client.new
40
+ # client = ::Google::Cloud::Asset::V1::AssetService::Client.new
41
41
  #
42
42
  module AssetService
43
43
  end
data/lib/google/cloud/asset/v1/asset_service/client.rb CHANGED
@@ -38,15 +38,15 @@ module Google
38
38
  ##
39
39
  # Configure the AssetService Client class.
40
40
  #
41
- # See {Google::Cloud::Asset::V1::AssetService::Client::Configuration}
41
+ # See {::Google::Cloud::Asset::V1::AssetService::Client::Configuration}
42
42
  # for a description of the configuration fields.
43
43
  #
44
44
  # ## Example
45
45
  #
46
46
  # To modify the configuration for all AssetService clients:
47
47
  #
48
- # Google::Cloud::Asset::V1::AssetService::Client.configure do |config|
49
- # config.timeout = 10_000
48
+ # ::Google::Cloud::Asset::V1::AssetService::Client.configure do |config|
49
+ # config.timeout = 10.0
50
50
  # end
51
51
  #
52
52
  # @yield [config] Configure the Client client.
@@ -75,6 +75,22 @@ module Google
75
75
  retry_codes: ["DEADLINE_EXCEEDED", "UNAVAILABLE"]
76
76
  }
77
77
 
78
+ default_config.rpcs.search_all_resources.timeout = 15.0
79
+ default_config.rpcs.search_all_resources.retry_policy = {
80
+ initial_delay: 0.1,
81
+ max_delay: 60.0,
82
+ multiplier: 1.3,
83
+ retry_codes: ["DEADLINE_EXCEEDED", "UNAVAILABLE"]
84
+ }
85
+
86
+ default_config.rpcs.search_all_iam_policies.timeout = 15.0
87
+ default_config.rpcs.search_all_iam_policies.retry_policy = {
88
+ initial_delay: 0.1,
89
+ max_delay: 60.0,
90
+ multiplier: 1.3,
91
+ retry_codes: ["DEADLINE_EXCEEDED", "UNAVAILABLE"]
92
+ }
93
+
78
94
  default_config
79
95
  end
80
96
  yield @configure if block_given?
@@ -88,7 +104,7 @@ module Google
88
104
  # but structural changes (adding new fields, etc.) are not allowed. Structural changes
89
105
  # should be made on {Client.configure}.
90
106
  #
91
- # See {Google::Cloud::Asset::V1::AssetService::Client::Configuration}
107
+ # See {::Google::Cloud::Asset::V1::AssetService::Client::Configuration}
92
108
  # for a description of the configuration fields.
93
109
  #
94
110
  # @yield [config] Configure the Client client.
@@ -109,13 +125,13 @@ module Google
109
125
  # To create a new AssetService client with the default
110
126
  # configuration:
111
127
  #
112
- # client = Google::Cloud::Asset::V1::AssetService::Client.new
128
+ # client = ::Google::Cloud::Asset::V1::AssetService::Client.new
113
129
  #
114
130
  # To create a new AssetService client with a custom
115
131
  # configuration:
116
132
  #
117
- # client = Google::Cloud::Asset::V1::AssetService::Client.new do |config|
118
- # config.timeout = 10_000
133
+ # client = ::Google::Cloud::Asset::V1::AssetService::Client.new do |config|
134
+ # config.timeout = 10.0
119
135
  # end
120
136
  #
121
137
  # @yield [config] Configure the AssetService client.
@@ -140,14 +156,16 @@ module Google
140
156
  if credentials.is_a?(String) || credentials.is_a?(Hash)
141
157
  credentials = Credentials.new credentials, scope: @config.scope
142
158
  end
143
- @quota_project_id = credentials.respond_to?(:quota_project_id) ? credentials.quota_project_id : nil
159
+ @quota_project_id = @config.quota_project
160
+ @quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
144
161
 
145
162
  @operations_client = Operations.new do |config|
146
163
  config.credentials = credentials
164
+ config.endpoint = @config.endpoint
147
165
  end
148
166
 
149
- @asset_service_stub = Gapic::ServiceStub.new(
150
- Google::Cloud::Asset::V1::AssetService::Stub,
167
+ @asset_service_stub = ::Gapic::ServiceStub.new(
168
+ ::Google::Cloud::Asset::V1::AssetService::Stub,
151
169
  credentials: credentials,
152
170
  endpoint: @config.endpoint,
153
171
  channel_args: @config.channel_args,
@@ -155,22 +173,30 @@ module Google
155
173
  )
156
174
  end
157
175
 
176
+ ##
177
+ # Get the associated client for long-running operations.
178
+ #
179
+ # @return [::Google::Cloud::Asset::V1::AssetService::Operations]
180
+ #
181
+ attr_reader :operations_client
182
+
158
183
  # Service calls
159
184
 
160
185
  ##
161
186
  # Exports assets with time and resource types to a given Cloud Storage
162
187
  # location. The output format is newline-delimited JSON.
163
- # This API implements the {Google::Longrunning::Operation google.longrunning.Operation} API allowing you
164
- # to keep track of the export.
188
+ # This API implements the
189
+ # {::Google::Longrunning::Operation google.longrunning.Operation} API allowing
190
+ # you to keep track of the export.
165
191
  #
166
192
  # @overload export_assets(request, options = nil)
167
193
  # Pass arguments to `export_assets` via a request object, either of type
168
- # {Google::Cloud::Asset::V1::ExportAssetsRequest} or an equivalent Hash.
194
+ # {::Google::Cloud::Asset::V1::ExportAssetsRequest} or an equivalent Hash.
169
195
  #
170
- # @param request [Google::Cloud::Asset::V1::ExportAssetsRequest, Hash]
196
+ # @param request [::Google::Cloud::Asset::V1::ExportAssetsRequest, ::Hash]
171
197
  # A request object representing the call parameters. Required. To specify no
172
198
  # parameters, or to keep all the default parameter values, pass an empty Hash.
173
- # @param options [Gapic::CallOptions, Hash]
199
+ # @param options [::Gapic::CallOptions, ::Hash]
174
200
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
175
201
  #
176
202
  # @overload export_assets(parent: nil, read_time: nil, asset_types: nil, content_type: nil, output_config: nil)
@@ -178,51 +204,51 @@ module Google
178
204
  # least one keyword argument is required. To specify no parameters, or to keep all
179
205
  # the default parameter values, pass an empty Hash as a request object (see above).
180
206
  #
181
- # @param parent [String]
207
+ # @param parent [::String]
182
208
  # Required. The relative name of the root asset. This can only be an
183
209
  # organization number (such as "organizations/123"), a project ID (such as
184
210
  # "projects/my-project-id"), or a project number (such as "projects/12345"),
185
211
  # or a folder number (such as "folders/123").
186
- # @param read_time [Google::Protobuf::Timestamp, Hash]
212
+ # @param read_time [::Google::Protobuf::Timestamp, ::Hash]
187
213
  # Timestamp to take an asset snapshot. This can only be set to a timestamp
188
214
  # between the current time and the current time minus 35 days (inclusive).
189
215
  # If not specified, the current time will be used. Due to delays in resource
190
216
  # data collection and indexing, there is a volatile window during which
191
217
  # running the same query may get different results.
192
- # @param asset_types [Array<String>]
218
+ # @param asset_types [::Array<::String>]
193
219
  # A list of asset types of which to take a snapshot for. For example:
194
220
  # "compute.googleapis.com/Disk". If specified, only matching assets will be
195
221
  # returned. See [Introduction to Cloud Asset
196
222
  # Inventory](https://cloud.google.com/asset-inventory/docs/overview)
197
223
  # for all supported asset types.
198
- # @param content_type [Google::Cloud::Asset::V1::ContentType]
224
+ # @param content_type [::Google::Cloud::Asset::V1::ContentType]
199
225
  # Asset content type. If not specified, no content but the asset name will be
200
226
  # returned.
201
- # @param output_config [Google::Cloud::Asset::V1::OutputConfig, Hash]
227
+ # @param output_config [::Google::Cloud::Asset::V1::OutputConfig, ::Hash]
202
228
  # Required. Output configuration indicating where the results will be output
203
229
  # to. All results will be in newline delimited JSON format.
204
230
  #
205
231
  # @yield [response, operation] Access the result along with the RPC operation
206
- # @yieldparam response [Gapic::Operation]
207
- # @yieldparam operation [GRPC::ActiveCall::Operation]
232
+ # @yieldparam response [::Gapic::Operation]
233
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
208
234
  #
209
- # @return [Gapic::Operation]
235
+ # @return [::Gapic::Operation]
210
236
  #
211
- # @raise [Google::Cloud::Error] if the RPC is aborted.
237
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
212
238
  #
213
239
  def export_assets request, options = nil
214
- raise ArgumentError, "request must be provided" if request.nil?
240
+ raise ::ArgumentError, "request must be provided" if request.nil?
215
241
 
216
- request = Gapic::Protobuf.coerce request, to: Google::Cloud::Asset::V1::ExportAssetsRequest
242
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Asset::V1::ExportAssetsRequest
217
243
 
218
244
  # Converts hash and nil to an options object
219
- options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
245
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
220
246
 
221
247
  # Customize the options with defaults
222
248
  metadata = @config.rpcs.export_assets.metadata.to_h
223
249
 
224
250
  # Set x-goog-api-client and x-goog-user-project headers
225
- metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
251
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
226
252
  lib_name: @config.lib_name, lib_version: @config.lib_version,
227
253
  gapic_version: ::Google::Cloud::Asset::V1::VERSION
228
254
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
@@ -240,12 +266,12 @@ module Google
240
266
  retry_policy: @config.retry_policy
241
267
 
242
268
  @asset_service_stub.call_rpc :export_assets, request, options: options do |response, operation|
243
- response = Gapic::Operation.new response, @operations_client, options: options
269
+ response = ::Gapic::Operation.new response, @operations_client, options: options
244
270
  yield response, operation if block_given?
245
271
  return response
246
272
  end
247
- rescue GRPC::BadStatus => e
248
- raise Google::Cloud::Error.from_error(e)
273
+ rescue ::GRPC::BadStatus => e
274
+ raise ::Google::Cloud::Error.from_error(e)
249
275
  end
250
276
 
251
277
  ##
@@ -259,12 +285,12 @@ module Google
259
285
  #
260
286
  # @overload batch_get_assets_history(request, options = nil)
261
287
  # Pass arguments to `batch_get_assets_history` via a request object, either of type
262
- # {Google::Cloud::Asset::V1::BatchGetAssetsHistoryRequest} or an equivalent Hash.
288
+ # {::Google::Cloud::Asset::V1::BatchGetAssetsHistoryRequest} or an equivalent Hash.
263
289
  #
264
- # @param request [Google::Cloud::Asset::V1::BatchGetAssetsHistoryRequest, Hash]
290
+ # @param request [::Google::Cloud::Asset::V1::BatchGetAssetsHistoryRequest, ::Hash]
265
291
  # A request object representing the call parameters. Required. To specify no
266
292
  # parameters, or to keep all the default parameter values, pass an empty Hash.
267
- # @param options [Gapic::CallOptions, Hash]
293
+ # @param options [::Gapic::CallOptions, ::Hash]
268
294
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
269
295
  #
270
296
  # @overload batch_get_assets_history(parent: nil, asset_names: nil, content_type: nil, read_time_window: nil)
@@ -272,11 +298,11 @@ module Google
272
298
  # least one keyword argument is required. To specify no parameters, or to keep all
273
299
  # the default parameter values, pass an empty Hash as a request object (see above).
274
300
  #
275
- # @param parent [String]
301
+ # @param parent [::String]
276
302
  # Required. The relative name of the root asset. It can only be an
277
303
  # organization number (such as "organizations/123"), a project ID (such as
278
304
  # "projects/my-project-id")", or a project number (such as "projects/12345").
279
- # @param asset_names [Array<String>]
305
+ # @param asset_names [::Array<::String>]
280
306
  # A list of the full names of the assets. For example:
281
307
  # `//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1`.
282
308
  # See [Resource
@@ -287,9 +313,9 @@ module Google
287
313
  #
288
314
  # The request becomes a no-op if the asset name list is empty, and the max
289
315
  # size of the asset name list is 100 in one request.
290
- # @param content_type [Google::Cloud::Asset::V1::ContentType]
316
+ # @param content_type [::Google::Cloud::Asset::V1::ContentType]
291
317
  # Optional. The content type.
292
- # @param read_time_window [Google::Cloud::Asset::V1::TimeWindow, Hash]
318
+ # @param read_time_window [::Google::Cloud::Asset::V1::TimeWindow, ::Hash]
293
319
  # Optional. The time window for the asset history. Both start_time and
294
320
  # end_time are optional and if set, it must be after the current time minus
295
321
  # 35 days. If end_time is not set, it is default to current timestamp.
@@ -298,26 +324,26 @@ module Google
298
324
  # window overlap with read_time_window.
299
325
  #
300
326
  # @yield [response, operation] Access the result along with the RPC operation
301
- # @yieldparam response [Google::Cloud::Asset::V1::BatchGetAssetsHistoryResponse]
302
- # @yieldparam operation [GRPC::ActiveCall::Operation]
327
+ # @yieldparam response [::Google::Cloud::Asset::V1::BatchGetAssetsHistoryResponse]
328
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
303
329
  #
304
- # @return [Google::Cloud::Asset::V1::BatchGetAssetsHistoryResponse]
330
+ # @return [::Google::Cloud::Asset::V1::BatchGetAssetsHistoryResponse]
305
331
  #
306
- # @raise [Google::Cloud::Error] if the RPC is aborted.
332
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
307
333
  #
308
334
  def batch_get_assets_history request, options = nil
309
- raise ArgumentError, "request must be provided" if request.nil?
335
+ raise ::ArgumentError, "request must be provided" if request.nil?
310
336
 
311
- request = Gapic::Protobuf.coerce request, to: Google::Cloud::Asset::V1::BatchGetAssetsHistoryRequest
337
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Asset::V1::BatchGetAssetsHistoryRequest
312
338
 
313
339
  # Converts hash and nil to an options object
314
- options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
340
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
315
341
 
316
342
  # Customize the options with defaults
317
343
  metadata = @config.rpcs.batch_get_assets_history.metadata.to_h
318
344
 
319
345
  # Set x-goog-api-client and x-goog-user-project headers
320
- metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
346
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
321
347
  lib_name: @config.lib_name, lib_version: @config.lib_version,
322
348
  gapic_version: ::Google::Cloud::Asset::V1::VERSION
323
349
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
@@ -338,8 +364,8 @@ module Google
338
364
  yield response, operation if block_given?
339
365
  return response
340
366
  end
341
- rescue GRPC::BadStatus => e
342
- raise Google::Cloud::Error.from_error(e)
367
+ rescue ::GRPC::BadStatus => e
368
+ raise ::Google::Cloud::Error.from_error(e)
343
369
  end
344
370
 
345
371
  ##
@@ -348,12 +374,12 @@ module Google
348
374
  #
349
375
  # @overload create_feed(request, options = nil)
350
376
  # Pass arguments to `create_feed` via a request object, either of type
351
- # {Google::Cloud::Asset::V1::CreateFeedRequest} or an equivalent Hash.
377
+ # {::Google::Cloud::Asset::V1::CreateFeedRequest} or an equivalent Hash.
352
378
  #
353
- # @param request [Google::Cloud::Asset::V1::CreateFeedRequest, Hash]
379
+ # @param request [::Google::Cloud::Asset::V1::CreateFeedRequest, ::Hash]
354
380
  # A request object representing the call parameters. Required. To specify no
355
381
  # parameters, or to keep all the default parameter values, pass an empty Hash.
356
- # @param options [Gapic::CallOptions, Hash]
382
+ # @param options [::Gapic::CallOptions, ::Hash]
357
383
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
358
384
  #
359
385
  # @overload create_feed(parent: nil, feed_id: nil, feed: nil)
@@ -361,43 +387,42 @@ module Google
361
387
  # least one keyword argument is required. To specify no parameters, or to keep all
362
388
  # the default parameter values, pass an empty Hash as a request object (see above).
363
389
  #
364
- # @param parent [String]
390
+ # @param parent [::String]
365
391
  # Required. The name of the project/folder/organization where this feed
366
392
  # should be created in. It can only be an organization number (such as
367
393
  # "organizations/123"), a folder number (such as "folders/123"), a project ID
368
394
  # (such as "projects/my-project-id")", or a project number (such as
369
395
  # "projects/12345").
370
- # @param feed_id [String]
396
+ # @param feed_id [::String]
371
397
  # Required. This is the client-assigned asset feed identifier and it needs to
372
398
  # be unique under a specific parent project/folder/organization.
373
- # @param feed [Google::Cloud::Asset::V1::Feed, Hash]
374
- # Required. The feed details. The field `name` must be empty and it will be generated
375
- # in the format of:
376
- # projects/project_number/feeds/feed_id
399
+ # @param feed [::Google::Cloud::Asset::V1::Feed, ::Hash]
400
+ # Required. The feed details. The field `name` must be empty and it will be
401
+ # generated in the format of: projects/project_number/feeds/feed_id
377
402
  # folders/folder_number/feeds/feed_id
378
403
  # organizations/organization_number/feeds/feed_id
379
404
  #
380
405
  # @yield [response, operation] Access the result along with the RPC operation
381
- # @yieldparam response [Google::Cloud::Asset::V1::Feed]
382
- # @yieldparam operation [GRPC::ActiveCall::Operation]
406
+ # @yieldparam response [::Google::Cloud::Asset::V1::Feed]
407
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
383
408
  #
384
- # @return [Google::Cloud::Asset::V1::Feed]
409
+ # @return [::Google::Cloud::Asset::V1::Feed]
385
410
  #
386
- # @raise [Google::Cloud::Error] if the RPC is aborted.
411
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
387
412
  #
388
413
  def create_feed request, options = nil
389
- raise ArgumentError, "request must be provided" if request.nil?
414
+ raise ::ArgumentError, "request must be provided" if request.nil?
390
415
 
391
- request = Gapic::Protobuf.coerce request, to: Google::Cloud::Asset::V1::CreateFeedRequest
416
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Asset::V1::CreateFeedRequest
392
417
 
393
418
  # Converts hash and nil to an options object
394
- options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
419
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
395
420
 
396
421
  # Customize the options with defaults
397
422
  metadata = @config.rpcs.create_feed.metadata.to_h
398
423
 
399
424
  # Set x-goog-api-client and x-goog-user-project headers
400
- metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
425
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
401
426
  lib_name: @config.lib_name, lib_version: @config.lib_version,
402
427
  gapic_version: ::Google::Cloud::Asset::V1::VERSION
403
428
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
@@ -418,8 +443,8 @@ module Google
418
443
  yield response, operation if block_given?
419
444
  return response
420
445
  end
421
- rescue GRPC::BadStatus => e
422
- raise Google::Cloud::Error.from_error(e)
446
+ rescue ::GRPC::BadStatus => e
447
+ raise ::Google::Cloud::Error.from_error(e)
423
448
  end
424
449
 
425
450
  ##
@@ -427,12 +452,12 @@ module Google
427
452
  #
428
453
  # @overload get_feed(request, options = nil)
429
454
  # Pass arguments to `get_feed` via a request object, either of type
430
- # {Google::Cloud::Asset::V1::GetFeedRequest} or an equivalent Hash.
455
+ # {::Google::Cloud::Asset::V1::GetFeedRequest} or an equivalent Hash.
431
456
  #
432
- # @param request [Google::Cloud::Asset::V1::GetFeedRequest, Hash]
457
+ # @param request [::Google::Cloud::Asset::V1::GetFeedRequest, ::Hash]
433
458
  # A request object representing the call parameters. Required. To specify no
434
459
  # parameters, or to keep all the default parameter values, pass an empty Hash.
435
- # @param options [Gapic::CallOptions, Hash]
460
+ # @param options [::Gapic::CallOptions, ::Hash]
436
461
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
437
462
  #
438
463
  # @overload get_feed(name: nil)
@@ -440,33 +465,33 @@ module Google
440
465
  # least one keyword argument is required. To specify no parameters, or to keep all
441
466
  # the default parameter values, pass an empty Hash as a request object (see above).
442
467
  #
443
- # @param name [String]
468
+ # @param name [::String]
444
469
  # Required. The name of the Feed and it must be in the format of:
445
470
  # projects/project_number/feeds/feed_id
446
471
  # folders/folder_number/feeds/feed_id
447
472
  # organizations/organization_number/feeds/feed_id
448
473
  #
449
474
  # @yield [response, operation] Access the result along with the RPC operation
450
- # @yieldparam response [Google::Cloud::Asset::V1::Feed]
451
- # @yieldparam operation [GRPC::ActiveCall::Operation]
475
+ # @yieldparam response [::Google::Cloud::Asset::V1::Feed]
476
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
452
477
  #
453
- # @return [Google::Cloud::Asset::V1::Feed]
478
+ # @return [::Google::Cloud::Asset::V1::Feed]
454
479
  #
455
- # @raise [Google::Cloud::Error] if the RPC is aborted.
480
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
456
481
  #
457
482
  def get_feed request, options = nil
458
- raise ArgumentError, "request must be provided" if request.nil?
483
+ raise ::ArgumentError, "request must be provided" if request.nil?
459
484
 
460
- request = Gapic::Protobuf.coerce request, to: Google::Cloud::Asset::V1::GetFeedRequest
485
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Asset::V1::GetFeedRequest
461
486
 
462
487
  # Converts hash and nil to an options object
463
- options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
488
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
464
489
 
465
490
  # Customize the options with defaults
466
491
  metadata = @config.rpcs.get_feed.metadata.to_h
467
492
 
468
493
  # Set x-goog-api-client and x-goog-user-project headers
469
- metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
494
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
470
495
  lib_name: @config.lib_name, lib_version: @config.lib_version,
471
496
  gapic_version: ::Google::Cloud::Asset::V1::VERSION
472
497
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
@@ -487,8 +512,8 @@ module Google
487
512
  yield response, operation if block_given?
488
513
  return response
489
514
  end
490
- rescue GRPC::BadStatus => e
491
- raise Google::Cloud::Error.from_error(e)
515
+ rescue ::GRPC::BadStatus => e
516
+ raise ::Google::Cloud::Error.from_error(e)
492
517
  end
493
518
 
494
519
  ##
@@ -496,12 +521,12 @@ module Google
496
521
  #
497
522
  # @overload list_feeds(request, options = nil)
498
523
  # Pass arguments to `list_feeds` via a request object, either of type
499
- # {Google::Cloud::Asset::V1::ListFeedsRequest} or an equivalent Hash.
524
+ # {::Google::Cloud::Asset::V1::ListFeedsRequest} or an equivalent Hash.
500
525
  #
501
- # @param request [Google::Cloud::Asset::V1::ListFeedsRequest, Hash]
526
+ # @param request [::Google::Cloud::Asset::V1::ListFeedsRequest, ::Hash]
502
527
  # A request object representing the call parameters. Required. To specify no
503
528
  # parameters, or to keep all the default parameter values, pass an empty Hash.
504
- # @param options [Gapic::CallOptions, Hash]
529
+ # @param options [::Gapic::CallOptions, ::Hash]
505
530
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
506
531
  #
507
532
  # @overload list_feeds(parent: nil)
@@ -509,32 +534,32 @@ module Google
509
534
  # least one keyword argument is required. To specify no parameters, or to keep all
510
535
  # the default parameter values, pass an empty Hash as a request object (see above).
511
536
  #
512
- # @param parent [String]
537
+ # @param parent [::String]
513
538
  # Required. The parent project/folder/organization whose feeds are to be
514
539
  # listed. It can only be using project/folder/organization number (such as
515
540
  # "folders/12345")", or a project ID (such as "projects/my-project-id").
516
541
  #
517
542
  # @yield [response, operation] Access the result along with the RPC operation
518
- # @yieldparam response [Google::Cloud::Asset::V1::ListFeedsResponse]
519
- # @yieldparam operation [GRPC::ActiveCall::Operation]
543
+ # @yieldparam response [::Google::Cloud::Asset::V1::ListFeedsResponse]
544
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
520
545
  #
521
- # @return [Google::Cloud::Asset::V1::ListFeedsResponse]
546
+ # @return [::Google::Cloud::Asset::V1::ListFeedsResponse]
522
547
  #
523
- # @raise [Google::Cloud::Error] if the RPC is aborted.
548
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
524
549
  #
525
550
  def list_feeds request, options = nil
526
- raise ArgumentError, "request must be provided" if request.nil?
551
+ raise ::ArgumentError, "request must be provided" if request.nil?
527
552
 
528
- request = Gapic::Protobuf.coerce request, to: Google::Cloud::Asset::V1::ListFeedsRequest
553
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Asset::V1::ListFeedsRequest
529
554
 
530
555
  # Converts hash and nil to an options object
531
- options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
556
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
532
557
 
533
558
  # Customize the options with defaults
534
559
  metadata = @config.rpcs.list_feeds.metadata.to_h
535
560
 
536
561
  # Set x-goog-api-client and x-goog-user-project headers
537
- metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
562
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
538
563
  lib_name: @config.lib_name, lib_version: @config.lib_version,
539
564
  gapic_version: ::Google::Cloud::Asset::V1::VERSION
540
565
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
@@ -555,8 +580,8 @@ module Google
555
580
  yield response, operation if block_given?
556
581
  return response
557
582
  end
558
- rescue GRPC::BadStatus => e
559
- raise Google::Cloud::Error.from_error(e)
583
+ rescue ::GRPC::BadStatus => e
584
+ raise ::Google::Cloud::Error.from_error(e)
560
585
  end
561
586
 
562
587
  ##
@@ -564,12 +589,12 @@ module Google
564
589
  #
565
590
  # @overload update_feed(request, options = nil)
566
591
  # Pass arguments to `update_feed` via a request object, either of type
567
- # {Google::Cloud::Asset::V1::UpdateFeedRequest} or an equivalent Hash.
592
+ # {::Google::Cloud::Asset::V1::UpdateFeedRequest} or an equivalent Hash.
568
593
  #
569
- # @param request [Google::Cloud::Asset::V1::UpdateFeedRequest, Hash]
594
+ # @param request [::Google::Cloud::Asset::V1::UpdateFeedRequest, ::Hash]
570
595
  # A request object representing the call parameters. Required. To specify no
571
596
  # parameters, or to keep all the default parameter values, pass an empty Hash.
572
- # @param options [Gapic::CallOptions, Hash]
597
+ # @param options [::Gapic::CallOptions, ::Hash]
573
598
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
574
599
  #
575
600
  # @overload update_feed(feed: nil, update_mask: nil)
@@ -577,38 +602,38 @@ module Google
577
602
  # least one keyword argument is required. To specify no parameters, or to keep all
578
603
  # the default parameter values, pass an empty Hash as a request object (see above).
579
604
  #
580
- # @param feed [Google::Cloud::Asset::V1::Feed, Hash]
581
- # Required. The new values of feed details. It must match an existing feed and the
582
- # field `name` must be in the format of:
605
+ # @param feed [::Google::Cloud::Asset::V1::Feed, ::Hash]
606
+ # Required. The new values of feed details. It must match an existing feed
607
+ # and the field `name` must be in the format of:
583
608
  # projects/project_number/feeds/feed_id or
584
609
  # folders/folder_number/feeds/feed_id or
585
610
  # organizations/organization_number/feeds/feed_id.
586
- # @param update_mask [Google::Protobuf::FieldMask, Hash]
611
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
587
612
  # Required. Only updates the `feed` fields indicated by this mask.
588
613
  # The field mask must not be empty, and it must not contain fields that
589
614
  # are immutable or only set by the server.
590
615
  #
591
616
  # @yield [response, operation] Access the result along with the RPC operation
592
- # @yieldparam response [Google::Cloud::Asset::V1::Feed]
593
- # @yieldparam operation [GRPC::ActiveCall::Operation]
617
+ # @yieldparam response [::Google::Cloud::Asset::V1::Feed]
618
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
594
619
  #
595
- # @return [Google::Cloud::Asset::V1::Feed]
620
+ # @return [::Google::Cloud::Asset::V1::Feed]
596
621
  #
597
- # @raise [Google::Cloud::Error] if the RPC is aborted.
622
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
598
623
  #
599
624
  def update_feed request, options = nil
600
- raise ArgumentError, "request must be provided" if request.nil?
625
+ raise ::ArgumentError, "request must be provided" if request.nil?
601
626
 
602
- request = Gapic::Protobuf.coerce request, to: Google::Cloud::Asset::V1::UpdateFeedRequest
627
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Asset::V1::UpdateFeedRequest
603
628
 
604
629
  # Converts hash and nil to an options object
605
- options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
630
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
606
631
 
607
632
  # Customize the options with defaults
608
633
  metadata = @config.rpcs.update_feed.metadata.to_h
609
634
 
610
635
  # Set x-goog-api-client and x-goog-user-project headers
611
- metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
636
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
612
637
  lib_name: @config.lib_name, lib_version: @config.lib_version,
613
638
  gapic_version: ::Google::Cloud::Asset::V1::VERSION
614
639
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
@@ -629,8 +654,8 @@ module Google
629
654
  yield response, operation if block_given?
630
655
  return response
631
656
  end
632
- rescue GRPC::BadStatus => e
633
- raise Google::Cloud::Error.from_error(e)
657
+ rescue ::GRPC::BadStatus => e
658
+ raise ::Google::Cloud::Error.from_error(e)
634
659
  end
635
660
 
636
661
  ##
@@ -638,12 +663,12 @@ module Google
638
663
  #
639
664
  # @overload delete_feed(request, options = nil)
640
665
  # Pass arguments to `delete_feed` via a request object, either of type
641
- # {Google::Cloud::Asset::V1::DeleteFeedRequest} or an equivalent Hash.
666
+ # {::Google::Cloud::Asset::V1::DeleteFeedRequest} or an equivalent Hash.
642
667
  #
643
- # @param request [Google::Cloud::Asset::V1::DeleteFeedRequest, Hash]
668
+ # @param request [::Google::Cloud::Asset::V1::DeleteFeedRequest, ::Hash]
644
669
  # A request object representing the call parameters. Required. To specify no
645
670
  # parameters, or to keep all the default parameter values, pass an empty Hash.
646
- # @param options [Gapic::CallOptions, Hash]
671
+ # @param options [::Gapic::CallOptions, ::Hash]
647
672
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
648
673
  #
649
674
  # @overload delete_feed(name: nil)
@@ -651,33 +676,33 @@ module Google
651
676
  # least one keyword argument is required. To specify no parameters, or to keep all
652
677
  # the default parameter values, pass an empty Hash as a request object (see above).
653
678
  #
654
- # @param name [String]
679
+ # @param name [::String]
655
680
  # Required. The name of the feed and it must be in the format of:
656
681
  # projects/project_number/feeds/feed_id
657
682
  # folders/folder_number/feeds/feed_id
658
683
  # organizations/organization_number/feeds/feed_id
659
684
  #
660
685
  # @yield [response, operation] Access the result along with the RPC operation
661
- # @yieldparam response [Google::Protobuf::Empty]
662
- # @yieldparam operation [GRPC::ActiveCall::Operation]
686
+ # @yieldparam response [::Google::Protobuf::Empty]
687
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
663
688
  #
664
- # @return [Google::Protobuf::Empty]
689
+ # @return [::Google::Protobuf::Empty]
665
690
  #
666
- # @raise [Google::Cloud::Error] if the RPC is aborted.
691
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
667
692
  #
668
693
  def delete_feed request, options = nil
669
- raise ArgumentError, "request must be provided" if request.nil?
694
+ raise ::ArgumentError, "request must be provided" if request.nil?
670
695
 
671
- request = Gapic::Protobuf.coerce request, to: Google::Cloud::Asset::V1::DeleteFeedRequest
696
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Asset::V1::DeleteFeedRequest
672
697
 
673
698
  # Converts hash and nil to an options object
674
- options = Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
699
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
675
700
 
676
701
  # Customize the options with defaults
677
702
  metadata = @config.rpcs.delete_feed.metadata.to_h
678
703
 
679
704
  # Set x-goog-api-client and x-goog-user-project headers
680
- metadata[:"x-goog-api-client"] ||= Gapic::Headers.x_goog_api_client \
705
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
681
706
  lib_name: @config.lib_name, lib_version: @config.lib_version,
682
707
  gapic_version: ::Google::Cloud::Asset::V1::VERSION
683
708
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
@@ -698,8 +723,252 @@ module Google
698
723
  yield response, operation if block_given?
699
724
  return response
700
725
  end
701
- rescue GRPC::BadStatus => e
702
- raise Google::Cloud::Error.from_error(e)
726
+ rescue ::GRPC::BadStatus => e
727
+ raise ::Google::Cloud::Error.from_error(e)
728
+ end
729
+
730
+ ##
731
+ # Searches all the resources within the given accessible scope (e.g., a
732
+ # project, a folder or an organization). Callers should have
733
+ # cloud.assets.SearchAllResources permission upon the requested scope,
734
+ # otherwise the request will be rejected.
735
+ #
736
+ # @overload search_all_resources(request, options = nil)
737
+ # Pass arguments to `search_all_resources` via a request object, either of type
738
+ # {::Google::Cloud::Asset::V1::SearchAllResourcesRequest} or an equivalent Hash.
739
+ #
740
+ # @param request [::Google::Cloud::Asset::V1::SearchAllResourcesRequest, ::Hash]
741
+ # A request object representing the call parameters. Required. To specify no
742
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
743
+ # @param options [::Gapic::CallOptions, ::Hash]
744
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
745
+ #
746
+ # @overload search_all_resources(scope: nil, query: nil, asset_types: nil, page_size: nil, page_token: nil, order_by: nil)
747
+ # Pass arguments to `search_all_resources` via keyword arguments. Note that at
748
+ # least one keyword argument is required. To specify no parameters, or to keep all
749
+ # the default parameter values, pass an empty Hash as a request object (see above).
750
+ #
751
+ # @param scope [::String]
752
+ # Required. A scope can be a project, a folder or an organization. The search
753
+ # is limited to the resources within the `scope`.
754
+ #
755
+ # The allowed values are:
756
+ #
757
+ # * projects/\\{PROJECT_ID}
758
+ # * projects/\\{PROJECT_NUMBER}
759
+ # * folders/\\{FOLDER_NUMBER}
760
+ # * organizations/\\{ORGANIZATION_NUMBER}
761
+ # @param query [::String]
762
+ # Optional. The query statement. An empty query can be specified to search
763
+ # all the resources of certain `asset_types` within the given `scope`.
764
+ #
765
+ # Examples:
766
+ #
767
+ # * `name : "Important"` to find Cloud resources whose name contains
768
+ # "Important" as a word.
769
+ # * `displayName : "Impor*"` to find Cloud resources whose display name
770
+ # contains "Impor" as a word prefix.
771
+ # * `description : "*por*"` to find Cloud resources whose description
772
+ # contains "por" as a substring.
773
+ # * `location : "us-west*"` to find Cloud resources whose location is
774
+ # prefixed with "us-west".
775
+ # * `labels : "prod"` to find Cloud resources whose labels contain "prod" as
776
+ # a key or value.
777
+ # * `labels.env : "prod"` to find Cloud resources which have a label "env"
778
+ # and its value is "prod".
779
+ # * `labels.env : *` to find Cloud resources which have a label "env".
780
+ # * `"Important"` to find Cloud resources which contain "Important" as a word
781
+ # in any of the searchable fields.
782
+ # * `"Impor*"` to find Cloud resources which contain "Impor" as a word prefix
783
+ # in any of the searchable fields.
784
+ # * `"*por*"` to find Cloud resources which contain "por" as a substring in
785
+ # any of the searchable fields.
786
+ # * `("Important" AND location : ("us-west1" OR "global"))` to find Cloud
787
+ # resources which contain "Important" as a word in any of the searchable
788
+ # fields and are also located in the "us-west1" region or the "global"
789
+ # location.
790
+ #
791
+ # See [how to construct a
792
+ # query](https://cloud.google.com/asset-inventory/docs/searching-resources#how_to_construct_a_query)
793
+ # for more details.
794
+ # @param asset_types [::Array<::String>]
795
+ # Optional. A list of asset types that this request searches for. If empty,
796
+ # it will search all the [searchable asset
797
+ # types](https://cloud.google.com/asset-inventory/docs/supported-asset-types#searchable_asset_types).
798
+ # @param page_size [::Integer]
799
+ # Optional. The page size for search result pagination. Page size is capped
800
+ # at 500 even if a larger value is given. If set to zero, server will pick an
801
+ # appropriate default. Returned results may be fewer than requested. When
802
+ # this happens, there could be more results as long as `next_page_token` is
803
+ # returned.
804
+ # @param page_token [::String]
805
+ # Optional. If present, then retrieve the next batch of results from the
806
+ # preceding call to this method. `page_token` must be the value of
807
+ # `next_page_token` from the previous response. The values of all other
808
+ # method parameters, must be identical to those in the previous call.
809
+ # @param order_by [::String]
810
+ # Optional. A comma separated list of fields specifying the sorting order of
811
+ # the results. The default order is ascending. Add " DESC" after the field
812
+ # name to indicate descending order. Redundant space characters are ignored.
813
+ # Example: "location DESC, name". See [supported resource metadata
814
+ # fields](https://cloud.google.com/asset-inventory/docs/searching-resources#query_on_resource_metadata_fields)
815
+ # for more details.
816
+ #
817
+ # @yield [response, operation] Access the result along with the RPC operation
818
+ # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::Asset::V1::ResourceSearchResult>]
819
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
820
+ #
821
+ # @return [::Gapic::PagedEnumerable<::Google::Cloud::Asset::V1::ResourceSearchResult>]
822
+ #
823
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
824
+ #
825
+ def search_all_resources request, options = nil
826
+ raise ::ArgumentError, "request must be provided" if request.nil?
827
+
828
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Asset::V1::SearchAllResourcesRequest
829
+
830
+ # Converts hash and nil to an options object
831
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
832
+
833
+ # Customize the options with defaults
834
+ metadata = @config.rpcs.search_all_resources.metadata.to_h
835
+
836
+ # Set x-goog-api-client and x-goog-user-project headers
837
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
838
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
839
+ gapic_version: ::Google::Cloud::Asset::V1::VERSION
840
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
841
+
842
+ header_params = {
843
+ "scope" => request.scope
844
+ }
845
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
846
+ metadata[:"x-goog-request-params"] ||= request_params_header
847
+
848
+ options.apply_defaults timeout: @config.rpcs.search_all_resources.timeout,
849
+ metadata: metadata,
850
+ retry_policy: @config.rpcs.search_all_resources.retry_policy
851
+ options.apply_defaults metadata: @config.metadata,
852
+ retry_policy: @config.retry_policy
853
+
854
+ @asset_service_stub.call_rpc :search_all_resources, request, options: options do |response, operation|
855
+ response = ::Gapic::PagedEnumerable.new @asset_service_stub, :search_all_resources, request, response, operation, options
856
+ yield response, operation if block_given?
857
+ return response
858
+ end
859
+ rescue ::GRPC::BadStatus => e
860
+ raise ::Google::Cloud::Error.from_error(e)
861
+ end
862
+
863
+ ##
864
+ # Searches all the IAM policies within the given accessible scope (e.g., a
865
+ # project, a folder or an organization). Callers should have
866
+ # cloud.assets.SearchAllIamPolicies permission upon the requested scope,
867
+ # otherwise the request will be rejected.
868
+ #
869
+ # @overload search_all_iam_policies(request, options = nil)
870
+ # Pass arguments to `search_all_iam_policies` via a request object, either of type
871
+ # {::Google::Cloud::Asset::V1::SearchAllIamPoliciesRequest} or an equivalent Hash.
872
+ #
873
+ # @param request [::Google::Cloud::Asset::V1::SearchAllIamPoliciesRequest, ::Hash]
874
+ # A request object representing the call parameters. Required. To specify no
875
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
876
+ # @param options [::Gapic::CallOptions, ::Hash]
877
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
878
+ #
879
+ # @overload search_all_iam_policies(scope: nil, query: nil, page_size: nil, page_token: nil)
880
+ # Pass arguments to `search_all_iam_policies` via keyword arguments. Note that at
881
+ # least one keyword argument is required. To specify no parameters, or to keep all
882
+ # the default parameter values, pass an empty Hash as a request object (see above).
883
+ #
884
+ # @param scope [::String]
885
+ # Required. A scope can be a project, a folder or an organization. The search
886
+ # is limited to the IAM policies within the `scope`.
887
+ #
888
+ # The allowed values are:
889
+ #
890
+ # * projects/\\{PROJECT_ID}
891
+ # * projects/\\{PROJECT_NUMBER}
892
+ # * folders/\\{FOLDER_NUMBER}
893
+ # * organizations/\\{ORGANIZATION_NUMBER}
894
+ # @param query [::String]
895
+ # Optional. The query statement. An empty query can be specified to search
896
+ # all the IAM policies within the given `scope`.
897
+ #
898
+ # Examples:
899
+ #
900
+ # * `policy : "amy@gmail.com"` to find Cloud IAM policy bindings that
901
+ # specify user "amy@gmail.com".
902
+ # * `policy : "roles/compute.admin"` to find Cloud IAM policy bindings that
903
+ # specify the Compute Admin role.
904
+ # * `policy.role.permissions : "storage.buckets.update"` to find Cloud IAM
905
+ # policy bindings that specify a role containing "storage.buckets.update"
906
+ # permission.
907
+ # * `resource : "organizations/123"` to find Cloud IAM policy bindings that
908
+ # are set on "organizations/123".
909
+ # * `(resource : ("organizations/123" OR "folders/1234") AND policy : "amy")`
910
+ # to find Cloud IAM policy bindings that are set on "organizations/123" or
911
+ # "folders/1234", and also specify user "amy".
912
+ #
913
+ # See [how to construct a
914
+ # query](https://cloud.google.com/asset-inventory/docs/searching-iam-policies#how_to_construct_a_query)
915
+ # for more details.
916
+ # @param page_size [::Integer]
917
+ # Optional. The page size for search result pagination. Page size is capped
918
+ # at 500 even if a larger value is given. If set to zero, server will pick an
919
+ # appropriate default. Returned results may be fewer than requested. When
920
+ # this happens, there could be more results as long as `next_page_token` is
921
+ # returned.
922
+ # @param page_token [::String]
923
+ # Optional. If present, retrieve the next batch of results from the preceding
924
+ # call to this method. `page_token` must be the value of `next_page_token`
925
+ # from the previous response. The values of all other method parameters must
926
+ # be identical to those in the previous call.
927
+ #
928
+ # @yield [response, operation] Access the result along with the RPC operation
929
+ # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::Asset::V1::IamPolicySearchResult>]
930
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
931
+ #
932
+ # @return [::Gapic::PagedEnumerable<::Google::Cloud::Asset::V1::IamPolicySearchResult>]
933
+ #
934
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
935
+ #
936
+ def search_all_iam_policies request, options = nil
937
+ raise ::ArgumentError, "request must be provided" if request.nil?
938
+
939
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Asset::V1::SearchAllIamPoliciesRequest
940
+
941
+ # Converts hash and nil to an options object
942
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
943
+
944
+ # Customize the options with defaults
945
+ metadata = @config.rpcs.search_all_iam_policies.metadata.to_h
946
+
947
+ # Set x-goog-api-client and x-goog-user-project headers
948
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
949
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
950
+ gapic_version: ::Google::Cloud::Asset::V1::VERSION
951
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
952
+
953
+ header_params = {
954
+ "scope" => request.scope
955
+ }
956
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
957
+ metadata[:"x-goog-request-params"] ||= request_params_header
958
+
959
+ options.apply_defaults timeout: @config.rpcs.search_all_iam_policies.timeout,
960
+ metadata: metadata,
961
+ retry_policy: @config.rpcs.search_all_iam_policies.retry_policy
962
+ options.apply_defaults metadata: @config.metadata,
963
+ retry_policy: @config.retry_policy
964
+
965
+ @asset_service_stub.call_rpc :search_all_iam_policies, request, options: options do |response, operation|
966
+ response = ::Gapic::PagedEnumerable.new @asset_service_stub, :search_all_iam_policies, request, response, operation, options
967
+ yield response, operation if block_given?
968
+ return response
969
+ end
970
+ rescue ::GRPC::BadStatus => e
971
+ raise ::Google::Cloud::Error.from_error(e)
703
972
  end
704
973
 
705
974
  ##
@@ -709,7 +978,7 @@ module Google
709
978
  # providing control over timeouts, retry behavior, logging, transport
710
979
  # parameters, and other low-level controls. Certain parameters can also be
711
980
  # applied individually to specific RPCs. See
712
- # {Google::Cloud::Asset::V1::AssetService::Client::Configuration::Rpcs}
981
+ # {::Google::Cloud::Asset::V1::AssetService::Client::Configuration::Rpcs}
713
982
  # for a list of RPCs that can be configured independently.
714
983
  #
715
984
  # Configuration can be applied globally to all clients, or to a single client
@@ -720,22 +989,22 @@ module Google
720
989
  # To modify the global config, setting the timeout for export_assets
721
990
  # to 20 seconds, and all remaining timeouts to 10 seconds:
722
991
  #
723
- # Google::Cloud::Asset::V1::AssetService::Client.configure do |config|
724
- # config.timeout = 10_000
725
- # config.rpcs.export_assets.timeout = 20_000
992
+ # ::Google::Cloud::Asset::V1::AssetService::Client.configure do |config|
993
+ # config.timeout = 10.0
994
+ # config.rpcs.export_assets.timeout = 20.0
726
995
  # end
727
996
  #
728
997
  # To apply the above configuration only to a new client:
729
998
  #
730
- # client = Google::Cloud::Asset::V1::AssetService::Client.new do |config|
731
- # config.timeout = 10_000
732
- # config.rpcs.export_assets.timeout = 20_000
999
+ # client = ::Google::Cloud::Asset::V1::AssetService::Client.new do |config|
1000
+ # config.timeout = 10.0
1001
+ # config.rpcs.export_assets.timeout = 20.0
733
1002
  # end
734
1003
  #
735
1004
  # @!attribute [rw] endpoint
736
1005
  # The hostname or hostname:port of the service endpoint.
737
1006
  # Defaults to `"cloudasset.googleapis.com"`.
738
- # @return [String]
1007
+ # @return [::String]
739
1008
  # @!attribute [rw] credentials
740
1009
  # Credentials to send with calls. You may provide any of the following types:
741
1010
  # * (`String`) The path to a service account key file in JSON format
@@ -747,29 +1016,29 @@ module Google
747
1016
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
748
1017
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
749
1018
  # * (`nil`) indicating no credentials
750
- # @return [Object]
1019
+ # @return [::Object]
751
1020
  # @!attribute [rw] scope
752
1021
  # The OAuth scopes
753
- # @return [Array<String>]
1022
+ # @return [::Array<::String>]
754
1023
  # @!attribute [rw] lib_name
755
1024
  # The library name as recorded in instrumentation and logging
756
- # @return [String]
1025
+ # @return [::String]
757
1026
  # @!attribute [rw] lib_version
758
1027
  # The library version as recorded in instrumentation and logging
759
- # @return [String]
1028
+ # @return [::String]
760
1029
  # @!attribute [rw] channel_args
761
1030
  # Extra parameters passed to the gRPC channel. Note: this is ignored if a
762
1031
  # `GRPC::Core::Channel` object is provided as the credential.
763
- # @return [Hash]
1032
+ # @return [::Hash]
764
1033
  # @!attribute [rw] interceptors
765
1034
  # An array of interceptors that are run before calls are executed.
766
- # @return [Array<GRPC::ClientInterceptor>]
1035
+ # @return [::Array<::GRPC::ClientInterceptor>]
767
1036
  # @!attribute [rw] timeout
768
- # The call timeout in milliseconds.
769
- # @return [Numeric]
1037
+ # The call timeout in seconds.
1038
+ # @return [::Numeric]
770
1039
  # @!attribute [rw] metadata
771
1040
  # Additional gRPC headers to be sent with the call.
772
- # @return [Hash{Symbol=>String}]
1041
+ # @return [::Hash{::Symbol=>::String}]
773
1042
  # @!attribute [rw] retry_policy
774
1043
  # The retry policy. The value is a hash with the following keys:
775
1044
  # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
@@ -777,25 +1046,29 @@ module Google
777
1046
  # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
778
1047
  # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
779
1048
  # trigger a retry.
780
- # @return [Hash]
1049
+ # @return [::Hash]
1050
+ # @!attribute [rw] quota_project
1051
+ # A separate project against which to charge quota.
1052
+ # @return [::String]
781
1053
  #
782
1054
  class Configuration
783
- extend Gapic::Config
1055
+ extend ::Gapic::Config
784
1056
 
785
- config_attr :endpoint, "cloudasset.googleapis.com", String
786
- config_attr :credentials, nil do |value|
1057
+ config_attr :endpoint, "cloudasset.googleapis.com", ::String
1058
+ config_attr :credentials, nil do |value|
787
1059
  allowed = [::String, ::Hash, ::Proc, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
788
1060
  allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
789
1061
  allowed.any? { |klass| klass === value }
790
1062
  end
791
- config_attr :scope, nil, String, Array, nil
792
- config_attr :lib_name, nil, String, nil
793
- config_attr :lib_version, nil, String, nil
794
- config_attr(:channel_args, { "grpc.service_config_disable_resolution"=>1 }, Hash, nil)
795
- config_attr :interceptors, nil, Array, nil
796
- config_attr :timeout, nil, Numeric, nil
797
- config_attr :metadata, nil, Hash, nil
798
- config_attr :retry_policy, nil, Hash, Proc, nil
1063
+ config_attr :scope, nil, ::String, ::Array, nil
1064
+ config_attr :lib_name, nil, ::String, nil
1065
+ config_attr :lib_version, nil, ::String, nil
1066
+ config_attr(:channel_args, { "grpc.service_config_disable_resolution"=>1 }, ::Hash, nil)
1067
+ config_attr :interceptors, nil, ::Array, nil
1068
+ config_attr :timeout, nil, ::Numeric, nil
1069
+ config_attr :metadata, nil, ::Hash, nil
1070
+ config_attr :retry_policy, nil, ::Hash, ::Proc, nil
1071
+ config_attr :quota_project, nil, ::String, nil
799
1072
 
800
1073
  # @private
801
1074
  def initialize parent_config = nil
@@ -836,56 +1109,70 @@ module Google
836
1109
  class Rpcs
837
1110
  ##
838
1111
  # RPC-specific configuration for `export_assets`
839
- # @return [Gapic::Config::Method]
1112
+ # @return [::Gapic::Config::Method]
840
1113
  #
841
1114
  attr_reader :export_assets
842
1115
  ##
843
1116
  # RPC-specific configuration for `batch_get_assets_history`
844
- # @return [Gapic::Config::Method]
1117
+ # @return [::Gapic::Config::Method]
845
1118
  #
846
1119
  attr_reader :batch_get_assets_history
847
1120
  ##
848
1121
  # RPC-specific configuration for `create_feed`
849
- # @return [Gapic::Config::Method]
1122
+ # @return [::Gapic::Config::Method]
850
1123
  #
851
1124
  attr_reader :create_feed
852
1125
  ##
853
1126
  # RPC-specific configuration for `get_feed`
854
- # @return [Gapic::Config::Method]
1127
+ # @return [::Gapic::Config::Method]
855
1128
  #
856
1129
  attr_reader :get_feed
857
1130
  ##
858
1131
  # RPC-specific configuration for `list_feeds`
859
- # @return [Gapic::Config::Method]
1132
+ # @return [::Gapic::Config::Method]
860
1133
  #
861
1134
  attr_reader :list_feeds
862
1135
  ##
863
1136
  # RPC-specific configuration for `update_feed`
864
- # @return [Gapic::Config::Method]
1137
+ # @return [::Gapic::Config::Method]
865
1138
  #
866
1139
  attr_reader :update_feed
867
1140
  ##
868
1141
  # RPC-specific configuration for `delete_feed`
869
- # @return [Gapic::Config::Method]
1142
+ # @return [::Gapic::Config::Method]
870
1143
  #
871
1144
  attr_reader :delete_feed
1145
+ ##
1146
+ # RPC-specific configuration for `search_all_resources`
1147
+ # @return [::Gapic::Config::Method]
1148
+ #
1149
+ attr_reader :search_all_resources
1150
+ ##
1151
+ # RPC-specific configuration for `search_all_iam_policies`
1152
+ # @return [::Gapic::Config::Method]
1153
+ #
1154
+ attr_reader :search_all_iam_policies
872
1155
 
873
1156
  # @private
874
1157
  def initialize parent_rpcs = nil
875
1158
  export_assets_config = parent_rpcs&.export_assets if parent_rpcs&.respond_to? :export_assets
876
- @export_assets = Gapic::Config::Method.new export_assets_config
1159
+ @export_assets = ::Gapic::Config::Method.new export_assets_config
877
1160
  batch_get_assets_history_config = parent_rpcs&.batch_get_assets_history if parent_rpcs&.respond_to? :batch_get_assets_history
878
- @batch_get_assets_history = Gapic::Config::Method.new batch_get_assets_history_config
1161
+ @batch_get_assets_history = ::Gapic::Config::Method.new batch_get_assets_history_config
879
1162
  create_feed_config = parent_rpcs&.create_feed if parent_rpcs&.respond_to? :create_feed
880
- @create_feed = Gapic::Config::Method.new create_feed_config
1163
+ @create_feed = ::Gapic::Config::Method.new create_feed_config
881
1164
  get_feed_config = parent_rpcs&.get_feed if parent_rpcs&.respond_to? :get_feed
882
- @get_feed = Gapic::Config::Method.new get_feed_config
1165
+ @get_feed = ::Gapic::Config::Method.new get_feed_config
883
1166
  list_feeds_config = parent_rpcs&.list_feeds if parent_rpcs&.respond_to? :list_feeds
884
- @list_feeds = Gapic::Config::Method.new list_feeds_config
1167
+ @list_feeds = ::Gapic::Config::Method.new list_feeds_config
885
1168
  update_feed_config = parent_rpcs&.update_feed if parent_rpcs&.respond_to? :update_feed
886
- @update_feed = Gapic::Config::Method.new update_feed_config
1169
+ @update_feed = ::Gapic::Config::Method.new update_feed_config
887
1170
  delete_feed_config = parent_rpcs&.delete_feed if parent_rpcs&.respond_to? :delete_feed
888
- @delete_feed = Gapic::Config::Method.new delete_feed_config
1171
+ @delete_feed = ::Gapic::Config::Method.new delete_feed_config
1172
+ search_all_resources_config = parent_rpcs&.search_all_resources if parent_rpcs&.respond_to? :search_all_resources
1173
+ @search_all_resources = ::Gapic::Config::Method.new search_all_resources_config
1174
+ search_all_iam_policies_config = parent_rpcs&.search_all_iam_policies if parent_rpcs&.respond_to? :search_all_iam_policies
1175
+ @search_all_iam_policies = ::Gapic::Config::Method.new search_all_iam_policies_config
889
1176
 
890
1177
  yield self if block_given?
891
1178
  end