Restore Object_API_Object Storage-Documentation

이 API는 아카이브 스토리지 유형에 저장된 파일을 복원할 수 있습니다. 복원된 후에는 이러한 아카이브된 파일에 직접 액세스할 수 있습니다.

요청 구문

이 API를 호출하려면 다음 형식으로 POST 요청을 보냅니다:

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

다음 표는 매개변수에 대한 필수 정보와 설명을 제공합니다:

매개변수	필수여부	설명
`encodedEntry`	예	복원할 파일을 지정합니다. 형식은 `EncodeEntryURI(bucket:key)`로, `bucket`은 저장 버킷의 이름이고 `key`는 파일 이름(경로 포함)입니다. 예를 들어, `YnVja2V0MToxLmpwZw==`은 `bucket1:1.jpg`의 URL 안전한 Base64 인코딩 형식입니다.
`days`	예	복원 후 파일에 액세스할 수 있는 기간으로, 최소 1일입니다. 형식이 잘못된 경우 400 오류가 반환됩니다.
`mgrDomain`	예	관리 도메인으로, 관리 도메인은 버킷의 개요 섹션에서 찾을 수 있습니다. 형식은 보통 `*.v1.wcsapi.com`입니다.
`managementcredential`	예	API 호출 시 인증에 사용되는 관리 자격 증명입니다. 관리 자격 증명 생성에 대한 자세한 내용은 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>"
}