객체 이름 지정 가이드라인

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

객체 이름 요구사항

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

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

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

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

  • XML 1.0에서 허용되지 않는 제어 문자를 사용하지 않습니다(# x7F- # x84 및 # x86- # x9F). 객체 나열 시 이러한 문자로 인해 XML 나열 문제가 발생합니다.
  • '#' 문자: gsutil이 #<숫자 문자열>로 끝나는 객체 이름을 버전 식별자로 해석하므로 객체 이름에 '#'을 포함하면 gsutil을 사용하여 버전 관리 객체에 대한 작업을 수행하기 어렵거나 불가능할 수 있습니다.
  • '[', ']', '*', '?' 문자: gsutil은 이러한 문자를 와일드 카드로 해석하므로 객체 이름에 이러한 문자를 포함하면 gsutil을 사용하여 와일드 카드 작업을 수행하기 어렵거나 불가능할 수 있습니다.
  • 민감한 정보나 개인 식별 정보(PII): 객체 이름이 객체 데이터보다 더 광범위하게 표시됩니다. 예를 들어, 객체 이름은 객체의 URL과 버킷의 객체를 나열할 때 표시됩니다.

객체 이름 고려 사항

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

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

예를 들어 객체 이름을 /europe/france/paris.jpg로 지정하면 paris.jpg가 하위 디렉터리 /europe/france에 있는 것처럼 보일 수 있지만 Cloud Storage에서 이 객체는 단순히 버킷에 있고 이름은 /europe/france/paris.jpg입니다. 따라서 Cloud Storage 내에서 슬래시 구분 기호를 사용하는 복잡하게 중첩된 디렉터리 형태의 구조를 사용할 수 있지만, 복잡하게 중첩된 하위 디렉터리를 나열하는 기본 파일 시스템의 성능을 갖지는 못합니다.

버킷과 마찬가지로 기존 객체의 이름을 직접 바꿀 수는 없지만 원본 객체를 복사하고 삭제하여 객체의 이름을 간접적으로 변경할 수 있습니다.

대규모 업로드 중에 순차적 이름을 사용하지 않고 성능을 최적화하는 방법은 요청 비율 권장사항을 참조하세요. 순차적 이름으로 업로드된 객체는 동일한 백엔드 서버에 도달하여 성능을 제한할 수 있습니다.

다음 단계