Copy, modify, and move storage objects

This page shows you how to copy, modify, and move objects within Google Distributed Cloud (GDC) air-gapped appliance storage buckets.

Before you begin

A project namespace manages bucket resources in the management API server. You must have a project to work with buckets and objects.

You must also have the appropriate bucket permissions to perform the following operation. See Grant bucket access.

To run commands against the management API server, sign in and generate the kubeconfig file for the management API server if you don't have one.

Copy an object:

gdcloud storage cp FILE  [FILE...] s3://BUCKET [/PREFIX ]

Modify an object's metadata:

gdcloud storage objects update s3://BUCKET1/OBJECT --custom-metadata=Key1=Value1

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-08-17 UTC.