Move Resource
최신 업데이트：2025-08-18 15:32:38
이 인터페이스는 지정한 리소스를 다른 버킷으로 이동하거나 같은 버킷 내에서 이름을 변경할 수 있도록 지원합니다.
참고: m3u8 파일 이동 시 ts 파일은 함께 이동되지 않습니다.
요청 설명
POST /fmgr/move
HOST: <MgrDomain>
Authorization:<accessToken>
헤더 설명
| 파라미터 | 필수 | 설명 |
|---|---|---|
| HOST | 예 | 관리 도메인 이름, 콘솔의 버킷 개요에서 확인 가능 |
| Authorization | 예 | 관리 인증 정보 |
파라미터 설명
요청 파라미터는 아래와 같은 형식으로 본문에 포함시켜 전송합니다.
fops=resource/<EncodeEntryURI>/bucket/<Urlsafe_Base64_Encoded_bucket>/key/<Urlsafe_Base64_Encoded_key>/prefix/<Urlsafe_Base64_Encoded_prefix>¬ifyURL=<Urlsafe_Base64_Encoded_notifyUrl>&separate=<Separate>
| 파라미터 | 필수 | 설명 |
|---|---|---|
| fops | 예 | 처리 파라미터 리스트. 위의 포맷을 사용하며 ;(세미콜론)으로 여러 요청을 동시에 지정할 수 있습니다. |
| resource | 예 | 공간명 및 리소스명을 지정. 포맷: <bucket>:<key>(디렉터리 이동 미지원). <EncodeEntryURI>는 해당 리소스를 URL-safe Base64로 인코딩한 값입니다. |
| bucket | 예 | 대상 버킷 지정. <Urlsafe_Base64_Encoded_bucket>는 버킷명을 URL-safe Base64로 인코딩한 값입니다. |
| key | 아니오 | 저장할 파일명(키) 지정. 같은 공간(버킷)으로 이동시 원본과 다른 이름이어야 함. <Urlsafe_Base64_Encoded_key>는 파일명을 URL-safe Base64로 인코딩한 값입니다.참고: 다른 공간으로 이동 시 key 미지정 시 원본 이름 사용. |
| prefix | 아니오 | 키(파일명)의 접두어 지정. <Urlsafe_Base64_Encoded_prefix>는 접두어를 URL-safe Base64로 인코딩한 값입니다.참고: prefix 지정 시 최종 파일명은 prefix/key 형태. |
| notifyURL | 아니오 | 처리 결과 알림 URL. 알림 포맷은 작업 조회 인터페이스 반환 내용 참고. |
| force | 아니오 | 강제 처리 여부. 1: 기존 결과 덮어쓰며 강제 처리, 0: 기존 결과 있으면 재처리하지 않음(기본값 0) |
| separate | 아니오 | 명령별 개별 알림 여부. 1: 각 명령 처리 후 notifyURL 알림, 0: 전체 다 끝난 뒤 한번만 알림(기본값 0) |
fops 파라미터 예시
fops=resource/bXlidWNrZXQ6YWEuanBn/bucket/bXlidWNrZXQy;resource/bXlidWNrZXQ6YWEuanBn/bucket/bXlidWNrZXQy/key/YWJjL2FhLmpwZw==/prefix/ZGlyYWEv¬ifyURL=aHR0cDovL3Rlc3QuY29tL25vdGlmeVVSbA==&separate=1
응답 설명
- 요청에 성공하면 아래와 같이
Json문자열 형식으로 응답됩니다.
{ "persistentId": <persistentId> }
| 필드명 | 필수 | 설명 |
|---|---|---|
| persistentId | 예 | 작업 처리 ID. 해당 ID로 작업 진행 상태를 조회할 수 있습니다. |
- 요청에 실패하면 아래와 같은
Json문자열이 반환됩니다:
{
"code": "<code string>",
"message": "<ErrMsg string>"
}
| 필드명 | 필수 | 설명 |
|---|---|---|
| code | 예 | HTTP 요청 응답 코드. HTTP 상태 코드 참고 |
| message | 예 | 요청 실패 안내 메시지 |
요청 예시
curl -v -X POST -d "fops=resource/bXlidWNrZXQ6YWFjLmpwZw==/bucket/bXlidWNrZXQy;resource/bXlidWNrZXQ6YWEuanBn/bucket/bXlidWNrZXQy/key/YWJjL2FhLmpwZw==/prefix/ZGlyYWEv¬ifyURL=aHR0cDovL3Rlc3QuY29tL25vdGlmeVVSbA==&separate=1" -H "Authorization:86622e227a50d49d858c2494a935bc2e4ac543a7:Y2JmMGY0YTNhZmQxZmVlZGM2ZTA0YTdjNTcyOWQ1NjRkNTExYjg0Yg==" --url "http://mgrDomain/fmgr/move"
이 문서의 내용이 도움이 되었습니까?
예
아니오