다큐멘트 센터 Object Storage API Fetch Resource from Mirror Storage

Fetch Resource from Mirror Storage

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

이 인터페이스는 미러 소스 사이트에서 지정된 리소스를 가져와 미러 스토리지 공간에 저장하는 기능을 제공합니다. 동일한 이름의 리소스가 이미 공간에 존재하는 경우, 해당 리소스는 미러 소스 사이트의 리소스로 완전히 덮어쓰게 됩니다.

요청 설명

요청 경로

POST /prefetch/{param1}
Host: <MgrDomain>
Authorization: <AccessToken>

파라미터 {param1} 생성 규칙

{param1}의 생성 규칙은: 버킷 이름 + “:” + 파일 이름1 | 파일 이름2 | 파일 이름3… 입니다.

결합한 문자열은 URL-safe Base64 인코딩 되어야 합니다.
인코딩 예시:

encode_file_key = Urlsafe_Base64_Encode(<key>)
{param1} = Urlsafe_Base64_Encode(<bucket>:encode_file_key1|encode_file_key2|encode_file_key3)

헤더 설명

파라미터 필수 여부 설명
Host 관리 도메인 이름은 사용자 관리 인터페이스에서 확인할 수 있습니다.
Authorization 관리 인증 정보 입니다.

응답 설명

  • 요청이 성공하면, 다음과 같은 Json 문자열이 반환됩니다:
{
    "bucket":"<bucket string>",
    "items":[
    {
        "key":"<filekey>",
        "mirrorAddress":"<mirrorAddress string>",
        "code":"<code int>",
        "message":"<message string>"
    }]
}
필드명 필수 여부 설명
bucket 버킷 이름
mirrorAddress 미러 소스 주소
code 미러 소스 응답 코드
message 미러 소스 응답 메시지
  • 요청이 실패하면, 다음과 같은 Json 문자열이 반환됩니다:
{
    "code":     "<code string>",
    "message":  "<message string>"
}
필드명 필수 여부 설명
code HTTP 요청 응답 코드, HTTP 응답 상태 코드 참고
message 안내 메시지

예시

curl -v  -X POST -H "Authorization:bea919a5a1bc53d76a9e4340951b0b3692ff2517:YjRmYWI4ZWVkYzNmNDkyYmM2Y2I0NWE2NzVjNjk1Y2NjOGQxYzI3NQ==" –-url http://mgrDomain/prefetch/aW1hZ2U6TVM1cWNHYz18TWk1cWNHYz0=
이 문서의 내용이 도움이 되었습니까?
아니오
정상적으로 제출되었습니다.피드백을 주셔서 감사합니다.앞으로도 개선을 위해 노력하겠습니다.