@googleapis/storage 21.2.0 → 22.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/v1.ts CHANGED
@@ -176,6 +176,10 @@ export namespace storage_v1 {
176
176
  * The ID of the resource, including the project number, bucket name and anywhere cache ID.
177
177
  */
178
178
  id?: string | null;
179
+ /**
180
+ * Specifies whether objects are ingested into the cache upon write.
181
+ */
182
+ ingestOnWrite?: boolean | null;
179
183
  /**
180
184
  * The kind of item this is. For Anywhere Cache, this is always storage#anywhereCache.
181
185
  */
@@ -350,6 +354,8 @@ export namespace storage_v1 {
350
354
  matchesSuffix?: string[];
351
355
  noncurrentTimeBefore?: string;
352
356
  numNewerVersions?: number;
357
+ sizeAboveBytes?: string;
358
+ sizeBelowBytes?: string;
353
359
  };
354
360
  }>;
355
361
  } | null;
@@ -1382,26 +1388,26 @@ export namespace storage_v1 {
1382
1388
  */
1383
1389
  kind?: string | null;
1384
1390
  /**
1385
- * The permissions held by the caller. Permissions are always of the format storage.resource.capability, where resource is one of buckets, objects, or managedFolders. The supported permissions are as follows:
1386
- * - storage.buckets.delete - Delete bucket.
1387
- * - storage.buckets.get - Read bucket metadata.
1388
- * - storage.buckets.getIamPolicy - Read bucket IAM policy.
1389
- * - storage.buckets.create - Create bucket.
1390
- * - storage.buckets.list - List buckets.
1391
- * - storage.buckets.setIamPolicy - Update bucket IAM policy.
1392
- * - storage.buckets.update - Update bucket metadata.
1393
- * - storage.objects.delete - Delete object.
1394
- * - storage.objects.get - Read object data and metadata.
1395
- * - storage.objects.getIamPolicy - Read object IAM policy.
1396
- * - storage.objects.create - Create object.
1397
- * - storage.objects.list - List objects.
1398
- * - storage.objects.setIamPolicy - Update object IAM policy.
1391
+ * The permissions held by the caller. Permissions are always of the format storage.resource.capability, where resource is one of buckets, objects, or managedFolders. The supported permissions are as follows:
1392
+ * - storage.buckets.delete - Delete bucket.
1393
+ * - storage.buckets.get - Read bucket metadata.
1394
+ * - storage.buckets.getIamPolicy - Read bucket IAM policy.
1395
+ * - storage.buckets.create - Create bucket.
1396
+ * - storage.buckets.list - List buckets.
1397
+ * - storage.buckets.setIamPolicy - Update bucket IAM policy.
1398
+ * - storage.buckets.update - Update bucket metadata.
1399
+ * - storage.objects.delete - Delete object.
1400
+ * - storage.objects.get - Read object data and metadata.
1401
+ * - storage.objects.getIamPolicy - Read object IAM policy.
1402
+ * - storage.objects.create - Create object.
1403
+ * - storage.objects.list - List objects.
1404
+ * - storage.objects.setIamPolicy - Update object IAM policy.
1399
1405
  * - storage.objects.update - Update object metadata.
1400
- * - storage.managedFolders.delete - Delete managed folder.
1401
- * - storage.managedFolders.get - Read managed folder metadata.
1402
- * - storage.managedFolders.getIamPolicy - Read managed folder IAM policy.
1403
- * - storage.managedFolders.create - Create managed folder.
1404
- * - storage.managedFolders.list - List managed folders.
1406
+ * - storage.managedFolders.delete - Delete managed folder.
1407
+ * - storage.managedFolders.get - Read managed folder metadata.
1408
+ * - storage.managedFolders.getIamPolicy - Read managed folder IAM policy.
1409
+ * - storage.managedFolders.create - Create managed folder.
1410
+ * - storage.managedFolders.list - List managed folders.
1405
1411
  * - storage.managedFolders.setIamPolicy - Update managed folder IAM policy.
1406
1412
  */
1407
1413
  permissions?: string[] | null;
@@ -1462,6 +1468,7 @@ export namespace storage_v1 {
1462
1468
  * // "bucket": "my_bucket",
1463
1469
  * // "createTime": "my_createTime",
1464
1470
  * // "id": "my_id",
1471
+ * // "ingestOnWrite": false,
1465
1472
  * // "kind": "my_kind",
1466
1473
  * // "pendingUpdate": false,
1467
1474
  * // "selfLink": "my_selfLink",
@@ -1618,6 +1625,7 @@ export namespace storage_v1 {
1618
1625
  * // "bucket": "my_bucket",
1619
1626
  * // "createTime": "my_createTime",
1620
1627
  * // "id": "my_id",
1628
+ * // "ingestOnWrite": false,
1621
1629
  * // "kind": "my_kind",
1622
1630
  * // "pendingUpdate": false,
1623
1631
  * // "selfLink": "my_selfLink",
@@ -1770,6 +1778,7 @@ export namespace storage_v1 {
1770
1778
  * // "bucket": "my_bucket",
1771
1779
  * // "createTime": "my_createTime",
1772
1780
  * // "id": "my_id",
1781
+ * // "ingestOnWrite": false,
1773
1782
  * // "kind": "my_kind",
1774
1783
  * // "pendingUpdate": false,
1775
1784
  * // "selfLink": "my_selfLink",
@@ -1822,8 +1831,7 @@ export namespace storage_v1 {
1822
1831
  insert(
1823
1832
  params: Params$Resource$Anywherecaches$Insert,
1824
1833
  options:
1825
- | MethodOptions
1826
- | BodyResponseCallback<Schema$GoogleLongrunningOperation>,
1834
+ MethodOptions | BodyResponseCallback<Schema$GoogleLongrunningOperation>,
1827
1835
  callback: BodyResponseCallback<Schema$GoogleLongrunningOperation>
1828
1836
  ): void;
1829
1837
  insert(
@@ -2091,6 +2099,7 @@ export namespace storage_v1 {
2091
2099
  * // "bucket": "my_bucket",
2092
2100
  * // "createTime": "my_createTime",
2093
2101
  * // "id": "my_id",
2102
+ * // "ingestOnWrite": false,
2094
2103
  * // "kind": "my_kind",
2095
2104
  * // "pendingUpdate": false,
2096
2105
  * // "selfLink": "my_selfLink",
@@ -2245,6 +2254,7 @@ export namespace storage_v1 {
2245
2254
  * // "bucket": "my_bucket",
2246
2255
  * // "createTime": "my_createTime",
2247
2256
  * // "id": "my_id",
2257
+ * // "ingestOnWrite": false,
2248
2258
  * // "kind": "my_kind",
2249
2259
  * // "pendingUpdate": false,
2250
2260
  * // "selfLink": "my_selfLink",
@@ -2351,7 +2361,7 @@ export namespace storage_v1 {
2351
2361
  }
2352
2362
 
2353
2363
  /**
2354
- * Updates the config(ttl and admissionPolicy) of an Anywhere Cache instance.
2364
+ * Updates the config of an Anywhere Cache instance.
2355
2365
  * @example
2356
2366
  * ```js
2357
2367
  * // Before running the sample:
@@ -2399,6 +2409,7 @@ export namespace storage_v1 {
2399
2409
  * // "bucket": "my_bucket",
2400
2410
  * // "createTime": "my_createTime",
2401
2411
  * // "id": "my_id",
2412
+ * // "ingestOnWrite": false,
2402
2413
  * // "kind": "my_kind",
2403
2414
  * // "pendingUpdate": false,
2404
2415
  * // "selfLink": "my_selfLink",
@@ -2451,8 +2462,7 @@ export namespace storage_v1 {
2451
2462
  update(
2452
2463
  params: Params$Resource$Anywherecaches$Update,
2453
2464
  options:
2454
- | MethodOptions
2455
- | BodyResponseCallback<Schema$GoogleLongrunningOperation>,
2465
+ MethodOptions | BodyResponseCallback<Schema$GoogleLongrunningOperation>,
2456
2466
  callback: BodyResponseCallback<Schema$GoogleLongrunningOperation>
2457
2467
  ): void;
2458
2468
  update(
@@ -3147,8 +3157,7 @@ export namespace storage_v1 {
3147
3157
  list(
3148
3158
  params: Params$Resource$Bucketaccesscontrols$List,
3149
3159
  options:
3150
- | MethodOptions
3151
- | BodyResponseCallback<Schema$BucketAccessControls>,
3160
+ MethodOptions | BodyResponseCallback<Schema$BucketAccessControls>,
3152
3161
  callback: BodyResponseCallback<Schema$BucketAccessControls>
3153
3162
  ): void;
3154
3163
  list(
@@ -3941,8 +3950,7 @@ export namespace storage_v1 {
3941
3950
  | BodyResponseCallback<Schema$Bucket>
3942
3951
  | BodyResponseCallback<Readable>,
3943
3952
  callback?:
3944
- | BodyResponseCallback<Schema$Bucket>
3945
- | BodyResponseCallback<Readable>
3953
+ BodyResponseCallback<Schema$Bucket> | BodyResponseCallback<Readable>
3946
3954
  ):
3947
3955
  | void
3948
3956
  | Promise<GaxiosResponseWithHTTP2<Schema$Bucket>>
@@ -4088,8 +4096,7 @@ export namespace storage_v1 {
4088
4096
  | BodyResponseCallback<Schema$Policy>
4089
4097
  | BodyResponseCallback<Readable>,
4090
4098
  callback?:
4091
- | BodyResponseCallback<Schema$Policy>
4092
- | BodyResponseCallback<Readable>
4099
+ BodyResponseCallback<Schema$Policy> | BodyResponseCallback<Readable>
4093
4100
  ):
4094
4101
  | void
4095
4102
  | Promise<GaxiosResponseWithHTTP2<Schema$Policy>>
@@ -4473,8 +4480,7 @@ export namespace storage_v1 {
4473
4480
  | BodyResponseCallback<Schema$Bucket>
4474
4481
  | BodyResponseCallback<Readable>,
4475
4482
  callback?:
4476
- | BodyResponseCallback<Schema$Bucket>
4477
- | BodyResponseCallback<Readable>
4483
+ BodyResponseCallback<Schema$Bucket> | BodyResponseCallback<Readable>
4478
4484
  ):
4479
4485
  | void
4480
4486
  | Promise<GaxiosResponseWithHTTP2<Schema$Bucket>>
@@ -4629,8 +4635,7 @@ export namespace storage_v1 {
4629
4635
  | BodyResponseCallback<Schema$Buckets>
4630
4636
  | BodyResponseCallback<Readable>,
4631
4637
  callback?:
4632
- | BodyResponseCallback<Schema$Buckets>
4633
- | BodyResponseCallback<Readable>
4638
+ BodyResponseCallback<Schema$Buckets> | BodyResponseCallback<Readable>
4634
4639
  ):
4635
4640
  | void
4636
4641
  | Promise<GaxiosResponseWithHTTP2<Schema$Buckets>>
@@ -4807,8 +4812,7 @@ export namespace storage_v1 {
4807
4812
  | BodyResponseCallback<Schema$Bucket>
4808
4813
  | BodyResponseCallback<Readable>,
4809
4814
  callback?:
4810
- | BodyResponseCallback<Schema$Bucket>
4811
- | BodyResponseCallback<Readable>
4815
+ BodyResponseCallback<Schema$Bucket> | BodyResponseCallback<Readable>
4812
4816
  ):
4813
4817
  | void
4814
4818
  | Promise<GaxiosResponseWithHTTP2<Schema$Bucket>>
@@ -5040,8 +5044,7 @@ export namespace storage_v1 {
5040
5044
  | BodyResponseCallback<Schema$Bucket>
5041
5045
  | BodyResponseCallback<Readable>,
5042
5046
  callback?:
5043
- | BodyResponseCallback<Schema$Bucket>
5044
- | BodyResponseCallback<Readable>
5047
+ BodyResponseCallback<Schema$Bucket> | BodyResponseCallback<Readable>
5045
5048
  ):
5046
5049
  | void
5047
5050
  | Promise<GaxiosResponseWithHTTP2<Schema$Bucket>>
@@ -5179,8 +5182,7 @@ export namespace storage_v1 {
5179
5182
  relocate(
5180
5183
  params: Params$Resource$Buckets$Relocate,
5181
5184
  options:
5182
- | MethodOptions
5183
- | BodyResponseCallback<Schema$GoogleLongrunningOperation>,
5185
+ MethodOptions | BodyResponseCallback<Schema$GoogleLongrunningOperation>,
5184
5186
  callback: BodyResponseCallback<Schema$GoogleLongrunningOperation>
5185
5187
  ): void;
5186
5188
  relocate(
@@ -5384,8 +5386,7 @@ export namespace storage_v1 {
5384
5386
  | BodyResponseCallback<Schema$Bucket>
5385
5387
  | BodyResponseCallback<Readable>,
5386
5388
  callback?:
5387
- | BodyResponseCallback<Schema$Bucket>
5388
- | BodyResponseCallback<Readable>
5389
+ BodyResponseCallback<Schema$Bucket> | BodyResponseCallback<Readable>
5389
5390
  ):
5390
5391
  | void
5391
5392
  | Promise<GaxiosResponseWithHTTP2<Schema$Bucket>>
@@ -5541,8 +5542,7 @@ export namespace storage_v1 {
5541
5542
  | BodyResponseCallback<Schema$Policy>
5542
5543
  | BodyResponseCallback<Readable>,
5543
5544
  callback?:
5544
- | BodyResponseCallback<Schema$Policy>
5545
- | BodyResponseCallback<Readable>
5545
+ BodyResponseCallback<Schema$Policy> | BodyResponseCallback<Readable>
5546
5546
  ):
5547
5547
  | void
5548
5548
  | Promise<GaxiosResponseWithHTTP2<Schema$Policy>>
@@ -5671,8 +5671,7 @@ export namespace storage_v1 {
5671
5671
  testIamPermissions(
5672
5672
  params: Params$Resource$Buckets$Testiampermissions,
5673
5673
  options:
5674
- | MethodOptions
5675
- | BodyResponseCallback<Schema$TestIamPermissionsResponse>,
5674
+ MethodOptions | BodyResponseCallback<Schema$TestIamPermissionsResponse>,
5676
5675
  callback: BodyResponseCallback<Schema$TestIamPermissionsResponse>
5677
5676
  ): void;
5678
5677
  testIamPermissions(
@@ -5926,8 +5925,7 @@ export namespace storage_v1 {
5926
5925
  | BodyResponseCallback<Schema$Bucket>
5927
5926
  | BodyResponseCallback<Readable>,
5928
5927
  callback?:
5929
- | BodyResponseCallback<Schema$Bucket>
5930
- | BodyResponseCallback<Readable>
5928
+ BodyResponseCallback<Schema$Bucket> | BodyResponseCallback<Readable>
5931
5929
  ):
5932
5930
  | void
5933
5931
  | Promise<GaxiosResponseWithHTTP2<Schema$Bucket>>
@@ -6969,8 +6967,7 @@ export namespace storage_v1 {
6969
6967
  list(
6970
6968
  params: Params$Resource$Defaultobjectaccesscontrols$List,
6971
6969
  options:
6972
- | MethodOptions
6973
- | BodyResponseCallback<Schema$ObjectAccessControls>,
6970
+ MethodOptions | BodyResponseCallback<Schema$ObjectAccessControls>,
6974
6971
  callback: BodyResponseCallback<Schema$ObjectAccessControls>
6975
6972
  ): void;
6976
6973
  list(
@@ -7634,6 +7631,162 @@ export namespace storage_v1 {
7634
7631
  }
7635
7632
  }
7636
7633
 
7634
+ /**
7635
+ * Deletes a folder recursively. Only applicable to buckets with hierarchical namespace enabled.
7636
+ * @example
7637
+ * ```js
7638
+ * // Before running the sample:
7639
+ * // - Enable the API at:
7640
+ * // https://console.developers.google.com/apis/api/storage.googleapis.com
7641
+ * // - Login into gcloud by running:
7642
+ * // ```sh
7643
+ * // $ gcloud auth application-default login
7644
+ * // ```
7645
+ * // - Install the npm module by running:
7646
+ * // ```sh
7647
+ * // $ npm install googleapis
7648
+ * // ```
7649
+ *
7650
+ * const {google} = require('googleapis');
7651
+ * const storage = google.storage('v1');
7652
+ *
7653
+ * async function main() {
7654
+ * const auth = new google.auth.GoogleAuth({
7655
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
7656
+ * scopes: [
7657
+ * 'https://www.googleapis.com/auth/cloud-platform',
7658
+ * 'https://www.googleapis.com/auth/devstorage.full_control',
7659
+ * 'https://www.googleapis.com/auth/devstorage.read_write',
7660
+ * ],
7661
+ * });
7662
+ *
7663
+ * // Acquire an auth client, and bind it to all future calls
7664
+ * const authClient = await auth.getClient();
7665
+ * google.options({auth: authClient});
7666
+ *
7667
+ * // Do the magic
7668
+ * const res = await storage.folders.deleteRecursive({
7669
+ * // Name of the bucket in which the folder resides.
7670
+ * bucket: 'placeholder-value',
7671
+ * // Name of a folder.
7672
+ * folder: 'placeholder-value',
7673
+ * // If set, only deletes the folder if its metageneration matches this value.
7674
+ * ifMetagenerationMatch: 'placeholder-value',
7675
+ * // If set, only deletes the folder if its metageneration does not match this value.
7676
+ * ifMetagenerationNotMatch: 'placeholder-value',
7677
+ * });
7678
+ * console.log(res.data);
7679
+ *
7680
+ * // Example response
7681
+ * // {
7682
+ * // "done": false,
7683
+ * // "error": {},
7684
+ * // "kind": "my_kind",
7685
+ * // "metadata": {},
7686
+ * // "name": "my_name",
7687
+ * // "response": {},
7688
+ * // "selfLink": "my_selfLink"
7689
+ * // }
7690
+ * }
7691
+ *
7692
+ * main().catch(e => {
7693
+ * console.error(e);
7694
+ * throw e;
7695
+ * });
7696
+ *
7697
+ * ```
7698
+ *
7699
+ * @param params - Parameters for request
7700
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
7701
+ * @param callback - Optional callback that handles the response.
7702
+ * @returns A promise if used with async/await, or void if used with a callback.
7703
+ */
7704
+ deleteRecursive(
7705
+ params: Params$Resource$Folders$Deleterecursive,
7706
+ options: StreamMethodOptions
7707
+ ): Promise<GaxiosResponseWithHTTP2<Readable>>;
7708
+ deleteRecursive(
7709
+ params?: Params$Resource$Folders$Deleterecursive,
7710
+ options?: MethodOptions
7711
+ ): Promise<GaxiosResponseWithHTTP2<Schema$GoogleLongrunningOperation>>;
7712
+ deleteRecursive(
7713
+ params: Params$Resource$Folders$Deleterecursive,
7714
+ options: StreamMethodOptions | BodyResponseCallback<Readable>,
7715
+ callback: BodyResponseCallback<Readable>
7716
+ ): void;
7717
+ deleteRecursive(
7718
+ params: Params$Resource$Folders$Deleterecursive,
7719
+ options:
7720
+ MethodOptions | BodyResponseCallback<Schema$GoogleLongrunningOperation>,
7721
+ callback: BodyResponseCallback<Schema$GoogleLongrunningOperation>
7722
+ ): void;
7723
+ deleteRecursive(
7724
+ params: Params$Resource$Folders$Deleterecursive,
7725
+ callback: BodyResponseCallback<Schema$GoogleLongrunningOperation>
7726
+ ): void;
7727
+ deleteRecursive(
7728
+ callback: BodyResponseCallback<Schema$GoogleLongrunningOperation>
7729
+ ): void;
7730
+ deleteRecursive(
7731
+ paramsOrCallback?:
7732
+ | Params$Resource$Folders$Deleterecursive
7733
+ | BodyResponseCallback<Schema$GoogleLongrunningOperation>
7734
+ | BodyResponseCallback<Readable>,
7735
+ optionsOrCallback?:
7736
+ | MethodOptions
7737
+ | StreamMethodOptions
7738
+ | BodyResponseCallback<Schema$GoogleLongrunningOperation>
7739
+ | BodyResponseCallback<Readable>,
7740
+ callback?:
7741
+ | BodyResponseCallback<Schema$GoogleLongrunningOperation>
7742
+ | BodyResponseCallback<Readable>
7743
+ ):
7744
+ | void
7745
+ | Promise<GaxiosResponseWithHTTP2<Schema$GoogleLongrunningOperation>>
7746
+ | Promise<GaxiosResponseWithHTTP2<Readable>> {
7747
+ let params = (paramsOrCallback ||
7748
+ {}) as Params$Resource$Folders$Deleterecursive;
7749
+ let options = (optionsOrCallback || {}) as MethodOptions;
7750
+
7751
+ if (typeof paramsOrCallback === 'function') {
7752
+ callback = paramsOrCallback;
7753
+ params = {} as Params$Resource$Folders$Deleterecursive;
7754
+ options = {};
7755
+ }
7756
+
7757
+ if (typeof optionsOrCallback === 'function') {
7758
+ callback = optionsOrCallback;
7759
+ options = {};
7760
+ }
7761
+
7762
+ const rootUrl = options.rootUrl || 'https://storage.googleapis.com/';
7763
+ const parameters = {
7764
+ options: Object.assign(
7765
+ {
7766
+ url: (
7767
+ rootUrl +
7768
+ '/storage/v1/b/{bucket}/folders/{folder}/deleteRecursive'
7769
+ ).replace(/([^:]\/)\/+/g, '$1'),
7770
+ method: 'POST',
7771
+ apiVersion: '',
7772
+ },
7773
+ options
7774
+ ),
7775
+ params,
7776
+ requiredParams: ['bucket', 'folder'],
7777
+ pathParams: ['bucket', 'folder'],
7778
+ context: this.context,
7779
+ };
7780
+ if (callback) {
7781
+ createAPIRequest<Schema$GoogleLongrunningOperation>(
7782
+ parameters,
7783
+ callback as BodyResponseCallback<unknown>
7784
+ );
7785
+ } else {
7786
+ return createAPIRequest<Schema$GoogleLongrunningOperation>(parameters);
7787
+ }
7788
+ }
7789
+
7637
7790
  /**
7638
7791
  * Returns metadata for the specified folder. Only applicable to buckets with hierarchical namespace enabled.
7639
7792
  * @example
@@ -7742,8 +7895,7 @@ export namespace storage_v1 {
7742
7895
  | BodyResponseCallback<Schema$Folder>
7743
7896
  | BodyResponseCallback<Readable>,
7744
7897
  callback?:
7745
- | BodyResponseCallback<Schema$Folder>
7746
- | BodyResponseCallback<Readable>
7898
+ BodyResponseCallback<Schema$Folder> | BodyResponseCallback<Readable>
7747
7899
  ):
7748
7900
  | void
7749
7901
  | Promise<GaxiosResponseWithHTTP2<Schema$Folder>>
@@ -7908,8 +8060,7 @@ export namespace storage_v1 {
7908
8060
  | BodyResponseCallback<Schema$Folder>
7909
8061
  | BodyResponseCallback<Readable>,
7910
8062
  callback?:
7911
- | BodyResponseCallback<Schema$Folder>
7912
- | BodyResponseCallback<Readable>
8063
+ BodyResponseCallback<Schema$Folder> | BodyResponseCallback<Readable>
7913
8064
  ):
7914
8065
  | void
7915
8066
  | Promise<GaxiosResponseWithHTTP2<Schema$Folder>>
@@ -8064,8 +8215,7 @@ export namespace storage_v1 {
8064
8215
  | BodyResponseCallback<Schema$Folders>
8065
8216
  | BodyResponseCallback<Readable>,
8066
8217
  callback?:
8067
- | BodyResponseCallback<Schema$Folders>
8068
- | BodyResponseCallback<Readable>
8218
+ BodyResponseCallback<Schema$Folders> | BodyResponseCallback<Readable>
8069
8219
  ):
8070
8220
  | void
8071
8221
  | Promise<GaxiosResponseWithHTTP2<Schema$Folders>>
@@ -8200,8 +8350,7 @@ export namespace storage_v1 {
8200
8350
  rename(
8201
8351
  params: Params$Resource$Folders$Rename,
8202
8352
  options:
8203
- | MethodOptions
8204
- | BodyResponseCallback<Schema$GoogleLongrunningOperation>,
8353
+ MethodOptions | BodyResponseCallback<Schema$GoogleLongrunningOperation>,
8205
8354
  callback: BodyResponseCallback<Schema$GoogleLongrunningOperation>
8206
8355
  ): void;
8207
8356
  rename(
@@ -8289,6 +8438,24 @@ export namespace storage_v1 {
8289
8438
  */
8290
8439
  ifMetagenerationNotMatch?: string;
8291
8440
  }
8441
+ export interface Params$Resource$Folders$Deleterecursive extends StandardParameters {
8442
+ /**
8443
+ * Name of the bucket in which the folder resides.
8444
+ */
8445
+ bucket?: string;
8446
+ /**
8447
+ * Name of a folder.
8448
+ */
8449
+ folder?: string;
8450
+ /**
8451
+ * If set, only deletes the folder if its metageneration matches this value.
8452
+ */
8453
+ ifMetagenerationMatch?: string;
8454
+ /**
8455
+ * If set, only deletes the folder if its metageneration does not match this value.
8456
+ */
8457
+ ifMetagenerationNotMatch?: string;
8458
+ }
8292
8459
  export interface Params$Resource$Folders$Get extends StandardParameters {
8293
8460
  /**
8294
8461
  * Name of the bucket in which the folder resides.
@@ -8781,8 +8948,7 @@ export namespace storage_v1 {
8781
8948
  | BodyResponseCallback<Schema$Policy>
8782
8949
  | BodyResponseCallback<Readable>,
8783
8950
  callback?:
8784
- | BodyResponseCallback<Schema$Policy>
8785
- | BodyResponseCallback<Readable>
8951
+ BodyResponseCallback<Schema$Policy> | BodyResponseCallback<Readable>
8786
8952
  ):
8787
8953
  | void
8788
8954
  | Promise<GaxiosResponseWithHTTP2<Schema$Policy>>
@@ -9255,8 +9421,7 @@ export namespace storage_v1 {
9255
9421
  | BodyResponseCallback<Schema$Policy>
9256
9422
  | BodyResponseCallback<Readable>,
9257
9423
  callback?:
9258
- | BodyResponseCallback<Schema$Policy>
9259
- | BodyResponseCallback<Readable>
9424
+ BodyResponseCallback<Schema$Policy> | BodyResponseCallback<Readable>
9260
9425
  ):
9261
9426
  | void
9262
9427
  | Promise<GaxiosResponseWithHTTP2<Schema$Policy>>
@@ -9387,8 +9552,7 @@ export namespace storage_v1 {
9387
9552
  testIamPermissions(
9388
9553
  params: Params$Resource$Managedfolders$Testiampermissions,
9389
9554
  options:
9390
- | MethodOptions
9391
- | BodyResponseCallback<Schema$TestIamPermissionsResponse>,
9555
+ MethodOptions | BodyResponseCallback<Schema$TestIamPermissionsResponse>,
9392
9556
  callback: BodyResponseCallback<Schema$TestIamPermissionsResponse>
9393
9557
  ): void;
9394
9558
  testIamPermissions(
@@ -10812,8 +10976,7 @@ export namespace storage_v1 {
10812
10976
  list(
10813
10977
  params: Params$Resource$Objectaccesscontrols$List,
10814
10978
  options:
10815
- | MethodOptions
10816
- | BodyResponseCallback<Schema$ObjectAccessControls>,
10979
+ MethodOptions | BodyResponseCallback<Schema$ObjectAccessControls>,
10817
10980
  callback: BodyResponseCallback<Schema$ObjectAccessControls>
10818
10981
  ): void;
10819
10982
  list(
@@ -11480,8 +11643,7 @@ export namespace storage_v1 {
11480
11643
  bulkRestore(
11481
11644
  params: Params$Resource$Objects$Bulkrestore,
11482
11645
  options:
11483
- | MethodOptions
11484
- | BodyResponseCallback<Schema$GoogleLongrunningOperation>,
11646
+ MethodOptions | BodyResponseCallback<Schema$GoogleLongrunningOperation>,
11485
11647
  callback: BodyResponseCallback<Schema$GoogleLongrunningOperation>
11486
11648
  ): void;
11487
11649
  bulkRestore(
@@ -11705,8 +11867,7 @@ export namespace storage_v1 {
11705
11867
  | BodyResponseCallback<Schema$Object>
11706
11868
  | BodyResponseCallback<Readable>,
11707
11869
  callback?:
11708
- | BodyResponseCallback<Schema$Object>
11709
- | BodyResponseCallback<Readable>
11870
+ BodyResponseCallback<Schema$Object> | BodyResponseCallback<Readable>
11710
11871
  ):
11711
11872
  | void
11712
11873
  | Promise<GaxiosResponseWithHTTP2<Schema$Object>>
@@ -11959,8 +12120,7 @@ export namespace storage_v1 {
11959
12120
  | BodyResponseCallback<Schema$Object>
11960
12121
  | BodyResponseCallback<Readable>,
11961
12122
  callback?:
11962
- | BodyResponseCallback<Schema$Object>
11963
- | BodyResponseCallback<Readable>
12123
+ BodyResponseCallback<Schema$Object> | BodyResponseCallback<Readable>
11964
12124
  ):
11965
12125
  | void
11966
12126
  | Promise<GaxiosResponseWithHTTP2<Schema$Object>>
@@ -12315,8 +12475,7 @@ export namespace storage_v1 {
12315
12475
  | BodyResponseCallback<Schema$Object>
12316
12476
  | BodyResponseCallback<Readable>,
12317
12477
  callback?:
12318
- | BodyResponseCallback<Schema$Object>
12319
- | BodyResponseCallback<Readable>
12478
+ BodyResponseCallback<Schema$Object> | BodyResponseCallback<Readable>
12320
12479
  ):
12321
12480
  | void
12322
12481
  | Promise<GaxiosResponseWithHTTP2<Schema$Object>>
@@ -12467,8 +12626,7 @@ export namespace storage_v1 {
12467
12626
  | BodyResponseCallback<Schema$Policy>
12468
12627
  | BodyResponseCallback<Readable>,
12469
12628
  callback?:
12470
- | BodyResponseCallback<Schema$Policy>
12471
- | BodyResponseCallback<Readable>
12629
+ BodyResponseCallback<Schema$Policy> | BodyResponseCallback<Readable>
12472
12630
  ):
12473
12631
  | void
12474
12632
  | Promise<GaxiosResponseWithHTTP2<Schema$Policy>>
@@ -12714,8 +12872,7 @@ export namespace storage_v1 {
12714
12872
  | BodyResponseCallback<Schema$Object>
12715
12873
  | BodyResponseCallback<Readable>,
12716
12874
  callback?:
12717
- | BodyResponseCallback<Schema$Object>
12718
- | BodyResponseCallback<Readable>
12875
+ BodyResponseCallback<Schema$Object> | BodyResponseCallback<Readable>
12719
12876
  ):
12720
12877
  | void
12721
12878
  | Promise<GaxiosResponseWithHTTP2<Schema$Object>>
@@ -12891,8 +13048,7 @@ export namespace storage_v1 {
12891
13048
  | BodyResponseCallback<Schema$Objects>
12892
13049
  | BodyResponseCallback<Readable>,
12893
13050
  callback?:
12894
- | BodyResponseCallback<Schema$Objects>
12895
- | BodyResponseCallback<Readable>
13051
+ BodyResponseCallback<Schema$Objects> | BodyResponseCallback<Readable>
12896
13052
  ):
12897
13053
  | void
12898
13054
  | Promise<GaxiosResponseWithHTTP2<Schema$Objects>>
@@ -13092,8 +13248,7 @@ export namespace storage_v1 {
13092
13248
  | BodyResponseCallback<Schema$Object>
13093
13249
  | BodyResponseCallback<Readable>,
13094
13250
  callback?:
13095
- | BodyResponseCallback<Schema$Object>
13096
- | BodyResponseCallback<Readable>
13251
+ BodyResponseCallback<Schema$Object> | BodyResponseCallback<Readable>
13097
13252
  ):
13098
13253
  | void
13099
13254
  | Promise<GaxiosResponseWithHTTP2<Schema$Object>>
@@ -13333,8 +13488,7 @@ export namespace storage_v1 {
13333
13488
  | BodyResponseCallback<Schema$Object>
13334
13489
  | BodyResponseCallback<Readable>,
13335
13490
  callback?:
13336
- | BodyResponseCallback<Schema$Object>
13337
- | BodyResponseCallback<Readable>
13491
+ BodyResponseCallback<Schema$Object> | BodyResponseCallback<Readable>
13338
13492
  ):
13339
13493
  | void
13340
13494
  | Promise<GaxiosResponseWithHTTP2<Schema$Object>>
@@ -13529,8 +13683,7 @@ export namespace storage_v1 {
13529
13683
  | BodyResponseCallback<Schema$Object>
13530
13684
  | BodyResponseCallback<Readable>,
13531
13685
  callback?:
13532
- | BodyResponseCallback<Schema$Object>
13533
- | BodyResponseCallback<Readable>
13686
+ BodyResponseCallback<Schema$Object> | BodyResponseCallback<Readable>
13534
13687
  ):
13535
13688
  | void
13536
13689
  | Promise<GaxiosResponseWithHTTP2<Schema$Object>>
@@ -13928,8 +14081,7 @@ export namespace storage_v1 {
13928
14081
  | BodyResponseCallback<Schema$Policy>
13929
14082
  | BodyResponseCallback<Readable>,
13930
14083
  callback?:
13931
- | BodyResponseCallback<Schema$Policy>
13932
- | BodyResponseCallback<Readable>
14084
+ BodyResponseCallback<Schema$Policy> | BodyResponseCallback<Readable>
13933
14085
  ):
13934
14086
  | void
13935
14087
  | Promise<GaxiosResponseWithHTTP2<Schema$Policy>>
@@ -14062,8 +14214,7 @@ export namespace storage_v1 {
14062
14214
  testIamPermissions(
14063
14215
  params: Params$Resource$Objects$Testiampermissions,
14064
14216
  options:
14065
- | MethodOptions
14066
- | BodyResponseCallback<Schema$TestIamPermissionsResponse>,
14217
+ MethodOptions | BodyResponseCallback<Schema$TestIamPermissionsResponse>,
14067
14218
  callback: BodyResponseCallback<Schema$TestIamPermissionsResponse>
14068
14219
  ): void;
14069
14220
  testIamPermissions(
@@ -14325,8 +14476,7 @@ export namespace storage_v1 {
14325
14476
  | BodyResponseCallback<Schema$Object>
14326
14477
  | BodyResponseCallback<Readable>,
14327
14478
  callback?:
14328
- | BodyResponseCallback<Schema$Object>
14329
- | BodyResponseCallback<Readable>
14479
+ BodyResponseCallback<Schema$Object> | BodyResponseCallback<Readable>
14330
14480
  ):
14331
14481
  | void
14332
14482
  | Promise<GaxiosResponseWithHTTP2<Schema$Object>>
@@ -14372,194 +14522,6 @@ export namespace storage_v1 {
14372
14522
  return createAPIRequest<Schema$Object>(parameters);
14373
14523
  }
14374
14524
  }
14375
-
14376
- /**
14377
- * Watch for changes on all objects in a bucket.
14378
- * @example
14379
- * ```js
14380
- * // Before running the sample:
14381
- * // - Enable the API at:
14382
- * // https://console.developers.google.com/apis/api/storage.googleapis.com
14383
- * // - Login into gcloud by running:
14384
- * // ```sh
14385
- * // $ gcloud auth application-default login
14386
- * // ```
14387
- * // - Install the npm module by running:
14388
- * // ```sh
14389
- * // $ npm install googleapis
14390
- * // ```
14391
- *
14392
- * const {google} = require('googleapis');
14393
- * const storage = google.storage('v1');
14394
- *
14395
- * async function main() {
14396
- * const auth = new google.auth.GoogleAuth({
14397
- * // Scopes can be specified either as an array or as a single, space-delimited string.
14398
- * scopes: [
14399
- * 'https://www.googleapis.com/auth/cloud-platform',
14400
- * 'https://www.googleapis.com/auth/cloud-platform.read-only',
14401
- * 'https://www.googleapis.com/auth/devstorage.full_control',
14402
- * 'https://www.googleapis.com/auth/devstorage.read_only',
14403
- * 'https://www.googleapis.com/auth/devstorage.read_write',
14404
- * ],
14405
- * });
14406
- *
14407
- * // Acquire an auth client, and bind it to all future calls
14408
- * const authClient = await auth.getClient();
14409
- * google.options({auth: authClient});
14410
- *
14411
- * // Do the magic
14412
- * const res = await storage.objects.watchAll({
14413
- * // Name of the bucket in which to look for objects.
14414
- * bucket: 'placeholder-value',
14415
- * // Returns results in a directory-like mode. items will contain only objects whose names, aside from the prefix, do not contain delimiter. Objects whose names, aside from the prefix, contain delimiter will have their name, truncated after the delimiter, returned in prefixes. Duplicate prefixes are omitted.
14416
- * delimiter: 'placeholder-value',
14417
- * // Filter results to objects whose names are lexicographically before endOffset. If startOffset is also set, the objects listed will have names between startOffset (inclusive) and endOffset (exclusive).
14418
- * endOffset: 'placeholder-value',
14419
- * // If true, objects that end in exactly one instance of delimiter will have their metadata included in items in addition to prefixes.
14420
- * includeTrailingDelimiter: 'placeholder-value',
14421
- * // Maximum number of items plus prefixes to return in a single page of responses. As duplicate prefixes are omitted, fewer total results may be returned than requested. The service will use this parameter or 1,000 items, whichever is smaller.
14422
- * maxResults: 'placeholder-value',
14423
- * // A previously-returned page token representing part of the larger set of results to view.
14424
- * pageToken: 'placeholder-value',
14425
- * // Filter results to objects whose names begin with this prefix.
14426
- * prefix: 'placeholder-value',
14427
- * // Set of properties to return. Defaults to noAcl.
14428
- * projection: 'placeholder-value',
14429
- * // Filter results to objects whose names are lexicographically equal to or after startOffset. If endOffset is also set, the objects listed will have names between startOffset (inclusive) and endOffset (exclusive).
14430
- * startOffset: 'placeholder-value',
14431
- * // The project to be billed for this request. Required for Requester Pays buckets.
14432
- * userProject: 'placeholder-value',
14433
- * // If true, lists all versions of an object as distinct results. The default is false. For more information, see [Object Versioning](https://cloud.google.com/storage/docs/object-versioning).
14434
- * versions: 'placeholder-value',
14435
- *
14436
- * // Request body metadata
14437
- * requestBody: {
14438
- * // request body parameters
14439
- * // {
14440
- * // "address": "my_address",
14441
- * // "expiration": "my_expiration",
14442
- * // "id": "my_id",
14443
- * // "kind": "my_kind",
14444
- * // "params": {},
14445
- * // "payload": false,
14446
- * // "resourceId": "my_resourceId",
14447
- * // "resourceUri": "my_resourceUri",
14448
- * // "token": "my_token",
14449
- * // "type": "my_type"
14450
- * // }
14451
- * },
14452
- * });
14453
- * console.log(res.data);
14454
- *
14455
- * // Example response
14456
- * // {
14457
- * // "address": "my_address",
14458
- * // "expiration": "my_expiration",
14459
- * // "id": "my_id",
14460
- * // "kind": "my_kind",
14461
- * // "params": {},
14462
- * // "payload": false,
14463
- * // "resourceId": "my_resourceId",
14464
- * // "resourceUri": "my_resourceUri",
14465
- * // "token": "my_token",
14466
- * // "type": "my_type"
14467
- * // }
14468
- * }
14469
- *
14470
- * main().catch(e => {
14471
- * console.error(e);
14472
- * throw e;
14473
- * });
14474
- *
14475
- * ```
14476
- *
14477
- * @param params - Parameters for request
14478
- * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
14479
- * @param callback - Optional callback that handles the response.
14480
- * @returns A promise if used with async/await, or void if used with a callback.
14481
- */
14482
- watchAll(
14483
- params: Params$Resource$Objects$Watchall,
14484
- options: StreamMethodOptions
14485
- ): Promise<GaxiosResponseWithHTTP2<Readable>>;
14486
- watchAll(
14487
- params?: Params$Resource$Objects$Watchall,
14488
- options?: MethodOptions
14489
- ): Promise<GaxiosResponseWithHTTP2<Schema$Channel>>;
14490
- watchAll(
14491
- params: Params$Resource$Objects$Watchall,
14492
- options: StreamMethodOptions | BodyResponseCallback<Readable>,
14493
- callback: BodyResponseCallback<Readable>
14494
- ): void;
14495
- watchAll(
14496
- params: Params$Resource$Objects$Watchall,
14497
- options: MethodOptions | BodyResponseCallback<Schema$Channel>,
14498
- callback: BodyResponseCallback<Schema$Channel>
14499
- ): void;
14500
- watchAll(
14501
- params: Params$Resource$Objects$Watchall,
14502
- callback: BodyResponseCallback<Schema$Channel>
14503
- ): void;
14504
- watchAll(callback: BodyResponseCallback<Schema$Channel>): void;
14505
- watchAll(
14506
- paramsOrCallback?:
14507
- | Params$Resource$Objects$Watchall
14508
- | BodyResponseCallback<Schema$Channel>
14509
- | BodyResponseCallback<Readable>,
14510
- optionsOrCallback?:
14511
- | MethodOptions
14512
- | StreamMethodOptions
14513
- | BodyResponseCallback<Schema$Channel>
14514
- | BodyResponseCallback<Readable>,
14515
- callback?:
14516
- | BodyResponseCallback<Schema$Channel>
14517
- | BodyResponseCallback<Readable>
14518
- ):
14519
- | void
14520
- | Promise<GaxiosResponseWithHTTP2<Schema$Channel>>
14521
- | Promise<GaxiosResponseWithHTTP2<Readable>> {
14522
- let params = (paramsOrCallback || {}) as Params$Resource$Objects$Watchall;
14523
- let options = (optionsOrCallback || {}) as MethodOptions;
14524
-
14525
- if (typeof paramsOrCallback === 'function') {
14526
- callback = paramsOrCallback;
14527
- params = {} as Params$Resource$Objects$Watchall;
14528
- options = {};
14529
- }
14530
-
14531
- if (typeof optionsOrCallback === 'function') {
14532
- callback = optionsOrCallback;
14533
- options = {};
14534
- }
14535
-
14536
- const rootUrl = options.rootUrl || 'https://storage.googleapis.com/';
14537
- const parameters = {
14538
- options: Object.assign(
14539
- {
14540
- url: (rootUrl + '/storage/v1/b/{bucket}/o/watch').replace(
14541
- /([^:]\/)\/+/g,
14542
- '$1'
14543
- ),
14544
- method: 'POST',
14545
- apiVersion: '',
14546
- },
14547
- options
14548
- ),
14549
- params,
14550
- requiredParams: ['bucket'],
14551
- pathParams: ['bucket'],
14552
- context: this.context,
14553
- };
14554
- if (callback) {
14555
- createAPIRequest<Schema$Channel>(
14556
- parameters,
14557
- callback as BodyResponseCallback<unknown>
14558
- );
14559
- } else {
14560
- return createAPIRequest<Schema$Channel>(parameters);
14561
- }
14562
- }
14563
14525
  }
14564
14526
 
14565
14527
  export interface Params$Resource$Objects$Bulkrestore extends StandardParameters {
@@ -15247,57 +15209,6 @@ export namespace storage_v1 {
15247
15209
  */
15248
15210
  requestBody?: Schema$Object;
15249
15211
  }
15250
- export interface Params$Resource$Objects$Watchall extends StandardParameters {
15251
- /**
15252
- * Name of the bucket in which to look for objects.
15253
- */
15254
- bucket?: string;
15255
- /**
15256
- * Returns results in a directory-like mode. items will contain only objects whose names, aside from the prefix, do not contain delimiter. Objects whose names, aside from the prefix, contain delimiter will have their name, truncated after the delimiter, returned in prefixes. Duplicate prefixes are omitted.
15257
- */
15258
- delimiter?: string;
15259
- /**
15260
- * Filter results to objects whose names are lexicographically before endOffset. If startOffset is also set, the objects listed will have names between startOffset (inclusive) and endOffset (exclusive).
15261
- */
15262
- endOffset?: string;
15263
- /**
15264
- * If true, objects that end in exactly one instance of delimiter will have their metadata included in items in addition to prefixes.
15265
- */
15266
- includeTrailingDelimiter?: boolean;
15267
- /**
15268
- * Maximum number of items plus prefixes to return in a single page of responses. As duplicate prefixes are omitted, fewer total results may be returned than requested. The service will use this parameter or 1,000 items, whichever is smaller.
15269
- */
15270
- maxResults?: number;
15271
- /**
15272
- * A previously-returned page token representing part of the larger set of results to view.
15273
- */
15274
- pageToken?: string;
15275
- /**
15276
- * Filter results to objects whose names begin with this prefix.
15277
- */
15278
- prefix?: string;
15279
- /**
15280
- * Set of properties to return. Defaults to noAcl.
15281
- */
15282
- projection?: string;
15283
- /**
15284
- * Filter results to objects whose names are lexicographically equal to or after startOffset. If endOffset is also set, the objects listed will have names between startOffset (inclusive) and endOffset (exclusive).
15285
- */
15286
- startOffset?: string;
15287
- /**
15288
- * The project to be billed for this request. Required for Requester Pays buckets.
15289
- */
15290
- userProject?: string;
15291
- /**
15292
- * If true, lists all versions of an object as distinct results. The default is false. For more information, see [Object Versioning](https://cloud.google.com/storage/docs/object-versioning).
15293
- */
15294
- versions?: boolean;
15295
-
15296
- /**
15297
- * Request body metadata
15298
- */
15299
- requestBody?: Schema$Channel;
15300
- }
15301
15212
 
15302
15213
  export class Resource$Operations {
15303
15214
  context: APIRequestContext;
@@ -15669,8 +15580,7 @@ export namespace storage_v1 {
15669
15580
  get(
15670
15581
  params: Params$Resource$Operations$Get,
15671
15582
  options:
15672
- | MethodOptions
15673
- | BodyResponseCallback<Schema$GoogleLongrunningOperation>,
15583
+ MethodOptions | BodyResponseCallback<Schema$GoogleLongrunningOperation>,
15674
15584
  callback: BodyResponseCallback<Schema$GoogleLongrunningOperation>
15675
15585
  ): void;
15676
15586
  get(
@@ -16067,8 +15977,7 @@ export namespace storage_v1 {
16067
15977
  | BodyResponseCallback<Schema$HmacKey>
16068
15978
  | BodyResponseCallback<Readable>,
16069
15979
  callback?:
16070
- | BodyResponseCallback<Schema$HmacKey>
16071
- | BodyResponseCallback<Readable>
15980
+ BodyResponseCallback<Schema$HmacKey> | BodyResponseCallback<Readable>
16072
15981
  ):
16073
15982
  | void
16074
15983
  | Promise<GaxiosResponseWithHTTP2<Schema$HmacKey>>