이 페이지에서는 Cloud Storage의 관리형 폴더를 간략히 설명합니다.
관리형 폴더는 IAM 역할을 부여할 수 있는 폴더 유형이므로 버킷 내의 특정 객체 그룹에 대한 액세스를 더 세부적으로 제어할 수 있습니다. 관리형 폴더는 Cloud Storage 내에 리소스로 존재하며 플랫 네임스페이스로 작동하는 시뮬레이션된 폴더와는 다릅니다.
관리 폴더의 IAM
관리 폴더에 IAM 정책을 적용하면 정책에 부여된 액세스 권한은 해당 관리 폴더 이름이 프리픽스로 있는 버킷 내의 모든 객체에도 적용됩니다. 예를 들어 주 구성원에게 example-bucket/example-managed-folder/라는 관리 폴더에 대한 스토리지 객체 뷰어(roles/storage.objectViewer) 역할을 부여하면 주 구성원은 example-managed-folder(예: example-bucket/example-managed-folder/example-object.txt) 내의 모든 객체를 볼 수 있습니다.
관리 폴더 이름은 /로 끝나야 합니다. 관리 폴더 이름은 최대 15개의 /를 가질 수 있습니다. 즉, 관리형 폴더는 최대 15단계까지 중첩할 수 있습니다.
관리 폴더 이름은 .well-known/acme-challenge/로 시작할 수 없습니다.
관리 폴더의 이름은 . 또는 ..으로 지정할 수 없습니다.
관리 폴더 이름에는 다음을 사용하지 않는 것이 좋습니다.
XML 1.0에서 허용되지 않는 제어 문자(#x7F–#x84 and #x86–#x9F): 관리 폴더 나열 시 이러한 문자로 인해 XML 나열 문제가 발생합니다.
[, ], * 또는 ? 문자: Google Cloud CLI에서 이러한 문자를 와일드 카드로 해석하므로 관리형 폴더 이름에 이러한 문자를 포함하면 도구에서 와일드 카드 작업을 수행하기가 어렵거나 불가능할 수 없습니다. 또한 * 및 ?는 Windows에서 파일 이름에 유효한 문자가 아닙니다.
민감한 정보나 개인 식별 정보(PII): 관리 폴더 이름은 객체 데이터보다 더 광범위하게 표시됩니다. 예를 들어, 관리 폴더 이름은 객체의 URL과 버킷의 객체를 나열할 때 표시됩니다.
고려사항
관리 폴더로 작업할 때는 다음 사항을 고려하세요.
시뮬레이션된 폴더 대신 관리형 폴더를 만들 수 있습니다. 즉, 해당 이름을 사용한 관리형 폴더가 아직 없는 경우 관리형 폴더를 생성하고 객체의 프리픽스를 따라 이름을 지정할 수 있습니다. 예를 들어 my-folder/object.txt라는 기존 객체가 있더라도 my-folder/라는 관리형 폴더를 만들 수 있습니다. 그러면 관리형 폴더 my-folder/의 IAM 정책이 이름 프리픽스로 my-folder/가 있는 모든 객체에 적용됩니다.
상위 관리형 폴더를 만들기 전에 하위 관리형 폴더를 만들 수 있습니다. 예를 들어 먼저 my-folder-A/ 관리형 폴더를 만들지 않고도 my-folder-A/my-folder-B/ 관리형 폴더를 만들 수 있습니다.
기본적으로 객체 또는 다른 하위 관리 폴더가 포함된 비어 있지 않은 관리 폴더는 삭제할 수 없습니다. Delete ManagedFolder JSON API 요청에서 allowNonEmpty 파라미터를 사용할 때 이 규칙을 우회할 수 있습니다.
명시적인 storage.managedFolders.get 또는 storage.managedFolders.list 권한이 없더라도 동일한 경로에 관리 폴더가 있는 폴더를 삭제하라는 요청이 실패하면 관리 폴더 이름이 오류 메시지 및 Cloud 감사 로그에 표시됩니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-05(UTC)"],[],[],null,["# Managed folders\n\nThis page provides an overview of managed folders in Cloud Storage.\nManaged folders are a type of folder on which you can grant IAM\nroles, so you have more fine-grained access control over specific groups of\nobjects within a bucket. Managed folders exist as resources within\nCloud Storage and are different from\n[simulated folders](/storage/docs/objects#simulated-folders), which operate with a flat namespace.\n\nIAM for managed folders\n-----------------------\n\nWhen you apply an IAM policy on a managed folder, the access\ngranted in the policy also applies to any object within that bucket that has the\nmanaged folder's name as a prefix. For example, if you grant a principal the\nStorage Object Viewer (`roles/storage.objectViewer`) role on a managed folder\nnamed `example-bucket/example-managed-folder/`, the principal can view any\nobject within `example-managed-folder` (such as\n`example-bucket/example-managed-folder/example-object.txt`).\nWhen you nest managed folders, the permissions granted through\nIAM policies are applied additively.\n\nManaged folders can only be created in buckets that have uniform bucket-level access\nenabled.\n\nRead the following pages for more information about managed folders:\n\n- [Creating and managing managed folders](/storage/docs/creating-managing-managed-folders)\n\n- [Control access to managed folders](/storage/docs/access-control/using-iam-for-managed-folders)\n\n- [ManagedFolder reference page](/storage/docs/json_api/v1/managedFolder) for the JSON API\n\nManaged folder names\n--------------------\n\nThe name you give to a managed folder must meet the following requirements:\n\n- Managed folder names can contain any sequence of valid Unicode characters, of\n length 1-1024 bytes when UTF-8 encoded.\n\n- Managed folder names cannot contain\n [Carriage Return or Line Feed characters](https://en.wikipedia.org/wiki/Newline#Unicode).\n\n- Managed folder names must end with `/`. At most, a managed folder name can\n have 15 `/`s. In other words, managed folders can be nested up to 15 levels\n deep.\n\n- Managed folder names cannot start with `.well-known/acme-challenge/`.\n\n- Managed folders cannot be named `.` or `..`.\n\nIt is strongly recommended that you avoid the following in your managed folder\nnames:\n\n- [Control characters](http://www.w3.org/TR/xml/#charsets) that are illegal in XML 1.0\n (#x7F--#x84 and #x86--#x9F): these characters cause XML listing\n issues when you try to list your managed folders.\n\n- The `[`, `]`, `*`, or `?` characters: the Google Cloud CLI interprets\n these characters as wildcards, so including them in managed folder names can\n make it difficult or impossible to perform [wildcard operations](/storage/docs/wildcards) with the\n tool. Additionally, `*` and `?` are not valid characters for file names in\n Windows.\n\n- Sensitive or personally identifiable information (PII): managed folder names\n are more broadly visible than object data. For example, managed folder names\n appear in URLs for the object and when listing objects in a bucket.\n\nConsiderations\n--------------\n\nWhen working with managed folders, note the following considerations:\n\n- Managed folders can be created in place of [simulated folders](/storage/docs/objects#simulated-folders), which means\n that you can create a managed folder and name it after an object's prefix, as\n long as there isn't already a managed folder using that name. For example, you\n can create a managed folder named `my-folder/`, even if you have an existing\n object named `my-folder/object.txt`. Note that the IAM policy\n on the managed folder `my-folder/` will then apply to all objects that has\n `my-folder/` as a name prefix.\n\n- You can create child managed folders before the parent managed folder is\n created. For example, you can create a managed folder named\n `my-folder-A/my-folder-B/` without first creating a managed folder named\n `my-folder-A/`.\n\n- By default, you can't delete a non-empty managed folder that contains objects\n or other child managed folders. You can bypass this rule when using the\n `allowNonEmpty` parameter in a [`Delete` ManagedFolder JSON API request](/storage/docs/json_api/v1/managedFolder/delete).\n\n- Managed folder names are visible in error messages and Cloud Audit Logs when a\n request to delete a [folder](/storage/docs/folders-overview) that has a managed folder at the same path\n fails, even without explicit `storage.managedFolders.get` or\n `storage.managedFolders.list` permissions.\n\nWhat's next\n-----------\n\n- [Create and manage managed folders](/storage/docs/creating-managing-managed-folders).\n\n- Learn about [simulated folders](/storage/docs/objects#simulated-folders).\n\n- [Upload objects](/storage/docs/uploading-objects) to a Cloud Storage bucket."]]
