This page shows you how to get the size of your Cloud Storage buckets .
Required roles
In order to get the required permissions for getting the size of a
Cloud Storage bucket, 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
Monitoring Viewer ( roles/monitoring.viewer 
) role on the project that contains
the bucket instead.
These roles contain the permissions required to get the size of a bucket. To see the exact permissions that are required, expand the Required permissionssection:
Required permissions
-  storage.objects.list- This permission is only required for using the Google Cloud CLI to perform the instructions on this page.
 
To see the permissions associated with roles/monitoring.viewer 
,
refer to the Monitoring Viewer documentation 
.
You might be able to get the required permission with other predefined roles or custom roles . For instructions on granting roles on buckets, see Set and manage IAM policies on buckets . For instructions on granting roles on projects, see Manage access to projects .
Determine a bucket's size
Console
To view the metrics for a monitored resource by using the Metrics Explorer, do the following:
-  In the Google Cloud console, go to the leaderboard Metrics explorer page: If you use the search bar to find this page, then select the result whose subheading is Monitoring . 
- In the toolbar of the Google Cloud console, select your Google Cloud project. For App Hub configurations, select the App Hub host project or the app-enabled folder's management project.
- In the Metric 
element, expand the Select a metric 
menu,
    enter Total bytes (v2)in the filter bar, and then use the submenus to select a specific resource type and metric:- In the Active resources menu, select GCS Bucket .
- In the Active metric categories menu, select Storage .
- In the Active metrics menu, select Total bytes (v2) .
- Click Apply .
 
-  To add filters, which remove time series from the query results, use the Filter element . 
-  To combine time series, use the menus on the Aggregation element . For example, to display the CPU utilization for your VMs, based on their zone, set the first menu to Mean and the second menu to zone . All time series are displayed when the first menu of the Aggregation element is set to Unaggregated . The default settings for the Aggregation element are determined by the metric type you selected. 
- For quota and other metrics that report one sample per day, do the following: - In the Display pane, set the Widget type to Stacked bar chart .
- Set the time period to at least one week.
 
You can also use the Metrics Explorer to measure other bucket metrics such as storage.googleapis.com/storage/object_countand storage.googleapis.com/storage/v2/total_byte_seconds, which measure the daily number of objects and the daily storage consumed, respectively. See the Google Cloud metrics documentation for a complete list of available metrics and Metrics, time series, and resources for more information about using the Metrics Explorer.
Command line
Use the  gcloud storage du 
 
command with a --summarize 
flag:
gcloud storage du gs:// BUCKET_NAME --summarize
where  BUCKET_NAME 
 
is the name of the relevant
bucket.
The response looks like the following example:
134620 gs://my-bucket
In this example, the size of the bucket named my-bucket 
is 134,620
bytes.
What's next
- List the objects in your bucket .
- Get object metadata .
- Learn more about monitoring your resources in Monitoring .
Try it for yourself
If you're new to Google Cloud, create an account to evaluate how Cloud Storage performs in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
Try Cloud Storage free
