객체 키(ObjectKey)는 버킷 내 객체의 고유 식별자로, 일반적으로 파일 경로로 이해할 수 있습니다. 예를 들어 객체 키가 doc/picture.jpg인 경우, 이는 이미지 파일 picture.jpg가 COS의 doc 경로(또는 폴더)에 저장되어 있음을 의미합니다.
객체 키를 나열하면 지정된 객체 키로 특정 객체를 검색할 수 있습니다. 또한 객체 키 접두사로 객체를 검색할 수도 있습니다. 즉, 객체 키 앞부분의 일부(예: doc)를 지정하여 동일한 접두사 doc를 가진 모든 객체를 찾을 수 있습니다.
적용 시나리오
Tencent Cloud COS는 접두사 순서대로 객체 키를 나열하는 것을 지원합니다. 또한 객체 키에 / 문자를 사용하여 기존 파일 시스템과 유사한 계층 구조를 구현할 수 있으며, COS는 구분자를 사용한 계층 구조 선택 및 탐색도 지원합니다.
단일 버킷 내의 모든 객체 키를 나열할 수 있으며, 접두사의 UTF-8 바이너리 순서에 따라 나열하거나 특정 접두사를 지정하여 객체 키 목록을 필터링할 수 있습니다. 예를 들어 매개변수 t를 추가하면 tencent로 시작하는 객체를 나열하고 a 또는 다른 문자로 시작하는 객체는 건너뜁니다.
/ 구분자를 추가하면 이 구분자에 따라 객체 키가 재구성됩니다. 접두사와 구분자를 결합하여 폴더 검색과 유사한 기능을 구현할 수 있습니다.
Tencent Cloud COS는 단일 버킷에서 무제한의 객체를 지원하므로 객체 키 목록이 매우 길 수 있습니다. 관리 편의를 위해 단일 객체 나열 인터페이스는 최대 1000개의 객체 목록을 반환하며, 잘림 여부를 알려주는 표시기도 함께 반환됩니다. 잘림이 있는 경우 다음 페이지에 더 많은 객체 목록이 존재함을 의미합니다. 표시기와 구분자를 활용하여 객체 키 나열 요청을 여러 번보낼 수 있어 모든 객체 키를 나열하거나 필요한 내용을 조회할 수 있습니다.
사용 방법
COS 콘솔 사용하기
COS 콘솔은 접두사 검색과 퍼지 검색을 지원합니다.
접두사 검색: 동일한 객체 접두사를 기준으로 검색하여 동일한 객체 접두사를 가진 객체 및 폴더의 검색 결과를 표시합니다.
퍼지 검색: 사용자 정의 키워드를 기준으로 검색하여 해당 키워드를 포함하는 객체 및 폴더의 검색 결과를 표시합니다.
설명:
객체 검색 시 입력하는 객체 접두사는 영문 대소문자를 구분해야 합니다.
이 외에도 COSBrowser 도구를 사용하여 퍼지 검색을 할 수 있으며, 자세한 내용은 COSBrowser 소개를 참고하십시오.
