google-apis-storage_v1 0.28.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: 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: []