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

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

버킷 이름 요구사항

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

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

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

버킷 이름 고려 사항

버킷 이름은 단일 Cloud Storage 네임스페이스에 있으므로 모든 버킷 이름은 고유해야 합니다. 기존 버킷에 이미 할당된 이름으로 버킷을 만들려고 하면 Cloud Storage가 오류 메시지로 응답합니다. 그러나 일단 버킷을 삭제하면 새 버킷을 만들 때 해당 이름을 다시 사용할 수 있습니다.

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

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

객체 이름 요구사항

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

  • 객체 이름은 UTF-8로 인코딩 시 길이가 1~1024바이트인 임의의 유효한 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에서 이 객체는 단순히 버킷에 있고 이름은 /europe/france/paris.jpg입니다.

버킷과 마찬가지로 기존 객체의 이름을 바꿀 수 없습니다. 대신 객체를 복사하고, 새 객체에 원하는 이름을 지정하고, 이전 객체를 삭제하는 방식으로 이름 바꾸기를 수행할 수 있습니다. 이 프로세스를 자동으로 처리하는 gsutil mv 명령어로 쉽게 수행할 수 있습니다. 폴더가 아닌 파일의 경우 Google Cloud Platform Console에서 원하는 파일의 드롭다운 메뉴(파일 줄의 오른쪽 끝에 세로로 나열된 점 세 개)를 클릭하고 이동/이름 변경을 클릭하여 간편하게 이름을 바꿀 수 있습니다. JSON 및 XML API를 통해 Google Cloud Storage를 사용하는 경우 객체를 복사했다가 삭제하여 객체 이름을 명시적으로 변경해야 합니다.

다음 단계

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

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

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