google-apis-storage_v1 0.32.0 → 0.33.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: '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