Lightsail 오브젝트 스토리지 버킷의 키 이름 - Amazon Lightsail
키 이름객체 키 명명 지침XML관련 객체 키 제약 조건

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Lightsail 오브젝트 스토리지 버킷의 키 이름

버킷에 업로드한 파일은 Amazon Lightsail 객체 스토리지 서비스에 객체로 저장됩니다. 객체 키(또는 키 이름)는 버킷에 저장된 객체를 고유하게 식별합니다. 이 가이드에서는 Lightsail 콘솔을 통해 표시되는 버킷의 폴더 구조를 구성하는 키 이름 및 키 이름 접두사의 개념을 설명합니다. 버킷에 대한 자세한 내용은 객체 스토리지를 참조하세요.

키 이름

Lightsail 오브젝트 스토리지 서비스 데이터 모델은 파일 시스템에서 볼 수 있는 계층 구조 대신 플랫 구조를 사용합니다. 이 모델에는 폴더 및 하위 폴더의 계층이 없습니다. 그러나 키 이름 접두사와 구분 기호를 사용하여 논리적 계층을 유추할 수 있습니다. Lightsail 콘솔은 키 이름 접두사를 사용하여 폴더 구조에 객체를 표시합니다.

버킷에 다음과 같은 객체 키를 가진 4개의 객체가 있다고 가정해 보겠습니다.

  • Development/Projects.xls

  • Finance/statement1.pdf

  • Private/taxdocument.pdf

  • to-dos.doc

Lightsail 콘솔은 키 이름 접두사 Development/ (Finance/, Private/ 및) 와 구분자 / () 를 사용하여 폴더 구조를 표시합니다. to-dos.doc 키 이름에는 접두사가 없으므로, 이 객체는 버킷의 루트 수준에 표시됩니다. Lightsail 콘솔에서 Development/ 폴더를 탐색하면 객체가 표시됩니다. Projects.xls Finance/ 폴더에는 statement1.pdf 객체가 표시되고, Private/ 폴더에는 taxdocument.pdf 객체가 표시됩니다.

Lightsail 콘솔에서는 키 이름 접두사와 구분자 값을 키 이름으로 사용하여 0바이트 객체를 생성하여 폴더를 생성할 수 있습니다. 이러한 폴더 객체는 콘솔에 표시되지 않습니다. 그러나 다른 객체처럼 동작합니다. Amazon S3API, AWS Command Line Interface (AWS CLI) 또는 AWS SDKs 을 사용하여 이를 보고 조작할 수 있습니다.

객체 키 명명 지침

객체 키 이름에는 UTF -8자를 아무거나 사용할 수 있습니다. 하지만 특정 문자는 키 이름에 사용하면 일부 애플리케이션 또는 프로토콜에 문제가 발생할 수도 있습니다. 다음 지침은 웹에 적합한 문자DNS, XML 파서 및 기타 항목에 대한 규정 준수를 극대화하는 데 도움이 됩니다. APIs

사용 가능 문자

다음 문자 집합은 일반적으로 키 이름으로 사용해도 문제가 되지 않습니다.

  • 영숫자

    • 0~9

    • a-z

    • A-Z

  • 특수 문자

    • 슬래시(/)

    • 느낌표(!)

    • 하이픈(-)

    • 밑줄(_)

    • 마침표(.)

    • 별표(*)

    • 작은 따옴표(')

    • 여는 괄호(()

    • 닫는 괄호())

다음은 유효한 객체 키 이름의 예입니다.

  • 4my-organization

  • my.great_photos-2014/jan/myvacation.jpg

  • videos/2014/birthday/video1.wmv

중요

객체 키 이름이 단일 마침표 (.) 또는 두 마침표 (..) 로 끝나는 경우 Lightsail 콘솔을 사용하여 객체를 다운로드할 수 없습니다. 키 이름이 하나 또는 두 개의 마침표로 끝나는 객체를 다운로드하려면 Amazon S3 API AWS CLI, 및 를 사용해야 합니다 AWS SDKs. 자세한 내용은 버킷의 객체 다운로드를 참조하세요.

특별한 처리가 필요한 문자

키 이름의 다음 문자는 추가 코드 처리가 필요할 수 있으며 다음과 같이 URL 인코딩하거나 참조해야 할 수 있습니다. HEX 이러한 문자 중 일부는 인쇄가 되지 않으며 브라우저에서 처리하지 못할 수 있으므로 특별한 처리가 필요합니다.

  • 앰퍼샌드(‘&‘)

  • 달러(‘$‘)

  • ASCII문자 범위 00—1F 16진수 (0~31 십진수) 및 7F (십진수 127)

  • '@' 기호(‘@‘)

  • 등호(‘=‘)

  • 세미콜론(‘;")

  • 콜론(‘:‘)

  • 더하기(‘+‘)

  • 공백 – 경우에 따라 중요한 의미가 있는 공백의 순서가 사라질 수 있음(특히 공백이 여러 개 있는 경우)

  • 쉼표(‘,‘)

  • 물음표(‘?‘)

피해야 하는 문자

모든 애플리케이션 간 일관성을 유지하기 위해 상당한 특수 처리가 필요하므로 다음과 같은 문자는 키 이름에서 사용하지 않는 것이 좋습니다.

  • 백슬래시(‘\‘)

  • 왼쪽 중괄호(‘{‘)

  • 인쇄할 수 없는 문자 ASCII (십진수 문자 128~255자)

  • 캐럿(‘^‘)

  • 오른쪽 중괄호(‘}‘)

  • 백분율 문자(‘%‘)

  • 억음 악센트 기호(‘`‘)

  • 오른쪽 대괄호(‘]‘)

  • 인용 부호

  • '보다 큼' 기호(‘>‘)

  • 왼쪽 대괄호(‘[‘)

  • 물결표(‘~‘)

  • '보다 작음' 기호(‘<‘)

  • '파운드' 문자(‘#‘)

  • 세로 막대/파이프(‘|‘)

XML관련 객체 키 제약 조건

end-of-line 처리 XML 표준에 지정된 대로 모든 XML 텍스트는 정규화되어 단일 캐리지 리턴 (ASCII코드 13) 과 캐리지 리턴 바로 뒤에 라인 피드 (ASCII코드 10) 가 단일 라인 피드 문자로 대체됩니다. XML요청 시 객체 키를 올바르게 구문 분석하려면 캐리지 리턴 및 기타 특수 문자를 태그 내에 XML 삽입할 때 해당 XML 엔티티 코드로 바꿔야 합니다. 다음은 이러한 특수 문자 및 대응하는 엔터티 코드의 목록입니다.

  • ' 문자: &apos;

  • ” 문자: &quot;

  • & 문자: &amp;

  • < 문자: &lt;

  • < 문자: &gt;

  • \r 문자: &#13; 또는 &#x0D;

  • \n 문자: &#10; 또는 &#x0A;

다음 예제는 XML 엔티티 코드를 캐리지 리턴을 대체하는 방법으로 사용하는 방법을 보여줍니다. DeleteObjects 요청은 /some/prefix/objectwith\rcarriagereturn 키 파라미터가 있는 객체를 삭제합니다. 여기서 \r은 캐리지 리턴입니다.

<Delete xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
      <Object>
        <Key>/some/prefix/objectwith&#13;carriagereturn</Key>
      </Object>
    </Delete>