Copy, modify, and move storage objects

This page shows you how to copy, modify, and move objects within Google Distributed Cloud (GDC) air-gapped 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.

Required IAM roles

Contact your IAM Project Admin to request the following roles in your project namespace:

  • Project Bucket Admin (project-bucket-admin): create, update, and delete storage buckets.
  • Project Bucket Object Viewer (project-bucket-object-viewer): view and check details of storage buckets and objects.

For more information, see Grant bucket access.

Prepare your environment

To run commands against the management API server or the global API server, do the following:

  1. Sign in and generate the kubeconfig file for the zonal management API server if you don't have one.
  2. For dual-zone buckets, do the following:
    • Verify with your Infrastructure Operator (IO) that the BucketLocationConfig custom resource has been created for your paired zones.
    • Generate the kubeconfig file for the global API server.

Copy, modify, and move objects

Copy an object:

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

Modify an object's metadata:

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

Move an object:

When moving an object, a copy of the object moves to another location, either in the same bucket or to another path in the same bucket. After, the original object is deleted.

gdcloud storage mv s3://FULLY_QUALIFIED_BUCKET_NAME1/OBJECT1 s3://FULLY_QUALIFIED_BUCKET_NAME2[/OBJECT2]