How-to Guides

Working with Buckets

• Creating Storage Buckets

  Create buckets in which you store your data.

• Listing Buckets

  List the buckets that are part of your Google Cloud Platform project.

• Getting Bucket Information

  Get the properties of a bucket.

• Changing the Default Storage Class of a Bucket

  Change the overall storage class of a bucket. By default, new objects uploaded to the bucket are set to this storage class.

• Moving and Renaming Buckets

  Learn how to move or rename your bucket.

• Deleting Buckets

  Delete a bucket.

Working with Objects

• Uploading Objects

  Store objects in your Cloud Storage bucket.

• Listing Objects

  List the objects stored in your Cloud Storage bucket.

• Downloading Objects

  Access objects in your Cloud Storage bucket.

• Renaming, Copying, and Moving Objects

  Rename, copy, and move objects within and between Cloud Storage buckets.

• Changing Storage Classes

  Change the storage class of individual objects within your bucket.

• Viewing and Editing Object Metadata

  Work with the metadata for objects stored in Cloud Storage.

• Streaming Transfers

  Stream data to and from Cloud Storage.

• Deleting Objects

  Remove objects from your Cloud Storage bucket.

Using Features

• Using Bucket Labels

  Add, view, edit, and remove labels for a bucket.

• Managing Object Lifecycles

  Set your bucket to automatically delete or change the storage class of objects within it when specified criteria are met.

• Using Object Versioning

  Set your bucket to retain older versions of your objects when they are deleted or overwritten.

• Using Requester Pays

  Set your bucket to require that requesters include a project ID for billing charges associated with accessing your data.

• Using Retention Policies and Bucket Lock

  Add a retention policy to your bucket that prevents objects within the bucket from being overwritten or deleted for a set period of time. Lock your bucket to prevent the retention policy from being reduced or removed.

• Using Object Holds

  Add holds to your objects that prevent them from being overwritten or deleted while the hold is in place.

• Using Customer-Supplied Encryption Keys

  Encrypt data on the server side using your own encryption keys.

• Using Customer-Managed Encryption Keys

  Encrypt data on the server side using encryption keys that you manage.

Controlling Access

• Making Data Public

  Make objects you control publicly readable.

• Managing IAM Permissions

  Use Identity and Access Management (IAM) permissions to give users access to buckets and objects.

• Using Bucket Policy Only^BETA

  Use Bucket Policy Only to prevent permissions from being granted at the object level.

• Creating and Managing Access Control Lists

  Use access control lists to give users specific types of access to buckets and data.

• Sharing and Collaboration

  Follow several different scenarios for controlling access to your data.

• Generating Signed URLs with gsutil

  Create signed URLs, which give users time-limited access to your data, with the gsutil command-line tool.

• Generating Signed URLs with Your Own Program

  Create signed URLs, which give users time-limited access to your data, with your own program.

• Performing Authenticated Browser Downloads

  Allow users to download content from their browser by logging in with their Google account.

Accessing Public Data

• Accessing Public Data

  Access data stored in Cloud Storage that is available to the general public.

Getting a Service Account

• Getting a Service Account

  Get the email address of a project's Cloud Storage service account.

Using with Other Products

• Interoperability

  Discover how Cloud Storage tools can be used to work with other, non-Google, cloud storage systems.

• Migrating from Amazon S3 to Cloud Storage

  A discussion of migration scenarios accomplished through using the XML API.

• Working with Big Data

  Learn how to use Cloud Storage to store and work with Big Data.

• Registering Object Changes

  Enable and configure notifications that are sent to Cloud Pub/Sub when objects in your buckets change.

• Analyzing Access Logs

  Work with the access logs for your buckets, such as by analyzing them with Google BigQuery.

• Configuring Cross-Origin Resource Sharing (CORS)

  Learn how to configure cross-origin resource sharing (CORS) on your buckets.

• Setting Organization Policies

  Set organizational policies that apply to your Cloud Storage resources.