google-apis-storage_v1 0.28.0 → 0.29.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: c0463e1a2829b3116b7369f32cc7f839e377c1618303e8a63d3600a411a555f4
4
- data.tar.gz: c0ee248c3b7e6bcb7622a0c9ac1d28211d4155c12db245b0ab06ab06190056eb
3
+ metadata.gz: '020013963c0788380819adccfee9543b9801c359450a9ea3513d36b5445186c3'
4
+ data.tar.gz: 281b44c2c6e88bae97547164d2142ad4264ea126f88efb7c576e7f9ce76248ca
5
5
  SHA512:
6
- metadata.gz: 87417738d5d357e9b3105936b049470b1eb2db02d805d4f6f121652c482866b93da38622d11d244e9f4ff006c99ee58f1375ae0877a2f5ea899f74e56a9c0e3e
7
- data.tar.gz: e41b93f79c70c63654ef5a763004f906fce4b2dc653b5274946b663e4cb364262291ac8a233cc82f069c64e18e089b46f16af6fdbcd28290637a67248651a5db
6
+ metadata.gz: bccff201c5a7acd9f8cb4018d7e14c53e66154239b94f2510302be9d5f9d769f7667eabebc0801a55fd75d362e4da864a65d51c55a9d7f564aede7584e097b36
7
+ data.tar.gz: fe604d77551bf9108ede003dc5129e77c2f8dec5c6a5c07220a783f1e9d5d5ad3e84a11ebe864b3a530d5ba38419bc5a5cfa4a3813a2cb47ad1291d46530a14d
data/CHANGELOG.md CHANGED
@@ -1,5 +1,9 @@
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
+
3
7
  ### v0.28.0 (2023-10-01)
4
8
 
5
9
  * Regenerated from discovery document revision 20230926
@@ -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
@@ -2207,7 +2304,7 @@ module Google
2207
2304
  end
2208
2305
  end
2209
2306
 
2210
- # A bucket/object IAM policy.
2307
+ # A bucket/object/managedFolder IAM policy.
2211
2308
  class Policy
2212
2309
  include Google::Apis::Core::Hashable
2213
2310
 
@@ -2230,11 +2327,11 @@ module Google
2230
2327
  attr_accessor :kind
2231
2328
 
2232
2329
  # The ID of the resource to which this policy belongs. Will be of the form
2233
- # projects/_/buckets/bucket for buckets, and projects/_/buckets/bucket/objects/
2234
- # object for objects. A specific generation may be specified by appending #
2235
- # generationNumber to the end of the object name, e.g. projects/_/buckets/my-
2236
- # bucket/objects/data.txt#17. The current generation can be denoted with #0.
2237
- # 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.
2238
2335
  # Corresponds to the JSON property `resourceId`
2239
2336
  # @return [String]
2240
2337
  attr_accessor :resource_id
@@ -2413,7 +2510,7 @@ module Google
2413
2510
  end
2414
2511
  end
2415
2512
 
2416
- # A storage.(buckets|objects).testIamPermissions response.
2513
+ # A storage.(buckets|objects|managedFolders).testIamPermissions response.
2417
2514
  class TestIamPermissionsResponse
2418
2515
  include Google::Apis::Core::Hashable
2419
2516
 
@@ -2423,8 +2520,8 @@ module Google
2423
2520
  attr_accessor :kind
2424
2521
 
2425
2522
  # The permissions held by the caller. Permissions are always of the format
2426
- # storage.resource.capability, where resource is one of buckets or objects. The
2427
- # 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:
2428
2525
  # - storage.buckets.delete — Delete bucket.
2429
2526
  # - storage.buckets.get — Read bucket metadata.
2430
2527
  # - storage.buckets.getIamPolicy — Read bucket IAM policy.
@@ -2439,6 +2536,12 @@ module Google
2439
2536
  # - storage.objects.list — List objects.
2440
2537
  # - storage.objects.setIamPolicy — Update object IAM policy.
2441
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.
2442
2545
  # Corresponds to the JSON property `permissions`
2443
2546
  # @return [Array<String>]
2444
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.28.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 = "20230926"
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
@@ -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.28.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-10-01 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.28.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: []