google-cloud-storage-control-v2 1.12.0 → 1.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.
@@ -75,132 +75,132 @@ module Google
75
75
 
76
76
  default_config.rpcs.create_folder.timeout = 60.0
77
77
  default_config.rpcs.create_folder.retry_policy = {
78
- initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 4, 13, 2]
78
+ initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 13, 2]
79
79
  }
80
80
 
81
81
  default_config.rpcs.get_folder.timeout = 60.0
82
82
  default_config.rpcs.get_folder.retry_policy = {
83
- initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 4, 13, 2]
83
+ initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 13, 2]
84
84
  }
85
85
 
86
86
  default_config.rpcs.list_folders.timeout = 60.0
87
87
  default_config.rpcs.list_folders.retry_policy = {
88
- initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 4, 13, 2]
88
+ initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 13, 2]
89
89
  }
90
90
 
91
91
  default_config.rpcs.rename_folder.timeout = 60.0
92
92
  default_config.rpcs.rename_folder.retry_policy = {
93
- initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 4, 13, 2]
93
+ initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 13, 2]
94
94
  }
95
95
 
96
96
  default_config.rpcs.delete_folder_recursive.timeout = 60.0
97
97
  default_config.rpcs.delete_folder_recursive.retry_policy = {
98
- initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 4, 13, 2]
98
+ initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 13, 2]
99
99
  }
100
100
 
101
101
  default_config.rpcs.get_storage_layout.timeout = 60.0
102
102
  default_config.rpcs.get_storage_layout.retry_policy = {
103
- initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 4, 13, 2]
103
+ initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 13, 2]
104
104
  }
105
105
 
106
106
  default_config.rpcs.get_managed_folder.timeout = 60.0
107
107
  default_config.rpcs.get_managed_folder.retry_policy = {
108
- initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 4, 13, 2]
108
+ initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 13, 2]
109
109
  }
110
110
 
111
111
  default_config.rpcs.list_managed_folders.timeout = 60.0
112
112
  default_config.rpcs.list_managed_folders.retry_policy = {
113
- initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 4, 13, 2]
113
+ initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 13, 2]
114
114
  }
115
115
 
116
116
  default_config.rpcs.create_anywhere_cache.timeout = 60.0
117
117
  default_config.rpcs.create_anywhere_cache.retry_policy = {
118
- initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 4, 13, 2]
118
+ initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 13, 2]
119
119
  }
120
120
 
121
121
  default_config.rpcs.update_anywhere_cache.timeout = 60.0
122
122
  default_config.rpcs.update_anywhere_cache.retry_policy = {
123
- initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 4, 13, 2]
123
+ initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 13, 2]
124
124
  }
125
125
 
126
126
  default_config.rpcs.disable_anywhere_cache.timeout = 60.0
127
127
  default_config.rpcs.disable_anywhere_cache.retry_policy = {
128
- initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 4, 13, 2]
128
+ initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 13, 2]
129
129
  }
130
130
 
131
131
  default_config.rpcs.pause_anywhere_cache.timeout = 60.0
132
132
  default_config.rpcs.pause_anywhere_cache.retry_policy = {
133
- initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 4, 13, 2]
133
+ initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 13, 2]
134
134
  }
135
135
 
136
136
  default_config.rpcs.resume_anywhere_cache.timeout = 60.0
137
137
  default_config.rpcs.resume_anywhere_cache.retry_policy = {
138
- initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 4, 13, 2]
138
+ initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 13, 2]
139
139
  }
140
140
 
141
141
  default_config.rpcs.get_anywhere_cache.timeout = 60.0
142
142
  default_config.rpcs.get_anywhere_cache.retry_policy = {
143
- initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 4, 13, 2]
143
+ initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 13, 2]
144
144
  }
145
145
 
146
146
  default_config.rpcs.list_anywhere_caches.timeout = 60.0
147
147
  default_config.rpcs.list_anywhere_caches.retry_policy = {
148
- initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 4, 13, 2]
148
+ initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 13, 2]
149
149
  }
150
150
 
151
151
  default_config.rpcs.get_project_intelligence_config.timeout = 60.0
152
152
  default_config.rpcs.get_project_intelligence_config.retry_policy = {
153
- initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 4, 13, 2]
153
+ initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 13, 2]
154
154
  }
155
155
 
156
156
  default_config.rpcs.update_project_intelligence_config.timeout = 60.0
157
157
  default_config.rpcs.update_project_intelligence_config.retry_policy = {
158
- initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 4, 13, 2]
158
+ initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 13, 2]
159
159
  }
160
160
 
161
161
  default_config.rpcs.get_folder_intelligence_config.timeout = 60.0
162
162
  default_config.rpcs.get_folder_intelligence_config.retry_policy = {
163
- initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 4, 13, 2]
163
+ initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 13, 2]
164
164
  }
165
165
 
166
166
  default_config.rpcs.update_folder_intelligence_config.timeout = 60.0
167
167
  default_config.rpcs.update_folder_intelligence_config.retry_policy = {
168
- initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 4, 13, 2]
168
+ initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 13, 2]
169
169
  }
170
170
 
171
171
  default_config.rpcs.get_organization_intelligence_config.timeout = 60.0
172
172
  default_config.rpcs.get_organization_intelligence_config.retry_policy = {
173
- initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 4, 13, 2]
173
+ initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 13, 2]
174
174
  }
175
175
 
176
176
  default_config.rpcs.update_organization_intelligence_config.timeout = 60.0
177
177
  default_config.rpcs.update_organization_intelligence_config.retry_policy = {
178
- initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 4, 13, 2]
178
+ initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 13, 2]
179
179
  }
180
180
 
181
181
  default_config.rpcs.get_intelligence_finding.timeout = 60.0
182
182
  default_config.rpcs.get_intelligence_finding.retry_policy = {
183
- initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 4, 13, 2]
183
+ initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 13, 2]
184
184
  }
185
185
 
186
186
  default_config.rpcs.list_intelligence_findings.timeout = 60.0
187
187
  default_config.rpcs.list_intelligence_findings.retry_policy = {
188
- initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 4, 13, 2]
188
+ initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 13, 2]
189
189
  }
190
190
 
191
191
  default_config.rpcs.summarize_intelligence_findings.timeout = 60.0
192
192
  default_config.rpcs.summarize_intelligence_findings.retry_policy = {
193
- initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 4, 13, 2]
193
+ initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 13, 2]
194
194
  }
195
195
 
196
196
  default_config.rpcs.get_intelligence_finding_revision.timeout = 60.0
197
197
  default_config.rpcs.get_intelligence_finding_revision.retry_policy = {
198
- initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 4, 13, 2]
198
+ initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 13, 2]
199
199
  }
200
200
 
201
201
  default_config.rpcs.list_intelligence_finding_revisions.timeout = 60.0
202
202
  default_config.rpcs.list_intelligence_finding_revisions.retry_policy = {
203
- initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 4, 13, 2]
203
+ initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [8, 14, 13, 2]
204
204
  }
205
205
 
206
206
  default_config
@@ -1470,6 +1470,115 @@ module Google
1470
1470
  raise ::Google::Cloud::Error.from_error(e)
1471
1471
  end
1472
1472
 
1473
+ ##
1474
+ # Updates a managed folder. Currently, this RPC only supports updating the
1475
+ # `rapid_cache_config` field.
1476
+ #
1477
+ # @overload update_managed_folder(request, options = nil)
1478
+ # Pass arguments to `update_managed_folder` via a request object, either of type
1479
+ # {::Google::Cloud::Storage::Control::V2::UpdateManagedFolderRequest} or an equivalent Hash.
1480
+ #
1481
+ # @param request [::Google::Cloud::Storage::Control::V2::UpdateManagedFolderRequest, ::Hash]
1482
+ # A request object representing the call parameters. Required. To specify no
1483
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1484
+ # @param options [::Gapic::CallOptions, ::Hash]
1485
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1486
+ #
1487
+ # @overload update_managed_folder(managed_folder: nil, update_mask: nil, if_metageneration_match: nil, if_metageneration_not_match: nil, request_id: nil)
1488
+ # Pass arguments to `update_managed_folder` via keyword arguments. Note that at
1489
+ # least one keyword argument is required. To specify no parameters, or to keep all
1490
+ # the default parameter values, pass an empty Hash as a request object (see above).
1491
+ #
1492
+ # @param managed_folder [::Google::Cloud::Storage::Control::V2::ManagedFolder, ::Hash]
1493
+ # Required. Properties of the managed folder being updated. Currently, this
1494
+ # RPC only supports updating the `rapid_cache_config` field in
1495
+ # `managed_folder`.
1496
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
1497
+ # Optional. Update mask for managed_folder.
1498
+ # Currently, this RPC only supports updating the `rapid_cache_config`
1499
+ # field in `managed_folder`. This field also supports update mask for the
1500
+ # subfields in the map of `rapid_cache_config`. The user can specify the
1501
+ # update mask for `rapid_cache_config.policies` and
1502
+ # `rapid_cache_config.policies.<key>`, but patching is not supported for
1503
+ # a field within `RapidCachePolicy.policies.<key>`, like
1504
+ # rapid_cache_config.policies.[key].ingest_on_write.
1505
+ # @param if_metageneration_match [::Integer]
1506
+ # Optional. The operation succeeds conditional on the managed folder's
1507
+ # current metageneration matching the value here specified.
1508
+ # @param if_metageneration_not_match [::Integer]
1509
+ # Optional. The operation succeeds conditional on the managed folder's
1510
+ # current metageneration NOT matching the value here specified.
1511
+ # @param request_id [::String]
1512
+ # Optional. A unique identifier for this request. UUID is the recommended
1513
+ # format, but other formats are still accepted.
1514
+ #
1515
+ # @yield [response, operation] Access the result along with the RPC operation
1516
+ # @yieldparam response [::Google::Cloud::Storage::Control::V2::ManagedFolder]
1517
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
1518
+ #
1519
+ # @return [::Google::Cloud::Storage::Control::V2::ManagedFolder]
1520
+ #
1521
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
1522
+ #
1523
+ # @example Basic example
1524
+ # require "google/cloud/storage/control/v2"
1525
+ #
1526
+ # # Create a client object. The client can be reused for multiple calls.
1527
+ # client = Google::Cloud::Storage::Control::V2::StorageControl::Client.new
1528
+ #
1529
+ # # Create a request. To set request fields, pass in keyword arguments.
1530
+ # request = Google::Cloud::Storage::Control::V2::UpdateManagedFolderRequest.new
1531
+ #
1532
+ # # Call the update_managed_folder method.
1533
+ # result = client.update_managed_folder request
1534
+ #
1535
+ # # The returned object is of type Google::Cloud::Storage::Control::V2::ManagedFolder.
1536
+ # p result
1537
+ #
1538
+ def update_managed_folder request, options = nil
1539
+ raise ::ArgumentError, "request must be provided" if request.nil?
1540
+
1541
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Storage::Control::V2::UpdateManagedFolderRequest
1542
+
1543
+ # Converts hash and nil to an options object
1544
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1545
+
1546
+ # Customize the options with defaults
1547
+ metadata = @config.rpcs.update_managed_folder.metadata.to_h
1548
+
1549
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1550
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1551
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1552
+ gapic_version: ::Google::Cloud::Storage::Control::V2::VERSION
1553
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1554
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1555
+
1556
+ header_params = {}
1557
+ if request.managed_folder&.name
1558
+ regex_match = %r{^(?<bucket>projects/[^/]+/buckets/[^/]+)(?:/.*)?$}.match request.managed_folder.name
1559
+ if regex_match
1560
+ header_params["bucket"] = regex_match["bucket".to_s]
1561
+ end
1562
+ end
1563
+
1564
+ request_params_header = URI.encode_www_form header_params
1565
+ metadata[:"x-goog-request-params"] ||= request_params_header
1566
+
1567
+ options.apply_defaults timeout: @config.rpcs.update_managed_folder.timeout,
1568
+ metadata: metadata,
1569
+ retry_policy: @config.rpcs.update_managed_folder.retry_policy
1570
+
1571
+ options.apply_defaults timeout: @config.timeout,
1572
+ metadata: @config.metadata,
1573
+ retry_policy: @config.retry_policy
1574
+
1575
+ @storage_control_stub.call_rpc :update_managed_folder, request, options: options do |response, operation|
1576
+ yield response, operation if block_given?
1577
+ end
1578
+ rescue ::GRPC::BadStatus => e
1579
+ raise ::Google::Cloud::Error.from_error(e)
1580
+ end
1581
+
1473
1582
  ##
1474
1583
  # Creates an Anywhere Cache instance.
1475
1584
  #
@@ -2160,6 +2269,411 @@ module Google
2160
2269
  raise ::Google::Cloud::Error.from_error(e)
2161
2270
  end
2162
2271
 
2272
+ ##
2273
+ # Creates a Rapid Cache instance.
2274
+ #
2275
+ # @overload create_rapid_cache(request, options = nil)
2276
+ # Pass arguments to `create_rapid_cache` via a request object, either of type
2277
+ # {::Google::Cloud::Storage::Control::V2::CreateRapidCacheRequest} or an equivalent Hash.
2278
+ #
2279
+ # @param request [::Google::Cloud::Storage::Control::V2::CreateRapidCacheRequest, ::Hash]
2280
+ # A request object representing the call parameters. Required. To specify no
2281
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2282
+ # @param options [::Gapic::CallOptions, ::Hash]
2283
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2284
+ #
2285
+ # @overload create_rapid_cache(parent: nil, rapid_cache: nil, request_id: nil)
2286
+ # Pass arguments to `create_rapid_cache` via keyword arguments. Note that at
2287
+ # least one keyword argument is required. To specify no parameters, or to keep all
2288
+ # the default parameter values, pass an empty Hash as a request object (see above).
2289
+ #
2290
+ # @param parent [::String]
2291
+ # Required. The bucket to which this cache belongs.
2292
+ # Format: `projects/{project}/buckets/{bucket}`
2293
+ # @param rapid_cache [::Google::Cloud::Storage::Control::V2::RapidCache, ::Hash]
2294
+ # Required. The RapidCache to create. Default values for ingest_on_write, ttl
2295
+ # and admission_policy will be applied if not specified in the request.
2296
+ # @param request_id [::String]
2297
+ # Optional. A unique identifier for this request. UUID is the recommended
2298
+ # format, but other formats are still accepted. This request is only
2299
+ # idempotent if a `request_id` is provided.
2300
+ #
2301
+ # @yield [response, operation] Access the result along with the RPC operation
2302
+ # @yieldparam response [::Gapic::Operation]
2303
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
2304
+ #
2305
+ # @return [::Gapic::Operation]
2306
+ #
2307
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
2308
+ #
2309
+ # @example Basic example
2310
+ # require "google/cloud/storage/control/v2"
2311
+ #
2312
+ # # Create a client object. The client can be reused for multiple calls.
2313
+ # client = Google::Cloud::Storage::Control::V2::StorageControl::Client.new
2314
+ #
2315
+ # # Create a request. To set request fields, pass in keyword arguments.
2316
+ # request = Google::Cloud::Storage::Control::V2::CreateRapidCacheRequest.new
2317
+ #
2318
+ # # Call the create_rapid_cache method.
2319
+ # result = client.create_rapid_cache request
2320
+ #
2321
+ # # The returned object is of type Gapic::Operation. You can use it to
2322
+ # # check the status of an operation, cancel it, or wait for results.
2323
+ # # Here is how to wait for a response.
2324
+ # result.wait_until_done! timeout: 60
2325
+ # if result.response?
2326
+ # p result.response
2327
+ # else
2328
+ # puts "No response received."
2329
+ # end
2330
+ #
2331
+ def create_rapid_cache request, options = nil
2332
+ raise ::ArgumentError, "request must be provided" if request.nil?
2333
+
2334
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Storage::Control::V2::CreateRapidCacheRequest
2335
+
2336
+ # Converts hash and nil to an options object
2337
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2338
+
2339
+ # Customize the options with defaults
2340
+ metadata = @config.rpcs.create_rapid_cache.metadata.to_h
2341
+
2342
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2343
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2344
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2345
+ gapic_version: ::Google::Cloud::Storage::Control::V2::VERSION
2346
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2347
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2348
+
2349
+ header_params = {}
2350
+ if request.parent && !request.parent.empty?
2351
+ header_params["bucket"] = request.parent
2352
+ end
2353
+
2354
+ request_params_header = URI.encode_www_form header_params
2355
+ metadata[:"x-goog-request-params"] ||= request_params_header
2356
+
2357
+ options.apply_defaults timeout: @config.rpcs.create_rapid_cache.timeout,
2358
+ metadata: metadata,
2359
+ retry_policy: @config.rpcs.create_rapid_cache.retry_policy
2360
+
2361
+ options.apply_defaults timeout: @config.timeout,
2362
+ metadata: @config.metadata,
2363
+ retry_policy: @config.retry_policy
2364
+
2365
+ @storage_control_stub.call_rpc :create_rapid_cache, request, options: options do |response, operation|
2366
+ response = ::Gapic::Operation.new response, @operations_client, options: options
2367
+ yield response, operation if block_given?
2368
+ throw :response, response
2369
+ end
2370
+ rescue ::GRPC::BadStatus => e
2371
+ raise ::Google::Cloud::Error.from_error(e)
2372
+ end
2373
+
2374
+ ##
2375
+ # Updates a Rapid Cache instance.
2376
+ #
2377
+ # @overload update_rapid_cache(request, options = nil)
2378
+ # Pass arguments to `update_rapid_cache` via a request object, either of type
2379
+ # {::Google::Cloud::Storage::Control::V2::UpdateRapidCacheRequest} or an equivalent Hash.
2380
+ #
2381
+ # @param request [::Google::Cloud::Storage::Control::V2::UpdateRapidCacheRequest, ::Hash]
2382
+ # A request object representing the call parameters. Required. To specify no
2383
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2384
+ # @param options [::Gapic::CallOptions, ::Hash]
2385
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2386
+ #
2387
+ # @overload update_rapid_cache(rapid_cache: nil, update_mask: nil, request_id: nil)
2388
+ # Pass arguments to `update_rapid_cache` via keyword arguments. Note that at
2389
+ # least one keyword argument is required. To specify no parameters, or to keep all
2390
+ # the default parameter values, pass an empty Hash as a request object (see above).
2391
+ #
2392
+ # @param rapid_cache [::Google::Cloud::Storage::Control::V2::RapidCache, ::Hash]
2393
+ # Required. The RapidCache to update.
2394
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
2395
+ # Required. List of fields to be updated. Mutable fields of RapidCache
2396
+ # include `ttl`, `admission_policy` and `ingest_on_write`.
2397
+ #
2398
+ # To specify ALL fields, specify a single field with the value `*`. Note: We
2399
+ # recommend against doing this. If a new field is introduced at a later time,
2400
+ # an older client updating with the `*` may accidentally reset the new
2401
+ # field's value.
2402
+ #
2403
+ # Not specifying any fields is an error.
2404
+ # @param request_id [::String]
2405
+ # Optional. A unique identifier for this request. UUID is the recommended
2406
+ # format, but other formats are still accepted. This request is only
2407
+ # idempotent if a `request_id` is provided.
2408
+ #
2409
+ # @yield [response, operation] Access the result along with the RPC operation
2410
+ # @yieldparam response [::Gapic::Operation]
2411
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
2412
+ #
2413
+ # @return [::Gapic::Operation]
2414
+ #
2415
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
2416
+ #
2417
+ # @example Basic example
2418
+ # require "google/cloud/storage/control/v2"
2419
+ #
2420
+ # # Create a client object. The client can be reused for multiple calls.
2421
+ # client = Google::Cloud::Storage::Control::V2::StorageControl::Client.new
2422
+ #
2423
+ # # Create a request. To set request fields, pass in keyword arguments.
2424
+ # request = Google::Cloud::Storage::Control::V2::UpdateRapidCacheRequest.new
2425
+ #
2426
+ # # Call the update_rapid_cache method.
2427
+ # result = client.update_rapid_cache request
2428
+ #
2429
+ # # The returned object is of type Gapic::Operation. You can use it to
2430
+ # # check the status of an operation, cancel it, or wait for results.
2431
+ # # Here is how to wait for a response.
2432
+ # result.wait_until_done! timeout: 60
2433
+ # if result.response?
2434
+ # p result.response
2435
+ # else
2436
+ # puts "No response received."
2437
+ # end
2438
+ #
2439
+ def update_rapid_cache request, options = nil
2440
+ raise ::ArgumentError, "request must be provided" if request.nil?
2441
+
2442
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Storage::Control::V2::UpdateRapidCacheRequest
2443
+
2444
+ # Converts hash and nil to an options object
2445
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2446
+
2447
+ # Customize the options with defaults
2448
+ metadata = @config.rpcs.update_rapid_cache.metadata.to_h
2449
+
2450
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2451
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2452
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2453
+ gapic_version: ::Google::Cloud::Storage::Control::V2::VERSION
2454
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2455
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2456
+
2457
+ header_params = {}
2458
+ if request.rapid_cache&.name
2459
+ regex_match = %r{^(?<bucket>projects/[^/]+/buckets/[^/]+)(?:/.*)?$}.match request.rapid_cache.name
2460
+ if regex_match
2461
+ header_params["bucket"] = regex_match["bucket".to_s]
2462
+ end
2463
+ end
2464
+
2465
+ request_params_header = URI.encode_www_form header_params
2466
+ metadata[:"x-goog-request-params"] ||= request_params_header
2467
+
2468
+ options.apply_defaults timeout: @config.rpcs.update_rapid_cache.timeout,
2469
+ metadata: metadata,
2470
+ retry_policy: @config.rpcs.update_rapid_cache.retry_policy
2471
+
2472
+ options.apply_defaults timeout: @config.timeout,
2473
+ metadata: @config.metadata,
2474
+ retry_policy: @config.retry_policy
2475
+
2476
+ @storage_control_stub.call_rpc :update_rapid_cache, request, options: options do |response, operation|
2477
+ response = ::Gapic::Operation.new response, @operations_client, options: options
2478
+ yield response, operation if block_given?
2479
+ throw :response, response
2480
+ end
2481
+ rescue ::GRPC::BadStatus => e
2482
+ raise ::Google::Cloud::Error.from_error(e)
2483
+ end
2484
+
2485
+ ##
2486
+ # Gets a Rapid Cache instance.
2487
+ #
2488
+ # @overload get_rapid_cache(request, options = nil)
2489
+ # Pass arguments to `get_rapid_cache` via a request object, either of type
2490
+ # {::Google::Cloud::Storage::Control::V2::GetRapidCacheRequest} or an equivalent Hash.
2491
+ #
2492
+ # @param request [::Google::Cloud::Storage::Control::V2::GetRapidCacheRequest, ::Hash]
2493
+ # A request object representing the call parameters. Required. To specify no
2494
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2495
+ # @param options [::Gapic::CallOptions, ::Hash]
2496
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2497
+ #
2498
+ # @overload get_rapid_cache(name: nil, request_id: nil)
2499
+ # Pass arguments to `get_rapid_cache` via keyword arguments. Note that at
2500
+ # least one keyword argument is required. To specify no parameters, or to keep all
2501
+ # the default parameter values, pass an empty Hash as a request object (see above).
2502
+ #
2503
+ # @param name [::String]
2504
+ # Required. The name field in the request should be:
2505
+ # `projects/{project}/buckets/{bucket}/rapidCaches/{rapid_cache}`
2506
+ # @param request_id [::String]
2507
+ # Optional. A unique identifier for this request. UUID is the recommended
2508
+ # format, but other formats are still accepted.
2509
+ #
2510
+ # @yield [response, operation] Access the result along with the RPC operation
2511
+ # @yieldparam response [::Google::Cloud::Storage::Control::V2::RapidCache]
2512
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
2513
+ #
2514
+ # @return [::Google::Cloud::Storage::Control::V2::RapidCache]
2515
+ #
2516
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
2517
+ #
2518
+ # @example Basic example
2519
+ # require "google/cloud/storage/control/v2"
2520
+ #
2521
+ # # Create a client object. The client can be reused for multiple calls.
2522
+ # client = Google::Cloud::Storage::Control::V2::StorageControl::Client.new
2523
+ #
2524
+ # # Create a request. To set request fields, pass in keyword arguments.
2525
+ # request = Google::Cloud::Storage::Control::V2::GetRapidCacheRequest.new
2526
+ #
2527
+ # # Call the get_rapid_cache method.
2528
+ # result = client.get_rapid_cache request
2529
+ #
2530
+ # # The returned object is of type Google::Cloud::Storage::Control::V2::RapidCache.
2531
+ # p result
2532
+ #
2533
+ def get_rapid_cache request, options = nil
2534
+ raise ::ArgumentError, "request must be provided" if request.nil?
2535
+
2536
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Storage::Control::V2::GetRapidCacheRequest
2537
+
2538
+ # Converts hash and nil to an options object
2539
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2540
+
2541
+ # Customize the options with defaults
2542
+ metadata = @config.rpcs.get_rapid_cache.metadata.to_h
2543
+
2544
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2545
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2546
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2547
+ gapic_version: ::Google::Cloud::Storage::Control::V2::VERSION
2548
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2549
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2550
+
2551
+ header_params = {}
2552
+ if request.name
2553
+ regex_match = %r{^(?<bucket>projects/[^/]+/buckets/[^/]+)(?:/.*)?$}.match request.name
2554
+ if regex_match
2555
+ header_params["bucket"] = regex_match["bucket".to_s]
2556
+ end
2557
+ end
2558
+
2559
+ request_params_header = URI.encode_www_form header_params
2560
+ metadata[:"x-goog-request-params"] ||= request_params_header
2561
+
2562
+ options.apply_defaults timeout: @config.rpcs.get_rapid_cache.timeout,
2563
+ metadata: metadata,
2564
+ retry_policy: @config.rpcs.get_rapid_cache.retry_policy
2565
+
2566
+ options.apply_defaults timeout: @config.timeout,
2567
+ metadata: @config.metadata,
2568
+ retry_policy: @config.retry_policy
2569
+
2570
+ @storage_control_stub.call_rpc :get_rapid_cache, request, options: options do |response, operation|
2571
+ yield response, operation if block_given?
2572
+ end
2573
+ rescue ::GRPC::BadStatus => e
2574
+ raise ::Google::Cloud::Error.from_error(e)
2575
+ end
2576
+
2577
+ ##
2578
+ # Lists Rapid Cache instances for a given bucket.
2579
+ #
2580
+ # @overload list_rapid_caches(request, options = nil)
2581
+ # Pass arguments to `list_rapid_caches` via a request object, either of type
2582
+ # {::Google::Cloud::Storage::Control::V2::ListRapidCachesRequest} or an equivalent Hash.
2583
+ #
2584
+ # @param request [::Google::Cloud::Storage::Control::V2::ListRapidCachesRequest, ::Hash]
2585
+ # A request object representing the call parameters. Required. To specify no
2586
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2587
+ # @param options [::Gapic::CallOptions, ::Hash]
2588
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2589
+ #
2590
+ # @overload list_rapid_caches(parent: nil, page_size: nil, page_token: nil, request_id: nil)
2591
+ # Pass arguments to `list_rapid_caches` via keyword arguments. Note that at
2592
+ # least one keyword argument is required. To specify no parameters, or to keep all
2593
+ # the default parameter values, pass an empty Hash as a request object (see above).
2594
+ #
2595
+ # @param parent [::String]
2596
+ # Required. The bucket to which this cache belongs.
2597
+ # @param page_size [::Integer]
2598
+ # Maximum number of caches to return in a single response.
2599
+ # The service will use this parameter or 1,000 items, whichever is smaller.
2600
+ # @param page_token [::String]
2601
+ # A previously-returned page token representing part of the larger set of
2602
+ # results to view.
2603
+ # @param request_id [::String]
2604
+ # Optional. A unique identifier for this request. UUID is the recommended
2605
+ # format, but other formats are still accepted.
2606
+ #
2607
+ # @yield [response, operation] Access the result along with the RPC operation
2608
+ # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::Storage::Control::V2::RapidCache>]
2609
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
2610
+ #
2611
+ # @return [::Gapic::PagedEnumerable<::Google::Cloud::Storage::Control::V2::RapidCache>]
2612
+ #
2613
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
2614
+ #
2615
+ # @example Basic example
2616
+ # require "google/cloud/storage/control/v2"
2617
+ #
2618
+ # # Create a client object. The client can be reused for multiple calls.
2619
+ # client = Google::Cloud::Storage::Control::V2::StorageControl::Client.new
2620
+ #
2621
+ # # Create a request. To set request fields, pass in keyword arguments.
2622
+ # request = Google::Cloud::Storage::Control::V2::ListRapidCachesRequest.new
2623
+ #
2624
+ # # Call the list_rapid_caches method.
2625
+ # result = client.list_rapid_caches request
2626
+ #
2627
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
2628
+ # # over elements, and API calls will be issued to fetch pages as needed.
2629
+ # result.each do |item|
2630
+ # # Each element is of type ::Google::Cloud::Storage::Control::V2::RapidCache.
2631
+ # p item
2632
+ # end
2633
+ #
2634
+ def list_rapid_caches request, options = nil
2635
+ raise ::ArgumentError, "request must be provided" if request.nil?
2636
+
2637
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Storage::Control::V2::ListRapidCachesRequest
2638
+
2639
+ # Converts hash and nil to an options object
2640
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2641
+
2642
+ # Customize the options with defaults
2643
+ metadata = @config.rpcs.list_rapid_caches.metadata.to_h
2644
+
2645
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2646
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2647
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2648
+ gapic_version: ::Google::Cloud::Storage::Control::V2::VERSION
2649
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2650
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2651
+
2652
+ header_params = {}
2653
+ if request.parent && !request.parent.empty?
2654
+ header_params["bucket"] = request.parent
2655
+ end
2656
+
2657
+ request_params_header = URI.encode_www_form header_params
2658
+ metadata[:"x-goog-request-params"] ||= request_params_header
2659
+
2660
+ options.apply_defaults timeout: @config.rpcs.list_rapid_caches.timeout,
2661
+ metadata: metadata,
2662
+ retry_policy: @config.rpcs.list_rapid_caches.retry_policy
2663
+
2664
+ options.apply_defaults timeout: @config.timeout,
2665
+ metadata: @config.metadata,
2666
+ retry_policy: @config.retry_policy
2667
+
2668
+ @storage_control_stub.call_rpc :list_rapid_caches, request, options: options do |response, operation|
2669
+ response = ::Gapic::PagedEnumerable.new @storage_control_stub, :list_rapid_caches, request, response, operation, options
2670
+ yield response, operation if block_given?
2671
+ throw :response, response
2672
+ end
2673
+ rescue ::GRPC::BadStatus => e
2674
+ raise ::Google::Cloud::Error.from_error(e)
2675
+ end
2676
+
2163
2677
  ##
2164
2678
  # Returns the Project scoped singleton IntelligenceConfig resource.
2165
2679
  #
@@ -3104,7 +3618,7 @@ module Google
3104
3618
  end
3105
3619
 
3106
3620
  ##
3107
- # Lists the `IntelligenceFinding` resources for the specified project.
3621
+ # Lists the `IntelligenceFinding` resources for the specified the project.
3108
3622
  #
3109
3623
  # @overload list_intelligence_findings(request, options = nil)
3110
3624
  # Pass arguments to `list_intelligence_findings` via a request object, either of type
@@ -3212,8 +3726,8 @@ module Google
3212
3726
  end
3213
3727
 
3214
3728
  ##
3215
- # Summarize the intelligence findings for the specified scope(org, folder or
3216
- # project).
3729
+ # Summarizes the intelligence findings for the specified scope (organization,
3730
+ # folder or project).
3217
3731
  #
3218
3732
  # @overload summarize_intelligence_findings(request, options = nil)
3219
3733
  # Pass arguments to `summarize_intelligence_findings` via a request object, either of type
@@ -3768,6 +4282,11 @@ module Google
3768
4282
  #
3769
4283
  attr_reader :list_managed_folders
3770
4284
  ##
4285
+ # RPC-specific configuration for `update_managed_folder`
4286
+ # @return [::Gapic::Config::Method]
4287
+ #
4288
+ attr_reader :update_managed_folder
4289
+ ##
3771
4290
  # RPC-specific configuration for `create_anywhere_cache`
3772
4291
  # @return [::Gapic::Config::Method]
3773
4292
  #
@@ -3803,6 +4322,26 @@ module Google
3803
4322
  #
3804
4323
  attr_reader :list_anywhere_caches
3805
4324
  ##
4325
+ # RPC-specific configuration for `create_rapid_cache`
4326
+ # @return [::Gapic::Config::Method]
4327
+ #
4328
+ attr_reader :create_rapid_cache
4329
+ ##
4330
+ # RPC-specific configuration for `update_rapid_cache`
4331
+ # @return [::Gapic::Config::Method]
4332
+ #
4333
+ attr_reader :update_rapid_cache
4334
+ ##
4335
+ # RPC-specific configuration for `get_rapid_cache`
4336
+ # @return [::Gapic::Config::Method]
4337
+ #
4338
+ attr_reader :get_rapid_cache
4339
+ ##
4340
+ # RPC-specific configuration for `list_rapid_caches`
4341
+ # @return [::Gapic::Config::Method]
4342
+ #
4343
+ attr_reader :list_rapid_caches
4344
+ ##
3806
4345
  # RPC-specific configuration for `get_project_intelligence_config`
3807
4346
  # @return [::Gapic::Config::Method]
3808
4347
  #
@@ -3897,6 +4436,8 @@ module Google
3897
4436
  @get_managed_folder = ::Gapic::Config::Method.new get_managed_folder_config
3898
4437
  list_managed_folders_config = parent_rpcs.list_managed_folders if parent_rpcs.respond_to? :list_managed_folders
3899
4438
  @list_managed_folders = ::Gapic::Config::Method.new list_managed_folders_config
4439
+ update_managed_folder_config = parent_rpcs.update_managed_folder if parent_rpcs.respond_to? :update_managed_folder
4440
+ @update_managed_folder = ::Gapic::Config::Method.new update_managed_folder_config
3900
4441
  create_anywhere_cache_config = parent_rpcs.create_anywhere_cache if parent_rpcs.respond_to? :create_anywhere_cache
3901
4442
  @create_anywhere_cache = ::Gapic::Config::Method.new create_anywhere_cache_config
3902
4443
  update_anywhere_cache_config = parent_rpcs.update_anywhere_cache if parent_rpcs.respond_to? :update_anywhere_cache
@@ -3911,6 +4452,14 @@ module Google
3911
4452
  @get_anywhere_cache = ::Gapic::Config::Method.new get_anywhere_cache_config
3912
4453
  list_anywhere_caches_config = parent_rpcs.list_anywhere_caches if parent_rpcs.respond_to? :list_anywhere_caches
3913
4454
  @list_anywhere_caches = ::Gapic::Config::Method.new list_anywhere_caches_config
4455
+ create_rapid_cache_config = parent_rpcs.create_rapid_cache if parent_rpcs.respond_to? :create_rapid_cache
4456
+ @create_rapid_cache = ::Gapic::Config::Method.new create_rapid_cache_config
4457
+ update_rapid_cache_config = parent_rpcs.update_rapid_cache if parent_rpcs.respond_to? :update_rapid_cache
4458
+ @update_rapid_cache = ::Gapic::Config::Method.new update_rapid_cache_config
4459
+ get_rapid_cache_config = parent_rpcs.get_rapid_cache if parent_rpcs.respond_to? :get_rapid_cache
4460
+ @get_rapid_cache = ::Gapic::Config::Method.new get_rapid_cache_config
4461
+ list_rapid_caches_config = parent_rpcs.list_rapid_caches if parent_rpcs.respond_to? :list_rapid_caches
4462
+ @list_rapid_caches = ::Gapic::Config::Method.new list_rapid_caches_config
3914
4463
  get_project_intelligence_config_config = parent_rpcs.get_project_intelligence_config if parent_rpcs.respond_to? :get_project_intelligence_config
3915
4464
  @get_project_intelligence_config = ::Gapic::Config::Method.new get_project_intelligence_config_config
3916
4465
  update_project_intelligence_config_config = parent_rpcs.update_project_intelligence_config if parent_rpcs.respond_to? :update_project_intelligence_config