이 페이지는 Cloud Translation API를 통해 번역되었습니다.

폴더 정보

Cloud Storage는 데이터를 구성하는 다양한 방법을 제공하며 폴더는 이 프로세스에서 중요한 역할을 합니다. 사용 가능한 다양한 폴더 유형을 이해하면 특정 요구사항에 가장 적합한 폴더를 선택하는 데 도움이 됩니다.

이 페이지에서는 Cloud Storage의 다양한 폴더 유형을 간략히 설명하며, 계층적 네임스페이스가 사용 설정된 경우 버킷 내에서 폴더가 작동하는 방식에 중점을 둡니다.

폴더 유형

Cloud Storage에는 세 가지 기본 폴더 유형이 있습니다.

시뮬레이션된 폴더: 일반적인 Cloud Storage 버킷은 단일 구조 네임스페이스에 객체를 구성합니다. Google Cloud 콘솔과 Google Cloud CLI를 사용하여 파일 트리를 모방하는 폴더를 시뮬레이션하여 버킷의 데이터를 구성할 수 있습니다. 시뮬레이션된 폴더에 대한 자세한 내용은 시뮬레이션된 폴더를 참고하세요.
폴더: 계층적 네임스페이스가 사용 설정된 버킷에서는 객체 또는 다른 폴더가 포함된 실제 폴더를 만들 수 있습니다. 폴더 이름 바꾸기, 폴더 나열과 같은 작업을 실행할 수도 있습니다. 계층 구조 및 폴더 관리 작업은 데이터 집약적인 파일 지향 워크로드의 성능, 일관성, 관리를 개선합니다.
관리 폴더: 관리 폴더를 사용하면 객체에 세분화된 액세스 제어를 적용하여 데이터에 대한 보안과 제어를 강화할 수 있습니다. 계층적 네임스페이스가 사용 설정되었는지와 관계없이 버킷에서 관리 폴더를 사용할 수 있습니다. 관리 폴더에 대한 자세한 내용은 관리 폴더를 참고하세요.

폴더 개요

폴더는 계층적 네임스페이스가 사용 설정된 버킷에 리소스로 존재합니다. 파일 시스템과 유사한 구조로 폴더 내에서 객체를 구성할 수 있습니다. 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.txt`	`foo.txt` 객체는 `dir1/`라는 최상위 폴더 내에 있습니다. 최상위 폴더는 루트 폴더와 다릅니다.
`dir1/`	`dir1/`와 같이 객체 이름의 후행 슬래시는 객체가 폴더 내에 있음을 나타냅니다. 이 예시에서 객체 이름 `dir1/`는 상위 폴더 이름 `dir1/`와 동일합니다.
`dir1//foo.txt`	`foo.txt` 객체는 `dir1/`의 하위 폴더인 `dir1//`라는 두 번째 계층 폴더에 있습니다.

최대 폴더 깊이: 계층적 네임스페이스가 사용 설정된 버킷은 50단계의 최대 폴더 깊이를 지원합니다. 따라서 객체 이름에 슬래시(/)는 50개를 초과할 수 없습니다.
최대 폴더 이름 크기: 512바이트 (UTF-8 인코딩)
자동 폴더 생성: 새 객체를 만들면 객체의 경로에 지정된 존재하지 않는 폴더가 자동으로 생성됩니다. 예를 들어 dir1/foo.txt라는 객체를 만들면 dir1/ 폴더가 아직 없는 경우 자동으로 생성됩니다.

다음 단계

직접 사용해 보기

Google Cloud를 처음 사용하는 경우 계정을 만들어 실제 시나리오에서 Cloud Storage의 성능을 평가할 수 있습니다. 신규 고객에게는 워크로드를 실행, 테스트, 배포하는 데 사용할 수 있는 $300의 무료 크레딧이 제공됩니다.

Cloud Storage 무료로 사용해 보기