최신 업데이트: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"}
{"code": 401, "message": "Invalid Object State"}
{"code": 409, "message": "Restore Is InProgress"}
{"code": 403, "message": "Unsupported Operation"}
{"code": 404, "message": "File Not Found"}
{
"code": "<httpCode int>",
"message": "<errMsg string>"
}
| 필드명 | 필수 | 설명 |
|---|---|---|
| code | 예 | HTTP 요청 응답 코드. HTTP 응답 상태 코드 참고 |
| message | 예 | 요청 결과 메시지. OK는 성공을 의미합니다. |