google-cloud-storage-control-v2 1.0.0 → 1.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/README.md +30 -20
- data/lib/google/cloud/storage/control/v2/storage_control/client.rb +30 -11
- data/lib/google/cloud/storage/control/v2/storage_control/operations.rb +12 -15
- data/lib/google/cloud/storage/control/v2/version.rb +1 -1
- data/proto_docs/google/api/client.rb +70 -10
- data/proto_docs/google/api/field_info.rb +23 -0
- data/proto_docs/google/api/resource.rb +7 -2
- data/proto_docs/google/longrunning/operations.rb +19 -14
- metadata +5 -5
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 80b4732e2c5fc89ee1a28acf18401d527d56a5292deddb172372ff0a5b326e93
|
4
|
+
data.tar.gz: 1e96717d3d3c6fb98ba8c7890633e1e123439eab70f45d092044f220717fd64a
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 2d5659a88ae1fbc01f2df0b40e7ade80a91d30645e7f9034c29178701d5d9e55943fe8ac094aa4a64b1ad5daa9b221d520348f293bf686bd6fdce3a9514e15f4
|
7
|
+
data.tar.gz: 12f6641d8a6b681171eb3e31a010a92842cd0a43fed4d4bdc22172e782be265340dc3b40e05ef1b7049b6c8a5501a66ff6207b396f050b1fd73afd82f72bfc0c
|
data/README.md
CHANGED
@@ -43,33 +43,43 @@ for class and method documentation.
|
|
43
43
|
See also the [Product Documentation](https://cloud.google.com/storage/docs/overview)
|
44
44
|
for general usage information.
|
45
45
|
|
46
|
-
##
|
47
|
-
|
48
|
-
|
49
|
-
|
50
|
-
|
51
|
-
|
52
|
-
|
53
|
-
|
54
|
-
|
46
|
+
## Debug Logging
|
47
|
+
|
48
|
+
This library comes with opt-in Debug Logging that can help you troubleshoot
|
49
|
+
your application's integration with the API. When logging is activated, key
|
50
|
+
events such as requests and responses, along with data payloads and metadata
|
51
|
+
such as headers and client configuration, are logged to the standard error
|
52
|
+
stream.
|
53
|
+
|
54
|
+
**WARNING:** Client Library Debug Logging includes your data payloads in
|
55
|
+
plaintext, which could include sensitive data such as PII for yourself or your
|
56
|
+
customers, private keys, or other security data that could be compromising if
|
57
|
+
leaked. Always practice good data hygiene with your application logs, and follow
|
58
|
+
the principle of least access. Google also recommends that Client Library Debug
|
59
|
+
Logging be enabled only temporarily during active debugging, and not used
|
60
|
+
permanently in production.
|
61
|
+
|
62
|
+
To enable logging, set the environment variable `GOOGLE_SDK_RUBY_LOGGING_GEMS`
|
63
|
+
to the value `all`. Alternatively, you can set the value to a comma-delimited
|
64
|
+
list of client library gem names. This will select the default logging behavior,
|
65
|
+
which writes logs to the standard error stream. On a local workstation, this may
|
66
|
+
result in logs appearing on the console. When running on a Google Cloud hosting
|
67
|
+
service such as [Google Cloud Run](https://cloud.google.com/run), this generally
|
68
|
+
results in logs appearing alongside your application logs in the
|
69
|
+
[Google Cloud Logging](https://cloud.google.com/logging/) service.
|
70
|
+
|
71
|
+
You can customize logging by modifying the `logger` configuration when
|
72
|
+
constructing a client object. For example:
|
55
73
|
|
56
74
|
```ruby
|
75
|
+
require "google/cloud/storage/control/v2"
|
57
76
|
require "logger"
|
58
77
|
|
59
|
-
|
60
|
-
|
61
|
-
def logger
|
62
|
-
LOGGER
|
63
|
-
end
|
64
|
-
end
|
65
|
-
|
66
|
-
# Define a gRPC module-level logger method before grpc/logconfig.rb loads.
|
67
|
-
module GRPC
|
68
|
-
extend MyLogger
|
78
|
+
client = ::Google::Cloud::Storage::Control::V2::StorageControl::Client.new do |config|
|
79
|
+
config.logger = Logger.new "my-app.log"
|
69
80
|
end
|
70
81
|
```
|
71
82
|
|
72
|
-
|
73
83
|
## Google Cloud Samples
|
74
84
|
|
75
85
|
To browse ready to use code samples check [Google Cloud Samples](https://cloud.google.com/docs/samples).
|
@@ -197,8 +197,19 @@ module Google
|
|
197
197
|
universe_domain: @config.universe_domain,
|
198
198
|
channel_args: @config.channel_args,
|
199
199
|
interceptors: @config.interceptors,
|
200
|
-
channel_pool_config: @config.channel_pool
|
200
|
+
channel_pool_config: @config.channel_pool,
|
201
|
+
logger: @config.logger
|
201
202
|
)
|
203
|
+
|
204
|
+
@storage_control_stub.stub_logger&.info do |entry|
|
205
|
+
entry.set_system_name
|
206
|
+
entry.set_service
|
207
|
+
entry.message = "Created client for #{entry.service}"
|
208
|
+
entry.set_credentials_fields credentials
|
209
|
+
entry.set "customEndpoint", @config.endpoint if @config.endpoint
|
210
|
+
entry.set "defaultTimeout", @config.timeout if @config.timeout
|
211
|
+
entry.set "quotaProject", @quota_project_id if @quota_project_id
|
212
|
+
end
|
202
213
|
end
|
203
214
|
|
204
215
|
##
|
@@ -208,6 +219,15 @@ module Google
|
|
208
219
|
#
|
209
220
|
attr_reader :operations_client
|
210
221
|
|
222
|
+
##
|
223
|
+
# The logger used for request/response debug logging.
|
224
|
+
#
|
225
|
+
# @return [Logger]
|
226
|
+
#
|
227
|
+
def logger
|
228
|
+
@storage_control_stub.logger
|
229
|
+
end
|
230
|
+
|
211
231
|
# Service calls
|
212
232
|
|
213
233
|
##
|
@@ -309,7 +329,6 @@ module Google
|
|
309
329
|
|
310
330
|
@storage_control_stub.call_rpc :create_folder, request, options: options do |response, operation|
|
311
331
|
yield response, operation if block_given?
|
312
|
-
return response
|
313
332
|
end
|
314
333
|
rescue ::GRPC::BadStatus => e
|
315
334
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -409,7 +428,6 @@ module Google
|
|
409
428
|
|
410
429
|
@storage_control_stub.call_rpc :delete_folder, request, options: options do |response, operation|
|
411
430
|
yield response, operation if block_given?
|
412
|
-
return response
|
413
431
|
end
|
414
432
|
rescue ::GRPC::BadStatus => e
|
415
433
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -509,7 +527,6 @@ module Google
|
|
509
527
|
|
510
528
|
@storage_control_stub.call_rpc :get_folder, request, options: options do |response, operation|
|
511
529
|
yield response, operation if block_given?
|
512
|
-
return response
|
513
530
|
end
|
514
531
|
rescue ::GRPC::BadStatus => e
|
515
532
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -628,7 +645,7 @@ module Google
|
|
628
645
|
@storage_control_stub.call_rpc :list_folders, request, options: options do |response, operation|
|
629
646
|
response = ::Gapic::PagedEnumerable.new @storage_control_stub, :list_folders, request, response, operation, options
|
630
647
|
yield response, operation if block_given?
|
631
|
-
|
648
|
+
throw :response, response
|
632
649
|
end
|
633
650
|
rescue ::GRPC::BadStatus => e
|
634
651
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -741,7 +758,7 @@ module Google
|
|
741
758
|
@storage_control_stub.call_rpc :rename_folder, request, options: options do |response, operation|
|
742
759
|
response = ::Gapic::Operation.new response, @operations_client, options: options
|
743
760
|
yield response, operation if block_given?
|
744
|
-
|
761
|
+
throw :response, response
|
745
762
|
end
|
746
763
|
rescue ::GRPC::BadStatus => e
|
747
764
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -837,7 +854,6 @@ module Google
|
|
837
854
|
|
838
855
|
@storage_control_stub.call_rpc :get_storage_layout, request, options: options do |response, operation|
|
839
856
|
yield response, operation if block_given?
|
840
|
-
return response
|
841
857
|
end
|
842
858
|
rescue ::GRPC::BadStatus => e
|
843
859
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -934,7 +950,6 @@ module Google
|
|
934
950
|
|
935
951
|
@storage_control_stub.call_rpc :create_managed_folder, request, options: options do |response, operation|
|
936
952
|
yield response, operation if block_given?
|
937
|
-
return response
|
938
953
|
end
|
939
954
|
rescue ::GRPC::BadStatus => e
|
940
955
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -1039,7 +1054,6 @@ module Google
|
|
1039
1054
|
|
1040
1055
|
@storage_control_stub.call_rpc :delete_managed_folder, request, options: options do |response, operation|
|
1041
1056
|
yield response, operation if block_given?
|
1042
|
-
return response
|
1043
1057
|
end
|
1044
1058
|
rescue ::GRPC::BadStatus => e
|
1045
1059
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -1139,7 +1153,6 @@ module Google
|
|
1139
1153
|
|
1140
1154
|
@storage_control_stub.call_rpc :get_managed_folder, request, options: options do |response, operation|
|
1141
1155
|
yield response, operation if block_given?
|
1142
|
-
return response
|
1143
1156
|
end
|
1144
1157
|
rescue ::GRPC::BadStatus => e
|
1145
1158
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -1242,7 +1255,7 @@ module Google
|
|
1242
1255
|
@storage_control_stub.call_rpc :list_managed_folders, request, options: options do |response, operation|
|
1243
1256
|
response = ::Gapic::PagedEnumerable.new @storage_control_stub, :list_managed_folders, request, response, operation, options
|
1244
1257
|
yield response, operation if block_given?
|
1245
|
-
|
1258
|
+
throw :response, response
|
1246
1259
|
end
|
1247
1260
|
rescue ::GRPC::BadStatus => e
|
1248
1261
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -1331,6 +1344,11 @@ module Google
|
|
1331
1344
|
# default endpoint URL. The default value of nil uses the environment
|
1332
1345
|
# universe (usually the default "googleapis.com" universe).
|
1333
1346
|
# @return [::String,nil]
|
1347
|
+
# @!attribute [rw] logger
|
1348
|
+
# A custom logger to use for request/response debug logging, or the value
|
1349
|
+
# `:default` (the default) to construct a default logger, or `nil` to
|
1350
|
+
# explicitly disable logging.
|
1351
|
+
# @return [::Logger,:default,nil]
|
1334
1352
|
#
|
1335
1353
|
class Configuration
|
1336
1354
|
extend ::Gapic::Config
|
@@ -1355,6 +1373,7 @@ module Google
|
|
1355
1373
|
config_attr :retry_policy, nil, ::Hash, ::Proc, nil
|
1356
1374
|
config_attr :quota_project, nil, ::String, nil
|
1357
1375
|
config_attr :universe_domain, nil, ::String, nil
|
1376
|
+
config_attr :logger, :default, ::Logger, nil, :default
|
1358
1377
|
|
1359
1378
|
# @private
|
1360
1379
|
def initialize parent_config = nil
|
@@ -125,14 +125,6 @@ module Google
|
|
125
125
|
# Lists operations that match the specified filter in the request. If the
|
126
126
|
# server doesn't support this method, it returns `UNIMPLEMENTED`.
|
127
127
|
#
|
128
|
-
# NOTE: the `name` binding allows API services to override the binding
|
129
|
-
# to use different resource name schemes, such as `users/*/operations`. To
|
130
|
-
# override the binding, API services can add a binding such as
|
131
|
-
# `"/v1/{name=users/*}/operations"` to their service configuration.
|
132
|
-
# For backwards compatibility, the default name includes the operations
|
133
|
-
# collection id, however overriding users must ensure the name binding
|
134
|
-
# is the parent resource, without the operations collection id.
|
135
|
-
#
|
136
128
|
# @overload list_operations(request, options = nil)
|
137
129
|
# Pass arguments to `list_operations` via a request object, either of type
|
138
130
|
# {::Google::Longrunning::ListOperationsRequest} or an equivalent Hash.
|
@@ -222,7 +214,7 @@ module Google
|
|
222
214
|
wrap_lro_operation = ->(op_response) { ::Gapic::Operation.new op_response, @operations_client }
|
223
215
|
response = ::Gapic::PagedEnumerable.new @operations_stub, :list_operations, request, response, operation, options, format_resource: wrap_lro_operation
|
224
216
|
yield response, operation if block_given?
|
225
|
-
|
217
|
+
throw :response, response
|
226
218
|
end
|
227
219
|
rescue ::GRPC::BadStatus => e
|
228
220
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -318,7 +310,7 @@ module Google
|
|
318
310
|
@operations_stub.call_rpc :get_operation, request, options: options do |response, operation|
|
319
311
|
response = ::Gapic::Operation.new response, @operations_client, options: options
|
320
312
|
yield response, operation if block_given?
|
321
|
-
|
313
|
+
throw :response, response
|
322
314
|
end
|
323
315
|
rescue ::GRPC::BadStatus => e
|
324
316
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -407,7 +399,6 @@ module Google
|
|
407
399
|
|
408
400
|
@operations_stub.call_rpc :delete_operation, request, options: options do |response, operation|
|
409
401
|
yield response, operation if block_given?
|
410
|
-
return response
|
411
402
|
end
|
412
403
|
rescue ::GRPC::BadStatus => e
|
413
404
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -422,8 +413,9 @@ module Google
|
|
422
413
|
# other methods to check whether the cancellation succeeded or whether the
|
423
414
|
# operation completed despite cancellation. On successful cancellation,
|
424
415
|
# the operation is not deleted; instead, it becomes an operation with
|
425
|
-
# an {::Google::Longrunning::Operation#error Operation.error} value with a
|
426
|
-
# corresponding to
|
416
|
+
# an {::Google::Longrunning::Operation#error Operation.error} value with a
|
417
|
+
# {::Google::Rpc::Status#code google.rpc.Status.code} of `1`, corresponding to
|
418
|
+
# `Code.CANCELLED`.
|
427
419
|
#
|
428
420
|
# @overload cancel_operation(request, options = nil)
|
429
421
|
# Pass arguments to `cancel_operation` via a request object, either of type
|
@@ -502,7 +494,6 @@ module Google
|
|
502
494
|
|
503
495
|
@operations_stub.call_rpc :cancel_operation, request, options: options do |response, operation|
|
504
496
|
yield response, operation if block_given?
|
505
|
-
return response
|
506
497
|
end
|
507
498
|
rescue ::GRPC::BadStatus => e
|
508
499
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -600,7 +591,7 @@ module Google
|
|
600
591
|
@operations_stub.call_rpc :wait_operation, request, options: options do |response, operation|
|
601
592
|
response = ::Gapic::Operation.new response, @operations_client, options: options
|
602
593
|
yield response, operation if block_given?
|
603
|
-
|
594
|
+
throw :response, response
|
604
595
|
end
|
605
596
|
rescue ::GRPC::BadStatus => e
|
606
597
|
raise ::Google::Cloud::Error.from_error(e)
|
@@ -689,6 +680,11 @@ module Google
|
|
689
680
|
# default endpoint URL. The default value of nil uses the environment
|
690
681
|
# universe (usually the default "googleapis.com" universe).
|
691
682
|
# @return [::String,nil]
|
683
|
+
# @!attribute [rw] logger
|
684
|
+
# A custom logger to use for request/response debug logging, or the value
|
685
|
+
# `:default` (the default) to construct a default logger, or `nil` to
|
686
|
+
# explicitly disable logging.
|
687
|
+
# @return [::Logger,:default,nil]
|
692
688
|
#
|
693
689
|
class Configuration
|
694
690
|
extend ::Gapic::Config
|
@@ -713,6 +709,7 @@ module Google
|
|
713
709
|
config_attr :retry_policy, nil, ::Hash, ::Proc, nil
|
714
710
|
config_attr :quota_project, nil, ::String, nil
|
715
711
|
config_attr :universe_domain, nil, ::String, nil
|
712
|
+
config_attr :logger, :default, ::Logger, nil, :default
|
716
713
|
|
717
714
|
# @private
|
718
715
|
def initialize parent_config = nil
|
@@ -28,6 +28,9 @@ module Google
|
|
28
28
|
# @!attribute [rw] destinations
|
29
29
|
# @return [::Array<::Google::Api::ClientLibraryDestination>]
|
30
30
|
# The destination where API teams want this client library to be published.
|
31
|
+
# @!attribute [rw] selective_gapic_generation
|
32
|
+
# @return [::Google::Api::SelectiveGapicGeneration]
|
33
|
+
# Configuration for which RPCs should be generated in the GAPIC client.
|
31
34
|
class CommonLanguageSettings
|
32
35
|
include ::Google::Protobuf::MessageExts
|
33
36
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
@@ -196,9 +199,32 @@ module Google
|
|
196
199
|
# @!attribute [rw] common
|
197
200
|
# @return [::Google::Api::CommonLanguageSettings]
|
198
201
|
# Some settings.
|
202
|
+
# @!attribute [rw] experimental_features
|
203
|
+
# @return [::Google::Api::PythonSettings::ExperimentalFeatures]
|
204
|
+
# Experimental features to be included during client library generation.
|
199
205
|
class PythonSettings
|
200
206
|
include ::Google::Protobuf::MessageExts
|
201
207
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
208
|
+
|
209
|
+
# Experimental features to be included during client library generation.
|
210
|
+
# These fields will be deprecated once the feature graduates and is enabled
|
211
|
+
# by default.
|
212
|
+
# @!attribute [rw] rest_async_io_enabled
|
213
|
+
# @return [::Boolean]
|
214
|
+
# Enables generation of asynchronous REST clients if `rest` transport is
|
215
|
+
# enabled. By default, asynchronous REST clients will not be generated.
|
216
|
+
# This feature will be enabled by default 1 month after launching the
|
217
|
+
# feature in preview packages.
|
218
|
+
# @!attribute [rw] protobuf_pythonic_types_enabled
|
219
|
+
# @return [::Boolean]
|
220
|
+
# Enables generation of protobuf code using new types that are more
|
221
|
+
# Pythonic which are included in `protobuf>=5.29.x`. This feature will be
|
222
|
+
# enabled by default 1 month after launching the feature in preview
|
223
|
+
# packages.
|
224
|
+
class ExperimentalFeatures
|
225
|
+
include ::Google::Protobuf::MessageExts
|
226
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
227
|
+
end
|
202
228
|
end
|
203
229
|
|
204
230
|
# Settings for Node client libraries.
|
@@ -280,9 +306,28 @@ module Google
|
|
280
306
|
# @!attribute [rw] common
|
281
307
|
# @return [::Google::Api::CommonLanguageSettings]
|
282
308
|
# Some settings.
|
309
|
+
# @!attribute [rw] renamed_services
|
310
|
+
# @return [::Google::Protobuf::Map{::String => ::String}]
|
311
|
+
# Map of service names to renamed services. Keys are the package relative
|
312
|
+
# service names and values are the name to be used for the service client
|
313
|
+
# and call options.
|
314
|
+
#
|
315
|
+
# publishing:
|
316
|
+
# go_settings:
|
317
|
+
# renamed_services:
|
318
|
+
# Publisher: TopicAdmin
|
283
319
|
class GoSettings
|
284
320
|
include ::Google::Protobuf::MessageExts
|
285
321
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
322
|
+
|
323
|
+
# @!attribute [rw] key
|
324
|
+
# @return [::String]
|
325
|
+
# @!attribute [rw] value
|
326
|
+
# @return [::String]
|
327
|
+
class RenamedServicesEntry
|
328
|
+
include ::Google::Protobuf::MessageExts
|
329
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
330
|
+
end
|
286
331
|
end
|
287
332
|
|
288
333
|
# Describes the generator configuration for a method.
|
@@ -290,6 +335,13 @@ module Google
|
|
290
335
|
# @return [::String]
|
291
336
|
# The fully qualified name of the method, for which the options below apply.
|
292
337
|
# This is used to find the method to apply the options.
|
338
|
+
#
|
339
|
+
# Example:
|
340
|
+
#
|
341
|
+
# publishing:
|
342
|
+
# method_settings:
|
343
|
+
# - selector: google.storage.control.v2.StorageControl.CreateFolder
|
344
|
+
# # method settings for CreateFolder...
|
293
345
|
# @!attribute [rw] long_running
|
294
346
|
# @return [::Google::Api::MethodSettings::LongRunning]
|
295
347
|
# Describes settings to use for long-running operations when generating
|
@@ -298,17 +350,14 @@ module Google
|
|
298
350
|
#
|
299
351
|
# Example of a YAML configuration::
|
300
352
|
#
|
301
|
-
#
|
302
|
-
#
|
353
|
+
# publishing:
|
354
|
+
# method_settings:
|
303
355
|
# - selector: google.cloud.speech.v2.Speech.BatchRecognize
|
304
356
|
# long_running:
|
305
|
-
# initial_poll_delay:
|
306
|
-
# seconds: 60 # 1 minute
|
357
|
+
# initial_poll_delay: 60s # 1 minute
|
307
358
|
# poll_delay_multiplier: 1.5
|
308
|
-
# max_poll_delay:
|
309
|
-
#
|
310
|
-
# total_poll_timeout:
|
311
|
-
# seconds: 54000 # 90 minutes
|
359
|
+
# max_poll_delay: 360s # 6 minutes
|
360
|
+
# total_poll_timeout: 54000s # 90 minutes
|
312
361
|
# @!attribute [rw] auto_populated_fields
|
313
362
|
# @return [::Array<::String>]
|
314
363
|
# List of top-level fields of the request message, that should be
|
@@ -317,8 +366,8 @@ module Google
|
|
317
366
|
#
|
318
367
|
# Example of a YAML configuration:
|
319
368
|
#
|
320
|
-
#
|
321
|
-
#
|
369
|
+
# publishing:
|
370
|
+
# method_settings:
|
322
371
|
# - selector: google.example.v1.ExampleService.CreateExample
|
323
372
|
# auto_populated_fields:
|
324
373
|
# - request_id
|
@@ -354,6 +403,17 @@ module Google
|
|
354
403
|
end
|
355
404
|
end
|
356
405
|
|
406
|
+
# This message is used to configure the generation of a subset of the RPCs in
|
407
|
+
# a service for client libraries.
|
408
|
+
# @!attribute [rw] methods
|
409
|
+
# @return [::Array<::String>]
|
410
|
+
# An allowlist of the fully qualified names of RPCs that should be included
|
411
|
+
# on public client surfaces.
|
412
|
+
class SelectiveGapicGeneration
|
413
|
+
include ::Google::Protobuf::MessageExts
|
414
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
415
|
+
end
|
416
|
+
|
357
417
|
# The organization for which the client libraries are being published.
|
358
418
|
# Affects the url where generated docs are published, etc.
|
359
419
|
module ClientLibraryOrganization
|
@@ -25,6 +25,12 @@ module Google
|
|
25
25
|
# The standard format of a field value. This does not explicitly configure
|
26
26
|
# any API consumer, just documents the API's format for the field it is
|
27
27
|
# applied to.
|
28
|
+
# @!attribute [rw] referenced_types
|
29
|
+
# @return [::Array<::Google::Api::TypeReference>]
|
30
|
+
# The type(s) that the annotated, generic field may represent.
|
31
|
+
#
|
32
|
+
# Currently, this must only be used on fields of type `google.protobuf.Any`.
|
33
|
+
# Supporting other generic types may be considered in the future.
|
28
34
|
class FieldInfo
|
29
35
|
include ::Google::Protobuf::MessageExts
|
30
36
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
@@ -61,5 +67,22 @@ module Google
|
|
61
67
|
IPV4_OR_IPV6 = 4
|
62
68
|
end
|
63
69
|
end
|
70
|
+
|
71
|
+
# A reference to a message type, for use in {::Google::Api::FieldInfo FieldInfo}.
|
72
|
+
# @!attribute [rw] type_name
|
73
|
+
# @return [::String]
|
74
|
+
# The name of the type that the annotated, generic field may represent.
|
75
|
+
# If the type is in the same protobuf package, the value can be the simple
|
76
|
+
# message name e.g., `"MyMessage"`. Otherwise, the value must be the
|
77
|
+
# fully-qualified message name e.g., `"google.library.v1.Book"`.
|
78
|
+
#
|
79
|
+
# If the type(s) are unknown to the service (e.g. the field accepts generic
|
80
|
+
# user input), use the wildcard `"*"` to denote this behavior.
|
81
|
+
#
|
82
|
+
# See [AIP-202](https://google.aip.dev/202#type-references) for more details.
|
83
|
+
class TypeReference
|
84
|
+
include ::Google::Protobuf::MessageExts
|
85
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
86
|
+
end
|
64
87
|
end
|
65
88
|
end
|
@@ -124,8 +124,13 @@ module Google
|
|
124
124
|
# @return [::String]
|
125
125
|
# The plural name used in the resource name and permission names, such as
|
126
126
|
# 'projects' for the resource name of 'projects/\\{project}' and the permission
|
127
|
-
# name of 'cloudresourcemanager.googleapis.com/projects.get'.
|
128
|
-
#
|
127
|
+
# name of 'cloudresourcemanager.googleapis.com/projects.get'. One exception
|
128
|
+
# to this is for Nested Collections that have stuttering names, as defined
|
129
|
+
# in [AIP-122](https://google.aip.dev/122#nested-collections), where the
|
130
|
+
# collection ID in the resource name pattern does not necessarily directly
|
131
|
+
# match the `plural` value.
|
132
|
+
#
|
133
|
+
# It is the same concept of the `plural` field in k8s CRD spec
|
129
134
|
# https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
|
130
135
|
#
|
131
136
|
# Note: The plural form is required even for singleton resources. See
|
@@ -42,7 +42,7 @@ module Google
|
|
42
42
|
# The error result of the operation in case of failure or cancellation.
|
43
43
|
# @!attribute [rw] response
|
44
44
|
# @return [::Google::Protobuf::Any]
|
45
|
-
# The normal response of the operation
|
45
|
+
# The normal, successful response of the operation. If the original
|
46
46
|
# method returns no data on success, such as `Delete`, the response is
|
47
47
|
# `google.protobuf.Empty`. If the original method is standard
|
48
48
|
# `Get`/`Create`/`Update`, the response should be the resource. For other
|
@@ -55,7 +55,8 @@ module Google
|
|
55
55
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
56
56
|
end
|
57
57
|
|
58
|
-
# The request message for
|
58
|
+
# The request message for
|
59
|
+
# Operations.GetOperation.
|
59
60
|
# @!attribute [rw] name
|
60
61
|
# @return [::String]
|
61
62
|
# The name of the operation resource.
|
@@ -64,7 +65,8 @@ module Google
|
|
64
65
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
65
66
|
end
|
66
67
|
|
67
|
-
# The request message for
|
68
|
+
# The request message for
|
69
|
+
# Operations.ListOperations.
|
68
70
|
# @!attribute [rw] name
|
69
71
|
# @return [::String]
|
70
72
|
# The name of the operation's parent resource.
|
@@ -82,7 +84,8 @@ module Google
|
|
82
84
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
83
85
|
end
|
84
86
|
|
85
|
-
# The response message for
|
87
|
+
# The response message for
|
88
|
+
# Operations.ListOperations.
|
86
89
|
# @!attribute [rw] operations
|
87
90
|
# @return [::Array<::Google::Longrunning::Operation>]
|
88
91
|
# A list of operations that matches the specified filter in the request.
|
@@ -94,7 +97,8 @@ module Google
|
|
94
97
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
95
98
|
end
|
96
99
|
|
97
|
-
# The request message for
|
100
|
+
# The request message for
|
101
|
+
# Operations.CancelOperation.
|
98
102
|
# @!attribute [rw] name
|
99
103
|
# @return [::String]
|
100
104
|
# The name of the operation resource to be cancelled.
|
@@ -103,7 +107,8 @@ module Google
|
|
103
107
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
104
108
|
end
|
105
109
|
|
106
|
-
# The request message for
|
110
|
+
# The request message for
|
111
|
+
# Operations.DeleteOperation.
|
107
112
|
# @!attribute [rw] name
|
108
113
|
# @return [::String]
|
109
114
|
# The name of the operation resource to be deleted.
|
@@ -112,7 +117,8 @@ module Google
|
|
112
117
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
113
118
|
end
|
114
119
|
|
115
|
-
# The request message for
|
120
|
+
# The request message for
|
121
|
+
# Operations.WaitOperation.
|
116
122
|
# @!attribute [rw] name
|
117
123
|
# @return [::String]
|
118
124
|
# The name of the operation resource to wait on.
|
@@ -130,13 +136,12 @@ module Google
|
|
130
136
|
#
|
131
137
|
# Example:
|
132
138
|
#
|
133
|
-
#
|
134
|
-
#
|
135
|
-
#
|
136
|
-
#
|
137
|
-
#
|
138
|
-
# }
|
139
|
-
# }
|
139
|
+
# rpc Export(ExportRequest) returns (google.longrunning.Operation) {
|
140
|
+
# option (google.longrunning.operation_info) = {
|
141
|
+
# response_type: "ExportResponse"
|
142
|
+
# metadata_type: "ExportMetadata"
|
143
|
+
# };
|
144
|
+
# }
|
140
145
|
# @!attribute [rw] response_type
|
141
146
|
# @return [::String]
|
142
147
|
# Required. The message name of the primary return type for this
|
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: google-cloud-storage-control-v2
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 1.
|
4
|
+
version: 1.1.0
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Google LLC
|
8
8
|
autorequire:
|
9
9
|
bindir: bin
|
10
10
|
cert_chain: []
|
11
|
-
date: 2024-
|
11
|
+
date: 2024-12-10 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
name: gapic-common
|
@@ -16,7 +16,7 @@ dependencies:
|
|
16
16
|
requirements:
|
17
17
|
- - ">="
|
18
18
|
- !ruby/object:Gem::Version
|
19
|
-
version: 0.
|
19
|
+
version: 0.24.0
|
20
20
|
- - "<"
|
21
21
|
- !ruby/object:Gem::Version
|
22
22
|
version: 2.a
|
@@ -26,7 +26,7 @@ dependencies:
|
|
26
26
|
requirements:
|
27
27
|
- - ">="
|
28
28
|
- !ruby/object:Gem::Version
|
29
|
-
version: 0.
|
29
|
+
version: 0.24.0
|
30
30
|
- - "<"
|
31
31
|
- !ruby/object:Gem::Version
|
32
32
|
version: 2.a
|
@@ -105,7 +105,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
|
|
105
105
|
- !ruby/object:Gem::Version
|
106
106
|
version: '0'
|
107
107
|
requirements: []
|
108
|
-
rubygems_version: 3.5.
|
108
|
+
rubygems_version: 3.5.23
|
109
109
|
signing_key:
|
110
110
|
specification_version: 4
|
111
111
|
summary: The Storage Control API lets you perform metadata-specific, control plane,
|