최신 업데이트:2025-08-21 15:18:21
이 API는 객체 스토리지에서 파일의 스토리지 유형(등급)을 변환하는 기능을 제공합니다.
이 API를 호출하려면 아래와 같은 형식으로 POST 요청을 전송해야 합니다.
POST /converttype/{param1}/{storageType}
Host: {mgrDomain}
Authorization: {managementcredential}
아래 표는 각 파라미터의 필요 여부와 상세 설명입니다.
| 파라미터 | 필수 | 설명 |
|---|---|---|
param1 |
예 | 스토리지 유형을 변환할 파일을 지정합니다. 포맷: Urlsafe_Base64_Encode(bucket:key)bucket은 스토리지 버킷 이름, key는 파일 이름(경로 포함)입니다.예시: 버킷명이 bucket1, 파일명이 1.jpg라면, 이 파라미터 값은 YnVja2V0MToxLmpwZw==(즉, bucket1:1.jpg의 URL-safe Base64 인코딩)입니다. |
storageType |
예 | 대상 스토리지 유형을 지정합니다. 가능한 값: Standard - 표준 스토리지 IA - 저빈도 스토리지 Archive - 아카이브 스토리지 |
mgrDomain |
예 | 관리 도메인으로, 콘솔의 버킷 개요(Overview)에서 확인할 수 있습니다. 포맷 예: *.v1.wcsapi.com |
managementcredential |
예 | 인증을 위한 관리 인증 정보입니다. 생성 방법에 대한 자세한 사항은 관리 인증 정보 문서를 참고하세요. |
아래는 curl 명령어를 이용한 스토리지 타입 변환 요청 예시입니다.
curl -v -X POST "http://mgrDomain/converttype/aW1hZ2VzOkltYWdlLnBuZw==/Standard"
성공적으로 변환이 완료되면 아래와 같이 응답합니다.
{"code": 200, "message": "ok"}
변경하려는 스토리지 타입이 기존과 동일하거나, 원본 파일이 아카이브 스토리지(Archive)인데 먼저 복원하지 않은 경우:
{"code": 403, "message": "Invalid Object State"}
파일이 존재하지 않는 경우:
{"code": 403, "message": "File Not Found"}
| 필드명 | 필수 | 설명 |
|---|---|---|
| code | 예 | HTTP 요청 응답 코드. 응답 상태 코드 참고 |
| message | 예 | 요청 결과 메시지. "ok"는 성공을 의미합니다. |