Halaman ini menunjukkan cara mendapatkan ukuran bucket Cloud Storage.
Peran yang diperlukan
Untuk mendapatkan izin yang diperlukan guna mendapatkan ukuran bucket Cloud Storage, minta administrator Anda untuk memberi Anda peran Storage Object Viewer (roles/storage.objectViewer) di bucket tersebut. Jika Anda berencana menggunakan konsol Google Cloud , minta administrator untuk memberi Anda peran Monitoring Viewer (roles/monitoring.viewer) di project yang berisi bucket.
Peran ini berisi izin yang diperlukan untuk mendapatkan ukuran bucket.
Untuk melihat izin yang benar-benar diperlukan, luaskan bagian
Izin yang diperlukan:
Izin yang diperlukan
storage.objects.list
Izin ini hanya diperlukan untuk menggunakan Google Cloud CLI guna menjalankan petunjuk di halaman ini.
Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.
Di toolbar konsol Google Cloud , pilih project Google Cloud Anda.
Untuk konfigurasi App Hub, pilih
project host App Hub atau project pengelolaan folder yang mendukung aplikasi.
Pada elemen Metrik, luaskan menu Pilih metrik, masukkan Total bytes (v2) di panel filter, lalu gunakan submenu untuk memilih jenis dan metrik resource tertentu:
Di menu Active resources, pilih GCS Bucket.
Di menu Active metric category, pilih Storage.
Di menu Active metrics, pilih Total bytes (v2).
Klik Terapkan.
Nama yang sepenuhnya memenuhi syarat untuk metrik ini adalah storage.googleapis.com/storage/v2/total_bytes.
Untuk menghapus deret waktu dari tampilan, gunakan elemen Filter.
Untuk menggabungkan deret waktu, gunakan menu pada elemen Agregasi.
Misalnya, untuk menampilkan pemakaian CPU bagi VM Anda, berdasarkan zonanya, tetapkan menu pertama ke Rataan dan menu kedua ke zona.
Semua deret waktu ditampilkan saat menu pertama elemen Agregasi ditetapkan ke Unaggregated. Setelan default untuk elemen Agregasi ditentukan oleh jenis metrik yang Anda pilih.
Untuk kuota dan metrik lain yang melaporkan satu sampel per hari, lakukan tindakan berikut:
Di panel Display,
tetapkan Jenis widget ke Diagram batang bertumpuk.
Tetapkan jangka waktu setidaknya satu minggu.
Anda juga dapat menggunakan Metrics Explorer untuk mengukur metrik bucket lainnya
seperti storage.googleapis.com/storage/object_count dan
storage.googleapis.com/storage/v2/total_byte_seconds, yang masing-masing mengukur
jumlah harian objek dan penyimpanan harian yang terpakai. Lihat
dokumentasi metrikGoogle Cloud untuk mengetahui daftar lengkap
metrik yang tersedia dan Metrik, deret waktu, dan resource untuk mengetahui informasi
selengkapnya tentang cara menggunakan Metrics Explorer.
Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi
performa Cloud Storage dalam skenario
dunia nyata. Pelanggan baru mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-08-25 UTC."],[],[],null,["# Get bucket size\n\n[Concepts](/storage/docs/bucket-metadata)\n\nThis page shows you how to get the size of your Cloud Storage [buckets](/storage/docs/buckets).\n\nRequired roles\n--------------\n\nIn order to get the required permissions for getting the size of a\nCloud Storage bucket, ask your administrator to grant you the Storage\nObject Viewer (`roles/storage.objectViewer`) role on the bucket. If you plan on\nusing the Google Cloud console, ask your administrator to grant you the\nMonitoring Viewer (`roles/monitoring.viewer`) role on the project that contains\nthe bucket instead.\n\nThese roles contain the permissions required to get the size of a bucket.\nTo see the exact permissions that are required, expand the\n**Required permissions** section: \n\n#### Required permissions\n\n- `storage.objects.list`\n - This permission is only required for using the Google Cloud CLI to perform the instructions on this page.\n\nTo see the permissions associated with `roles/monitoring.viewer`,\nrefer to the\n[Monitoring Viewer documentation](/iam/docs/understanding-roles#monitoring.editor).\n\nYou might be able to get the required permission with other\n[predefined roles](/iam/docs/understanding-roles) or [custom roles](/iam/docs/creating-custom-roles). For instructions on granting roles\non buckets, see [Use IAM with buckets](/storage/docs/access-control/using-iam-permissions#bucket-iam). For instructions on\ngranting roles on projects, see [Manage access to projects](/iam/docs/granting-changing-revoking-access).\n\nDetermine a bucket's size\n-------------------------\n\n### Console\n\n| **Note:** Monitoring measures bucket size once a day and does not report empty buckets. To measure bucket size at a given moment for any bucket, use `gcloud storage` instead.\n\nTo view the metrics for a monitored resource by using the\nMetrics Explorer, do the following:\n\n1. In the Google Cloud console, go to the\n *leaderboard* **Metrics explorer** page:\n\n [Go to **Metrics explorer**](https://console.cloud.google.com/monitoring/metrics-explorer)\n\n \u003cbr /\u003e\n\n If you use the search bar to find this page, then select the result whose subheading is\n **Monitoring**.\n2. In the toolbar of the Google Cloud console, select your Google Cloud project. For [App Hub](/app-hub/docs/overview) configurations, select the App Hub host project or the app-enabled folder's management project.\n3. 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:\n 1. In the **Active resources** menu, select **GCS Bucket**.\n 2. In the **Active metric categories** menu, select **Storage**.\n 3. In the **Active metrics** menu, select **Total bytes (v2)**.\n 4. Click **Apply**.\n\n The fully qualified name for this metric is **storage.googleapis.com/storage/v2/total_bytes**.\n4. To remove time series from the display, use the\n [**Filter** element](/monitoring/charts/metrics-selector#filter-option).\n\n5. To combine time series, use the menus on the\n [**Aggregation** element](/monitoring/charts/metrics-selector#select_display).\n For example, to display the CPU utilization for your VMs, based on their zone, set the\n first menu to **Mean** and the second menu to **zone**.\n\n All time series are displayed when the first menu of the **Aggregation** element is set\n to **Unaggregated** . The default settings for the **Aggregation** element\n are determined by the metric type you selected.\n6. For quota and other metrics that report one sample per day, do the following:\n 1. In the **Display** pane, set the **Widget type** to **Stacked bar chart**.\n 2. Set the time period to at least one week.\n\nYou can also use the Metrics Explorer to measure other bucket metrics\nsuch as **storage.googleapis.com/storage/object_count** and\n**storage.googleapis.com/storage/v2/total_byte_seconds** , which measure the\ndaily number of objects and the daily storage consumed, respectively. See\nthe [Google Cloud metrics documentation](/monitoring/api/metrics_gcp_p_z#gcp-storage) for a complete list of\navailable metrics and [Metrics, time series, and resources](/monitoring/api/v3/metrics) for more\ninformation about using the Metrics Explorer.\n\n### Command line\n\n| **Caution:** The `gcloud storage du` command calculates the current space usage by making a series of object listing requests, which can take a long time for large buckets. If the number of objects in your bucket is hundreds of thousands or more, or if you want to monitor your bucket size over time, use Monitoring instead, as described in the Console tab.\n\nUse the [`gcloud storage du`](/sdk/gcloud/reference/storage/du) command with a `--summarize` flag: \n\n```\ngcloud storage du gs://BUCKET_NAME --summarize\n```\n\nwhere \u003cvar translate=\"no\"\u003eBUCKET_NAME\u003c/var\u003e is the name of the relevant\nbucket.\n\nThe response looks like the following example: \n\n```\n134620 gs://my-bucket\n```\n\nIn this example, the size of the bucket named `my-bucket` is 134,620\nbytes.\n\nWhat's next\n-----------\n\n- [List the objects in your bucket](/storage/docs/listing-objects).\n- [Get object metadata](/storage/docs/viewing-editing-metadata).\n- [Learn more about monitoring your resources in Monitoring](/monitoring/api/v3/metrics).\n\nTry it for yourself\n-------------------\n\n\nIf you're new to Google Cloud, create an account to evaluate how\nCloud Storage performs in real-world\nscenarios. New customers also get $300 in free credits to run, test, and\ndeploy workloads.\n[Try Cloud Storage free](https://console.cloud.google.com/freetrial)"]]
