버킷 및 객체 이름 지정 가이드라인

이 페이지에서는 Cloud Storage에서 버킷을 만들고 객체를 업로드할 때 따라야 하는 이름 지정 가이드라인을 간략하게 설명합니다. 버킷을 만드는 방법에 대해 알아보려면 저장소 버킷 만들기 가이드를 참조하세요.

버킷 이름 요구사항

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

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

또한 DNS 규정 준수와 향후 호환성을 위해 밑줄(_)을 사용하지 말아야 하며 마침표를 다른 마침표나 대시와 연달아 사용하면 안 됩니다. 예를 들어 '..', '-', '.-'는 DNS 이름으로 유효하지 않습니다.

버킷 이름 고려 사항

버킷 이름은 단일 Cloud Storage 네임스페이스에 있습니다. 다시 말하면 다음과 같습니다.

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

이미 기존 버킷에 속한 이름으로 버킷을 만들려고 하면 Cloud Storage가 오류 메시지로 응답합니다. 하지만 버킷을 삭제한 후에는 본인이나 다른 사용자가 새 버킷에 해당 이름을 재사용할 수 있습니다.

버킷 이름은 생성 중에만 할당할 수 있습니다. 기존 버킷의 이름은 변경할 수 없습니다. 대신 원하는 이름으로 새 버킷을 만들고 이전 버킷의 콘텐츠를 새 버킷으로 옮겨야 합니다. 단계별 안내는 버킷 이동 및 이름 바꾸기를 참조하세요.

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

객체 이름 요구사항

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

  • 객체 이름은 UTF-8로 인코딩 시 길이가 1~1,024바이트인 임의의 유효한 Unicode 문자 시퀀스를 포함할 수 있습니다.
  • 객체 이름에는 캐리지 리턴 문자나 줄바꿈 문자가 포함될 수 없습니다.
  • 객체 이름은 .well-known/acme-challenge로 시작할 수 없습니다.
  • 객체 이름은 . 또는 ..으로 지정할 수 없습니다.

캐리지 리턴 및 줄바꿈 문자에 대한 자세한 내용은 줄바꿈을 참조하세요.

객체 이름에 다음을 사용하지 않는 것이 좋습니다.

  • XML 1.0에서 허용되지 않는 제어 문자를 사용하지 않습니다(# x7F- # x84 및 # x86- # x9F). 객체 나열 시 이러한 문자로 인해 XML 나열 문제가 발생합니다.
  • 객체 이름에 '#'을 사용하지 않습니다. gsutil은 #<숫자 문자열>로 끝나는 객체 이름을 버전 식별자로 해석하므로 객체 이름에 '#'을 포함하면 gsutil을 사용하여 버전 관리 객체에 대한 작업을 수행하기 어렵거나 불가능할 수 있습니다(객체 버전 관리 및 동시 실행 제어 참조).
  • 객체 이름에 '[", "]', '*' 또는 '?'를 사용하지 않습니다. gsutil은 이러한 문자를 와일드 카드로 해석하므로 객체 이름에 이러한 문자를 포함하면 gsutil을 사용하여 와일드 카드 작업을 수행하기 어렵거나 불가능할 수 있습니다.

객체 이름 고려 사항

객체 이름은 버킷 내의 단일 구조 네임스페이스에 있습니다. 다시 말하면 다음과 같습니다.

  • 여러 버킷에 동일한 이름을 가진 객체가 있을 수 있습니다.
  • 객체가 버킷의 하위 디렉터리 내에 있지 않습니다.

예를 들어 객체 이름을 /europe/france/paris.jpg로 지정하면 paris.jpg가 하위 디렉터리 /europe/france에 있는 것처럼 보일 수 있지만 Cloud Storage에서 이 객체는 단순히 버킷에 있고 이름은 입니다.

버킷과 마찬가지로 기존 객체의 이름을 직접 바꿀 수는 없습니다. 대신 객체를 복사하고 복사된 버전에 원하는 이름을 지정하고 객체의 원래 버전을 삭제할 수 있습니다. 이름 바꾸기 프로세스를 자동으로 처리하는 gsutil 및 Google Cloud Platform Console과 같은 도구를 설명하는 단계별 안내를 보려면 객체 이름 바꾸기를 참조하세요.

다음 단계

이 페이지가 도움이 되었나요? 평가를 부탁드립니다.

다음에 대한 의견 보내기...

도움이 필요하시나요? 지원 페이지를 방문하세요.