Delete Resource by Prefix
최신 업데이트：2025-08-18 15:32:44
이 인터페이스는 지정한 prefix와 일치하는(=해당 디렉터리 내의) 리소스를 삭제하는 기능을 제공합니다.
주의:
- 파일 삭제 후에는 복구할 수 없으므로 신중히 작업해 주세요.
- m3u8 파일 삭제 시 ts 파일은 함께 삭제되지 않습니다. 연동 삭제가 필요하면 m3u8 파일 삭제 인터페이스를 사용하세요.
요청 설명
POST /fmgr/deletePrefix
HOST: <MgrDomain>
Authorization:<accessToken>
헤더 설명
| 파라미터 | 필수 | 설명 |
|---|---|---|
| HOST | 예 | 관리 도메인 이름, 콘솔의 버킷 개요에서 확인 가능 |
| Authorization | 예 | 관리 인증 정보 |
파라미터 설명
요청 파라미터는 아래와 같이 구성되어 본문(request content)으로 전송됩니다.
fops=bucket/<Urlsafe_Base64_Encoded_bucket>/prefix/<Urlsafe_Base64_Encoded_prefix>/output/<Urlsafe_Base64_Encoded_output>¬ifyURL=<Urlsafe_Base64_Encoded_notifyUrl>&separate=<Separate>
| 파라미터 | 필수 | 설명 |
|---|---|---|
| fops | 예 | 처리 파라미터 목록. 상기 포맷을 따르며, 여러 작업 동시 지원(세미콜론;로 구분). 참고: 삭제 대상 리소스가 존재하지 않더라도 "삭제 성공"을 반환합니다. |
| bucket | 예 | 버킷 지정. <Urlsafe_Base64_Encoded_bucket>는 버킷명을 URL-safe Base64로 인코딩한 값입니다. |
| prefix | 예 | 삭제할 prefix(즉 디렉터리명). <Urlsafe_Base64_Encoded_prefix>는 prefix를 URL-safe Base64로 인코딩한 값입니다.참고: 퍼지(부분) 매칭은 지원하지 않습니다. prefix가 test라면, test123으로 시작하는 key는 삭제되지 않습니다. |
| output | 아니오 | 처리 결과를 지정 파일에 기록(기본 저장 안 함). 포맷: <bucket>:<key>. <Urlsafe_Base64_Encoded_output>은 해당 값을 URL-safe Base64로 인코딩한 값입니다. 주의: 여러 작업에서 같은 output 지정 시 최신 기록으로 덮어쓰기 됩니다. |
| notifyURL | 아니오 | 처리 결과 통지 받을 URL. 알림 포맷은 작업 조회 인터페이스 반환 예시 참고. |
| separate | 아니오 | 처리 결과별 개별 알림 여부. 1: 각 명령마다 notifyURL 알림, 0: 전체 완료 후 1번만 알림(기본값 0) |
참고: output을 지정하면 결과 파일에는 아래와 같은 정보들이 탭(
\t)으로 구분되어 한 줄씩 기록됩니다.<code> <desc> <bucket> <Urlsafe_Base64_Encoded_key> <Id>
필드명 설명 id 작업 프로세스 ID(현재 API의 persistentId) code 작업 상태 코드: 0-성공, 1-실패 desc 상태 코드에 대한 텍스트 설명 bucket 공간(버킷) 이름 Urlsafe_Base64_Encoded_key 리소스 key의 URL-safe Base64 인코딩 값
fops 파라미터 예시
fops=bucket/bXlidWNrZXQ=/prefix/YWFjLw==;bucket/bXlidWNrZXQ=/prefix/YWFiLw==¬ifyURL=aHR0cDovL3Rlc3QuY29tL25vdGlmeVVSbA==&separate=1
응답 설명
- 요청 성공 시, 아래와 같은
Json문자열이 반환됩니다.
{ "persistentId": <persistentId> }
| 필드명 | 필수 | 설명 |
|---|---|---|
| persistentId | 예 | 작업 프로세스 ID(작업 진행 상태 조회에 사용) |
- 요청 실패 시, 아래 형식의 Json 문자열이 반환됩니다.
{
"code": "<code string>",
"message": "<ErrMsg string>"
}
| 필드명 | 필수 | 설명 |
|---|---|---|
| code | 예 | HTTP 요청 응답 코드. HTTP 응답 상태 코드 참고 |
| message | 예 | 요청 실패 설명 메시지 |
요청 예시
curl -v -X POST -d "fops=bucket/bXlidWNrZXQ=/prefix/YWFjLw==;bucket/bXlidWNrZXQ=/key/bXlkaXIvYWFi¬ifyURL=aHR0cDovL3Rlc3QuY29tL25vdGlmeVVSbA==&separate=1" -H "Authorization:86622e227a50d49d858c2494a935bc2e4ac543a7:Y2JmMGY0YTNhZmQxZmVlZGM2ZTA0YTdjNTcyOWQ1NjRkNTExYjg0Yg==" --url "http://mgrDomain/fmgr/deletePrefix"
이 문서의 내용이 도움이 되었습니까?
예
아니오