Get File Info

최신 업데이트:2025-08-18 15:32:11

이 인터페이스는 오브젝트 스토리지 플랫폼에서 파일의 정보(파일 이름, 크기, ETag, 업로드 시간, 만료 시간 등)를 조회할 때 사용됩니다.

요청 설명

요청 형식

GET /stat/{param1}
Host: <MgrDomain>
Authorization: <AccessToken>

헤더 설명

파라미터 필수 설명
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=="
이 문서의 내용이 도움이 되었습니까?
예
아니오
정상적으로 제출되었습니다.피드백을 주셔서 감사합니다.앞으로도 개선을 위해 노력하겠습니다.