@googleapis/storage 21.2.0 → 22.0.0

package/build/v1.d.ts

@@ -106,6 +106,10 @@ export declare namespace storage_v1 {
          * The ID of the resource, including the project number, bucket name and anywhere cache ID.
          */
         id?: string | null;
+        /**
+         * Specifies whether objects are ingested into the cache upon write.
+         */
+        ingestOnWrite?: boolean | null;
         /**
          * The kind of item this is. For Anywhere Cache, this is always storage#anywhereCache.
          */
@@ -299,6 +303,8 @@ export declare namespace storage_v1 {
                     matchesSuffix?: string[];
                     noncurrentTimeBefore?: string;
                     numNewerVersions?: number;
+                    sizeAboveBytes?: string;
+                    sizeBelowBytes?: string;
                 };
             }>;
         } | null;
@@ -1456,6 +1462,7 @@ export declare namespace storage_v1 {
          *   //   "bucket": "my_bucket",
          *   //   "createTime": "my_createTime",
          *   //   "id": "my_id",
+         *   //   "ingestOnWrite": false,
          *   //   "kind": "my_kind",
          *   //   "pendingUpdate": false,
          *   //   "selfLink": "my_selfLink",
@@ -1535,6 +1542,7 @@ export declare namespace storage_v1 {
          *   //   "bucket": "my_bucket",
          *   //   "createTime": "my_createTime",
          *   //   "id": "my_id",
+         *   //   "ingestOnWrite": false,
          *   //   "kind": "my_kind",
          *   //   "pendingUpdate": false,
          *   //   "selfLink": "my_selfLink",
@@ -1610,6 +1618,7 @@ export declare namespace storage_v1 {
          *       //   "bucket": "my_bucket",
          *       //   "createTime": "my_createTime",
          *       //   "id": "my_id",
+         *       //   "ingestOnWrite": false,
          *       //   "kind": "my_kind",
          *       //   "pendingUpdate": false,
          *       //   "selfLink": "my_selfLink",
@@ -1773,6 +1782,7 @@ export declare namespace storage_v1 {
          *   //   "bucket": "my_bucket",
          *   //   "createTime": "my_createTime",
          *   //   "id": "my_id",
+         *   //   "ingestOnWrite": false,
          *   //   "kind": "my_kind",
          *   //   "pendingUpdate": false,
          *   //   "selfLink": "my_selfLink",
@@ -1850,6 +1860,7 @@ export declare namespace storage_v1 {
          *   //   "bucket": "my_bucket",
          *   //   "createTime": "my_createTime",
          *   //   "id": "my_id",
+         *   //   "ingestOnWrite": false,
          *   //   "kind": "my_kind",
          *   //   "pendingUpdate": false,
          *   //   "selfLink": "my_selfLink",
@@ -1879,7 +1890,7 @@ export declare namespace storage_v1 {
         resume(params: Params$Resource$Anywherecaches$Resume, callback: BodyResponseCallback<Schema$AnywhereCache>): void;
         resume(callback: BodyResponseCallback<Schema$AnywhereCache>): void;
         /**
-         * Updates the config(ttl and admissionPolicy) of an Anywhere Cache instance.
+         * Updates the config of an Anywhere Cache instance.
          * @example
          * ```js
          * // Before running the sample:
@@ -1927,6 +1938,7 @@ export declare namespace storage_v1 {
          *       //   "bucket": "my_bucket",
          *       //   "createTime": "my_createTime",
          *       //   "id": "my_id",
+         *       //   "ingestOnWrite": false,
          *       //   "kind": "my_kind",
          *       //   "pendingUpdate": false,
          *       //   "selfLink": "my_selfLink",
@@ -4987,6 +4999,82 @@ export declare namespace storage_v1 {
         delete(params: Params$Resource$Folders$Delete, options: MethodOptions | BodyResponseCallback<void>, callback: BodyResponseCallback<void>): void;
         delete(params: Params$Resource$Folders$Delete, callback: BodyResponseCallback<void>): void;
         delete(callback: BodyResponseCallback<void>): void;
+        /**
+         * Deletes a folder recursively. Only applicable to buckets with hierarchical namespace enabled.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
+         * // - Login into gcloud by running:
+         * //   ```sh
+         * //   $ gcloud auth application-default login
+         * //   ```
+         * // - Install the npm module by running:
+         * //   ```sh
+         * //   $ npm install googleapis
+         * //   ```
+         *
+         * const {google} = require('googleapis');
+         * const storage = google.storage('v1');
+         *
+         * async function main() {
+         *   const auth = new google.auth.GoogleAuth({
+         *     // Scopes can be specified either as an array or as a single, space-delimited string.
+         *     scopes: [
+         *       'https://www.googleapis.com/auth/cloud-platform',
+         *       'https://www.googleapis.com/auth/devstorage.full_control',
+         *       'https://www.googleapis.com/auth/devstorage.read_write',
+         *     ],
+         *   });
+         *
+         *   // Acquire an auth client, and bind it to all future calls
+         *   const authClient = await auth.getClient();
+         *   google.options({auth: authClient});
+         *
+         *   // Do the magic
+         *   const res = await storage.folders.deleteRecursive({
+         *     // Name of the bucket in which the folder resides.
+         *     bucket: 'placeholder-value',
+         *     // Name of a folder.
+         *     folder: 'placeholder-value',
+         *     // If set, only deletes the folder if its metageneration matches this value.
+         *     ifMetagenerationMatch: 'placeholder-value',
+         *     // If set, only deletes the folder if its metageneration does not match this value.
+         *     ifMetagenerationNotMatch: 'placeholder-value',
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "done": false,
+         *   //   "error": {},
+         *   //   "kind": "my_kind",
+         *   //   "metadata": {},
+         *   //   "name": "my_name",
+         *   //   "response": {},
+         *   //   "selfLink": "my_selfLink"
+         *   // }
+         * }
+         *
+         * main().catch(e => {
+         *   console.error(e);
+         *   throw e;
+         * });
+         *
+         * ```
+         *
+         * @param params - Parameters for request
+         * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
+         * @param callback - Optional callback that handles the response.
+         * @returns A promise if used with async/await, or void if used with a callback.
+         */
+        deleteRecursive(params: Params$Resource$Folders$Deleterecursive, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
+        deleteRecursive(params?: Params$Resource$Folders$Deleterecursive, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$GoogleLongrunningOperation>>;
+        deleteRecursive(params: Params$Resource$Folders$Deleterecursive, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
+        deleteRecursive(params: Params$Resource$Folders$Deleterecursive, options: MethodOptions | BodyResponseCallback<Schema$GoogleLongrunningOperation>, callback: BodyResponseCallback<Schema$GoogleLongrunningOperation>): void;
+        deleteRecursive(params: Params$Resource$Folders$Deleterecursive, callback: BodyResponseCallback<Schema$GoogleLongrunningOperation>): void;
+        deleteRecursive(callback: BodyResponseCallback<Schema$GoogleLongrunningOperation>): void;
         /**
          * Returns metadata for the specified folder. Only applicable to buckets with hierarchical namespace enabled.
          * @example
@@ -5334,6 +5422,24 @@ export declare namespace storage_v1 {
          */
         ifMetagenerationNotMatch?: string;
     }
+    export interface Params$Resource$Folders$Deleterecursive extends StandardParameters {
+        /**
+         * Name of the bucket in which the folder resides.
+         */
+        bucket?: string;
+        /**
+         * Name of a folder.
+         */
+        folder?: string;
+        /**
+         * If set, only deletes the folder if its metageneration matches this value.
+         */
+        ifMetagenerationMatch?: string;
+        /**
+         * If set, only deletes the folder if its metageneration does not match this value.
+         */
+        ifMetagenerationNotMatch?: string;
+    }
     export interface Params$Resource$Folders$Get extends StandardParameters {
         /**
          * Name of the bucket in which the folder resides.
@@ -8922,118 +9028,6 @@ export declare namespace storage_v1 {
         update(params: Params$Resource$Objects$Update, options: MethodOptions | BodyResponseCallback<Schema$Object>, callback: BodyResponseCallback<Schema$Object>): void;
         update(params: Params$Resource$Objects$Update, callback: BodyResponseCallback<Schema$Object>): void;
         update(callback: BodyResponseCallback<Schema$Object>): void;
-        /**
-         * Watch for changes on all objects in a bucket.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   ```sh
-         * //   $ gcloud auth application-default login
-         * //   ```
-         * // - Install the npm module by running:
-         * //   ```sh
-         * //   $ npm install googleapis
-         * //   ```
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/cloud-platform.read-only',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *       'https://www.googleapis.com/auth/devstorage.read_only',
-         *       'https://www.googleapis.com/auth/devstorage.read_write',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.objects.watchAll({
-         *     // Name of the bucket in which to look for objects.
-         *     bucket: 'placeholder-value',
-         *     // 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.
-         *     delimiter: 'placeholder-value',
-         *     // 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).
-         *     endOffset: 'placeholder-value',
-         *     // If true, objects that end in exactly one instance of delimiter will have their metadata included in items in addition to prefixes.
-         *     includeTrailingDelimiter: 'placeholder-value',
-         *     // 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.
-         *     maxResults: 'placeholder-value',
-         *     // A previously-returned page token representing part of the larger set of results to view.
-         *     pageToken: 'placeholder-value',
-         *     // Filter results to objects whose names begin with this prefix.
-         *     prefix: 'placeholder-value',
-         *     // Set of properties to return. Defaults to noAcl.
-         *     projection: 'placeholder-value',
-         *     // 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).
-         *     startOffset: 'placeholder-value',
-         *     // The project to be billed for this request. Required for Requester Pays buckets.
-         *     userProject: 'placeholder-value',
-         *     // 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).
-         *     versions: 'placeholder-value',
-         *
-         *     // Request body metadata
-         *     requestBody: {
-         *       // request body parameters
-         *       // {
-         *       //   "address": "my_address",
-         *       //   "expiration": "my_expiration",
-         *       //   "id": "my_id",
-         *       //   "kind": "my_kind",
-         *       //   "params": {},
-         *       //   "payload": false,
-         *       //   "resourceId": "my_resourceId",
-         *       //   "resourceUri": "my_resourceUri",
-         *       //   "token": "my_token",
-         *       //   "type": "my_type"
-         *       // }
-         *     },
-         *   });
-         *   console.log(res.data);
-         *
-         *   // Example response
-         *   // {
-         *   //   "address": "my_address",
-         *   //   "expiration": "my_expiration",
-         *   //   "id": "my_id",
-         *   //   "kind": "my_kind",
-         *   //   "params": {},
-         *   //   "payload": false,
-         *   //   "resourceId": "my_resourceId",
-         *   //   "resourceUri": "my_resourceUri",
-         *   //   "token": "my_token",
-         *   //   "type": "my_type"
-         *   // }
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
-         *
-         * @param params - Parameters for request
-         * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
-         * @param callback - Optional callback that handles the response.
-         * @returns A promise if used with async/await, or void if used with a callback.
-         */
-        watchAll(params: Params$Resource$Objects$Watchall, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
-        watchAll(params?: Params$Resource$Objects$Watchall, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Channel>>;
-        watchAll(params: Params$Resource$Objects$Watchall, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
-        watchAll(params: Params$Resource$Objects$Watchall, options: MethodOptions | BodyResponseCallback<Schema$Channel>, callback: BodyResponseCallback<Schema$Channel>): void;
-        watchAll(params: Params$Resource$Objects$Watchall, callback: BodyResponseCallback<Schema$Channel>): void;
-        watchAll(callback: BodyResponseCallback<Schema$Channel>): void;
     }
     export interface Params$Resource$Objects$Bulkrestore extends StandardParameters {
         /**
@@ -9710,56 +9704,6 @@ export declare namespace storage_v1 {
          */
         requestBody?: Schema$Object;
     }
-    export interface Params$Resource$Objects$Watchall extends StandardParameters {
-        /**
-         * Name of the bucket in which to look for objects.
-         */
-        bucket?: string;
-        /**
-         * 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.
-         */
-        delimiter?: string;
-        /**
-         * 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).
-         */
-        endOffset?: string;
-        /**
-         * If true, objects that end in exactly one instance of delimiter will have their metadata included in items in addition to prefixes.
-         */
-        includeTrailingDelimiter?: boolean;
-        /**
-         * 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.
-         */
-        maxResults?: number;
-        /**
-         * A previously-returned page token representing part of the larger set of results to view.
-         */
-        pageToken?: string;
-        /**
-         * Filter results to objects whose names begin with this prefix.
-         */
-        prefix?: string;
-        /**
-         * Set of properties to return. Defaults to noAcl.
-         */
-        projection?: string;
-        /**
-         * 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).
-         */
-        startOffset?: string;
-        /**
-         * The project to be billed for this request. Required for Requester Pays buckets.
-         */
-        userProject?: string;
-        /**
-         * 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).
-         */
-        versions?: boolean;
-        /**
-         * Request body metadata
-         */
-        requestBody?: Schema$Channel;
-    }
     export class Resource$Operations {
         context: APIRequestContext;
         constructor(context: APIRequestContext);

package/build/v1.js

@@ -1190,6 +1190,39 @@ var storage_v1;
                 return (0, googleapis_common_1.createAPIRequest)(parameters);
             }
         }
+        deleteRecursive(paramsOrCallback, optionsOrCallback, callback) {
+            let params = (paramsOrCallback ||
+                {});
+            let options = (optionsOrCallback || {});
+            if (typeof paramsOrCallback === 'function') {
+                callback = paramsOrCallback;
+                params = {};
+                options = {};
+            }
+            if (typeof optionsOrCallback === 'function') {
+                callback = optionsOrCallback;
+                options = {};
+            }
+            const rootUrl = options.rootUrl || 'https://storage.googleapis.com/';
+            const parameters = {
+                options: Object.assign({
+                    url: (rootUrl +
+                        '/storage/v1/b/{bucket}/folders/{folder}/deleteRecursive').replace(/([^:]\/)\/+/g, '$1'),
+                    method: 'POST',
+                    apiVersion: '',
+                }, options),
+                params,
+                requiredParams: ['bucket', 'folder'],
+                pathParams: ['bucket', 'folder'],
+                context: this.context,
+            };
+            if (callback) {
+                (0, googleapis_common_1.createAPIRequest)(parameters, callback);
+            }
+            else {
+                return (0, googleapis_common_1.createAPIRequest)(parameters);
+            }
+        }
         get(paramsOrCallback, optionsOrCallback, callback) {
             let params = (paramsOrCallback || {});
             let options = (optionsOrCallback || {});
@@ -2386,37 +2419,6 @@ var storage_v1;
                 return (0, googleapis_common_1.createAPIRequest)(parameters);
             }
         }
-        watchAll(paramsOrCallback, optionsOrCallback, callback) {
-            let params = (paramsOrCallback || {});
-            let options = (optionsOrCallback || {});
-            if (typeof paramsOrCallback === 'function') {
-                callback = paramsOrCallback;
-                params = {};
-                options = {};
-            }
-            if (typeof optionsOrCallback === 'function') {
-                callback = optionsOrCallback;
-                options = {};
-            }
-            const rootUrl = options.rootUrl || 'https://storage.googleapis.com/';
-            const parameters = {
-                options: Object.assign({
-                    url: (rootUrl + '/storage/v1/b/{bucket}/o/watch').replace(/([^:]\/)\/+/g, '$1'),
-                    method: 'POST',
-                    apiVersion: '',
-                }, options),
-                params,
-                requiredParams: ['bucket'],
-                pathParams: ['bucket'],
-                context: this.context,
-            };
-            if (callback) {
-                (0, googleapis_common_1.createAPIRequest)(parameters, callback);
-            }
-            else {
-                return (0, googleapis_common_1.createAPIRequest)(parameters);
-            }
-        }
     }
     storage_v1.Resource$Objects = Resource$Objects;
     class Resource$Operations {