이 페이지에서는 Cloud Storage 버킷의 크기와 메타데이터의 정보를 가져오는 방법을 설명합니다.
기본 요건
기본 요건은 사용되는 도구에 따라 다를 수 있습니다.
콘솔
Google Cloud 콘솔을 사용하여 이 가이드를 완료하려면 적절한 IAM 권한이 있어야 합니다. 액세스하려는 버킷을 만들지 않은 경우 프로젝트 소유자가 필요한 권한이 포함된 역할을 부여해야 할 수 있습니다.
특정 작업에 필요한 권한 목록은 Google Cloud 콘솔에 대한 IAM 권한을 참조하세요.
관련 역할 목록은 Cloud Storage 역할을 참조하세요. 또는 특별히 제한된 권한이 있는 커스텀 역할을 만들 수 있습니다.
명령줄
명령줄 유틸리티를 사용하여 이 가이드를 완료하려면 적절한 IAM 권한이 있어야 합니다. 액세스하려는 버킷을 만들지 않은 경우 프로젝트 소유자가 필요한 권한이 포함된 역할을 부여해야 할 수 있습니다.
특정 작업에 필요한 권한 목록은 gsutil 명령어에 대한 IAM 권한을 참조하세요.
관련 역할 목록은 Cloud Storage 역할을 참조하세요. 또는 특별히 제한된 권한이 있는 커스텀 역할을 만들 수 있습니다.
코드 샘플
Cloud Storage 클라이언트 라이브러리를 사용하여 이 가이드를 완료하려면 적절한 IAM 권한이 있어야 합니다. 액세스하려는 버킷을 만들지 않은 경우 프로젝트 소유자가 필요한 권한이 포함된 역할을 부여해야 할 수 있습니다. 달리 명시되지 않는 한 클라이언트 라이브러리 요청은 JSON API를 통해 수행됩니다.
특정 작업에 필요한 권한 목록은 JSON 메서드에 대한 IAM 권한을 참조하세요.
관련 역할 목록은 Cloud Storage 역할을 참조하세요. 또는 특별히 제한된 권한이 있는 커스텀 역할을 만들 수 있습니다.
REST API
JSON API
JSON API를 사용하여 이 가이드를 완료하려면 적절한 IAM 권한이 있어야 합니다. 액세스하려는 버킷을 만들지 않은 경우 프로젝트 소유자가 필요한 권한이 포함된 역할을 부여해야 할 수 있습니다.
특정 작업에 필요한 권한 목록은 JSON 메서드에 대한 IAM 권한을 참조하세요.
관련 역할 목록은 Cloud Storage 역할을 참조하세요. 또는 특별히 제한된 권한이 있는 커스텀 역할을 만들 수 있습니다.
버킷 크기 확인
콘솔
측정항목 탐색기를 사용하여 모니터링 리소스의 측정항목을 확인하려면 다음 단계를 따르세요.
- Google Cloud 콘솔에서 Monitoring의 측정항목 탐색기 페이지로 이동합니다.
- 툴바에서 탐색기 탭을 선택합니다.
- 구성 탭을 선택합니다.
- 측정항목 선택 메뉴를 확장하고 필터 표시줄에
Total bytes
을 입력한 후 하위 메뉴를 사용하여 특정 리소스 유형과 측정항목을 선택합니다.- 활성 리소스 메뉴에서 GCS 버킷을 선택합니다.
- 활성 측정항목 카테고리 메뉴에서 스토리지를 선택합니다.
- 활성 측정항목 메뉴에서 총 바이트를 선택합니다.
- 적용을 클릭합니다.
- 선택사항: 데이터를 보는 방법을 구성하려면 필터를 추가하고 그룹화 기준, 애그리게이터, 차트 유형 메뉴를 사용합니다. 예를 들어 리소스 또는 측정항목 라벨별로 그룹화할 수 있습니다. 자세한 내용은 측정항목 탐색기 사용 시 측정항목 선택을 참조하세요.
- 선택사항: 그래프 설정을 변경합니다.
- 하루에 샘플 하나를 보고하는 할당량과 기타 측정항목의 경우 기간을 최소 1주일 이상으로 설정하고 플롯 유형을 누적 막대 그래프로 설정합니다.
- 분포 값 측정항목의 경우 플롯 유형을 히트맵 차트로 설정합니다.
측정항목 탐색기를 사용하여 일일 객체 수와 일일 스토리지 소비량을 각각 측정하는 storage.googleapis.com/storage/object_count 및 storage.googleapis.com/storage/total_byte_seconds와 같은 다른 버킷 측정항목을 측정할 수도 있습니다. 사용 가능한 측정 항목의 전체 목록은 Google Cloud 측정항목 문서를, 측정항목 탐색기 사용에 대한 자세한 내용은 측정항목, 시계열, 리소스를 참조하세요.
명령줄
gsutil du
명령어를 -s
플래그와 함께 사용하세요.
gsutil du -s gs://BUCKET_NAME
여기서 BUCKET_NAME
은 관련 버킷의 이름입니다.
응답은 다음 예시와 같습니다.
134620 gs://my-bucket
이 예시에서 my-bucket
이라는 버킷의 크기는 134,620바이트입니다.
버킷의 메타데이터 표시
콘솔
- Google Cloud 콘솔에서 Cloud Storage 버킷 페이지로 이동합니다.
(선택사항): 열 표시 옵션 메뉴()를 클릭하여 Google Cloud Console 버킷 목록에 표시되는 열을 제한할 수 있습니다.
버킷 목록에서 인증하려는 버킷을 찾고 보려는 메타데이터에 대한 열 헤더를 확인합니다.
명령줄
다음 gsutil ls
명령어를 사용하세요.
gsutil ls -L -b gs://BUCKET_NAME
여기서 BUCKET_NAME
은 관련 버킷의 이름입니다.
응답은 다음 예시와 같습니다.
gs://my-bucket/ : Storage class: STANDARD Location constraint: US ...
코드 샘플
C++
자세한 내용은 Cloud Storage C++ API 참조 문서를 확인하세요.
C#
자세한 내용은 Cloud Storage C# API 참조 문서를 확인하세요.
Go
자세한 내용은 Cloud Storage Go API 참조 문서를 확인하세요.
Java
자세한 내용은 Cloud Storage Java API 참조 문서를 확인하세요.
Node.js
자세한 내용은 Cloud Storage Node.js API 참조 문서를 확인하세요.
PHP
자세한 내용은 Cloud Storage PHP API 참조 문서를 확인하세요.
Python
자세한 내용은 Cloud Storage Python API 참조 문서를 확인하세요.
Ruby
자세한 내용은 Cloud Storage Ruby API 참조 문서를 확인하세요.
Terraform
Terraform 리소스를 사용하여 버킷의 메타데이터를 볼 수 있습니다.
REST API
JSON API
- OAuth 2.0 Playground에서 승인 액세스 토큰을 가져옵니다. 자체 OAuth 사용자 인증 정보를 사용하도록 Playground를 구성합니다. 자세한 내용은 API 인증을 참조하세요.
cURL
을 사용하여GET
버킷 요청으로 JSON API를 호출합니다.curl -X GET \ -H "Authorization: Bearer OAUTH2_TOKEN" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME"
각 항목의 의미는 다음과 같습니다.
OAUTH2_TOKEN
은 1단계에서 생성한 액세스 토큰의 이름입니다.BUCKET_NAME
은 관련 버킷의 이름입니다. 예를 들면my-bucket
입니다.
쿼리 매개변수를 사용하여 결과의 범위를 원하는 필드로 좁힙니다.
curl -X GET \ -H "Authorization: Bearer OAUTH2_TOKEN" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=FIELD1%2CFIELD2"
여기서
FIELD#
은 결과에 포함하고자 하는 버킷 속성입니다. 예를 들면location
및storageClass
입니다.
응답은 다음 예시와 같습니다.
{ "location": "US", "storageClass": "STANDARD" }
XML API
- OAuth 2.0 Playground에서 승인 액세스 토큰을 가져옵니다. 자체 OAuth 사용자 인증 정보를 사용하도록 Playground를 구성합니다. 자세한 내용은 API 인증을 참조하세요.
cURL
을 사용하여GET
버킷 요청으로 XML API를 호출합니다.curl -X GET \ -H "Authorization: Bearer OAUTH2_TOKEN" \ "https://storage.googleapis.com/BUCKET_NAME?QUERY_PARAMETER"
각 항목의 의미는 다음과 같습니다.
OAUTH2_TOKEN
은 1단계에서 생성한 액세스 토큰의 이름입니다.BUCKET_NAME
은 관련 버킷의 이름입니다. 예를 들면my-bucket
입니다.QUERY_PARAMETER
는 반환하려는 메타데이터 필드입니다. 예를 들어location
은 버킷의 위치를 가져옵니다. XML API에서는 한 번에 하나의 쿼리 매개변수만 사용할 수 있습니다.
응답은 다음 예시와 같습니다.
<LocationConstraint>US</LocationConstraint>
다음 단계
직접 사용해 보기
Google Cloud를 처음 사용하는 경우 계정을 만들어 실제 시나리오에서 Cloud Storage의 성능을 평가할 수 있습니다. 신규 고객에게는 워크로드를 실행, 테스트, 배포하는 데 사용할 수 있는 $300의 무료 크레딧이 제공됩니다.
Cloud Storage 무료로 사용해 보기