버킷 이름 지정 가이드라인

이 페이지에는 Cloud Storage에서 버킷을 만들 때 따라야 하는 이름 지정 가이드라인이 요약되어 있습니다. 버킷을 만드는 방법에 대해 알아보려면 스토리지 버킷 만들기 가이드를 참조하세요.

버킷 이름 요구사항

버킷 이름은 다음 요구사항을 충족해야 합니다.

  • 버킷 이름은 소문자, 숫자, 대시(-), 밑줄(_), 점(.)만 포함해야 합니다. 공백은 사용할 수 없습니다. 점이 포함된 이름은 확인이 필요합니다.
  • 버킷 이름은 숫자 또는 문자로 시작하고 끝나야 합니다.
  • 버킷 이름은 3~63자를 포함해야 합니다. 점을 포함하는 이름은 최대 222자를 포함할 수 있으나, 점으로 구분된 각 부분은 63자 이하여야 합니다.
  • 버킷 이름은 마침표로 구분된 십진수 표기 형식의 IP 주소로 표시할 수 없습니다(예: 192.168.5.4).
  • 버킷 이름은 프리픽스 'goog'로 시작할 수 없습니다.
  • 버킷 이름에 'google' 또는 이와 유사한 잘못된 철자(예: 'g00gle')를 포함할 수 없습니다.

버킷 이름 고려사항

  • 버킷 이름은 단일 Cloud Storage 네임스페이스에 있습니다.

    다시 말하면 다음과 같습니다.

    • 모든 버킷 이름은 고유해야 합니다.
    • 버킷 이름은 공개적으로 표시됩니다.

    이미 기존 버킷에 속하는 이름으로 버킷을 만들려고 하면 Cloud Storage에 오류 메시지가 표시됩니다.

  • 버킷 이름은 생성 중에만 할당될 수 있습니다.

    기존 버킷의 이름을 변경할 수 없습니다. 대신 원하는 이름으로 새 버킷을 만들고 이전 버킷의 콘텐츠를 새 버킷으로 이전해야 합니다. 단계별 가이드는 버킷 이동 및 이름 바꾸기를 참조하세요.

  • 버킷을 삭제하면 누구나 새 버킷에 이름을 사용할 수 있습니다.

    삭제된 버킷의 이름을 다시 사용할 수 있게 되는 데 걸리는 시간은 일반적으로 몇 초입니다. 하지만 버킷이 포함된 프로젝트를 삭제하면 실질적으로 버킷도 삭제되므로 버킷 이름이 몇 주 이상 해제되지 않을 수 있습니다.

  • CNAME 또는 A 리디렉션의 일부로 DNS 레코드에서 버킷 이름을 사용할 수 있습니다.

    이렇게 하려면 버킷 이름이 표준 DNS 명명 규칙을 따라야 합니다. 즉, 버킷 이름에 밑줄(_)을 사용하거나 다른 마침표 또는 대시와 옆에 마침표가 있어서는 안 됩니다. 예를 들어 DNS 이름에서 '..'는 유효하지 않으며 '-.' 또는 '.-'도 마찬가지입니다.

버킷 이름에서 독점 정보를 제외하는 방법에 대한 권장사항이 포함된 이름 지정 권장사항 섹션도 참조하세요.

버킷 이름 예시

다음은 유효한 버킷 이름의 예시입니다.

  • my-travel-maps
  • 0f75d593-8e7b-4418-a5ba-cb2970f0b91e
  • test.example.com(example.com의 소유권 확인 필요)

다음은 잘못된 버킷 이름의 예시입니다.

  • My-Travel-Maps(대문자 포함)
  • my_google_bucket('google' 포함)
  • test bucket(공백 포함)

다음 단계