Delete m3u8 File
최신 업데이트：2025-08-18 15:32:46
이 인터페이스는 지정한 리소스(m3u8 파일)를 삭제하는 기능을 제공합니다.
주의:
- 삭제된 파일은 복구할 수 없으니 신중히 작업해 주세요.
- 삭제 과정에서 일부 ts 파일 삭제가 실패할 수 있습니다. 삭제 실패 알림을 받으면 m3u8 파일 삭제를 성공할 때까지 재시도해야 합니다.
요청 설명
POST /fmgr/deletem3u8
HOST: <MgrDomain>
Authorization:<accessToken>
헤더 설명
| 파라미터 | 필수 | 설명 |
|---|---|---|
| HOST | 예 | 관리 도메인 이름, 콘솔의 버킷 개요에서 확인 가능 |
| Authorization | 예 | 관리 인증 정보 |
파라미터 설명
요청 파라미터는 아래 포맷으로 request content(본문)로 제출합니다.
fops=bucket/<Urlsafe_Base64_Encoded_bucket>/key/<Urlsafe_Base64_Encoded_key>/deletets/<deletets>¬ifyURL=<Urlsafe_Base64_Encoded_notifyUrl>&separate=<Separate>
| 파라미터 | 필수 | 설명 |
|---|---|---|
| fops | 예 | 처리 파라미터 목록. 위 포맷을 따르며, 여러 건 동시 요청(세미콜론 : ; 로 구분) 지원. 참고: 지정한 리소스가 없어도 "삭제 성공"을 반환합니다. |
| bucket | 예 | 버킷 지정. <Urlsafe_Base64_Encoded_bucket>는 버킷명을 URL safe Base64로 인코딩한 값입니다. |
| key | 예 | 삭제할 리소스의 키(파일명). <Urlsafe_Base64_Encoded_key>는 파일명을 URL safe Base64로 인코딩한 값입니다. |
| deletets | 아니오 | 연동된 ts 파일도 삭제 여부. 0: 연동 삭제 안 함 1: 연동 ts 파일도 삭제 참고:<1> 미설정 시 기본적으로 연동 삭제 <2> m3u8 내 TS 접근 경로가 상대경로일 때만 유효(절대경로면 연동 삭제 안 됨) <3> TS 주소가 절대경로인 m3u8 파일은 먼저 m3u8 파일의 내용을 파싱해서 TS 파일을 별도로 삭제 처리하는 것이 권장됩니다. |
| notifyURL | 아니오 | 처리 결과 알림 받을 URL. 알림 포맷은 작업 조회 인터페이스 반환 값 참고. |
| separate | 아니오 | 명령별 개별 알림 여부. 1: 각 명령마다 notifyURL 알림 0: 전체 완료 후 한 번만 알림(기본값 0) |
fops 파라미터 예시
fops=bucket/bXlidWNrZXQ=/key/SW1hZ2UubTN1OA==/deletets/1;bucket/bXlidWNrZXQ=/key/SW1hZ2UxLm0zdTg=/deletets/0¬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/SW1hZ2UubTN1OA==/deletets/1;bucket/bXlidWNrZXQ=/key/SW1hZ2UxLm0zdTg=/deletets/0¬ifyURL=aHR0cDovL3Rlc3QuY29tL25vdGlmeVVSbA==&separate=1" -H "Authorization:86622e227a50d49d858c2494a935bc2e4ac543a7:Y2JmMGY0YTNhZmQxZmVlZGM2ZTA0YTdjNTcyOWQ1NjRkNTExYjg0Yg==" --url "http://mgrDomain/fmgr/deletem3u8"
이 문서의 내용이 도움이 되었습니까?
예
아니오