객체 이름 지정 가이드라인

이 페이지에서는 Cloud Storage에 객체를 업로드할 때 따라야 하는 이름 지정 가이드라인을 간략하게 설명합니다. 객체를 업로드하는 방법은 객체 업로드 가이드를 참조하세요.

객체 이름 요구사항

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

  • 객체 이름은 UTF-8로 인코딩 시 길이가 1~1,024바이트인 임의의 유효한 유니코드 문자 시퀀스를 포함할 수 있습니다.
  • 객체 이름에는 캐리지 리턴 문자나 줄바꿈 문자가 포함될 수 없습니다.
  • 객체 이름은 .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입니다. 따라서 Cloud Storage 내에서 슬래시 구분 기호를 사용하는 복잡하게 중첩된 디렉터리 형태의 구조를 사용할 수 있지만, 복잡하게 중첩된 하위 디렉터리를 나열하는 기본 파일 시스템의 성능을 갖지는 못합니다.

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

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

다음 단계