Get File Info
최신 업데이트：2025-08-18 15:32:11
이 인터페이스는 오브젝트 스토리지 플랫폼에서 파일의 정보(파일 이름, 크기, ETag, 업로드 시간, 만료 시간 등)를 조회할 때 사용됩니다.
요청 설명
요청 형식
GET /stat/{param1}
Host: <MgrDomain>
Authorization: <AccessToken>
{param1}: EncodeEntryURI 형식을 참고해 생성해야 합니다.
헤더 설명
| 파라미터 | 필수 | 설명 |
|---|---|---|
| Host | 예 | 관리 도메인, 콘솔 Bucket 개요에서 확인 가능 |
| Authorization | 예 | 관리 인증정보 |
응답 설명
-
요청 성공 시, 아래와 같은 JSON 문자열이 반환됩니다.
(Append 업로드 객체의 경우, 아래 두 가지 헤더가 추가됩니다.)
x-wcs-object-type: Appendable x-wcs-next-append-positon: <Content-Length int64>{ "result": "true", "code": "200", "name": "<fileName string>", "message": "<message string>", "fsize": "<FileSize int>", "hash": "<FileETag string>", "mimeType": "<MimeType string>", "putTime": "<PutTime int64>", "expirationDate": "<ExpirationDate string>", "storageClass": "<storageClass>" }
| 필드명 | 필수 | 설명 |
|---|---|---|
| x-wcs-object-type | 아니오 | append 업로드 객체일 경우 이 헤더가 추가되어 Appendable이 고정 값으로 반환됨 |
| x-wcs-next-append-position | 아니오 | append 업로드 객체일 경우 다음 append 위치(오브젝트 크기) 반환 |
| code | 예 | 요청 결과 상태 코드 (상세 코드 안내) |
| name | 예 | 파일명 |
| message | 예 | 파일 정보 조회 성공 메시지 |
| fsize | 예 | 파일 크기(Byte) |
| hash | 예 | 파일 ETag(해시) |
| mimeType | 예 | 파일의 MIME 타입(자세한 내용은 IANA 공식 문서 참고) |
| putTime | 예 | 파일 업로드 시 서버 타임스탬프(밀리초; 예: 13603956734587420) |
| expirationDate | 예 | 파일 만료시각(YYYYMMDDhhmmss), 청소는 서버 스케줄에 따라 수분~1일 차이 있을 수 있음 |
| storageClass | 예 | 파일 저장 유형(Standard(표준), IA(저빈도), Archive(아카이브) 등) |
| result | 예 | 성공여부, "true"가 성공 |
- 요청 실패 시, 아래와 같은 JSON 문자열이 반환됩니다.
{
"code": "<code string>",
"message": "<ErrMsg string>"
}
| 필드명 | 필수 | 설명 |
|---|---|---|
| code | 예 | HTTP 요청 응답 코드(상세 코드 안내) |
| message | 예 | 파일 정보 조회 실패 시 안내 메시지 |
예시
curl -v -H "Authorization:86622e227a50d49d858c2494a935bc2e4ac543a7:OGZmYzQ0ZmM2MDU5N2FhZWRhMDhjNWNmZjcxZjE5MmEwNjUxOGU4Nw==" --url "http://mgrDomain/stat/aW1hZ2VzOmFmZGRkLnBuZw=="
이 문서의 내용이 도움이 되었습니까?
예
아니오