버킷의 스토리지 레이아웃 가져오기

이 페이지에서는 버킷의 스토리지 레이아웃을 확인하는 방법을 설명합니다. 스토리지 레이아웃은 객체가 버킷 내에서 플랫 네임스페이스 또는 계층적 네임스페이스로 구성되는 방식을 나타냅니다. 객체 액세스 및 조작 메서드는 레이아웃에 따라 다르므로 버킷과 상호작용하는 애플리케이션에는 레이아웃이 중요합니다. 스토리지 레이아웃에는 버킷 위치에 관한 정보도 포함됩니다.

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

  1. Authorization 헤더에 대한 액세스 토큰을 생성하려면 gcloud CLI가 설치 및 초기화되어 있어야 합니다.

  2. 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 무료로 사용해 보기