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

Convert Storage Classes

최신 업데이트: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"는 성공을 의미합니다.
이 문서의 내용이 도움이 되었습니까?
아니오
정상적으로 제출되었습니다.피드백을 주셔서 감사합니다.앞으로도 개선을 위해 노력하겠습니다.