google-apis-storage_v1 0.27.0 → 0.29.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: feb2fe9978aa4d9c7958652200ba4260223738ff141abab73f911ab49df518c9
4
- data.tar.gz: dc95d0254e830623e5149c6a32f1e79f8801c7c1a988a4d9bc9ea88f3005f146
3
+ metadata.gz: '020013963c0788380819adccfee9543b9801c359450a9ea3513d36b5445186c3'
4
+ data.tar.gz: 281b44c2c6e88bae97547164d2142ad4264ea126f88efb7c576e7f9ce76248ca
5
5
  SHA512:
6
- metadata.gz: 33cff6aefb30306df3a0333fc37ee16accdf54e3d553c029a000909fed19d3ad858f95307555604498acf8c6194a950388e5b38776fd2a4aee39fed22889bf80
7
- data.tar.gz: d1f0ca34f4e9dc2d99c94273736012a197f0d0188f6c38d2fcf7d305b45e60aba9d3fe71a82017e3bec0bec6d24ad3ff718aea51e16121d5763d4e56bfc247a2
6
+ metadata.gz: bccff201c5a7acd9f8cb4018d7e14c53e66154239b94f2510302be9d5f9d769f7667eabebc0801a55fd75d362e4da864a65d51c55a9d7f564aede7584e097b36
7
+ data.tar.gz: fe604d77551bf9108ede003dc5129e77c2f8dec5c6a5c07220a783f1e9d5d5ad3e84a11ebe864b3a530d5ba38419bc5a5cfa4a3813a2cb47ad1291d46530a14d
data/CHANGELOG.md CHANGED
@@ -1,5 +1,13 @@
1
1
  # Release history for google-apis-storage_v1
2
2
 
3
+ ### v0.29.0 (2023-10-15)
4
+
5
+ * Regenerated from discovery document revision 20231012
6
+
7
+ ### v0.28.0 (2023-10-01)
8
+
9
+ * Regenerated from discovery document revision 20230926
10
+
3
11
  ### v0.27.0 (2023-09-24)
4
12
 
5
13
  * Regenerated from discovery document revision 20230922
@@ -1575,6 +1575,103 @@ module Google
1575
1575
  end
1576
1576
  end
1577
1577
 
1578
+ # A managed folder.
1579
+ class ManagedFolder
1580
+ include Google::Apis::Core::Hashable
1581
+
1582
+ # The name of the bucket containing this managed folder.
1583
+ # Corresponds to the JSON property `bucket`
1584
+ # @return [String]
1585
+ attr_accessor :bucket
1586
+
1587
+ # The creation time of the managed folder in RFC 3339 format.
1588
+ # Corresponds to the JSON property `createTime`
1589
+ # @return [DateTime]
1590
+ attr_accessor :create_time
1591
+
1592
+ # The ID of the managed folder, including the bucket name and managed folder
1593
+ # name.
1594
+ # Corresponds to the JSON property `id`
1595
+ # @return [String]
1596
+ attr_accessor :id
1597
+
1598
+ # The kind of item this is. For managed folders, this is always storage#
1599
+ # managedFolder.
1600
+ # Corresponds to the JSON property `kind`
1601
+ # @return [String]
1602
+ attr_accessor :kind
1603
+
1604
+ # The version of the metadata for this managed folder. Used for preconditions
1605
+ # and for detecting changes in metadata.
1606
+ # Corresponds to the JSON property `metageneration`
1607
+ # @return [Fixnum]
1608
+ attr_accessor :metageneration
1609
+
1610
+ # The name of the managed folder. Required if not specified by URL parameter.
1611
+ # Corresponds to the JSON property `name`
1612
+ # @return [String]
1613
+ attr_accessor :name
1614
+
1615
+ # The link to this managed folder.
1616
+ # Corresponds to the JSON property `selfLink`
1617
+ # @return [String]
1618
+ attr_accessor :self_link
1619
+
1620
+ # The last update time of the managed folder metadata in RFC 3339 format.
1621
+ # Corresponds to the JSON property `updateTime`
1622
+ # @return [DateTime]
1623
+ attr_accessor :update_time
1624
+
1625
+ def initialize(**args)
1626
+ update!(**args)
1627
+ end
1628
+
1629
+ # Update properties of this object
1630
+ def update!(**args)
1631
+ @bucket = args[:bucket] if args.key?(:bucket)
1632
+ @create_time = args[:create_time] if args.key?(:create_time)
1633
+ @id = args[:id] if args.key?(:id)
1634
+ @kind = args[:kind] if args.key?(:kind)
1635
+ @metageneration = args[:metageneration] if args.key?(:metageneration)
1636
+ @name = args[:name] if args.key?(:name)
1637
+ @self_link = args[:self_link] if args.key?(:self_link)
1638
+ @update_time = args[:update_time] if args.key?(:update_time)
1639
+ end
1640
+ end
1641
+
1642
+ # A list of managed folders.
1643
+ class ManagedFolders
1644
+ include Google::Apis::Core::Hashable
1645
+
1646
+ # The list of items.
1647
+ # Corresponds to the JSON property `items`
1648
+ # @return [Array<Google::Apis::StorageV1::ManagedFolder>]
1649
+ attr_accessor :items
1650
+
1651
+ # The kind of item this is. For lists of managed folders, this is always storage#
1652
+ # managedFolders.
1653
+ # Corresponds to the JSON property `kind`
1654
+ # @return [String]
1655
+ attr_accessor :kind
1656
+
1657
+ # The continuation token, used to page through large result sets. Provide this
1658
+ # value in a subsequent request to return the next page of results.
1659
+ # Corresponds to the JSON property `nextPageToken`
1660
+ # @return [String]
1661
+ attr_accessor :next_page_token
1662
+
1663
+ def initialize(**args)
1664
+ update!(**args)
1665
+ end
1666
+
1667
+ # Update properties of this object
1668
+ def update!(**args)
1669
+ @items = args[:items] if args.key?(:items)
1670
+ @kind = args[:kind] if args.key?(:kind)
1671
+ @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
1672
+ end
1673
+ end
1674
+
1578
1675
  # A subscription to receive Google PubSub notifications.
1579
1676
  class Notification
1580
1677
  include Google::Apis::Core::Hashable
@@ -1764,6 +1861,13 @@ module Google
1764
1861
  # @return [Fixnum]
1765
1862
  attr_accessor :generation
1766
1863
 
1864
+ # This is the time (in the future) when the soft-deleted object will no longer
1865
+ # be restorable. It is equal to the soft delete time plus the current soft
1866
+ # delete retention duration of the bucket.
1867
+ # Corresponds to the JSON property `hardDeleteTime`
1868
+ # @return [DateTime]
1869
+ attr_accessor :hard_delete_time
1870
+
1767
1871
  # The ID of the object, including the bucket name, object name, and generation
1768
1872
  # number.
1769
1873
  # Corresponds to the JSON property `id`
@@ -1840,6 +1944,11 @@ module Google
1840
1944
  # @return [Fixnum]
1841
1945
  attr_accessor :size
1842
1946
 
1947
+ # The time at which the object became soft-deleted in RFC 3339 format.
1948
+ # Corresponds to the JSON property `softDeleteTime`
1949
+ # @return [DateTime]
1950
+ attr_accessor :soft_delete_time
1951
+
1843
1952
  # Storage class of the object.
1844
1953
  # Corresponds to the JSON property `storageClass`
1845
1954
  # @return [String]
@@ -1860,8 +1969,8 @@ module Google
1860
1969
  # @return [DateTime]
1861
1970
  attr_accessor :time_created
1862
1971
 
1863
- # The deletion time of the object in RFC 3339 format. Will be returned if and
1864
- # only if this version of the object has been deleted.
1972
+ # The time at which the object became noncurrent in RFC 3339 format. Will be
1973
+ # returned if and only if this version of the object has been deleted.
1865
1974
  # Corresponds to the JSON property `timeDeleted`
1866
1975
  # @return [DateTime]
1867
1976
  attr_accessor :time_deleted
@@ -1901,6 +2010,7 @@ module Google
1901
2010
  @etag = args[:etag] if args.key?(:etag)
1902
2011
  @event_based_hold = args[:event_based_hold] if args.key?(:event_based_hold)
1903
2012
  @generation = args[:generation] if args.key?(:generation)
2013
+ @hard_delete_time = args[:hard_delete_time] if args.key?(:hard_delete_time)
1904
2014
  @id = args[:id] if args.key?(:id)
1905
2015
  @kind = args[:kind] if args.key?(:kind)
1906
2016
  @kms_key_name = args[:kms_key_name] if args.key?(:kms_key_name)
@@ -1914,6 +2024,7 @@ module Google
1914
2024
  @retention_expiration_time = args[:retention_expiration_time] if args.key?(:retention_expiration_time)
1915
2025
  @self_link = args[:self_link] if args.key?(:self_link)
1916
2026
  @size = args[:size] if args.key?(:size)
2027
+ @soft_delete_time = args[:soft_delete_time] if args.key?(:soft_delete_time)
1917
2028
  @storage_class = args[:storage_class] if args.key?(:storage_class)
1918
2029
  @temporary_hold = args[:temporary_hold] if args.key?(:temporary_hold)
1919
2030
  @time_created = args[:time_created] if args.key?(:time_created)
@@ -2193,7 +2304,7 @@ module Google
2193
2304
  end
2194
2305
  end
2195
2306
 
2196
- # A bucket/object IAM policy.
2307
+ # A bucket/object/managedFolder IAM policy.
2197
2308
  class Policy
2198
2309
  include Google::Apis::Core::Hashable
2199
2310
 
@@ -2216,11 +2327,11 @@ module Google
2216
2327
  attr_accessor :kind
2217
2328
 
2218
2329
  # The ID of the resource to which this policy belongs. Will be of the form
2219
- # projects/_/buckets/bucket for buckets, and projects/_/buckets/bucket/objects/
2220
- # object for objects. A specific generation may be specified by appending #
2221
- # generationNumber to the end of the object name, e.g. projects/_/buckets/my-
2222
- # bucket/objects/data.txt#17. The current generation can be denoted with #0.
2223
- # This field is ignored on input.
2330
+ # projects/_/buckets/bucket for buckets, projects/_/buckets/bucket/objects/
2331
+ # object for objects, and projects/_/buckets/bucket/managedFolders/managedFolder.
2332
+ # A specific generation may be specified by appending #generationNumber to the
2333
+ # end of the object name, e.g. projects/_/buckets/my-bucket/objects/data.txt#17.
2334
+ # The current generation can be denoted with #0. This field is ignored on input.
2224
2335
  # Corresponds to the JSON property `resourceId`
2225
2336
  # @return [String]
2226
2337
  attr_accessor :resource_id
@@ -2399,7 +2510,7 @@ module Google
2399
2510
  end
2400
2511
  end
2401
2512
 
2402
- # A storage.(buckets|objects).testIamPermissions response.
2513
+ # A storage.(buckets|objects|managedFolders).testIamPermissions response.
2403
2514
  class TestIamPermissionsResponse
2404
2515
  include Google::Apis::Core::Hashable
2405
2516
 
@@ -2409,8 +2520,8 @@ module Google
2409
2520
  attr_accessor :kind
2410
2521
 
2411
2522
  # The permissions held by the caller. Permissions are always of the format
2412
- # storage.resource.capability, where resource is one of buckets or objects. The
2413
- # supported permissions are as follows:
2523
+ # storage.resource.capability, where resource is one of buckets, objects, or
2524
+ # managedFolders. The supported permissions are as follows:
2414
2525
  # - storage.buckets.delete — Delete bucket.
2415
2526
  # - storage.buckets.get — Read bucket metadata.
2416
2527
  # - storage.buckets.getIamPolicy — Read bucket IAM policy.
@@ -2425,6 +2536,12 @@ module Google
2425
2536
  # - storage.objects.list — List objects.
2426
2537
  # - storage.objects.setIamPolicy — Update object IAM policy.
2427
2538
  # - storage.objects.update — Update object metadata.
2539
+ # - storage.managedFolders.delete — Delete managed folder.
2540
+ # - storage.managedFolders.get — Read managed folder metadata.
2541
+ # - storage.managedFolders.getIamPolicy — Read managed folder IAM policy.
2542
+ # - storage.managedFolders.create — Create managed folder.
2543
+ # - storage.managedFolders.list — List managed folders.
2544
+ # - storage.managedFolders.setIamPolicy — Update managed folder IAM policy.
2428
2545
  # Corresponds to the JSON property `permissions`
2429
2546
  # @return [Array<String>]
2430
2547
  attr_accessor :permissions
@@ -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.27.0"
19
+ GEM_VERSION = "0.29.0"
20
20
 
21
21
  # Version of the code generator used to generate this client
22
22
  GENERATOR_VERSION = "0.12.0"
23
23
 
24
24
  # Revision of the discovery document this client was generated from
25
- REVISION = "20230922"
25
+ REVISION = "20231012"
26
26
  end
27
27
  end
28
28
  end
@@ -238,6 +238,18 @@ module Google
238
238
  include Google::Apis::Core::JsonObjectSupport
239
239
  end
240
240
 
241
+ class ManagedFolder
242
+ class Representation < Google::Apis::Core::JsonRepresentation; end
243
+
244
+ include Google::Apis::Core::JsonObjectSupport
245
+ end
246
+
247
+ class ManagedFolders
248
+ class Representation < Google::Apis::Core::JsonRepresentation; end
249
+
250
+ include Google::Apis::Core::JsonObjectSupport
251
+ end
252
+
241
253
  class Notification
242
254
  class Representation < Google::Apis::Core::JsonRepresentation; end
243
255
 
@@ -740,6 +752,32 @@ module Google
740
752
  end
741
753
  end
742
754
 
755
+ class ManagedFolder
756
+ # @private
757
+ class Representation < Google::Apis::Core::JsonRepresentation
758
+ property :bucket, as: 'bucket'
759
+ property :create_time, as: 'createTime', type: DateTime
760
+
761
+ property :id, as: 'id'
762
+ property :kind, as: 'kind'
763
+ property :metageneration, :numeric_string => true, as: 'metageneration'
764
+ property :name, as: 'name'
765
+ property :self_link, as: 'selfLink'
766
+ property :update_time, as: 'updateTime', type: DateTime
767
+
768
+ end
769
+ end
770
+
771
+ class ManagedFolders
772
+ # @private
773
+ class Representation < Google::Apis::Core::JsonRepresentation
774
+ collection :items, as: 'items', class: Google::Apis::StorageV1::ManagedFolder, decorator: Google::Apis::StorageV1::ManagedFolder::Representation
775
+
776
+ property :kind, as: 'kind'
777
+ property :next_page_token, as: 'nextPageToken'
778
+ end
779
+ end
780
+
743
781
  class Notification
744
782
  # @private
745
783
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -784,6 +822,8 @@ module Google
784
822
  property :etag, as: 'etag'
785
823
  property :event_based_hold, as: 'eventBasedHold'
786
824
  property :generation, :numeric_string => true, as: 'generation'
825
+ property :hard_delete_time, as: 'hardDeleteTime', type: DateTime
826
+
787
827
  property :id, as: 'id'
788
828
  property :kind, as: 'kind'
789
829
  property :kms_key_name, as: 'kmsKeyName'
@@ -800,6 +840,8 @@ module Google
800
840
 
801
841
  property :self_link, as: 'selfLink'
802
842
  property :size, :numeric_string => true, as: 'size'
843
+ property :soft_delete_time, as: 'softDeleteTime', type: DateTime
844
+
803
845
  property :storage_class, as: 'storageClass'
804
846
  property :temporary_hold, as: 'temporaryHold'
805
847
  property :time_created, as: 'timeCreated', type: DateTime
@@ -1037,6 +1037,300 @@ module Google
1037
1037
  execute_or_queue_command(command, &block)
1038
1038
  end
1039
1039
 
1040
+ # Permanently deletes a managed folder.
1041
+ # @param [String] bucket
1042
+ # Name of the bucket containing the managed folder.
1043
+ # @param [String] managed_folder
1044
+ # The managed folder name/path.
1045
+ # @param [Fixnum] if_metageneration_match
1046
+ # If set, only deletes the managed folder if its metageneration matches this
1047
+ # value.
1048
+ # @param [Fixnum] if_metageneration_not_match
1049
+ # If set, only deletes the managed folder if its metageneration does not match
1050
+ # this value.
1051
+ # @param [String] fields
1052
+ # Selector specifying which fields to include in a partial response.
1053
+ # @param [String] quota_user
1054
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
1055
+ # characters.
1056
+ # @param [String] user_ip
1057
+ # Deprecated. Please use quotaUser instead.
1058
+ # @param [Google::Apis::RequestOptions] options
1059
+ # Request-specific options
1060
+ #
1061
+ # @yield [result, err] Result & error if block supplied
1062
+ # @yieldparam result [NilClass] No result returned for this method
1063
+ # @yieldparam err [StandardError] error object if request failed
1064
+ #
1065
+ # @return [void]
1066
+ #
1067
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1068
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1069
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1070
+ def delete_managed_folder(bucket, managed_folder, if_metageneration_match: nil, if_metageneration_not_match: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1071
+ command = make_simple_command(:delete, 'b/{bucket}/managedFolders/{managedFolder}', options)
1072
+ command.params['bucket'] = bucket unless bucket.nil?
1073
+ command.params['managedFolder'] = managed_folder unless managed_folder.nil?
1074
+ command.query['ifMetagenerationMatch'] = if_metageneration_match unless if_metageneration_match.nil?
1075
+ command.query['ifMetagenerationNotMatch'] = if_metageneration_not_match unless if_metageneration_not_match.nil?
1076
+ command.query['fields'] = fields unless fields.nil?
1077
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1078
+ command.query['userIp'] = user_ip unless user_ip.nil?
1079
+ execute_or_queue_command(command, &block)
1080
+ end
1081
+
1082
+ # Returns metadata of the specified managed folder.
1083
+ # @param [String] bucket
1084
+ # Name of the bucket containing the managed folder.
1085
+ # @param [String] managed_folder
1086
+ # The managed folder name/path.
1087
+ # @param [Fixnum] if_metageneration_match
1088
+ # Makes the return of the managed folder metadata conditional on whether the
1089
+ # managed folder's current metageneration matches the given value.
1090
+ # @param [Fixnum] if_metageneration_not_match
1091
+ # Makes the return of the managed folder metadata conditional on whether the
1092
+ # managed folder's current metageneration does not match the given value.
1093
+ # @param [String] fields
1094
+ # Selector specifying which fields to include in a partial response.
1095
+ # @param [String] quota_user
1096
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
1097
+ # characters.
1098
+ # @param [String] user_ip
1099
+ # Deprecated. Please use quotaUser instead.
1100
+ # @param [Google::Apis::RequestOptions] options
1101
+ # Request-specific options
1102
+ #
1103
+ # @yield [result, err] Result & error if block supplied
1104
+ # @yieldparam result [Google::Apis::StorageV1::ManagedFolder] parsed result object
1105
+ # @yieldparam err [StandardError] error object if request failed
1106
+ #
1107
+ # @return [Google::Apis::StorageV1::ManagedFolder]
1108
+ #
1109
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1110
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1111
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1112
+ def get_managed_folder(bucket, managed_folder, if_metageneration_match: nil, if_metageneration_not_match: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1113
+ command = make_simple_command(:get, 'b/{bucket}/managedFolders/{managedFolder}', options)
1114
+ command.response_representation = Google::Apis::StorageV1::ManagedFolder::Representation
1115
+ command.response_class = Google::Apis::StorageV1::ManagedFolder
1116
+ command.params['bucket'] = bucket unless bucket.nil?
1117
+ command.params['managedFolder'] = managed_folder unless managed_folder.nil?
1118
+ command.query['ifMetagenerationMatch'] = if_metageneration_match unless if_metageneration_match.nil?
1119
+ command.query['ifMetagenerationNotMatch'] = if_metageneration_not_match unless if_metageneration_not_match.nil?
1120
+ command.query['fields'] = fields unless fields.nil?
1121
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1122
+ command.query['userIp'] = user_ip unless user_ip.nil?
1123
+ execute_or_queue_command(command, &block)
1124
+ end
1125
+
1126
+ # Returns an IAM policy for the specified managed folder.
1127
+ # @param [String] bucket
1128
+ # Name of the bucket containing the managed folder.
1129
+ # @param [String] managed_folder
1130
+ # The managed folder name/path.
1131
+ # @param [Fixnum] options_requested_policy_version
1132
+ # The IAM policy format version to be returned. If the
1133
+ # optionsRequestedPolicyVersion is for an older version that doesn't support
1134
+ # part of the requested IAM policy, the request fails.
1135
+ # @param [String] user_project
1136
+ # The project to be billed for this request. Required for Requester Pays buckets.
1137
+ # @param [String] fields
1138
+ # Selector specifying which fields to include in a partial response.
1139
+ # @param [String] quota_user
1140
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
1141
+ # characters.
1142
+ # @param [String] user_ip
1143
+ # Deprecated. Please use quotaUser instead.
1144
+ # @param [Google::Apis::RequestOptions] options
1145
+ # Request-specific options
1146
+ #
1147
+ # @yield [result, err] Result & error if block supplied
1148
+ # @yieldparam result [Google::Apis::StorageV1::Policy] parsed result object
1149
+ # @yieldparam err [StandardError] error object if request failed
1150
+ #
1151
+ # @return [Google::Apis::StorageV1::Policy]
1152
+ #
1153
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1154
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1155
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1156
+ def get_managed_folder_iam_policy(bucket, managed_folder, options_requested_policy_version: nil, user_project: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1157
+ command = make_simple_command(:get, 'b/{bucket}/managedFolders/{managedFolder}/iam', options)
1158
+ command.response_representation = Google::Apis::StorageV1::Policy::Representation
1159
+ command.response_class = Google::Apis::StorageV1::Policy
1160
+ command.params['bucket'] = bucket unless bucket.nil?
1161
+ command.params['managedFolder'] = managed_folder unless managed_folder.nil?
1162
+ command.query['optionsRequestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil?
1163
+ command.query['userProject'] = user_project unless user_project.nil?
1164
+ command.query['fields'] = fields unless fields.nil?
1165
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1166
+ command.query['userIp'] = user_ip unless user_ip.nil?
1167
+ execute_or_queue_command(command, &block)
1168
+ end
1169
+
1170
+ # Creates a new managed folder.
1171
+ # @param [String] bucket
1172
+ # Name of the bucket containing the managed folder.
1173
+ # @param [Google::Apis::StorageV1::ManagedFolder] managed_folder_object
1174
+ # @param [String] fields
1175
+ # Selector specifying which fields to include in a partial response.
1176
+ # @param [String] quota_user
1177
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
1178
+ # characters.
1179
+ # @param [String] user_ip
1180
+ # Deprecated. Please use quotaUser instead.
1181
+ # @param [Google::Apis::RequestOptions] options
1182
+ # Request-specific options
1183
+ #
1184
+ # @yield [result, err] Result & error if block supplied
1185
+ # @yieldparam result [Google::Apis::StorageV1::ManagedFolder] parsed result object
1186
+ # @yieldparam err [StandardError] error object if request failed
1187
+ #
1188
+ # @return [Google::Apis::StorageV1::ManagedFolder]
1189
+ #
1190
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1191
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1192
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1193
+ def insert_managed_folder(bucket, managed_folder_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1194
+ command = make_simple_command(:post, 'b/{bucket}/managedFolders', options)
1195
+ command.request_representation = Google::Apis::StorageV1::ManagedFolder::Representation
1196
+ command.request_object = managed_folder_object
1197
+ command.response_representation = Google::Apis::StorageV1::ManagedFolder::Representation
1198
+ command.response_class = Google::Apis::StorageV1::ManagedFolder
1199
+ command.params['bucket'] = bucket unless bucket.nil?
1200
+ command.query['fields'] = fields unless fields.nil?
1201
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1202
+ command.query['userIp'] = user_ip unless user_ip.nil?
1203
+ execute_or_queue_command(command, &block)
1204
+ end
1205
+
1206
+ # Lists managed folders in the given bucket.
1207
+ # @param [String] bucket
1208
+ # Name of the bucket containing the managed folder.
1209
+ # @param [Fixnum] page_size
1210
+ # Maximum number of items return in a single page of responses.
1211
+ # @param [String] page_token
1212
+ # A previously-returned page token representing part of the larger set of
1213
+ # results to view.
1214
+ # @param [String] prefix
1215
+ # The managed folder name/path prefix to filter the output list of results.
1216
+ # @param [String] fields
1217
+ # Selector specifying which fields to include in a partial response.
1218
+ # @param [String] quota_user
1219
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
1220
+ # characters.
1221
+ # @param [String] user_ip
1222
+ # Deprecated. Please use quotaUser instead.
1223
+ # @param [Google::Apis::RequestOptions] options
1224
+ # Request-specific options
1225
+ #
1226
+ # @yield [result, err] Result & error if block supplied
1227
+ # @yieldparam result [Google::Apis::StorageV1::ManagedFolders] parsed result object
1228
+ # @yieldparam err [StandardError] error object if request failed
1229
+ #
1230
+ # @return [Google::Apis::StorageV1::ManagedFolders]
1231
+ #
1232
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1233
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1234
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1235
+ def list_managed_folders(bucket, page_size: nil, page_token: nil, prefix: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1236
+ command = make_simple_command(:get, 'b/{bucket}/managedFolders', options)
1237
+ command.response_representation = Google::Apis::StorageV1::ManagedFolders::Representation
1238
+ command.response_class = Google::Apis::StorageV1::ManagedFolders
1239
+ command.params['bucket'] = bucket unless bucket.nil?
1240
+ command.query['pageSize'] = page_size unless page_size.nil?
1241
+ command.query['pageToken'] = page_token unless page_token.nil?
1242
+ command.query['prefix'] = prefix unless prefix.nil?
1243
+ command.query['fields'] = fields unless fields.nil?
1244
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1245
+ command.query['userIp'] = user_ip unless user_ip.nil?
1246
+ execute_or_queue_command(command, &block)
1247
+ end
1248
+
1249
+ # Updates an IAM policy for the specified managed folder.
1250
+ # @param [String] bucket
1251
+ # Name of the bucket containing the managed folder.
1252
+ # @param [String] managed_folder
1253
+ # The managed folder name/path.
1254
+ # @param [Google::Apis::StorageV1::Policy] policy_object
1255
+ # @param [String] user_project
1256
+ # The project to be billed for this request. Required for Requester Pays buckets.
1257
+ # @param [String] fields
1258
+ # Selector specifying which fields to include in a partial response.
1259
+ # @param [String] quota_user
1260
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
1261
+ # characters.
1262
+ # @param [String] user_ip
1263
+ # Deprecated. Please use quotaUser instead.
1264
+ # @param [Google::Apis::RequestOptions] options
1265
+ # Request-specific options
1266
+ #
1267
+ # @yield [result, err] Result & error if block supplied
1268
+ # @yieldparam result [Google::Apis::StorageV1::Policy] parsed result object
1269
+ # @yieldparam err [StandardError] error object if request failed
1270
+ #
1271
+ # @return [Google::Apis::StorageV1::Policy]
1272
+ #
1273
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1274
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1275
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1276
+ def set_managed_folder_iam_policy(bucket, managed_folder, policy_object = nil, user_project: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1277
+ command = make_simple_command(:put, 'b/{bucket}/managedFolders/{managedFolder}/iam', options)
1278
+ command.request_representation = Google::Apis::StorageV1::Policy::Representation
1279
+ command.request_object = policy_object
1280
+ command.response_representation = Google::Apis::StorageV1::Policy::Representation
1281
+ command.response_class = Google::Apis::StorageV1::Policy
1282
+ command.params['bucket'] = bucket unless bucket.nil?
1283
+ command.params['managedFolder'] = managed_folder unless managed_folder.nil?
1284
+ command.query['userProject'] = user_project unless user_project.nil?
1285
+ command.query['fields'] = fields unless fields.nil?
1286
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1287
+ command.query['userIp'] = user_ip unless user_ip.nil?
1288
+ execute_or_queue_command(command, &block)
1289
+ end
1290
+
1291
+ # Tests a set of permissions on the given managed folder to see which, if any,
1292
+ # are held by the caller.
1293
+ # @param [String] bucket
1294
+ # Name of the bucket containing the managed folder.
1295
+ # @param [String] managed_folder
1296
+ # The managed folder name/path.
1297
+ # @param [Array<String>, String] permissions
1298
+ # Permissions to test.
1299
+ # @param [String] user_project
1300
+ # The project to be billed for this request. Required for Requester Pays buckets.
1301
+ # @param [String] fields
1302
+ # Selector specifying which fields to include in a partial response.
1303
+ # @param [String] quota_user
1304
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
1305
+ # characters.
1306
+ # @param [String] user_ip
1307
+ # Deprecated. Please use quotaUser instead.
1308
+ # @param [Google::Apis::RequestOptions] options
1309
+ # Request-specific options
1310
+ #
1311
+ # @yield [result, err] Result & error if block supplied
1312
+ # @yieldparam result [Google::Apis::StorageV1::TestIamPermissionsResponse] parsed result object
1313
+ # @yieldparam err [StandardError] error object if request failed
1314
+ #
1315
+ # @return [Google::Apis::StorageV1::TestIamPermissionsResponse]
1316
+ #
1317
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1318
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1319
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1320
+ def test_managed_folder_iam_permissions(bucket, managed_folder, permissions, user_project: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1321
+ command = make_simple_command(:get, 'b/{bucket}/managedFolders/{managedFolder}/iam/testPermissions', options)
1322
+ command.response_representation = Google::Apis::StorageV1::TestIamPermissionsResponse::Representation
1323
+ command.response_class = Google::Apis::StorageV1::TestIamPermissionsResponse
1324
+ command.params['bucket'] = bucket unless bucket.nil?
1325
+ command.params['managedFolder'] = managed_folder unless managed_folder.nil?
1326
+ command.query['permissions'] = permissions unless permissions.nil?
1327
+ command.query['userProject'] = user_project unless user_project.nil?
1328
+ command.query['fields'] = fields unless fields.nil?
1329
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1330
+ command.query['userIp'] = user_ip unless user_ip.nil?
1331
+ execute_or_queue_command(command, &block)
1332
+ end
1333
+
1040
1334
  # Permanently deletes a notification subscription.
1041
1335
  # @param [String] bucket
1042
1336
  # The parent bucket of the notification.
@@ -1979,6 +2273,9 @@ module Google
1979
2273
  # Filter results to objects whose names are lexicographically before endOffset.
1980
2274
  # If startOffset is also set, the objects listed will have names between
1981
2275
  # startOffset (inclusive) and endOffset (exclusive).
2276
+ # @param [Boolean] include_folders_as_prefixes
2277
+ # Only applicable if delimiter is set to '/'. If true, will also include folders
2278
+ # and managed folders (besides objects) in the returned prefixes.
1982
2279
  # @param [Boolean] include_trailing_delimiter
1983
2280
  # If true, objects that end in exactly one instance of delimiter will have their
1984
2281
  # metadata included in items in addition to prefixes.
@@ -2027,13 +2324,14 @@ module Google
2027
2324
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2028
2325
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2029
2326
  # @raise [Google::Apis::AuthorizationError] Authorization is required
2030
- def list_objects(bucket, delimiter: nil, end_offset: nil, include_trailing_delimiter: nil, match_glob: nil, max_results: nil, page_token: nil, prefix: nil, projection: nil, soft_deleted: nil, start_offset: nil, user_project: nil, versions: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
2327
+ def list_objects(bucket, delimiter: nil, end_offset: nil, include_folders_as_prefixes: nil, include_trailing_delimiter: nil, match_glob: nil, max_results: nil, page_token: nil, prefix: nil, projection: nil, soft_deleted: nil, start_offset: nil, user_project: nil, versions: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
2031
2328
  command = make_simple_command(:get, 'b/{bucket}/o', options)
2032
2329
  command.response_representation = Google::Apis::StorageV1::Objects::Representation
2033
2330
  command.response_class = Google::Apis::StorageV1::Objects
2034
2331
  command.params['bucket'] = bucket unless bucket.nil?
2035
2332
  command.query['delimiter'] = delimiter unless delimiter.nil?
2036
2333
  command.query['endOffset'] = end_offset unless end_offset.nil?
2334
+ command.query['includeFoldersAsPrefixes'] = include_folders_as_prefixes unless include_folders_as_prefixes.nil?
2037
2335
  command.query['includeTrailingDelimiter'] = include_trailing_delimiter unless include_trailing_delimiter.nil?
2038
2336
  command.query['matchGlob'] = match_glob unless match_glob.nil?
2039
2337
  command.query['maxResults'] = max_results unless max_results.nil?
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.27.0
4
+ version: 0.29.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-09-24 00:00:00.000000000 Z
11
+ date: 2023-10-15 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: google-apis-core
@@ -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.27.0
61
+ documentation_uri: https://googleapis.dev/ruby/google-apis-storage_v1/v0.29.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: []