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](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/appliance/platform/pa-user/create-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](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/appliance/platform/pa-user/grant-obtain-storage-access#grant_bucket_access).

To run commands against the management API server, [sign in and generate](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/appliance/platform/pa-user/iam/sign-in#management-api-kubeconfig) the kubeconfig file for the management API server if you don't have one.

## Copy, modify, and move objects

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