google-apis-storage_v1 0.32.0 → 0.33.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: '082994552478f30980e6c10d42adc7e06440c990e7c64f9178a5d47962e4498e'
4
- data.tar.gz: ba0979be68147b00908232118012fce6cdf20a4c2a6a25c4c42e47f6b1ee5bfd
3
+ metadata.gz: f989e40a2987931829276d4995a71ebda962f08ccde2b5fed1a2af4aed15d926
4
+ data.tar.gz: 4ab145c53f7e2048f0c387d4fdf623ef4fba5d5a3a924449bfbd55731b5191b8
5
5
  SHA512:
6
- metadata.gz: cb0343be2838ce35223834668e967a0bcbe901895f2560a2023eb8ec3e0f4f4c2bb4d7b4527ef50932be37011a2659126615cdcc8c25882987d17c34671cf6c0
7
- data.tar.gz: cd78298b11dde8312e695016b15b992b396494d6fdf5d696ef0ca47bfc31d47074aa19348a295ba505575d4b0d458b15f362685e349416347f7519e04c96a560
6
+ metadata.gz: fd56b0fd9489f800ff57f769ae3f296616b572b6014e5a971584ab6497274f805d60cf697fd4d3c85d0047c2dc68d70c02bc5e6d76eb479e947469dc95c3dfa0
7
+ data.tar.gz: 649bb8c3203d6ce70a54216cd8446461489c9bc3b74257670ea57e965ef7815bee3b4a1b4889ecdc93f51a3f4519cc0291932bb7d506f8cbe835c6b6b50181ff
data/CHANGELOG.md CHANGED
@@ -1,5 +1,10 @@
1
1
  # Release history for google-apis-storage_v1
2
2
 
3
+ ### v0.33.0 (2024-01-23)
4
+
5
+ * Regenerated from discovery document revision 20240105
6
+ * Regenerated using generator version 0.13.0
7
+
3
8
  ### v0.32.0 (2023-12-24)
4
9
 
5
10
  * Regenerated from discovery document revision 20231218
@@ -204,6 +204,11 @@ module Google
204
204
  # @return [String]
205
205
  attr_accessor :etag
206
206
 
207
+ # The bucket's hierarchical namespace configuration.
208
+ # Corresponds to the JSON property `hierarchicalNamespace`
209
+ # @return [Google::Apis::StorageV1::Bucket::HierarchicalNamespace]
210
+ attr_accessor :hierarchical_namespace
211
+
207
212
  # The bucket's IAM configuration.
208
213
  # Corresponds to the JSON property `iamConfiguration`
209
214
  # @return [Google::Apis::StorageV1::Bucket::IamConfiguration]
@@ -357,6 +362,7 @@ module Google
357
362
  @default_object_acl = args[:default_object_acl] if args.key?(:default_object_acl)
358
363
  @encryption = args[:encryption] if args.key?(:encryption)
359
364
  @etag = args[:etag] if args.key?(:etag)
365
+ @hierarchical_namespace = args[:hierarchical_namespace] if args.key?(:hierarchical_namespace)
360
366
  @iam_configuration = args[:iam_configuration] if args.key?(:iam_configuration)
361
367
  @id = args[:id] if args.key?(:id)
362
368
  @kind = args[:kind] if args.key?(:kind)
@@ -525,6 +531,26 @@ module Google
525
531
  end
526
532
  end
527
533
 
534
+ # The bucket's hierarchical namespace configuration.
535
+ class HierarchicalNamespace
536
+ include Google::Apis::Core::Hashable
537
+
538
+ # When set to true, hierarchical namespace is enabled for this bucket.
539
+ # Corresponds to the JSON property `enabled`
540
+ # @return [Boolean]
541
+ attr_accessor :enabled
542
+ alias_method :enabled?, :enabled
543
+
544
+ def initialize(**args)
545
+ update!(**args)
546
+ end
547
+
548
+ # Update properties of this object
549
+ def update!(**args)
550
+ @enabled = args[:enabled] if args.key?(:enabled)
551
+ end
552
+ end
553
+
528
554
  # The bucket's IAM configuration.
529
555
  class IamConfiguration
530
556
  include Google::Apis::Core::Hashable
@@ -1433,6 +1459,133 @@ module Google
1433
1459
  end
1434
1460
  end
1435
1461
 
1462
+ # A folder. Only available in buckets with hierarchical namespace enabled.
1463
+ class Folder
1464
+ include Google::Apis::Core::Hashable
1465
+
1466
+ # The name of the bucket containing this folder.
1467
+ # Corresponds to the JSON property `bucket`
1468
+ # @return [String]
1469
+ attr_accessor :bucket
1470
+
1471
+ # The ID of the folder, including the bucket name, folder name.
1472
+ # Corresponds to the JSON property `id`
1473
+ # @return [String]
1474
+ attr_accessor :id
1475
+
1476
+ # The kind of item this is. For folders, this is always storage#folder.
1477
+ # Corresponds to the JSON property `kind`
1478
+ # @return [String]
1479
+ attr_accessor :kind
1480
+
1481
+ # User-provided metadata, in key/value pairs.
1482
+ # Corresponds to the JSON property `metadata`
1483
+ # @return [Hash<String,String>]
1484
+ attr_accessor :metadata
1485
+
1486
+ # The version of the metadata for this folder. Used for preconditions and for
1487
+ # detecting changes in metadata.
1488
+ # Corresponds to the JSON property `metageneration`
1489
+ # @return [Fixnum]
1490
+ attr_accessor :metageneration
1491
+
1492
+ # The name of the folder. Required if not specified by URL parameter.
1493
+ # Corresponds to the JSON property `name`
1494
+ # @return [String]
1495
+ attr_accessor :name
1496
+
1497
+ # Only present if the folder is part of an ongoing rename folder operation.
1498
+ # Contains information which can be used to query the operation status.
1499
+ # Corresponds to the JSON property `pendingRenameInfo`
1500
+ # @return [Google::Apis::StorageV1::Folder::PendingRenameInfo]
1501
+ attr_accessor :pending_rename_info
1502
+
1503
+ # The link to this folder.
1504
+ # Corresponds to the JSON property `selfLink`
1505
+ # @return [String]
1506
+ attr_accessor :self_link
1507
+
1508
+ # The creation time of the folder in RFC 3339 format.
1509
+ # Corresponds to the JSON property `timeCreated`
1510
+ # @return [DateTime]
1511
+ attr_accessor :time_created
1512
+
1513
+ # The modification time of the folder metadata in RFC 3339 format.
1514
+ # Corresponds to the JSON property `updated`
1515
+ # @return [DateTime]
1516
+ attr_accessor :updated
1517
+
1518
+ def initialize(**args)
1519
+ update!(**args)
1520
+ end
1521
+
1522
+ # Update properties of this object
1523
+ def update!(**args)
1524
+ @bucket = args[:bucket] if args.key?(:bucket)
1525
+ @id = args[:id] if args.key?(:id)
1526
+ @kind = args[:kind] if args.key?(:kind)
1527
+ @metadata = args[:metadata] if args.key?(:metadata)
1528
+ @metageneration = args[:metageneration] if args.key?(:metageneration)
1529
+ @name = args[:name] if args.key?(:name)
1530
+ @pending_rename_info = args[:pending_rename_info] if args.key?(:pending_rename_info)
1531
+ @self_link = args[:self_link] if args.key?(:self_link)
1532
+ @time_created = args[:time_created] if args.key?(:time_created)
1533
+ @updated = args[:updated] if args.key?(:updated)
1534
+ end
1535
+
1536
+ # Only present if the folder is part of an ongoing rename folder operation.
1537
+ # Contains information which can be used to query the operation status.
1538
+ class PendingRenameInfo
1539
+ include Google::Apis::Core::Hashable
1540
+
1541
+ # The ID of the rename folder operation.
1542
+ # Corresponds to the JSON property `operationId`
1543
+ # @return [String]
1544
+ attr_accessor :operation_id
1545
+
1546
+ def initialize(**args)
1547
+ update!(**args)
1548
+ end
1549
+
1550
+ # Update properties of this object
1551
+ def update!(**args)
1552
+ @operation_id = args[:operation_id] if args.key?(:operation_id)
1553
+ end
1554
+ end
1555
+ end
1556
+
1557
+ # A list of folders.
1558
+ class Folders
1559
+ include Google::Apis::Core::Hashable
1560
+
1561
+ # The list of items.
1562
+ # Corresponds to the JSON property `items`
1563
+ # @return [Array<Google::Apis::StorageV1::Folder>]
1564
+ attr_accessor :items
1565
+
1566
+ # The kind of item this is. For lists of folders, this is always storage#folders.
1567
+ # Corresponds to the JSON property `kind`
1568
+ # @return [String]
1569
+ attr_accessor :kind
1570
+
1571
+ # The continuation token, used to page through large result sets. Provide this
1572
+ # value in a subsequent request to return the next page of results.
1573
+ # Corresponds to the JSON property `nextPageToken`
1574
+ # @return [String]
1575
+ attr_accessor :next_page_token
1576
+
1577
+ def initialize(**args)
1578
+ update!(**args)
1579
+ end
1580
+
1581
+ # Update properties of this object
1582
+ def update!(**args)
1583
+ @items = args[:items] if args.key?(:items)
1584
+ @kind = args[:kind] if args.key?(:kind)
1585
+ @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
1586
+ end
1587
+ end
1588
+
1436
1589
  # The response message for storage.buckets.operations.list.
1437
1590
  class GoogleLongrunningListOperationsResponse
1438
1591
  include Google::Apis::Core::Hashable
@@ -16,13 +16,13 @@ module Google
16
16
  module Apis
17
17
  module StorageV1
18
18
  # Version of the google-apis-storage_v1 gem
19
- GEM_VERSION = "0.32.0"
19
+ GEM_VERSION = "0.33.0"
20
20
 
21
21
  # Version of the code generator used to generate this client
22
- GENERATOR_VERSION = "0.12.0"
22
+ GENERATOR_VERSION = "0.13.0"
23
23
 
24
24
  # Revision of the discovery document this client was generated from
25
- REVISION = "20231218"
25
+ REVISION = "20240105"
26
26
  end
27
27
  end
28
28
  end
@@ -67,6 +67,12 @@ module Google
67
67
  include Google::Apis::Core::JsonObjectSupport
68
68
  end
69
69
 
70
+ class HierarchicalNamespace
71
+ class Representation < Google::Apis::Core::JsonRepresentation; end
72
+
73
+ include Google::Apis::Core::JsonObjectSupport
74
+ end
75
+
70
76
  class IamConfiguration
71
77
  class Representation < Google::Apis::Core::JsonRepresentation; end
72
78
 
@@ -214,6 +220,24 @@ module Google
214
220
  include Google::Apis::Core::JsonObjectSupport
215
221
  end
216
222
 
223
+ class Folder
224
+ class Representation < Google::Apis::Core::JsonRepresentation; end
225
+
226
+ class PendingRenameInfo
227
+ class Representation < Google::Apis::Core::JsonRepresentation; end
228
+
229
+ include Google::Apis::Core::JsonObjectSupport
230
+ end
231
+
232
+ include Google::Apis::Core::JsonObjectSupport
233
+ end
234
+
235
+ class Folders
236
+ class Representation < Google::Apis::Core::JsonRepresentation; end
237
+
238
+ include Google::Apis::Core::JsonObjectSupport
239
+ end
240
+
217
241
  class GoogleLongrunningListOperationsResponse
218
242
  class Representation < Google::Apis::Core::JsonRepresentation; end
219
243
 
@@ -401,6 +425,8 @@ module Google
401
425
  property :encryption, as: 'encryption', class: Google::Apis::StorageV1::Bucket::Encryption, decorator: Google::Apis::StorageV1::Bucket::Encryption::Representation
402
426
 
403
427
  property :etag, as: 'etag'
428
+ property :hierarchical_namespace, as: 'hierarchicalNamespace', class: Google::Apis::StorageV1::Bucket::HierarchicalNamespace, decorator: Google::Apis::StorageV1::Bucket::HierarchicalNamespace::Representation
429
+
404
430
  property :iam_configuration, as: 'iamConfiguration', class: Google::Apis::StorageV1::Bucket::IamConfiguration, decorator: Google::Apis::StorageV1::Bucket::IamConfiguration::Representation
405
431
 
406
432
  property :id, as: 'id'
@@ -480,6 +506,13 @@ module Google
480
506
  end
481
507
  end
482
508
 
509
+ class HierarchicalNamespace
510
+ # @private
511
+ class Representation < Google::Apis::Core::JsonRepresentation
512
+ property :enabled, as: 'enabled'
513
+ end
514
+ end
515
+
483
516
  class IamConfiguration
484
517
  # @private
485
518
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -726,6 +759,42 @@ module Google
726
759
  end
727
760
  end
728
761
 
762
+ class Folder
763
+ # @private
764
+ class Representation < Google::Apis::Core::JsonRepresentation
765
+ property :bucket, as: 'bucket'
766
+ property :id, as: 'id'
767
+ property :kind, as: 'kind'
768
+ hash :metadata, as: 'metadata'
769
+ property :metageneration, :numeric_string => true, as: 'metageneration'
770
+ property :name, as: 'name'
771
+ property :pending_rename_info, as: 'pendingRenameInfo', class: Google::Apis::StorageV1::Folder::PendingRenameInfo, decorator: Google::Apis::StorageV1::Folder::PendingRenameInfo::Representation
772
+
773
+ property :self_link, as: 'selfLink'
774
+ property :time_created, as: 'timeCreated', type: DateTime
775
+
776
+ property :updated, as: 'updated', type: DateTime
777
+
778
+ end
779
+
780
+ class PendingRenameInfo
781
+ # @private
782
+ class Representation < Google::Apis::Core::JsonRepresentation
783
+ property :operation_id, as: 'operationId'
784
+ end
785
+ end
786
+ end
787
+
788
+ class Folders
789
+ # @private
790
+ class Representation < Google::Apis::Core::JsonRepresentation
791
+ collection :items, as: 'items', class: Google::Apis::StorageV1::Folder, decorator: Google::Apis::StorageV1::Folder::Representation
792
+
793
+ property :kind, as: 'kind'
794
+ property :next_page_token, as: 'nextPageToken'
795
+ end
796
+ end
797
+
729
798
  class GoogleLongrunningListOperationsResponse
730
799
  # @private
731
800
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -32,6 +32,8 @@ module Google
32
32
  #
33
33
  # @see https://developers.google.com/storage/docs/json_api/
34
34
  class StorageService < Google::Apis::Core::BaseService
35
+ DEFAULT_ENDPOINT_TEMPLATE = "https://storage.$UNIVERSE_DOMAIN$/"
36
+
35
37
  # @return [String]
36
38
  # API key. Your API key identifies your project and provides you with API access,
37
39
  # quota, and reports. Required unless you provide an OAuth 2.0 token.
@@ -47,7 +49,7 @@ module Google
47
49
  attr_accessor :user_ip
48
50
 
49
51
  def initialize
50
- super('https://storage.googleapis.com/', 'storage/v1/',
52
+ super(DEFAULT_ENDPOINT_TEMPLATE, 'storage/v1/',
51
53
  client_name: 'google-apis-storage_v1',
52
54
  client_version: Google::Apis::StorageV1::GEM_VERSION)
53
55
  @batch_path = 'batch/storage/v1'
@@ -165,7 +167,7 @@ module Google
165
167
  # @param [String] bucket
166
168
  # Name of the parent bucket.
167
169
  # @param [Fixnum] page_size
168
- # Maximum number of items return in a single page of responses. Maximum 1000.
170
+ # Maximum number of items to return in a single page of responses. Maximum 1000.
169
171
  # @param [String] page_token
170
172
  # A previously-returned page token representing part of the larger set of
171
173
  # results to view.
@@ -1296,6 +1298,241 @@ module Google
1296
1298
  execute_or_queue_command(command, &block)
1297
1299
  end
1298
1300
 
1301
+ # Permanently deletes a folder. Only applicable to buckets with hierarchical
1302
+ # namespace enabled.
1303
+ # @param [String] bucket
1304
+ # Name of the bucket in which the folder resides.
1305
+ # @param [String] folder
1306
+ # Name of a folder.
1307
+ # @param [Fixnum] if_metageneration_match
1308
+ # If set, only deletes the folder if its metageneration matches this value.
1309
+ # @param [Fixnum] if_metageneration_not_match
1310
+ # If set, only deletes the folder if its metageneration does not match this
1311
+ # value.
1312
+ # @param [String] fields
1313
+ # Selector specifying which fields to include in a partial response.
1314
+ # @param [String] quota_user
1315
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
1316
+ # characters.
1317
+ # @param [String] user_ip
1318
+ # Deprecated. Please use quotaUser instead.
1319
+ # @param [Google::Apis::RequestOptions] options
1320
+ # Request-specific options
1321
+ #
1322
+ # @yield [result, err] Result & error if block supplied
1323
+ # @yieldparam result [NilClass] No result returned for this method
1324
+ # @yieldparam err [StandardError] error object if request failed
1325
+ #
1326
+ # @return [void]
1327
+ #
1328
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1329
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1330
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1331
+ def delete_folder(bucket, folder, if_metageneration_match: nil, if_metageneration_not_match: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1332
+ command = make_simple_command(:delete, 'b/{bucket}/folders/{folder}', options)
1333
+ command.params['bucket'] = bucket unless bucket.nil?
1334
+ command.params['folder'] = folder unless folder.nil?
1335
+ command.query['ifMetagenerationMatch'] = if_metageneration_match unless if_metageneration_match.nil?
1336
+ command.query['ifMetagenerationNotMatch'] = if_metageneration_not_match unless if_metageneration_not_match.nil?
1337
+ command.query['fields'] = fields unless fields.nil?
1338
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1339
+ command.query['userIp'] = user_ip unless user_ip.nil?
1340
+ execute_or_queue_command(command, &block)
1341
+ end
1342
+
1343
+ # Returns metadata for the specified folder. Only applicable to buckets with
1344
+ # hierarchical namespace enabled.
1345
+ # @param [String] bucket
1346
+ # Name of the bucket in which the folder resides.
1347
+ # @param [String] folder
1348
+ # Name of a folder.
1349
+ # @param [Fixnum] if_metageneration_match
1350
+ # Makes the return of the folder metadata conditional on whether the folder's
1351
+ # current metageneration matches the given value.
1352
+ # @param [Fixnum] if_metageneration_not_match
1353
+ # Makes the return of the folder metadata conditional on whether the folder's
1354
+ # current metageneration does not match the given value.
1355
+ # @param [String] fields
1356
+ # Selector specifying which fields to include in a partial response.
1357
+ # @param [String] quota_user
1358
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
1359
+ # characters.
1360
+ # @param [String] user_ip
1361
+ # Deprecated. Please use quotaUser instead.
1362
+ # @param [Google::Apis::RequestOptions] options
1363
+ # Request-specific options
1364
+ #
1365
+ # @yield [result, err] Result & error if block supplied
1366
+ # @yieldparam result [Google::Apis::StorageV1::Folder] parsed result object
1367
+ # @yieldparam err [StandardError] error object if request failed
1368
+ #
1369
+ # @return [Google::Apis::StorageV1::Folder]
1370
+ #
1371
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1372
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1373
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1374
+ def get_folder(bucket, folder, if_metageneration_match: nil, if_metageneration_not_match: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1375
+ command = make_simple_command(:get, 'b/{bucket}/folders/{folder}', options)
1376
+ command.response_representation = Google::Apis::StorageV1::Folder::Representation
1377
+ command.response_class = Google::Apis::StorageV1::Folder
1378
+ command.params['bucket'] = bucket unless bucket.nil?
1379
+ command.params['folder'] = folder unless folder.nil?
1380
+ command.query['ifMetagenerationMatch'] = if_metageneration_match unless if_metageneration_match.nil?
1381
+ command.query['ifMetagenerationNotMatch'] = if_metageneration_not_match unless if_metageneration_not_match.nil?
1382
+ command.query['fields'] = fields unless fields.nil?
1383
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1384
+ command.query['userIp'] = user_ip unless user_ip.nil?
1385
+ execute_or_queue_command(command, &block)
1386
+ end
1387
+
1388
+ # Creates a new folder. Only applicable to buckets with hierarchical namespace
1389
+ # enabled.
1390
+ # @param [String] bucket
1391
+ # Name of the bucket in which the folder resides.
1392
+ # @param [Google::Apis::StorageV1::Folder] folder_object
1393
+ # @param [Boolean] recursive
1394
+ # If true, any parent folder which doesn’t exist will be created automatically.
1395
+ # @param [String] fields
1396
+ # Selector specifying which fields to include in a partial response.
1397
+ # @param [String] quota_user
1398
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
1399
+ # characters.
1400
+ # @param [String] user_ip
1401
+ # Deprecated. Please use quotaUser instead.
1402
+ # @param [Google::Apis::RequestOptions] options
1403
+ # Request-specific options
1404
+ #
1405
+ # @yield [result, err] Result & error if block supplied
1406
+ # @yieldparam result [Google::Apis::StorageV1::Folder] parsed result object
1407
+ # @yieldparam err [StandardError] error object if request failed
1408
+ #
1409
+ # @return [Google::Apis::StorageV1::Folder]
1410
+ #
1411
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1412
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1413
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1414
+ def insert_folder(bucket, folder_object = nil, recursive: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1415
+ command = make_simple_command(:post, 'b/{bucket}/folders', options)
1416
+ command.request_representation = Google::Apis::StorageV1::Folder::Representation
1417
+ command.request_object = folder_object
1418
+ command.response_representation = Google::Apis::StorageV1::Folder::Representation
1419
+ command.response_class = Google::Apis::StorageV1::Folder
1420
+ command.params['bucket'] = bucket unless bucket.nil?
1421
+ command.query['recursive'] = recursive unless recursive.nil?
1422
+ command.query['fields'] = fields unless fields.nil?
1423
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1424
+ command.query['userIp'] = user_ip unless user_ip.nil?
1425
+ execute_or_queue_command(command, &block)
1426
+ end
1427
+
1428
+ # Retrieves a list of folders matching the criteria. Only applicable to buckets
1429
+ # with hierarchical namespace enabled.
1430
+ # @param [String] bucket
1431
+ # Name of the bucket in which to look for folders.
1432
+ # @param [String] delimiter
1433
+ # Returns results in a directory-like mode. The only supported value is '/'. If
1434
+ # set, items will only contain folders that either exactly match the prefix, or
1435
+ # are one level below the prefix.
1436
+ # @param [String] end_offset
1437
+ # Filter results to folders whose names are lexicographically before endOffset.
1438
+ # If startOffset is also set, the folders listed will have names between
1439
+ # startOffset (inclusive) and endOffset (exclusive).
1440
+ # @param [Fixnum] page_size
1441
+ # Maximum number of items to return in a single page of responses.
1442
+ # @param [String] page_token
1443
+ # A previously-returned page token representing part of the larger set of
1444
+ # results to view.
1445
+ # @param [String] prefix
1446
+ # Filter results to folders whose paths begin with this prefix. If set, the
1447
+ # value must either be an empty string or end with a '/'.
1448
+ # @param [String] start_offset
1449
+ # Filter results to folders whose names are lexicographically equal to or after
1450
+ # startOffset. If endOffset is also set, the folders listed will have names
1451
+ # between startOffset (inclusive) and endOffset (exclusive).
1452
+ # @param [String] fields
1453
+ # Selector specifying which fields to include in a partial response.
1454
+ # @param [String] quota_user
1455
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
1456
+ # characters.
1457
+ # @param [String] user_ip
1458
+ # Deprecated. Please use quotaUser instead.
1459
+ # @param [Google::Apis::RequestOptions] options
1460
+ # Request-specific options
1461
+ #
1462
+ # @yield [result, err] Result & error if block supplied
1463
+ # @yieldparam result [Google::Apis::StorageV1::Folders] parsed result object
1464
+ # @yieldparam err [StandardError] error object if request failed
1465
+ #
1466
+ # @return [Google::Apis::StorageV1::Folders]
1467
+ #
1468
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1469
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1470
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1471
+ def list_folders(bucket, delimiter: nil, end_offset: nil, page_size: nil, page_token: nil, prefix: nil, start_offset: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1472
+ command = make_simple_command(:get, 'b/{bucket}/folders', options)
1473
+ command.response_representation = Google::Apis::StorageV1::Folders::Representation
1474
+ command.response_class = Google::Apis::StorageV1::Folders
1475
+ command.params['bucket'] = bucket unless bucket.nil?
1476
+ command.query['delimiter'] = delimiter unless delimiter.nil?
1477
+ command.query['endOffset'] = end_offset unless end_offset.nil?
1478
+ command.query['pageSize'] = page_size unless page_size.nil?
1479
+ command.query['pageToken'] = page_token unless page_token.nil?
1480
+ command.query['prefix'] = prefix unless prefix.nil?
1481
+ command.query['startOffset'] = start_offset unless start_offset.nil?
1482
+ command.query['fields'] = fields unless fields.nil?
1483
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1484
+ command.query['userIp'] = user_ip unless user_ip.nil?
1485
+ execute_or_queue_command(command, &block)
1486
+ end
1487
+
1488
+ # Renames a source folder to a destination folder. Only applicable to buckets
1489
+ # with hierarchical namespace enabled.
1490
+ # @param [String] bucket
1491
+ # Name of the bucket in which the folders are in.
1492
+ # @param [String] source_folder
1493
+ # Name of the source folder.
1494
+ # @param [String] destination_folder
1495
+ # Name of the destination folder.
1496
+ # @param [Fixnum] if_source_metageneration_match
1497
+ # Makes the operation conditional on whether the source object's current
1498
+ # metageneration matches the given value.
1499
+ # @param [Fixnum] if_source_metageneration_not_match
1500
+ # Makes the operation conditional on whether the source object's current
1501
+ # metageneration does not match the given value.
1502
+ # @param [String] fields
1503
+ # Selector specifying which fields to include in a partial response.
1504
+ # @param [String] quota_user
1505
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
1506
+ # characters.
1507
+ # @param [String] user_ip
1508
+ # Deprecated. Please use quotaUser instead.
1509
+ # @param [Google::Apis::RequestOptions] options
1510
+ # Request-specific options
1511
+ #
1512
+ # @yield [result, err] Result & error if block supplied
1513
+ # @yieldparam result [Google::Apis::StorageV1::GoogleLongrunningOperation] parsed result object
1514
+ # @yieldparam err [StandardError] error object if request failed
1515
+ #
1516
+ # @return [Google::Apis::StorageV1::GoogleLongrunningOperation]
1517
+ #
1518
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1519
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1520
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1521
+ def rename_folder(bucket, source_folder, destination_folder, if_source_metageneration_match: nil, if_source_metageneration_not_match: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1522
+ command = make_simple_command(:post, 'b/{bucket}/folders/{sourceFolder}/renameTo/folders/{destinationFolder}', options)
1523
+ command.response_representation = Google::Apis::StorageV1::GoogleLongrunningOperation::Representation
1524
+ command.response_class = Google::Apis::StorageV1::GoogleLongrunningOperation
1525
+ command.params['bucket'] = bucket unless bucket.nil?
1526
+ command.params['sourceFolder'] = source_folder unless source_folder.nil?
1527
+ command.params['destinationFolder'] = destination_folder unless destination_folder.nil?
1528
+ command.query['ifSourceMetagenerationMatch'] = if_source_metageneration_match unless if_source_metageneration_match.nil?
1529
+ command.query['ifSourceMetagenerationNotMatch'] = if_source_metageneration_not_match unless if_source_metageneration_not_match.nil?
1530
+ command.query['fields'] = fields unless fields.nil?
1531
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1532
+ command.query['userIp'] = user_ip unless user_ip.nil?
1533
+ execute_or_queue_command(command, &block)
1534
+ end
1535
+
1299
1536
  # Permanently deletes a managed folder.
1300
1537
  # @param [String] bucket
1301
1538
  # Name of the bucket containing the managed folder.
@@ -1466,7 +1703,7 @@ module Google
1466
1703
  # @param [String] bucket
1467
1704
  # Name of the bucket containing the managed folder.
1468
1705
  # @param [Fixnum] page_size
1469
- # Maximum number of items return in a single page of responses.
1706
+ # Maximum number of items to return in a single page of responses.
1470
1707
  # @param [String] page_token
1471
1708
  # A previously-returned page token representing part of the larger set of
1472
1709
  # results to view.
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-apis-storage_v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.32.0
4
+ version: 0.33.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: 2023-12-24 00:00:00.000000000 Z
11
+ date: 2024-01-23 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: google-apis-core
@@ -16,7 +16,7 @@ dependencies:
16
16
  requirements:
17
17
  - - ">="
18
18
  - !ruby/object:Gem::Version
19
- version: 0.11.0
19
+ version: 0.12.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.11.0
29
+ version: 0.12.0
30
30
  - - "<"
31
31
  - !ruby/object:Gem::Version
32
32
  version: 2.a
@@ -58,7 +58,7 @@ licenses:
58
58
  metadata:
59
59
  bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
60
60
  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-storage_v1/CHANGELOG.md
61
- documentation_uri: https://googleapis.dev/ruby/google-apis-storage_v1/v0.32.0
61
+ documentation_uri: https://googleapis.dev/ruby/google-apis-storage_v1/v0.33.0
62
62
  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-storage_v1
63
63
  post_install_message:
64
64
  rdoc_options: []
@@ -75,7 +75,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
75
75
  - !ruby/object:Gem::Version
76
76
  version: '0'
77
77
  requirements: []
78
- rubygems_version: 3.4.19
78
+ rubygems_version: 3.5.3
79
79
  signing_key:
80
80
  specification_version: 4
81
81
  summary: Simple REST client for Cloud Storage JSON API V1