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

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

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.s3nsapis.fr/storage/v1/b/BUCKET_NAME/storageLayout"

    여기서 BUCKET_NAME은 관련 버킷의 이름입니다. 예를 들면 my-bucket입니다.

    성공하면 응답은 다음 예시와 같습니다.

      {
      "kind": "storage#storageLayout",
      "bucket": "my-bucket",
      "location": "us-central1",
      "locationType": "region",
      "hierarchicalNamespace":{enabled: true},
  }

다음 단계