이 페이지에서는 계층적 네임스페이스가 사용 설정된 버킷의 폴더에 관한 정보를 제공합니다.
개요
폴더는 계층적 네임스페이스가 사용 설정된 버킷에 리소스로 존재합니다. 파일 시스템과 같은 구조로 폴더 내에서 객체를 정리할 수 있습니다. Cloud Storage는 폴더 만들기, 삭제, 이름 바꾸기, 나열은 및 폴더 메타데이터 검색과 같은 작업을 할 수 있도록 하는 API를 제공합니다.
폴더 메타데이터
폴더의 메타데이터에는 폴더에 관한 구조화된 정보가 포함됩니다. 폴더 메타데이터에 관한 자세한 내용은 Cloud Storage JSON API 참조 문서의 Folder 리소스를 참고하세요.
폴더 메타데이터의 주요 구성요소는 다음과 같습니다.
bucket: 폴더가 있는 버킷의 이름입니다. 예를 들면my-bucket입니다.id: 버킷 내 폴더의 고유 식별자입니다. 예를 들면hns-bucket/dir1/입니다.kind: 리소스 유형입니다. 폴더의 경우 이 값은 항상storage#folder입니다.name: 폴더의 이름입니다. 예를 들면dir1/입니다.selfLink: Cloud Storage API에서 폴더를 참조하는 URL입니다.timeCreated: 폴더가 생성된 타임스탬프입니다. 예를 들면2023-05-05T16:32:08.878000+00:00입니다.updated: 폴더가 최종 업데이트된 타임스탬프입니다. 예를 들면2024-05-06T16:32:08.878000+00:00입니다.
고려사항
폴더를 만들 때 다음 사항을 고려하세요.
객체 및 폴더 이름: 계층적 네임스페이스가 사용 설정된 버킷은 선행 및 후행 슬래시(
/) 또는 연속 슬래시가 있는 항목을 포함하여 모든 유효한 객체 이름을 지원합니다. 객체 이름의 각 슬래시(/)는 폴더를 나타냅니다. 다음 표는 객체 이름과 폴더 계층 구조의 해당 위치 간의 관계를 보여주는 예입니다.객체 이름 폴더 계층 구조 내 위치 foo.txt모든 버킷에는 루트 폴더가 포함됩니다. foo.txt객체는 버킷의 루트 폴더 아래에 있습니다.dir1/foo.txtfoo.txt객체는dir1/라는 최상위 폴더 내에 있습니다. 최상위 폴더는 루트 폴더와 다릅니다.dir1/dir1/와 같이 객체 이름의 후행 슬래시는 객체가 폴더 내에 있음을 나타냅니다. 이 예시에서 객체 이름dir1/는 상위 폴더 이름dir1/와 동일합니다.dir1//foo.txtfoo.txt객체는dir1/의 하위 폴더인dir1//라는 두 번째 계층 폴더에 있습니다.최대 폴더 깊이: 계층적 네임스페이스가 사용 설정된 버킷은 50단계의 최대 폴더 깊이를 지원합니다. 따라서 객체 이름에 슬래시(
/)는 50개를 초과할 수 없습니다.최대 폴더 이름 크기: 512바이트 (UTF-8 인코딩)
자동 폴더 생성: 새 객체를 만들면 객체의 경로에 지정된 존재하지 않는 폴더가 자동으로 생성됩니다. 예를 들어
dir1/foo.txt라는 객체를 만들면dir1/폴더가 아직 존재하지 않는 경우 자동으로 생성됩니다.
다음 단계
직접 사용해 보기
Google Cloud를 처음 사용하는 경우 계정을 만들어 실제 시나리오에서 Cloud Storage의 성능을 평가할 수 있습니다. 신규 고객에게는 워크로드를 실행, 테스트, 배포하는 데 사용할 수 있는 $300의 무료 크레딧이 제공됩니다.
Cloud Storage 무료로 사용해 보기