This page shows you how to download objects from your buckets in Cloud Storage to persistent storage. You can also download objects into memory .
Required roles
In order to get the required permissions for downloading objects, ask your
administrator to grant you the Storage Object Viewer
( roles/storage.objectViewer
) role on the bucket. If you plan on using the
Google Cloud console, ask your administrator to grant you the Storage Admin
( roles/storage.admin
) role on the bucket instead.
These roles contain the permissions required to download objects. To see the exact permissions that are required, expand the Required permissionssection:
Required permissions
-
storage.buckets.list
- This permission is only required for using the Google Cloud console to perform the tasks on this page.
-
storage.objects.get
-
storage.objects.list
- This permission is only required for using the Google Cloud console to perform the tasks on this page.
You might also be able to get these permissions with other predefined roles or custom roles .
For instructions on granting roles on buckets, see Use IAM with buckets .
Download an object from a bucket
Complete the following instructions to download an object from a bucket:
Console
- In the Google Cloud console, go to the Cloud Storage Buckets
page.
-
In the list of buckets, click the name of the bucket that contains the object you want to download.
The Bucket detailspage opens, with the Objectstab selected.
-
Navigate to the object, which may be located in a folder.
-
Click the Downloadicon associated with the object.
Your browser settings control the download location for the object.
To learn how to get detailed error information about failed Cloud Storage operations in the Google Cloud console, see Troubleshooting .
Command line
Use the gcloud storage cp
command
:
gcloud storage cp gs:// BUCKET_NAME / OBJECT_NAME SAVE_TO_LOCATION
Where:
-
BUCKET_NAME
is the name of the bucket containing the object you are downloading. For example,my-bucket
. -
OBJECT_NAME
is the name of object you are downloading. For example,pets/dog.png
. -
SAVE_TO_LOCATION
is the local path where you are saving your object. For example,Desktop/Images
.
If successful, the response looks like the following example:
Completed files 1/1 | 164.3kiB/164.3kiB
If your download is interrupted prior to completion, run the same cp
command to resume the download from where it left off.
Client libraries
C++
For more information, see the Cloud Storage C++ API reference documentation .
To authenticate to Cloud Storage, set up Application Default Credentials. For more information, see Set up authentication for a local development environment .
C#
For more information, see the Cloud Storage C# API reference documentation .
To authenticate to Cloud Storage, set up Application Default Credentials. For more information, see Set up authentication for a local development environment .
Go
For more information, see the Cloud Storage Go API reference documentation .
To authenticate to Cloud Storage, set up Application Default Credentials. For more information, see Set up authentication for a local development environment .
Java
For more information, see the Cloud Storage Java API reference documentation .
To authenticate to Cloud Storage, set up Application Default Credentials. For more information, see Set up authentication for a local development environment .
The following sample downloads an individual object:
The following sample downloads multiple objects using multiple processes:
The following sample downloads all objects with a common prefix using multiple processes:
Node.js
For more information, see the Cloud Storage Node.js API reference documentation .
To authenticate to Cloud Storage, set up Application Default Credentials. For more information, see Set up authentication for a local development environment .
The following sample downloads an individual object:
The following sample downloads multiple objects using multiple processes:
The following sample downloads all objects with a common prefix using multiple processes:
PHP
For more information, see the Cloud Storage PHP API reference documentation .
To authenticate to Cloud Storage, set up Application Default Credentials. For more information, see Set up authentication for a local development environment .
Python
For more information, see the Cloud Storage Python API reference documentation .
To authenticate to Cloud Storage, set up Application Default Credentials. For more information, see Set up authentication for a local development environment .
The following sample downloads an individual object:
The following sample downloads multiple objects using multiple processes:
The following sample downloads all objects in a bucket using multiple processes:
Ruby
For more information, see the Cloud Storage Ruby API reference documentation .
To authenticate to Cloud Storage, set up Application Default Credentials. For more information, see Set up authentication for a local development environment .