객체 이름 지정 가이드라인

이 페이지에서는 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입니다.

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

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

다음 단계