// Copyright 2025 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. /** * This application demonstrates how to perform basic operations on files with * the Google Cloud Storage API. * * For more information, see the README.md under /storage and the documentation * at https://cloud.google.com/storage/docs. */ function main( bucketName = 'my-bucket', srcFileName = 'test.txt', destFileName = 'test2.txt', destinationGenerationMatchPrecondition = 0 ) { // [START storage_move_object] /** * TODO(developer): Uncomment the following lines before running the sample. */ // The ID of your GCS bucket // const bucketName = 'your-source-bucket'; // The ID of your GCS file // const srcFileName = 'your-file-name'; // The new ID for your GCS file // const destFileName = 'your-new-file-name'; // Imports the Google Cloud client library const {Storage} = require('@google-cloud/storage'); // Creates a client const storage = new Storage(); async function moveFileAtomic() { // Optional: // Set a generation-match precondition to avoid potential race conditions // and data corruptions. The request to copy is aborted if the object's // generation number does not match your precondition. For a destination // object that does not yet exist, set the ifGenerationMatch precondition to 0 // If the destination object already exists in your bucket, set instead a // generation-match precondition using its generation number. const moveOptions = { preconditionOpts: { ifGenerationMatch: destinationGenerationMatchPrecondition, }, }; // Moves the file automatically within the HNS enabled bucket await storage .bucket(bucketName) .file(srcFileName) .moveFileAtomic(destFileName, moveOptions); console.log( `gs://${bucketName}/${srcFileName} moved to gs://${bucketName}/${destFileName}` ); } moveFileAtomic().catch(console.error); // [END storage_move_object] } main(...process.argv.slice(2));