@googleapis/storage 8.0.0 → 10.0.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.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,27 @@
1
1
  # Changelog
2
2
 
3
+ ## [10.0.0](https://github.com/googleapis/google-api-nodejs-client/compare/storage-v9.0.0...storage-v10.0.0) (2024-02-07)
4
+
5
+
6
+ ### ⚠ BREAKING CHANGES
7
+
8
+ * **storage:** This release has breaking changes.
9
+
10
+ ### Features
11
+
12
+ * **storage:** update the API ([170e77b](https://github.com/googleapis/google-api-nodejs-client/commit/170e77b695c2b43cbc8a3d991fbe86bdb7d3ba57))
13
+
14
+ ## [9.0.0](https://github.com/googleapis/google-api-nodejs-client/compare/storage-v8.0.0...storage-v9.0.0) (2024-02-02)
15
+
16
+
17
+ ### ⚠ BREAKING CHANGES
18
+
19
+ * **storage:** This release has breaking changes.
20
+
21
+ ### Features
22
+
23
+ * **storage:** update the API ([5bc62e5](https://github.com/googleapis/google-api-nodejs-client/commit/5bc62e590c1b44ced15de06dc08c53445fcd00d0))
24
+
3
25
  ## [8.0.0](https://github.com/googleapis/google-api-nodejs-client/compare/storage-v7.1.0...storage-v8.0.0) (2024-01-05)
4
26
 
5
27
 
package/build/v1.d.ts CHANGED
@@ -56,11 +56,12 @@ export declare namespace storage_v1 {
56
56
  */
57
57
  export class Storage {
58
58
  context: APIRequestContext;
59
- anywhereCache: Resource$Anywherecache;
59
+ anywhereCaches: Resource$Anywherecaches;
60
60
  bucketAccessControls: Resource$Bucketaccesscontrols;
61
61
  buckets: Resource$Buckets;
62
62
  channels: Resource$Channels;
63
63
  defaultObjectAccessControls: Resource$Defaultobjectaccesscontrols;
64
+ folders: Resource$Folders;
64
65
  managedFolders: Resource$Managedfolders;
65
66
  notifications: Resource$Notifications;
66
67
  objectAccessControls: Resource$Objectaccesscontrols;
@@ -117,6 +118,10 @@ export declare namespace storage_v1 {
117
118
  * The modification time of the cache instance metadata in RFC 3339 format.
118
119
  */
119
120
  updateTime?: string | null;
121
+ /**
122
+ * The zone in which the cache instance is running. For example, us-central1-a.
123
+ */
124
+ zone?: string | null;
120
125
  }
121
126
  /**
122
127
  * A list of Anywhere Caches.
@@ -191,6 +196,12 @@ export declare namespace storage_v1 {
191
196
  * HTTP 1.1 Entity tag for the bucket.
192
197
  */
193
198
  etag?: string | null;
199
+ /**
200
+ * The bucket's hierarchical namespace configuration.
201
+ */
202
+ hierarchicalNamespace?: {
203
+ enabled?: boolean;
204
+ } | null;
194
205
  /**
195
206
  * The bucket's IAM configuration.
196
207
  */
@@ -546,6 +557,66 @@ export declare namespace storage_v1 {
546
557
  */
547
558
  title?: string | null;
548
559
  }
560
+ /**
561
+ * A folder. Only available in buckets with hierarchical namespace enabled.
562
+ */
563
+ export interface Schema$Folder {
564
+ /**
565
+ * The name of the bucket containing this folder.
566
+ */
567
+ bucket?: string | null;
568
+ /**
569
+ * The ID of the folder, including the bucket name, folder name.
570
+ */
571
+ id?: string | null;
572
+ /**
573
+ * The kind of item this is. For folders, this is always storage#folder.
574
+ */
575
+ kind?: string | null;
576
+ /**
577
+ * The version of the metadata for this folder. Used for preconditions and for detecting changes in metadata.
578
+ */
579
+ metageneration?: string | null;
580
+ /**
581
+ * The name of the folder. Required if not specified by URL parameter.
582
+ */
583
+ name?: string | null;
584
+ /**
585
+ * Only present if the folder is part of an ongoing rename folder operation. Contains information which can be used to query the operation status.
586
+ */
587
+ pendingRenameInfo?: {
588
+ operationId?: string;
589
+ } | null;
590
+ /**
591
+ * The link to this folder.
592
+ */
593
+ selfLink?: string | null;
594
+ /**
595
+ * The creation time of the folder in RFC 3339 format.
596
+ */
597
+ timeCreated?: string | null;
598
+ /**
599
+ * The modification time of the folder metadata in RFC 3339 format.
600
+ */
601
+ updated?: string | null;
602
+ }
603
+ /**
604
+ * A list of folders.
605
+ */
606
+ export interface Schema$Folders {
607
+ /**
608
+ * The list of items.
609
+ */
610
+ items?: Schema$Folder[];
611
+ /**
612
+ * The kind of item this is. For lists of folders, this is always storage#folders.
613
+ */
614
+ kind?: string | null;
615
+ /**
616
+ * The continuation token, used to page through large result sets. Provide this value in a subsequent request to return the next page of results.
617
+ */
618
+ nextPageToken?: string | null;
619
+ }
549
620
  /**
550
621
  * The response message for storage.buckets.operations.list.
551
622
  */
@@ -1161,7 +1232,7 @@ export declare namespace storage_v1 {
1161
1232
  */
1162
1233
  permissions?: string[] | null;
1163
1234
  }
1164
- export class Resource$Anywherecache {
1235
+ export class Resource$Anywherecaches {
1165
1236
  context: APIRequestContext;
1166
1237
  constructor(context: APIRequestContext);
1167
1238
  /**
@@ -1172,11 +1243,11 @@ export declare namespace storage_v1 {
1172
1243
  * @param callback - Optional callback that handles the response.
1173
1244
  * @returns A promise if used with async/await, or void if used with a callback.
1174
1245
  */
1175
- disable(params: Params$Resource$Anywherecache$Disable, options: StreamMethodOptions): GaxiosPromise<Readable>;
1176
- disable(params?: Params$Resource$Anywherecache$Disable, options?: MethodOptions): GaxiosPromise<Schema$AnywhereCache>;
1177
- disable(params: Params$Resource$Anywherecache$Disable, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
1178
- disable(params: Params$Resource$Anywherecache$Disable, options: MethodOptions | BodyResponseCallback<Schema$AnywhereCache>, callback: BodyResponseCallback<Schema$AnywhereCache>): void;
1179
- disable(params: Params$Resource$Anywherecache$Disable, callback: BodyResponseCallback<Schema$AnywhereCache>): void;
1246
+ disable(params: Params$Resource$Anywherecaches$Disable, options: StreamMethodOptions): GaxiosPromise<Readable>;
1247
+ disable(params?: Params$Resource$Anywherecaches$Disable, options?: MethodOptions): GaxiosPromise<Schema$AnywhereCache>;
1248
+ disable(params: Params$Resource$Anywherecaches$Disable, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
1249
+ disable(params: Params$Resource$Anywherecaches$Disable, options: MethodOptions | BodyResponseCallback<Schema$AnywhereCache>, callback: BodyResponseCallback<Schema$AnywhereCache>): void;
1250
+ disable(params: Params$Resource$Anywherecaches$Disable, callback: BodyResponseCallback<Schema$AnywhereCache>): void;
1180
1251
  disable(callback: BodyResponseCallback<Schema$AnywhereCache>): void;
1181
1252
  /**
1182
1253
  * Returns the metadata of an Anywhere Cache instance.
@@ -1186,11 +1257,11 @@ export declare namespace storage_v1 {
1186
1257
  * @param callback - Optional callback that handles the response.
1187
1258
  * @returns A promise if used with async/await, or void if used with a callback.
1188
1259
  */
1189
- get(params: Params$Resource$Anywherecache$Get, options: StreamMethodOptions): GaxiosPromise<Readable>;
1190
- get(params?: Params$Resource$Anywherecache$Get, options?: MethodOptions): GaxiosPromise<Schema$AnywhereCache>;
1191
- get(params: Params$Resource$Anywherecache$Get, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
1192
- get(params: Params$Resource$Anywherecache$Get, options: MethodOptions | BodyResponseCallback<Schema$AnywhereCache>, callback: BodyResponseCallback<Schema$AnywhereCache>): void;
1193
- get(params: Params$Resource$Anywherecache$Get, callback: BodyResponseCallback<Schema$AnywhereCache>): void;
1260
+ get(params: Params$Resource$Anywherecaches$Get, options: StreamMethodOptions): GaxiosPromise<Readable>;
1261
+ get(params?: Params$Resource$Anywherecaches$Get, options?: MethodOptions): GaxiosPromise<Schema$AnywhereCache>;
1262
+ get(params: Params$Resource$Anywherecaches$Get, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
1263
+ get(params: Params$Resource$Anywherecaches$Get, options: MethodOptions | BodyResponseCallback<Schema$AnywhereCache>, callback: BodyResponseCallback<Schema$AnywhereCache>): void;
1264
+ get(params: Params$Resource$Anywherecaches$Get, callback: BodyResponseCallback<Schema$AnywhereCache>): void;
1194
1265
  get(callback: BodyResponseCallback<Schema$AnywhereCache>): void;
1195
1266
  /**
1196
1267
  * Creates an Anywhere Cache instance.
@@ -1200,11 +1271,11 @@ export declare namespace storage_v1 {
1200
1271
  * @param callback - Optional callback that handles the response.
1201
1272
  * @returns A promise if used with async/await, or void if used with a callback.
1202
1273
  */
1203
- insert(params: Params$Resource$Anywherecache$Insert, options: StreamMethodOptions): GaxiosPromise<Readable>;
1204
- insert(params?: Params$Resource$Anywherecache$Insert, options?: MethodOptions): GaxiosPromise<Schema$GoogleLongrunningOperation>;
1205
- insert(params: Params$Resource$Anywherecache$Insert, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
1206
- insert(params: Params$Resource$Anywherecache$Insert, options: MethodOptions | BodyResponseCallback<Schema$GoogleLongrunningOperation>, callback: BodyResponseCallback<Schema$GoogleLongrunningOperation>): void;
1207
- insert(params: Params$Resource$Anywherecache$Insert, callback: BodyResponseCallback<Schema$GoogleLongrunningOperation>): void;
1274
+ insert(params: Params$Resource$Anywherecaches$Insert, options: StreamMethodOptions): GaxiosPromise<Readable>;
1275
+ insert(params?: Params$Resource$Anywherecaches$Insert, options?: MethodOptions): GaxiosPromise<Schema$GoogleLongrunningOperation>;
1276
+ insert(params: Params$Resource$Anywherecaches$Insert, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
1277
+ insert(params: Params$Resource$Anywherecaches$Insert, options: MethodOptions | BodyResponseCallback<Schema$GoogleLongrunningOperation>, callback: BodyResponseCallback<Schema$GoogleLongrunningOperation>): void;
1278
+ insert(params: Params$Resource$Anywherecaches$Insert, callback: BodyResponseCallback<Schema$GoogleLongrunningOperation>): void;
1208
1279
  insert(callback: BodyResponseCallback<Schema$GoogleLongrunningOperation>): void;
1209
1280
  /**
1210
1281
  * Returns a list of Anywhere Cache instances of the bucket matching the criteria.
@@ -1214,11 +1285,11 @@ export declare namespace storage_v1 {
1214
1285
  * @param callback - Optional callback that handles the response.
1215
1286
  * @returns A promise if used with async/await, or void if used with a callback.
1216
1287
  */
1217
- list(params: Params$Resource$Anywherecache$List, options: StreamMethodOptions): GaxiosPromise<Readable>;
1218
- list(params?: Params$Resource$Anywherecache$List, options?: MethodOptions): GaxiosPromise<Schema$AnywhereCaches>;
1219
- list(params: Params$Resource$Anywherecache$List, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
1220
- list(params: Params$Resource$Anywherecache$List, options: MethodOptions | BodyResponseCallback<Schema$AnywhereCaches>, callback: BodyResponseCallback<Schema$AnywhereCaches>): void;
1221
- list(params: Params$Resource$Anywherecache$List, callback: BodyResponseCallback<Schema$AnywhereCaches>): void;
1288
+ list(params: Params$Resource$Anywherecaches$List, options: StreamMethodOptions): GaxiosPromise<Readable>;
1289
+ list(params?: Params$Resource$Anywherecaches$List, options?: MethodOptions): GaxiosPromise<Schema$AnywhereCaches>;
1290
+ list(params: Params$Resource$Anywherecaches$List, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
1291
+ list(params: Params$Resource$Anywherecaches$List, options: MethodOptions | BodyResponseCallback<Schema$AnywhereCaches>, callback: BodyResponseCallback<Schema$AnywhereCaches>): void;
1292
+ list(params: Params$Resource$Anywherecaches$List, callback: BodyResponseCallback<Schema$AnywhereCaches>): void;
1222
1293
  list(callback: BodyResponseCallback<Schema$AnywhereCaches>): void;
1223
1294
  /**
1224
1295
  * Pauses an Anywhere Cache instance.
@@ -1228,11 +1299,11 @@ export declare namespace storage_v1 {
1228
1299
  * @param callback - Optional callback that handles the response.
1229
1300
  * @returns A promise if used with async/await, or void if used with a callback.
1230
1301
  */
1231
- pause(params: Params$Resource$Anywherecache$Pause, options: StreamMethodOptions): GaxiosPromise<Readable>;
1232
- pause(params?: Params$Resource$Anywherecache$Pause, options?: MethodOptions): GaxiosPromise<Schema$AnywhereCache>;
1233
- pause(params: Params$Resource$Anywherecache$Pause, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
1234
- pause(params: Params$Resource$Anywherecache$Pause, options: MethodOptions | BodyResponseCallback<Schema$AnywhereCache>, callback: BodyResponseCallback<Schema$AnywhereCache>): void;
1235
- pause(params: Params$Resource$Anywherecache$Pause, callback: BodyResponseCallback<Schema$AnywhereCache>): void;
1302
+ pause(params: Params$Resource$Anywherecaches$Pause, options: StreamMethodOptions): GaxiosPromise<Readable>;
1303
+ pause(params?: Params$Resource$Anywherecaches$Pause, options?: MethodOptions): GaxiosPromise<Schema$AnywhereCache>;
1304
+ pause(params: Params$Resource$Anywherecaches$Pause, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
1305
+ pause(params: Params$Resource$Anywherecaches$Pause, options: MethodOptions | BodyResponseCallback<Schema$AnywhereCache>, callback: BodyResponseCallback<Schema$AnywhereCache>): void;
1306
+ pause(params: Params$Resource$Anywherecaches$Pause, callback: BodyResponseCallback<Schema$AnywhereCache>): void;
1236
1307
  pause(callback: BodyResponseCallback<Schema$AnywhereCache>): void;
1237
1308
  /**
1238
1309
  * Resumes a paused or disabled Anywhere Cache instance.
@@ -1242,11 +1313,11 @@ export declare namespace storage_v1 {
1242
1313
  * @param callback - Optional callback that handles the response.
1243
1314
  * @returns A promise if used with async/await, or void if used with a callback.
1244
1315
  */
1245
- resume(params: Params$Resource$Anywherecache$Resume, options: StreamMethodOptions): GaxiosPromise<Readable>;
1246
- resume(params?: Params$Resource$Anywherecache$Resume, options?: MethodOptions): GaxiosPromise<Schema$AnywhereCache>;
1247
- resume(params: Params$Resource$Anywherecache$Resume, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
1248
- resume(params: Params$Resource$Anywherecache$Resume, options: MethodOptions | BodyResponseCallback<Schema$AnywhereCache>, callback: BodyResponseCallback<Schema$AnywhereCache>): void;
1249
- resume(params: Params$Resource$Anywherecache$Resume, callback: BodyResponseCallback<Schema$AnywhereCache>): void;
1316
+ resume(params: Params$Resource$Anywherecaches$Resume, options: StreamMethodOptions): GaxiosPromise<Readable>;
1317
+ resume(params?: Params$Resource$Anywherecaches$Resume, options?: MethodOptions): GaxiosPromise<Schema$AnywhereCache>;
1318
+ resume(params: Params$Resource$Anywherecaches$Resume, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
1319
+ resume(params: Params$Resource$Anywherecaches$Resume, options: MethodOptions | BodyResponseCallback<Schema$AnywhereCache>, callback: BodyResponseCallback<Schema$AnywhereCache>): void;
1320
+ resume(params: Params$Resource$Anywherecaches$Resume, callback: BodyResponseCallback<Schema$AnywhereCache>): void;
1250
1321
  resume(callback: BodyResponseCallback<Schema$AnywhereCache>): void;
1251
1322
  /**
1252
1323
  * Updates the config(ttl and admissionPolicy) of an Anywhere Cache instance.
@@ -1256,36 +1327,36 @@ export declare namespace storage_v1 {
1256
1327
  * @param callback - Optional callback that handles the response.
1257
1328
  * @returns A promise if used with async/await, or void if used with a callback.
1258
1329
  */
1259
- update(params: Params$Resource$Anywherecache$Update, options: StreamMethodOptions): GaxiosPromise<Readable>;
1260
- update(params?: Params$Resource$Anywherecache$Update, options?: MethodOptions): GaxiosPromise<Schema$GoogleLongrunningOperation>;
1261
- update(params: Params$Resource$Anywherecache$Update, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
1262
- update(params: Params$Resource$Anywherecache$Update, options: MethodOptions | BodyResponseCallback<Schema$GoogleLongrunningOperation>, callback: BodyResponseCallback<Schema$GoogleLongrunningOperation>): void;
1263
- update(params: Params$Resource$Anywherecache$Update, callback: BodyResponseCallback<Schema$GoogleLongrunningOperation>): void;
1330
+ update(params: Params$Resource$Anywherecaches$Update, options: StreamMethodOptions): GaxiosPromise<Readable>;
1331
+ update(params?: Params$Resource$Anywherecaches$Update, options?: MethodOptions): GaxiosPromise<Schema$GoogleLongrunningOperation>;
1332
+ update(params: Params$Resource$Anywherecaches$Update, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
1333
+ update(params: Params$Resource$Anywherecaches$Update, options: MethodOptions | BodyResponseCallback<Schema$GoogleLongrunningOperation>, callback: BodyResponseCallback<Schema$GoogleLongrunningOperation>): void;
1334
+ update(params: Params$Resource$Anywherecaches$Update, callback: BodyResponseCallback<Schema$GoogleLongrunningOperation>): void;
1264
1335
  update(callback: BodyResponseCallback<Schema$GoogleLongrunningOperation>): void;
1265
1336
  }
1266
- export interface Params$Resource$Anywherecache$Disable extends StandardParameters {
1337
+ export interface Params$Resource$Anywherecaches$Disable extends StandardParameters {
1267
1338
  /**
1268
1339
  * The ID of requested Anywhere Cache instance.
1269
1340
  */
1270
1341
  anywhereCacheId?: string;
1271
1342
  /**
1272
- * Name of the partent bucket
1343
+ * Name of the parent bucket.
1273
1344
  */
1274
1345
  bucket?: string;
1275
1346
  }
1276
- export interface Params$Resource$Anywherecache$Get extends StandardParameters {
1347
+ export interface Params$Resource$Anywherecaches$Get extends StandardParameters {
1277
1348
  /**
1278
1349
  * The ID of requested Anywhere Cache instance.
1279
1350
  */
1280
1351
  anywhereCacheId?: string;
1281
1352
  /**
1282
- * Name of the partent bucket
1353
+ * Name of the parent bucket.
1283
1354
  */
1284
1355
  bucket?: string;
1285
1356
  }
1286
- export interface Params$Resource$Anywherecache$Insert extends StandardParameters {
1357
+ export interface Params$Resource$Anywherecaches$Insert extends StandardParameters {
1287
1358
  /**
1288
- * Name of the partent bucket
1359
+ * Name of the parent bucket.
1289
1360
  */
1290
1361
  bucket?: string;
1291
1362
  /**
@@ -1293,13 +1364,13 @@ export declare namespace storage_v1 {
1293
1364
  */
1294
1365
  requestBody?: Schema$AnywhereCache;
1295
1366
  }
1296
- export interface Params$Resource$Anywherecache$List extends StandardParameters {
1367
+ export interface Params$Resource$Anywherecaches$List extends StandardParameters {
1297
1368
  /**
1298
- * Name of the partent bucket
1369
+ * Name of the parent bucket.
1299
1370
  */
1300
1371
  bucket?: string;
1301
1372
  /**
1302
- * Maximum number of items return in a single page of responses. Maximum 1000.
1373
+ * Maximum number of items to return in a single page of responses. Maximum 1000.
1303
1374
  */
1304
1375
  pageSize?: number;
1305
1376
  /**
@@ -1307,33 +1378,33 @@ export declare namespace storage_v1 {
1307
1378
  */
1308
1379
  pageToken?: string;
1309
1380
  }
1310
- export interface Params$Resource$Anywherecache$Pause extends StandardParameters {
1381
+ export interface Params$Resource$Anywherecaches$Pause extends StandardParameters {
1311
1382
  /**
1312
1383
  * The ID of requested Anywhere Cache instance.
1313
1384
  */
1314
1385
  anywhereCacheId?: string;
1315
1386
  /**
1316
- * Name of the partent bucket
1387
+ * Name of the parent bucket.
1317
1388
  */
1318
1389
  bucket?: string;
1319
1390
  }
1320
- export interface Params$Resource$Anywherecache$Resume extends StandardParameters {
1391
+ export interface Params$Resource$Anywherecaches$Resume extends StandardParameters {
1321
1392
  /**
1322
1393
  * The ID of requested Anywhere Cache instance.
1323
1394
  */
1324
1395
  anywhereCacheId?: string;
1325
1396
  /**
1326
- * Name of the partent bucket
1397
+ * Name of the parent bucket.
1327
1398
  */
1328
1399
  bucket?: string;
1329
1400
  }
1330
- export interface Params$Resource$Anywherecache$Update extends StandardParameters {
1401
+ export interface Params$Resource$Anywherecaches$Update extends StandardParameters {
1331
1402
  /**
1332
1403
  * The ID of requested Anywhere Cache instance.
1333
1404
  */
1334
1405
  anywhereCacheId?: string;
1335
1406
  /**
1336
- * Name of the partent bucket
1407
+ * Name of the parent bucket.
1337
1408
  */
1338
1409
  bucket?: string;
1339
1410
  /**
@@ -2089,6 +2160,182 @@ export declare namespace storage_v1 {
2089
2160
  */
2090
2161
  requestBody?: Schema$ObjectAccessControl;
2091
2162
  }
2163
+ export class Resource$Folders {
2164
+ context: APIRequestContext;
2165
+ constructor(context: APIRequestContext);
2166
+ /**
2167
+ * Permanently deletes a folder. Only applicable to buckets with hierarchical namespace enabled.
2168
+ *
2169
+ * @param params - Parameters for request
2170
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
2171
+ * @param callback - Optional callback that handles the response.
2172
+ * @returns A promise if used with async/await, or void if used with a callback.
2173
+ */
2174
+ delete(params: Params$Resource$Folders$Delete, options: StreamMethodOptions): GaxiosPromise<Readable>;
2175
+ delete(params?: Params$Resource$Folders$Delete, options?: MethodOptions): GaxiosPromise<void>;
2176
+ delete(params: Params$Resource$Folders$Delete, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
2177
+ delete(params: Params$Resource$Folders$Delete, options: MethodOptions | BodyResponseCallback<void>, callback: BodyResponseCallback<void>): void;
2178
+ delete(params: Params$Resource$Folders$Delete, callback: BodyResponseCallback<void>): void;
2179
+ delete(callback: BodyResponseCallback<void>): void;
2180
+ /**
2181
+ * Returns metadata for the specified folder. Only applicable to buckets with hierarchical namespace enabled.
2182
+ *
2183
+ * @param params - Parameters for request
2184
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
2185
+ * @param callback - Optional callback that handles the response.
2186
+ * @returns A promise if used with async/await, or void if used with a callback.
2187
+ */
2188
+ get(params: Params$Resource$Folders$Get, options: StreamMethodOptions): GaxiosPromise<Readable>;
2189
+ get(params?: Params$Resource$Folders$Get, options?: MethodOptions): GaxiosPromise<Schema$Folder>;
2190
+ get(params: Params$Resource$Folders$Get, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
2191
+ get(params: Params$Resource$Folders$Get, options: MethodOptions | BodyResponseCallback<Schema$Folder>, callback: BodyResponseCallback<Schema$Folder>): void;
2192
+ get(params: Params$Resource$Folders$Get, callback: BodyResponseCallback<Schema$Folder>): void;
2193
+ get(callback: BodyResponseCallback<Schema$Folder>): void;
2194
+ /**
2195
+ * Creates a new folder. Only applicable to buckets with hierarchical namespace enabled.
2196
+ *
2197
+ * @param params - Parameters for request
2198
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
2199
+ * @param callback - Optional callback that handles the response.
2200
+ * @returns A promise if used with async/await, or void if used with a callback.
2201
+ */
2202
+ insert(params: Params$Resource$Folders$Insert, options: StreamMethodOptions): GaxiosPromise<Readable>;
2203
+ insert(params?: Params$Resource$Folders$Insert, options?: MethodOptions): GaxiosPromise<Schema$Folder>;
2204
+ insert(params: Params$Resource$Folders$Insert, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
2205
+ insert(params: Params$Resource$Folders$Insert, options: MethodOptions | BodyResponseCallback<Schema$Folder>, callback: BodyResponseCallback<Schema$Folder>): void;
2206
+ insert(params: Params$Resource$Folders$Insert, callback: BodyResponseCallback<Schema$Folder>): void;
2207
+ insert(callback: BodyResponseCallback<Schema$Folder>): void;
2208
+ /**
2209
+ * Retrieves a list of folders matching the criteria. Only applicable to buckets with hierarchical namespace enabled.
2210
+ *
2211
+ * @param params - Parameters for request
2212
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
2213
+ * @param callback - Optional callback that handles the response.
2214
+ * @returns A promise if used with async/await, or void if used with a callback.
2215
+ */
2216
+ list(params: Params$Resource$Folders$List, options: StreamMethodOptions): GaxiosPromise<Readable>;
2217
+ list(params?: Params$Resource$Folders$List, options?: MethodOptions): GaxiosPromise<Schema$Folders>;
2218
+ list(params: Params$Resource$Folders$List, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
2219
+ list(params: Params$Resource$Folders$List, options: MethodOptions | BodyResponseCallback<Schema$Folders>, callback: BodyResponseCallback<Schema$Folders>): void;
2220
+ list(params: Params$Resource$Folders$List, callback: BodyResponseCallback<Schema$Folders>): void;
2221
+ list(callback: BodyResponseCallback<Schema$Folders>): void;
2222
+ /**
2223
+ * Renames a source folder to a destination folder. Only applicable to buckets with hierarchical namespace enabled.
2224
+ *
2225
+ * @param params - Parameters for request
2226
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
2227
+ * @param callback - Optional callback that handles the response.
2228
+ * @returns A promise if used with async/await, or void if used with a callback.
2229
+ */
2230
+ rename(params: Params$Resource$Folders$Rename, options: StreamMethodOptions): GaxiosPromise<Readable>;
2231
+ rename(params?: Params$Resource$Folders$Rename, options?: MethodOptions): GaxiosPromise<Schema$GoogleLongrunningOperation>;
2232
+ rename(params: Params$Resource$Folders$Rename, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
2233
+ rename(params: Params$Resource$Folders$Rename, options: MethodOptions | BodyResponseCallback<Schema$GoogleLongrunningOperation>, callback: BodyResponseCallback<Schema$GoogleLongrunningOperation>): void;
2234
+ rename(params: Params$Resource$Folders$Rename, callback: BodyResponseCallback<Schema$GoogleLongrunningOperation>): void;
2235
+ rename(callback: BodyResponseCallback<Schema$GoogleLongrunningOperation>): void;
2236
+ }
2237
+ export interface Params$Resource$Folders$Delete extends StandardParameters {
2238
+ /**
2239
+ * Name of the bucket in which the folder resides.
2240
+ */
2241
+ bucket?: string;
2242
+ /**
2243
+ * Name of a folder.
2244
+ */
2245
+ folder?: string;
2246
+ /**
2247
+ * If set, only deletes the folder if its metageneration matches this value.
2248
+ */
2249
+ ifMetagenerationMatch?: string;
2250
+ /**
2251
+ * If set, only deletes the folder if its metageneration does not match this value.
2252
+ */
2253
+ ifMetagenerationNotMatch?: string;
2254
+ }
2255
+ export interface Params$Resource$Folders$Get extends StandardParameters {
2256
+ /**
2257
+ * Name of the bucket in which the folder resides.
2258
+ */
2259
+ bucket?: string;
2260
+ /**
2261
+ * Name of a folder.
2262
+ */
2263
+ folder?: string;
2264
+ /**
2265
+ * Makes the return of the folder metadata conditional on whether the folder's current metageneration matches the given value.
2266
+ */
2267
+ ifMetagenerationMatch?: string;
2268
+ /**
2269
+ * Makes the return of the folder metadata conditional on whether the folder's current metageneration does not match the given value.
2270
+ */
2271
+ ifMetagenerationNotMatch?: string;
2272
+ }
2273
+ export interface Params$Resource$Folders$Insert extends StandardParameters {
2274
+ /**
2275
+ * Name of the bucket in which the folder resides.
2276
+ */
2277
+ bucket?: string;
2278
+ /**
2279
+ * If true, any parent folder which doesn’t exist will be created automatically.
2280
+ */
2281
+ recursive?: boolean;
2282
+ /**
2283
+ * Request body metadata
2284
+ */
2285
+ requestBody?: Schema$Folder;
2286
+ }
2287
+ export interface Params$Resource$Folders$List extends StandardParameters {
2288
+ /**
2289
+ * Name of the bucket in which to look for folders.
2290
+ */
2291
+ bucket?: string;
2292
+ /**
2293
+ * Returns results in a directory-like mode. The only supported value is '/'. If set, items will only contain folders that either exactly match the prefix, or are one level below the prefix.
2294
+ */
2295
+ delimiter?: string;
2296
+ /**
2297
+ * Filter results to folders whose names are lexicographically before endOffset. If startOffset is also set, the folders listed will have names between startOffset (inclusive) and endOffset (exclusive).
2298
+ */
2299
+ endOffset?: string;
2300
+ /**
2301
+ * Maximum number of items to return in a single page of responses.
2302
+ */
2303
+ pageSize?: number;
2304
+ /**
2305
+ * A previously-returned page token representing part of the larger set of results to view.
2306
+ */
2307
+ pageToken?: string;
2308
+ /**
2309
+ * Filter results to folders whose paths begin with this prefix. If set, the value must either be an empty string or end with a '/'.
2310
+ */
2311
+ prefix?: string;
2312
+ /**
2313
+ * Filter results to folders whose names are lexicographically equal to or after startOffset. If endOffset is also set, the folders listed will have names between startOffset (inclusive) and endOffset (exclusive).
2314
+ */
2315
+ startOffset?: string;
2316
+ }
2317
+ export interface Params$Resource$Folders$Rename extends StandardParameters {
2318
+ /**
2319
+ * Name of the bucket in which the folders are in.
2320
+ */
2321
+ bucket?: string;
2322
+ /**
2323
+ * Name of the destination folder.
2324
+ */
2325
+ destinationFolder?: string;
2326
+ /**
2327
+ * Makes the operation conditional on whether the source object's current metageneration matches the given value.
2328
+ */
2329
+ ifSourceMetagenerationMatch?: string;
2330
+ /**
2331
+ * Makes the operation conditional on whether the source object's current metageneration does not match the given value.
2332
+ */
2333
+ ifSourceMetagenerationNotMatch?: string;
2334
+ /**
2335
+ * Name of the source folder.
2336
+ */
2337
+ sourceFolder?: string;
2338
+ }
2092
2339
  export class Resource$Managedfolders {
2093
2340
  context: APIRequestContext;
2094
2341
  constructor(context: APIRequestContext);
@@ -2261,7 +2508,7 @@ export declare namespace storage_v1 {
2261
2508
  */
2262
2509
  bucket?: string;
2263
2510
  /**
2264
- * Maximum number of items return in a single page of responses.
2511
+ * Maximum number of items to return in a single page of responses.
2265
2512
  */
2266
2513
  pageSize?: number;
2267
2514
  /**