List Resources
최신 업데이트：2025-08-20 11:12:08
이 인터페이스는 객체 스토리지 플랫폼에서 지정된 공간에 있는 리소스를 배치 단위로 나열하는 기능을 제공합니다.
요청 설명
요청 형식
GET /list?bucket=<bucket>&limit=<limit>&prefix=<Urlsafe_Base64_Encoded_Prefix>&mode=<mode>&marker=<marker>
Host:<MgrDomain>
Authorization:<AccessToken>
헤더 설명
| 파라미터 | 필수 여부 | 설명 |
|---|---|---|
| Host | 예 | 관리 도메인 이름으로, 콘솔의 버킷 개요 인터페이스에서 확인할 수 있습니다. |
| Authorization | 예 | 관리 인증 정보 입니다. |
파라미터 설명
| 파라미터 | 필수 여부 | 설명 |
|---|---|---|
| bucket | 예 | 공간을 지정합니다. |
| limit | 아니오 | 한 번에 조회할 목록의 수입니다(1~1000 범위). 기본값은 1000입니다. |
| prefix | 아니오 | 접두어를 지정하면, 해당 접두어와 일치하는 파일명만 나열됩니다. 기본값은 비어있음. 문자열은 URL-safe Base64 인코딩 되어야 합니다. |
| startTime | 아니오 | 파일 업로드 시작 시간, 밀리초 단위의 타임스탬프(예: 1526745600000, 2015/5/20 00:00:00) |
| endTime | 아니오 | 파일 업로드 종료 시간, 밀리초 단위의 타임스탬프(예: 1527609600000, 2015/5/30 00:00:00) |
| mode | 아니오 | 목록 정렬 방식을 지정합니다: 0 - 디렉터리 내 파일 우선, 1 - 디렉터리 내 폴더 우선. 미지정 시, 디렉터리 및 하위 디렉터리의 모든 파일이 키 순서로 나열됩니다. |
| marker | 아니오 | 이전 나열 작업에서 반환된 위치 마커를 이번 나열 작업의 시작점으로 사용합니다. 기본값은 비어있음. |
참고:
- mode 파라미터는 파일 시스템을 시뮬레이션하는 데 사용됩니다.
- mode 파라미터를 지정하면, prefix 파라미터를 통해 조회할 디렉터리를 명확히 지정할 수 있습니다. 이 경우 prefix는 모호한(와일드카드) 검색을 지원하지 않습니다.
- mode 파라미터 미지정 시 prefix 파라미터는 모호한(와일드카드) 검색을 지원합니다.
응답 설명
- 요청이 성공하면, 아래와 같은 내용의
Json문자열이 반환됩니다.
{
"marker": "<marker string>",
"commonPrefixes": [
"xxx",
"yyy"
],
"items": [
{
"key": "<key string>",
"putTime": <filePutTime long>,
"hash": "<fileETag string>",
"fsize": <fileSize string>,
"mimeType": "<mimeType string>",
"expirationDate": "<expirationDate string>",
"storageClass": "<storageClass>"
},
...
]
}
| 필드명 | 필수 여부 | 설명 |
|---|---|---|
| marker | 예 | 남은 엔트리가 있을 경우, 비어 있지 않은 문자열이 반환되며, 다음 조회 요청의 파라미터로 사용됩니다. 남은 엔트리가 없으면 빈 문자열이 반환됩니다. |
| commonPrefixes | 예 | 모든 디렉터리 이름의 배열. mode 파라미터 비지정 시 값은 비어 있습니다. |
| items | 예 | 반환된 모든 엔트리의 배열이며, 더 이상 엔트리가 없을 경우 빈 배열이 반환됩니다. |
| key | 예 | 리소스 이름. |
| putTime | 예 | 업로드 시간, 밀리초 단위의 Unix 타임스탬프. |
| fsize | 예 | 리소스 콘텐츠 크기(바이트 단위). |
| hash | 예 | 리소스의 ETag 값. |
| mimeType | 예 | 리소스의 MIME 타입. |
| expirationDate | 예 | 파일 만료 시간(YYYYMMDDhhmmss 형식). 참고: 파일이 실제로 정리되는 시간은 서버 작업 스케줄에 따라 다를 수 있으며, 하루 이내 시간 차는 정상입니다. |
| storageClass | 예 | 파일 스토리지 유형(예: Standard – 표준 스토리지, IA – 저빈도 스토리지, Archive – 아카이브 스토리지) |
- 요청이 실패한 경우, 아래와 같은 내용의
Json문자열이 반환됩니다.
{
"code": "<code string>",
"message": "<message string>"
}
| 필드명 | 필수 여부 | 설명 |
|---|---|---|
| code | 예 | HTTP 요청 응답 코드, HTTP 응답 상태 코드 참고 |
| message | 예 | 리소스를 나열하지 못한 경우의 안내 메시지 |
예시
curl -v -o filelist.json -H "Authorization:86622e227a50d49d858c2494a935bc2e4ac543a7:NTVjZWZmOThhYjUzMjhkMWQ3YzE3OGM0NTRhYzFmODc5MDQ0MWExNQ==" --url "http://mgrDomain/list?bucket=images&limit=10"
이 문서의 내용이 도움이 되었습니까?
예
아니오