Copy Resource
최신 업데이트：2025-08-18 15:32:35
이 인터페이스는 지정한 리소스를 새 이름으로 복사할 수 있도록 합니다.
참고: m3u8 파일을 복사할 경우 ts 파일은 함께 복사되지 않습니다.
요청 설명
POST /fmgr/copy
HOST: <MgrDomain>
Authorization: <accessToken>
헤더 설명
| 파라미터 | 필수 | 설명 |
|---|---|---|
| HOST | 예 | 관리 도메인 이름, 콘솔의 버킷 개요에서 확인 가능 |
| Authorization | 예 | 관리 인증 정보 |
파라미터 설명
요청 파라미터는 아래와 같은 형식으로 구성되며, 본문(request content)으로 전달합니다.
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로 인코딩한 값입니다. |
| prefix | 아니오 | 리소스 파일명의 prefix 지정. <Urlsafe_Base64_Encoded_prefix>는 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. 작업 진행 상태 조회에 사용. |
- 요청이 실패하면 아래와 같은 내용이 반환됩니다:
{
"code": "<code string>",
"message": "<ErrMsg string>"
}
| 필드명 | 필수 | 설명 |
|---|---|---|
| code | 예 | HTTP 요청 응답 코드. HTTP 상태 코드 참고 |
| message | 예 | 요청 실패 안내 메시지 |
요청 예시
curl -v -X POST -d "fops=resource/bXlidWNrZXQ6YWEuanBn/bucket/bXlidWNrZXQy;resource/bXlidWNrZXQ6YWEuanBn/bucket/bXlidWNrZXQy/key/YWJjL2FhLmpwZw==/prefix/ZGlyYWEv¬ifyURL=aHR0cDovL3Rlc3QuY29tL25vdGlmeVVSbA==&separate=1" -H "Authorization:86622e227a50d49d858c2494a935bc2e4ac543a7:Y2JmMGY0YTNhZmQxZmVlZGM2ZTA0YTdjNTcyOWQ1NjRkNTExYjg0Yg==" --url "http://mgrDomain/fmgr/copy"
이 문서의 내용이 도움이 되었습니까?
예
아니오