Restore Object

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

이 API는 Archive 스토리지 유형에 저장된 파일을 복원하는 기능을 제공합니다. 복원 후에는 해당 아카이브 파일에 직접 접근이 가능합니다.

요청 설명

아래와 같은 형식의 POST 요청을 전송하여 API를 호출할 수 있습니다:

POST /restore/{encodedEntry}/days/{duration}
Host: {mgrDomain}
Authorization: {managementcredential}

파라미터 설명

파라미터 필수 설명
encodedEntry 복원할 파일을 지정합니다. 포맷은 EncodeEntryURI(bucket:key)로,
bucket은 스토리지 버킷 이름, key는 파일명(경로 포함)입니다.
예: YnVja2V0MToxLmpwZw==bucket1:1.jpg를 URL-safe Base64로 인코딩한 값입니다.
days 복원된 파일을 접근할 수 있는 기간(최소 1일). 형식이 올바르지 않으면 400 에러를 반환합니다.
mgrDomain 관리 도메인. 버킷의 개요(Overview) 섹션에서 확인할 수 있습니다. 일반적으로 *.v1.wcsapi.com 형태입니다.
managementcredential 인증을 위한 관리 인증정보입니다. 생성 및 활용법은 Management Credential 문서 참고.

요청 예시

다음은 curl을 사용하여 아카이브 파일을 복원하는 요청 예시입니다:

curl -v -X POST "http://{mgrDomain}/restore/aW1hZ2VzOkltYWdlLnBuZw==/days/1"

응답 설명

성공 시

성공적으로 요청이 처리되면 아래와 같이 응답됩니다:

{"code": 200, "message": "ok"}

실패 시

  • 파일이 이미 Standard 스토리지라면:
{"code": 401, "message": "Invalid Object State"}
  • 파일이 이미 복원 중일 경우(중복 요청):
{"code": 409, "message": "Restore Is InProgress"}
  • Archive 스토리지 타입이 아닌 파일에 복원 요청 시:
{"code": 403, "message": "Unsupported Operation"}
  • 파일이 존재하지 않는 경우:
{"code": 404, "message": "File Not Found"}
  • 기타 실패 상황:
{
    "code": "<httpCode int>",
    "message": "<errMsg string>"
}
필드명 필수 설명
code HTTP 요청 응답 코드. HTTP 응답 상태 코드 참고
message 요청 결과 메시지. OK는 성공을 의미합니다.
이 문서의 내용이 도움이 되었습니까?
아니오
정상적으로 제출되었습니다.피드백을 주셔서 감사합니다.앞으로도 개선을 위해 노력하겠습니다.