이 페이지에서는 버킷의 스토리지 레이아웃을 확인하는 방법을 설명합니다. 스토리지 레이아웃은 객체가 버킷 내에서 플랫 네임스페이스 또는 계층적 네임스페이스로 구성되는 방식을 나타냅니다. 객체 액세스 및 조작 메서드는 레이아웃에 따라 다르므로 버킷과 상호작용하는 애플리케이션에는 레이아웃이 중요합니다. 스토리지 레이아웃에는 버킷 위치에 관한 정보도 포함됩니다.
getStorageLayout
API를 사용하면 애플리케이션이 버킷이 계층적 네임스페이스를 사용하는지 여부에 따라 동작을 조정할 수 있어, 버킷 구성에 따라 적절한 기능을 활용하고 최적의 호환성을 보장할 수 있습니다.
버킷의 스토리지 레이아웃 가져오기
명령줄
gcloud alpha storage buckets describe
명령어를 --format
플래그와 함께 사용합니다.
gcloud alpha storage buckets describe gs://BUCKET_NAME --raw --format="default(hierarchicalNamespace)"
각 항목의 의미는 다음과 같습니다.
BUCKET_NAME
은 관련 버킷의 이름입니다. 예를 들면my-bucket
입니다.
성공하고 계층적 네임스페이스가 사용 설정되면 다음 예시와 비슷한 응답이 표시됩니다.
hierarchicalNamespace: enabled: true
JSON API
Authorization
헤더에 대한 액세스 토큰을 생성하려면 gcloud CLI가 설치 및 초기화되어 있어야 합니다.cURL
를 사용하여getStorageLayout
요청으로 JSON API를 호출합니다.curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/storageLayout"
여기서
BUCKET_NAME
은 관련 버킷의 이름입니다. 예를 들면my-bucket
입니다.성공하면 응답은 다음 예시와 같습니다.
{ "kind": "storage#storageLayout", "bucket": "my-bucket", "location": "us-central1", "locationType": "region", "hierarchicalNamespace":{enabled: true}, }
다음 단계
직접 사용해 보기
Google Cloud를 처음 사용하는 경우 계정을 만들어 실제 시나리오에서 Cloud Storage의 성능을 평가할 수 있습니다. 신규 고객에게는 워크로드를 실행, 테스트, 배포하는 데 사용할 수 있는 $300의 무료 크레딧이 제공됩니다.
Cloud Storage 무료로 사용해 보기