@googleapis/storage 15.6.0 → 15.8.0

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## [15.8.0](https://github.com/googleapis/google-api-nodejs-client/compare/storage-v15.7.0...storage-v15.8.0) (2025-02-04)
+
+
+### Features
+
+* **storage:** update the API ([487bfb4](https://github.com/googleapis/google-api-nodejs-client/commit/487bfb47a144ab293cf7a634788a10a9aaf798f8))
+* **storage:** update the API ([e40cb95](https://github.com/googleapis/google-api-nodejs-client/commit/e40cb950668f9881f13abd468ea36f18e6767b69))
+* **storage:** update the API ([cae4993](https://github.com/googleapis/google-api-nodejs-client/commit/cae49936785d6e4532bf5e78c4a4aec48ba1139c))
+* **storage:** update the API ([d42b431](https://github.com/googleapis/google-api-nodejs-client/commit/d42b4313216b4d2727d5a793b49046d4258542e7))
+
+## [15.7.0](https://github.com/googleapis/google-api-nodejs-client/compare/storage-v15.6.0...storage-v15.7.0) (2024-10-30)
+
+
+### Features
+
+* **storage:** update the API ([e40cb95](https://github.com/googleapis/google-api-nodejs-client/commit/e40cb950668f9881f13abd468ea36f18e6767b69))
+
 ## [15.6.0](https://github.com/googleapis/google-api-nodejs-client/compare/storage-v15.5.0...storage-v15.6.0) (2024-08-27)
 
 

package/build/v1.d.ts

@@ -70,6 +70,19 @@ export declare namespace storage_v1 {
         projects: Resource$Projects;
         constructor(options: GlobalOptions, google?: GoogleConfigurable);
     }
+    /**
+     * An AdvanceRelocateBucketOperation request.
+     */
+    export interface Schema$AdvanceRelocateBucketOperationRequest {
+        /**
+         * Specifies the time when the relocation will revert to the sync stage if the relocation hasn't succeeded.
+         */
+        expireTime?: string | null;
+        /**
+         * Specifies the duration after which the relocation will revert to the sync stage if the relocation hasn't succeeded. Optional, if not supplied, a default value of 12h will be used.
+         */
+        ttl?: string | null;
+    }
     /**
      * An Anywhere Cache instance.
      */
@@ -1049,6 +1062,10 @@ export declare namespace storage_v1 {
             entity?: string;
             entityId?: string;
         } | null;
+        /**
+         * Restore token used to differentiate deleted objects with the same name and generation. This field is only returned for deleted objects in hierarchical namespace buckets.
+         */
+        restoreToken?: string | null;
         /**
          * A collection of object level retention parameters.
          */
@@ -1088,6 +1105,10 @@ export declare namespace storage_v1 {
          * The time at which the object became noncurrent in RFC 3339 format. Will be returned if and only if this version of the object has been deleted.
          */
         timeDeleted?: string | null;
+        /**
+         * The time when the object was finalized.
+         */
+        timeFinalized?: string | null;
         /**
          * The time at which the object's storage class was last changed. When the object is initially created, it will be set to timeCreated.
          */
@@ -1231,6 +1252,25 @@ export declare namespace storage_v1 {
          */
         version?: number | null;
     }
+    /**
+     * A Relocate Bucket request.
+     */
+    export interface Schema$RelocateBucketRequest {
+        /**
+         * The bucket's new custom placement configuration if relocating to a Custom Dual Region.
+         */
+        destinationCustomPlacementConfig?: {
+            dataLocations?: string[];
+        } | null;
+        /**
+         * The new location the bucket will be relocated to.
+         */
+        destinationLocation?: string | null;
+        /**
+         * If true, validate the operation, but do not actually relocate the bucket.
+         */
+        validateOnly?: boolean | null;
+    }
     /**
      * A rewrite response.
      */
@@ -1777,6 +1817,20 @@ export declare namespace storage_v1 {
         patch(params: Params$Resource$Buckets$Patch, options: MethodOptions | BodyResponseCallback<Schema$Bucket>, callback: BodyResponseCallback<Schema$Bucket>): void;
         patch(params: Params$Resource$Buckets$Patch, callback: BodyResponseCallback<Schema$Bucket>): void;
         patch(callback: BodyResponseCallback<Schema$Bucket>): void;
+        /**
+         * Initiates a long-running Relocate Bucket operation on the specified bucket.
+         *
+         * @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.
+         */
+        relocate(params: Params$Resource$Buckets$Relocate, options: StreamMethodOptions): GaxiosPromise<Readable>;
+        relocate(params?: Params$Resource$Buckets$Relocate, options?: MethodOptions): GaxiosPromise<Schema$GoogleLongrunningOperation>;
+        relocate(params: Params$Resource$Buckets$Relocate, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
+        relocate(params: Params$Resource$Buckets$Relocate, options: MethodOptions | BodyResponseCallback<Schema$GoogleLongrunningOperation>, callback: BodyResponseCallback<Schema$GoogleLongrunningOperation>): void;
+        relocate(params: Params$Resource$Buckets$Relocate, callback: BodyResponseCallback<Schema$GoogleLongrunningOperation>): void;
+        relocate(callback: BodyResponseCallback<Schema$GoogleLongrunningOperation>): void;
         /**
          * Restores a soft-deleted bucket.
          *
@@ -1786,11 +1840,11 @@ export declare namespace storage_v1 {
          * @returns A promise if used with async/await, or void if used with a callback.
          */
         restore(params: Params$Resource$Buckets$Restore, options: StreamMethodOptions): GaxiosPromise<Readable>;
-        restore(params?: Params$Resource$Buckets$Restore, options?: MethodOptions): GaxiosPromise<void>;
+        restore(params?: Params$Resource$Buckets$Restore, options?: MethodOptions): GaxiosPromise<Schema$Bucket>;
         restore(params: Params$Resource$Buckets$Restore, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
-        restore(params: Params$Resource$Buckets$Restore, options: MethodOptions | BodyResponseCallback<void>, callback: BodyResponseCallback<void>): void;
-        restore(params: Params$Resource$Buckets$Restore, callback: BodyResponseCallback<void>): void;
-        restore(callback: BodyResponseCallback<void>): void;
+        restore(params: Params$Resource$Buckets$Restore, options: MethodOptions | BodyResponseCallback<Schema$Bucket>, callback: BodyResponseCallback<Schema$Bucket>): void;
+        restore(params: Params$Resource$Buckets$Restore, callback: BodyResponseCallback<Schema$Bucket>): void;
+        restore(callback: BodyResponseCallback<Schema$Bucket>): void;
         /**
          * Updates an IAM policy for the specified bucket.
          *
@@ -2014,6 +2068,16 @@ export declare namespace storage_v1 {
          */
         requestBody?: Schema$Bucket;
     }
+    export interface Params$Resource$Buckets$Relocate extends StandardParameters {
+        /**
+         * Name of the bucket to be moved.
+         */
+        bucket?: string;
+        /**
+         * Request body metadata
+         */
+        requestBody?: Schema$RelocateBucketRequest;
+    }
     export interface Params$Resource$Buckets$Restore extends StandardParameters {
         /**
          * Name of a bucket.
@@ -2023,6 +2087,10 @@ export declare namespace storage_v1 {
          * Generation of a bucket.
          */
         generation?: string;
+        /**
+         * Set of properties to return. Defaults to full.
+         */
+        projection?: string;
         /**
          * The project to be billed for this request. Required for Requester Pays buckets.
          */
@@ -3149,6 +3217,20 @@ export declare namespace storage_v1 {
         list(params: Params$Resource$Objects$List, options: MethodOptions | BodyResponseCallback<Schema$Objects>, callback: BodyResponseCallback<Schema$Objects>): void;
         list(params: Params$Resource$Objects$List, callback: BodyResponseCallback<Schema$Objects>): void;
         list(callback: BodyResponseCallback<Schema$Objects>): void;
+        /**
+         * Moves the source object to the destination object in the same bucket.
+         *
+         * @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.
+         */
+        move(params: Params$Resource$Objects$Move, options: StreamMethodOptions): GaxiosPromise<Readable>;
+        move(params?: Params$Resource$Objects$Move, options?: MethodOptions): GaxiosPromise<Schema$Object>;
+        move(params: Params$Resource$Objects$Move, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
+        move(params: Params$Resource$Objects$Move, options: MethodOptions | BodyResponseCallback<Schema$Object>, callback: BodyResponseCallback<Schema$Object>): void;
+        move(params: Params$Resource$Objects$Move, callback: BodyResponseCallback<Schema$Object>): void;
+        move(callback: BodyResponseCallback<Schema$Object>): void;
         /**
          * Patches an object's metadata.
          *
@@ -3433,6 +3515,10 @@ export declare namespace storage_v1 {
          * Set of properties to return. Defaults to noAcl.
          */
         projection?: string;
+        /**
+         * Restore token used to differentiate soft-deleted objects with the same name and generation. Only applicable for hierarchical namespace buckets and if softDeleted is set to true. This parameter is optional, and is only required in the rare case when there are multiple soft-deleted objects with the same name and generation.
+         */
+        restoreToken?: string;
         /**
          * If true, only soft-deleted object versions will be listed. The default is false. For more information, see [Soft Delete](https://cloud.google.com/storage/docs/soft-delete).
          */
@@ -3581,6 +3667,56 @@ export declare namespace storage_v1 {
          */
         versions?: boolean;
     }
+    export interface Params$Resource$Objects$Move extends StandardParameters {
+        /**
+         * Name of the bucket in which the object resides.
+         */
+        bucket?: string;
+        /**
+         * Name of the destination object. For information about how to URL encode object names to be path safe, see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).
+         */
+        destinationObject?: string;
+        /**
+         * Makes the operation conditional on whether the destination object's current generation matches the given value. Setting to 0 makes the operation succeed only if there are no live versions of the object. `ifGenerationMatch` and `ifGenerationNotMatch` conditions are mutually exclusive: it's an error for both of them to be set in the request.
+         */
+        ifGenerationMatch?: string;
+        /**
+         * Makes the operation conditional on whether the destination object's current generation does not match the given value. If no live object exists, the precondition fails. Setting to 0 makes the operation succeed only if there is a live version of the object.`ifGenerationMatch` and `ifGenerationNotMatch` conditions are mutually exclusive: it's an error for both of them to be set in the request.
+         */
+        ifGenerationNotMatch?: string;
+        /**
+         * Makes the operation conditional on whether the destination object's current metageneration matches the given value. `ifMetagenerationMatch` and `ifMetagenerationNotMatch` conditions are mutually exclusive: it's an error for both of them to be set in the request.
+         */
+        ifMetagenerationMatch?: string;
+        /**
+         * Makes the operation conditional on whether the destination object's current metageneration does not match the given value. `ifMetagenerationMatch` and `ifMetagenerationNotMatch` conditions are mutually exclusive: it's an error for both of them to be set in the request.
+         */
+        ifMetagenerationNotMatch?: string;
+        /**
+         * Makes the operation conditional on whether the source object's current generation matches the given value. `ifSourceGenerationMatch` and `ifSourceGenerationNotMatch` conditions are mutually exclusive: it's an error for both of them to be set in the request.
+         */
+        ifSourceGenerationMatch?: string;
+        /**
+         * Makes the operation conditional on whether the source object's current generation does not match the given value. `ifSourceGenerationMatch` and `ifSourceGenerationNotMatch` conditions are mutually exclusive: it's an error for both of them to be set in the request.
+         */
+        ifSourceGenerationNotMatch?: string;
+        /**
+         * Makes the operation conditional on whether the source object's current metageneration matches the given value. `ifSourceMetagenerationMatch` and `ifSourceMetagenerationNotMatch` conditions are mutually exclusive: it's an error for both of them to be set in the request.
+         */
+        ifSourceMetagenerationMatch?: string;
+        /**
+         * Makes the operation conditional on whether the source object's current metageneration does not match the given value. `ifSourceMetagenerationMatch` and `ifSourceMetagenerationNotMatch` conditions are mutually exclusive: it's an error for both of them to be set in the request.
+         */
+        ifSourceMetagenerationNotMatch?: string;
+        /**
+         * Name of the source object. For information about how to URL encode object names to be path safe, see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).
+         */
+        sourceObject?: string;
+        /**
+         * The project to be billed for this request. Required for Requester Pays buckets.
+         */
+        userProject?: string;
+    }
     export interface Params$Resource$Objects$Patch extends StandardParameters {
         /**
          * Name of the bucket in which the object resides.
@@ -3668,6 +3804,10 @@ export declare namespace storage_v1 {
          * Set of properties to return. Defaults to full.
          */
         projection?: string;
+        /**
+         * Restore token used to differentiate sof-deleted objects with the same name and generation. Only applicable for hierarchical namespace buckets. This parameter is optional, and is only required in the rare case when there are multiple soft-deleted objects with the same name and generation.
+         */
+        restoreToken?: string;
         /**
          * The project to be billed for this request. Required for Requester Pays buckets.
          */
@@ -3902,6 +4042,20 @@ export declare namespace storage_v1 {
     export class Resource$Operations {
         context: APIRequestContext;
         constructor(context: APIRequestContext);
+        /**
+         * Starts asynchronous advancement of the relocate bucket operation in the case of required write downtime, to allow it to lock the bucket at the source location, and proceed with the bucket location swap. The server makes a best effort to advance the relocate bucket operation, but success is not guaranteed.
+         *
+         * @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.
+         */
+        advanceRelocateBucket(params: Params$Resource$Operations$Advancerelocatebucket, options: StreamMethodOptions): GaxiosPromise<Readable>;
+        advanceRelocateBucket(params?: Params$Resource$Operations$Advancerelocatebucket, options?: MethodOptions): GaxiosPromise<void>;
+        advanceRelocateBucket(params: Params$Resource$Operations$Advancerelocatebucket, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
+        advanceRelocateBucket(params: Params$Resource$Operations$Advancerelocatebucket, options: MethodOptions | BodyResponseCallback<void>, callback: BodyResponseCallback<void>): void;
+        advanceRelocateBucket(params: Params$Resource$Operations$Advancerelocatebucket, callback: BodyResponseCallback<void>): void;
+        advanceRelocateBucket(callback: BodyResponseCallback<void>): void;
         /**
          * Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed.
          *
@@ -3945,6 +4099,20 @@ export declare namespace storage_v1 {
         list(params: Params$Resource$Operations$List, callback: BodyResponseCallback<Schema$GoogleLongrunningListOperationsResponse>): void;
         list(callback: BodyResponseCallback<Schema$GoogleLongrunningListOperationsResponse>): void;
     }
+    export interface Params$Resource$Operations$Advancerelocatebucket extends StandardParameters {
+        /**
+         * Name of the bucket to advance the relocate for.
+         */
+        bucket?: string;
+        /**
+         * ID of the operation resource.
+         */
+        operationId?: string;
+        /**
+         * Request body metadata
+         */
+        requestBody?: Schema$AdvanceRelocateBucketOperationRequest;
+    }
     export interface Params$Resource$Operations$Cancel extends StandardParameters {
         /**
          * The parent bucket of the operation resource.

package/build/v1.js

@@ -742,6 +742,37 @@ var storage_v1;
                 return (0, googleapis_common_1.createAPIRequest)(parameters);
             }
         }
+        relocate(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}/relocate').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);
+            }
+        }
         restore(paramsOrCallback, optionsOrCallback, callback) {
             let params = (paramsOrCallback || {});
             let options = (optionsOrCallback || {});
@@ -2101,6 +2132,38 @@ var storage_v1;
                 return (0, googleapis_common_1.createAPIRequest)(parameters);
             }
         }
+        move(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/{sourceObject}/moveTo/o/{destinationObject}').replace(/([^:]\/)\/+/g, '$1'),
+                    method: 'POST',
+                    apiVersion: '',
+                }, options),
+                params,
+                requiredParams: ['bucket', 'sourceObject', 'destinationObject'],
+                pathParams: ['bucket', 'destinationObject', 'sourceObject'],
+                context: this.context,
+            };
+            if (callback) {
+                (0, googleapis_common_1.createAPIRequest)(parameters, callback);
+            }
+            else {
+                return (0, googleapis_common_1.createAPIRequest)(parameters);
+            }
+        }
         patch(paramsOrCallback, optionsOrCallback, callback) {
             let params = (paramsOrCallback || {});
             let options = (optionsOrCallback || {});
@@ -2337,6 +2400,39 @@ var storage_v1;
         constructor(context) {
             this.context = context;
         }
+        advanceRelocateBucket(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}/operations/{operationId}/advanceRelocateBucket').replace(/([^:]\/)\/+/g, '$1'),
+                    method: 'POST',
+                    apiVersion: '',
+                }, options),
+                params,
+                requiredParams: ['bucket', 'operationId'],
+                pathParams: ['bucket', 'operationId'],
+                context: this.context,
+            };
+            if (callback) {
+                (0, googleapis_common_1.createAPIRequest)(parameters, callback);
+            }
+            else {
+                return (0, googleapis_common_1.createAPIRequest)(parameters);
+            }
+        }
         cancel(paramsOrCallback, optionsOrCallback, callback) {
             let params = (paramsOrCallback ||
                 {});