Cloud Storage 버킷의 메타데이터를 가져오는 데 필요한 권한을 얻으려면 관리자에게 버킷에 대한 스토리지 객체 뷰어(roles/storage.objectViewer) 역할을 부여해 달라고 요청하세요. Google Cloud 콘솔을 사용하려는 경우에는 관리자에게 대신 버킷이 포함된 프로젝트에 대한 모니터링 뷰어(roles/monitoring.viewer) 역할을 부여해 달라고 요청하세요.
이러한 역할에는 버킷 크기를 가져오는 데 필요한 권한이 포함되어 있습니다.
필요한 정확한 권한을 보려면 필수 권한 섹션을 확장하세요.
필수 권한
storage.objects.list
이 권한은 Google Cloud CLI를 사용하여 이 페이지의 안내를 수행하는 경우에만 필요합니다.
시계열을 조합하려면 집계 요소의 메뉴를 사용합니다.
예를 들어 VM의 CPU 사용률을 영역에 따라 표시하려면 첫 번째 메뉴를 평균으로, 두 번째 메뉴를 영역으로 설정합니다.
집계 요소의 첫 번째 메뉴가 집계되지 않음으로 설정되면 모든 시계열이 표시됩니다. 집계 요소 기본 설정은 선택한 측정항목 유형에 따라 결정됩니다.
하루에 샘플 하나를 보고하는 할당량과 기타 측정항목의 경우 다음을 수행합니다.
표시 창에서 위젯 유형을 누적 막대 그래프로 설정합니다.
기간을 최소 1주일로 설정합니다.
측정항목 탐색기를 사용하여 일일 객체 수와 일일 스토리지 소비량을 각각 측정하는 storage.googleapis.com/storage/object_count 및 storage.googleapis.com/storage/v2/total_byte_seconds와 같은 다른 버킷 측정항목을 측정할 수도 있습니다 사용 가능한 측정 항목의 전체 목록은 Google Cloud 측정항목 문서를, 측정항목 탐색기 사용에 대한 자세한 내용은 측정항목, 시계열, 리소스를 참조하세요.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-08-26(UTC)"],[],[],null,["[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\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\nRequired 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\nConsole**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 add filters, which remove time series from the query results, 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\nCommand line**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- [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\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)"]]
