Delete Resource
최신 업데이트：2025-08-18 15:32:42
이 인터페이스는 지정한 리소스를 삭제하는 기능을 제공합니다.
주의:
- 파일 삭제 후 복구가 불가하니 신중하게 작업해 주세요.
- m3u8 파일을 삭제해도 ts 파일은 함께 삭제되지 않습니다. 연동 삭제가 필요하다면 m3u8 파일 삭제 인터페이스를 사용하세요.
요청 설명
POST /fmgr/delete
HOST: <MgrDomain>
Authorization:<accessToken>
헤더 설명
| 파라미터 | 필수 | 설명 |
|---|---|---|
| HOST | 예 | 관리 도메인 이름, 콘솔의 버킷 개요에서 확인 가능 |
| Authorization | 예 | 관리 인증 정보 |
파라미터 설명
요청 파라미터는 다음과 같은 형식으로 request content(본문)에 담아 전송합니다.
fops=bucket/<Urlsafe_Base64_Encoded_bucket>/key/<Urlsafe_Base64_Encoded_key>¬ifyURL=<Urlsafe_Base64_Encoded_notifyUrl>&separate=<Separate>
| 파라미터 | 필수 | 설명 |
|---|---|---|
| fops | 예 | 처리 파라미터 리스트. 위 포맷을 따르며, 여러 요청을 동시에 지정할 수 있습니다(각 파라미터 세트는 세미콜론(;)으로 구분). 참고: 지정한 리소스가 존재하지 않을 때에도 "삭제 성공"을 반환합니다. |
| bucket | 예 | 버킷 이름. <Urlsafe_Base64_Encoded_bucket>는 버킷명을 URL-safe Base64로 인코딩한 값입니다. |
| key | 예 | 삭제할 리소스의 키(파일명). <Urlsafe_Base64_Encoded_key>는 키를 URL-safe Base64로 인코딩한 값입니다. |
| notifyURL | 아니오 | 처리 결과를 알림 받을 URL. 알림 내용 형식은 작업 조회 인터페이스 반환 내용을 참고하세요. |
| separate | 아니오 | 명령별 개별 알림 여부. 1: 각 명령마다 notifyURL 알림, 0: 모든 명령 처리 후 한 번만 알림(기본값은 0) |
fops 파라미터 예시
fops=bucket/bXlidWNrZXQ=/key/bXlkaXIvYWFjLmpwZw==;bucket/bXlidWNrZXQ=/key/bXlkaXIvYWFiLmpwZw==¬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=bucket/bXlidWNrZXQ=/key/bXlkaXIvYWFjLmpwZw==;bucket/bXlidWNrZXQ=/key/bXlkaXIvYWFiLmpwZw==¬ifyURL=aHR0cDovL3Rlc3QuY29tL25vdGlmeVVSbA==&separate=1" -H "Authorization:86622e227a50d49d858c2494a935bc2e4ac543a7:Y2JmMGY0YTNhZmQxZmVlZGM2ZTA0YTdjNTcyOWQ1NjRkNTExYjg0Yg==" --url "http://mgrDomain/fmgr/delete"
이 문서의 내용이 도움이 되었습니까?
예
아니오