버킷 이름은 모든 Cloud Storage 사용자에 의해 공유되는 단일 네임스페이스에 있습니다. 다시 말하면 다음과 같습니다.
모든 버킷 이름은 전역적으로 고유해야 합니다.
이미 기존 버킷에 속하는 이름으로 버킷을 만들려고 하면(예: example-bucket) Cloud Storage에 오류 메시지가 표시됩니다.
버킷 이름은 공개적으로 표시됩니다.
누구든지 버킷의 존재를 프로브할 수 있으므로 사용자 ID, 이메일 주소, 프로젝트 이름, 프로젝트 번호 또는 기타 개인 식별 정보(PII)를 버킷 이름에 사용하지 마세요.
버킷을 삭제하면 누구나 새 버킷에 이름을 사용할 수 있습니다.
삭제된 버킷의 이름을 다시 사용할 수 있게 되는데 걸리는 시간은 일반적으로 몇 초 정도입니다. 하지만 몇 가지 주의할 사항이 있습니다.
버킷이 포함된 프로젝트를 삭제할 경우 버킷도 실질적으로 함께 삭제되어, 몇 주 이상 버킷 이름이 해제되지 않을 수 있습니다.
다른 사용자가 내 버킷의 이름을 재사용하는 경우 버킷에 소프트 삭제가 사용 설정되어 있어도 삭제된 버킷을 복원할 수 없습니다.
이전 버킷을 삭제하고 10분 이내에 다른 위치에 같은 이름의 새 버킷이 생성되면 이 10분의 기간 동안 새 버킷에 대한 요청은 실패하고 404-Bucket Not Found 오류가 발생합니다.
요청이 XML API를 거치는 경우 새 위치에서 이름을 재사용하는 버킷을 만들려고 시도하면 기존 버킷이 삭제되고 최대 10분 동안 404-Bucket Not Found 오류와 함께 실패할 수 있습니다.
다른 사용자가 내 버킷의 이름을 재사용하면 원래 삭제된 버킷으로 전송될 데이터나 요청을 실수로 수신할 수 있습니다. 이러한 위험을 완화하려면 다음 권장사항을 고려하세요.
버킷을 만들 때는 추측하거나 예측하기 어려운 강력한 이름 지정 규칙을 사용하세요.
버킷을 삭제할 때는 외부 문서나 오픈소스 저장소 등 삭제된 버킷 이름의 모든 참조를 삭제해야 합니다.
버킷이 더 이상 필요하지 않은 경우 버킷을 삭제하는 대신 버킷에서 모든 객체를 비우고 버킷을 유지하는 것이 좋습니다.
CNAME 또는 A 리디렉션의 일부로 DNS 레코드에서 버킷 이름을 사용할 수 있습니다.
이렇게 하려면 버킷 이름이 표준 DNS 명명 규칙을 따라야 합니다. 즉, 버킷 이름에 밑줄(_)을 사용하거나 다른 마침표 또는 대시와 옆에 마침표가 있어서는 안 됩니다. 예를 들어 .., -., .-는 DNS 이름 내에서 유효하지 않은 문자 조합입니다.
폴더 또는 디렉터리를 사용하여 버킷의 데이터에 액세스
Cloud Storage는 객체 형태로 구조화되지 않은 데이터를 저장하지만 일부 기능을 사용하면 폴더나 디렉터리를 통해 데이터에 액세스하고 관리할 수 있습니다.
계층적 네임스페이스
버킷을 만들 때 원하는 경우 버킷에 계층적 네임스페이스를 사용 설정할 수 있습니다. 이렇게 하면 폴더를 사용하여 파일 시스템 방식으로 객체를 저장할 수 있습니다. 객체를 폴더로 구성하면 대규모 데이터에 대한 작업을 더 쉽게 실행하여 성능, 일관성, 관리 용이성을 개선할 수 있습니다. 계층적 네임스페이스가 사용 설정된 버킷을 사용하면 데이터 집약적이고 파일 지향적인 워크로드로 작업할 때 특히 유용합니다.
Cloud Storage FUSE는 버킷을 로컬 파일 시스템으로 마운트하고 액세스할 수 있도록 지원하는 FUSE 어댑터로, 애플리케이션이 표준 파일 시스템 시맨틱스를 사용하여 버킷의 객체를 읽고 쓸 수 있습니다. Cloud Storage FUSE를 사용하면 서비스의 모든 이점을 활용하여 Cloud Storage에 데이터를 저장하면서도 변경 없이 애플리케이션의 코드를 사용하여 데이터에 액세스할 수 있습니다.
[[["이해하기 쉬움","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-03(UTC)"],[],[],null,["# About Cloud Storage buckets\n\nThis page describes buckets, a resource in Cloud Storage. For a general\noverview of how Cloud Storage works, see the\n[Cloud Storage product overview](/storage/docs/introduction).\n\nBuckets\n-------\n\nBuckets are the basic containers that hold your data as [objects](/storage/docs/objects).\nEverything that you store in Cloud Storage must be contained in a\nbucket. You can use buckets to organize your data and control access to your\ndata, but unlike directories and folders, you cannot nest buckets.\n\n- There is no limit to the number of buckets you can have in a project or\n [location](/storage/docs/locations).\n\n - There are, however, [limits to the rate you can create or delete buckets](/storage/quotas).\n- When you [create a bucket](/storage/docs/creating-buckets), you give it a [globally-unique name](#naming) and a\n [geographic location](/storage/docs/locations) where the bucket and its contents are stored.\n\n - You cannot change the name of an existing bucket. Instead, you can create a new bucket with the name you want and move the contents from the old bucket to the new bucket. See [Move and rename buckets](/storage/docs/moving-buckets) for a step-by-step guide.\n\n\u003c!-- --\u003e\n\n- Pricing (such as charges for data storage, data processing, and network outbound data transfer) depends on factors such as the bucket's location and the storage classes of objects within it. For more details, see [Cloud Storage pricing](/storage/pricing).\n\n\u003c!-- --\u003e\n\n- You can use [Identity and Access Management (IAM)](/storage/docs/access-control/iam) to control access to individual buckets.\n\nBucket names\n------------\n\nYour bucket names must meet the following requirements:\n\n- Bucket names can only contain lowercase letters, numeric characters, dashes (`-`), underscores (`_`), and dots (`.`). Spaces are not allowed. Names containing dots require [verification](/storage/docs/domain-name-verification).\n- Bucket names must start and end with a number or letter.\n- Bucket names must contain 3-63 characters. Names containing dots can contain up to 222 characters, but each dot-separated component can be no longer than 63 characters.\n- Bucket names cannot be represented as an IP address in dotted-decimal notation (for example, 192.168.5.4).\n- Bucket names cannot begin with the \"goog\" prefix.\n- Bucket names cannot contain \"google\" or close misspellings, such as \"g00gle\".\n\n### Example bucket names\n\nThe following are examples of valid bucket names:\n\n- `my-travel-maps`\n- `0f75d593-8e7b-4418-a5ba-cb2970f0b91e`\n- `test.example.com` (Requires [verification of ownership for `example.com`](/storage/docs/domain-name-verification))\n\nThe following are examples of invalid bucket names:\n\n- `My-Travel-Maps` (contains uppercase letters)\n- `my_google_bucket` (contains \"google\")\n- `test bucket` (contains a space)\n\n### Bucket name considerations\n\n- Bucket names reside in a single namespace that is shared by all\n Cloud Storage users. This means that:\n\n - Every bucket name must be globally unique.\n\n If you try to create a bucket with a name that already belongs to an\n existing bucket, such as `example-bucket`, Cloud Storage\n responds with an error message.\n - Bucket names are publicly visible.\n\n Don't use user IDs, email addresses, project names, project numbers, or\n any personally identifiable information (PII) in bucket names because\n anyone can probe for the existence of a bucket.\n- Once you delete a bucket, anyone can reuse its name for a new bucket.\n\n - The time it takes a deleted bucket's name to become available again is\n typically on the order of seconds; however, keep in mind the following:\n\n - If you delete the project that contains the bucket, which effectively\n deletes the bucket as well, the bucket name may not be released for weeks\n or longer.\n\n - If someone reuses your bucket's name, you cannot restore your deleted\n bucket even if the bucket has soft delete enabled.\n\n - If a new bucket with the same name is created in a different location and\n within 10 minutes of the old bucket's deletion, requests made to the new\n bucket during this 10 minute timeframe might fail with a\n `404-Bucket Not Found` error.\n\n - If your requests go through the [XML API](/storage/docs/xml-api), attempts to create a bucket\n that reuses a name in a new location might fail with a\n `404-Bucket Not Found` error for up to 10 minutes after the old bucket's\n deletion.\n\n - If someone reuses your bucket's name, they could inadvertently\n receive data or requests intended for your original deleted bucket. To\n mitigate this risk, consider the following best practices:\n\n - When creating buckets, use a strong naming convention that's not easy to\n guess or predict.\n\n - When deleting buckets, make sure to remove all references of the\n deleted bucket's name, such as from external documentation or open\n source repositories.\n\n - If you no longer need a bucket, consider emptying all objects from\n the bucket and keeping the bucket instead of deleting it.\n\n- You can use a bucket name in a DNS record as part of a `CNAME` or `A`\n redirect.\n\n In order to do so, your bucket name should conform to standard DNS naming\n conventions. This means that your bucket name shouldn't use underscores\n (`_`) or have a period next to another period or dash. For example, `..`,\n `-.`, and `.-` are invalid character combinations within DNS names.\n\nAccess data in buckets by using folders or directories\n------------------------------------------------------\n\nAlthough Cloud Storage stores unstructured data in the form of objects,\nsome features let you access and manage your data using folders or directories.\n\n### Hierarchical namespace\n\nWhen you create buckets, you can optionally enable [hierarchical namespace](/storage/docs/hns-overview)\nfor the bucket, which lets you use [folders](/storage/docs/folders-overview) to store your objects in\na file system manner. Organizing your objects into folders makes it easier to\nrun operations on large scales of data, improving performance, consistency,\nand ease of management. Using buckets with hierarchical namespace enabled is\nespecially beneficial when working with data-intensive and file-oriented\nworkloads.\n\nTo get started using hierarchical namespace, see\n[Create buckets with hierarchical namespace enabled](/storage/docs/create-hns-bucket).\n\n### Cloud Storage FUSE\n\n[Cloud Storage FUSE](/storage/docs/cloud-storage-fuse/overview#overview) is a FUSE adapter that lets you mount and access buckets as\nlocal file systems, so applications can read and write objects in your bucket\nusing standard file system semantics. Cloud Storage FUSE lets you store your data\nin Cloud Storage with all the service's benefits, all while retaining\nthe ability to access that data using your application's code without needing\nchanges.\n\nTo learn how to use Cloud Storage FUSE, see the [Cloud Storage FUSE quickstart](/storage/docs/cloud-storage-fuse/quickstart-mount-bucket).\n\nWhat's next\n-----------\n\n- [Create Cloud Storage buckets](/storage/docs/creating-buckets).\n- [Rename an existing bucket](/storage/docs/moving-buckets).\n- Learn about the [metadata associated with a bucket](/storage/docs/bucket-metadata).\n- [Upload an object](/storage/docs/uploading-objects)."]]
