최신 업데이트: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"}