다큐멘트 센터 Object Storage API Convert Storage Classes

Convert Storage Classes

최신 업데이트:2024-06-18 17:11:47

이 API는 개발자에게 객체 스토리지에서 파일 저장 유형을 변환할 수 있는 기능을 제공합니다.

요청 구문

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

POST /converttype/{encodedEntry}/{storageType}
Host: {mgrDomain}
Authorization: {accessToken}

매개변수 설명

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

매개변수 필수여부 설명
param1 저장 유형을 변환해야 하는 파일을 지정합니다. 형식은 Urlsafe_Base64_Encode(bucket:key)로, bucket은 저장 버킷의 이름이고 key는 파일 이름(경로 포함)입니다. 예를 들어, 버킷 bucket1에 있는 파일 1.jpg의 저장 유형을 변환하려면 이 매개변수는 YnVja2V0MToxLmpwZw==이 되어야 합니다. 이는 bucket1:1.jpg의 URL 안전한 Base64 인코딩 형식입니다.
storageType 대상 저장 유형을 지정합니다. 사용 가능한 저장 유형은 다음과 같습니다:
Standard - 표준 스토리지
IA - 드문 액세스 스토리지
Archive - 아카이브 스토리지
mgrDomain 관리 도메인입니다. 관리 도메인은 버킷의 개요 섹션에서 찾을 수 있습니다. 형식은 보통 *.v1.wcsapi.com입니다.
accessToken 관리 자격 증명으로도 알려져 있으며, API 호출에서 인증에 사용됩니다. 관리 자격 증명 생성에 대한 자세한 내용은 관리 자격 증명을 참조하십시오.

요청 예시

다음 예시는 curl 명령어를 사용하여 저장 유형을 변환하는 요청을 시작하는 방법을 보여줍니다:

curl -v -X POST "http://mgrDomain/converttype/aW1hZ2VzOkltYWdlLnBuZw==/Standard"

응답 설명

성공적인 요청

성공적인 요청 후 응답은 다음과 같습니다:

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

실패한 요청

대상 저장 유형이 원래 저장 유형과 동일하거나, 원래 파일이 아카이브 스토리지에 있고 먼저 해동되지 않은 경우 응답은 다음과 같습니다:

{"code": 403, "message": "Invalid Object State"}

파일이 존재하지 않는 경우 응답은 다음과 같습니다:

{"code": 403, "message": "File Not Found"}
이 문서의 내용이 도움이 되었습니까?
아니오
정상적으로 제출되었습니다.피드백을 주셔서 감사합니다.앞으로도 개선을 위해 노력하겠습니다.