다큐멘트 센터 Object Storage API Query Persistent Processing Status

Query Persistent Processing Status

최신 업데이트:2025-08-20 13:57:28

이 API는 CDNetworks 오브젝트 스토리지 플랫폼에서 오디오/비디오 트랜스코딩, 압축 해제 등과 같은 영구 처리 작업의 상태를 조회하는 데 사용됩니다.

참고:
오디오/비디오 트랜스코딩 서비스에 대한 자세한 내용은 비디오 트랜스코딩오디오 트랜스코딩을 참조하세요.

요청 설명

GET /status/get/prefop?persistentId=<persistentId>
HOST: <MgrDomain>

파라미터 설명

파라미터 필수 설명
Host 관리 도메인, 콘솔의 버킷 개요(Overview)에서 확인 가능
persistentId 업로드 전처리/영구 처리 트리거 API에서 반환되는 persistentId

응답 설명

  • 요청이 성공하면 다음 형식의 JSON 객체가 반환됩니다:
{
	"id": "<id string>",
	"code": "<code int>",
	"desc": "<desc string>",
	"separate": "<separate int>",
	"inputkey": "<inputkey string>",
	"inputbucket": "<inputbucket string>",
	"inputfsize": "<inputfsize int>",
	"items": [{
		"cmd": "<cmd string>",
		"code": "<code string>",
		"costTime": "<costTime int>",
		"desc": "<desc string>",
		"error": "<error string>",
		"fsize": "<fsize int>",
		"hash": "<hash string>",
		"key": "<key string>",
		"url": "<url string>",
		"duration": "<duration double>",
		"bit_rate": "<bit_rate string>",
		"resolution": "<resolution string>",
		"detail": [{
			"fsize": "<fsize int>",
			"tssize": "<tssize int>",
			"hash": "<hash string>",
			"key": "<key string>",
			"url": "<url string>",
			"duration": "<duration double>",
			"bit_rate": "<bit_rate string>",
			"resolution": "<resolution string>"
		}]
	}]
}

필드 설명

최상위 필드

필드명 타입 설명
id string 업로드 전처리/영구 처리 API에서 반환되는 persistentId
code int 처리 상태 코드: 0-대기, 1-처리중, 3-완료, 4-알림중, 5-알림실패, 6-알림성공
desc string 상태 코드에 대한 상세 설명
separate int 알림 옵션. 0: 일괄 알림, 1: 분리(개별) 알림
inputkey string 원본 파일명
inputbucket string 원본 파일의 스토리지 버킷
inputfsize int 원본 파일 크기
items array 각 처리 작업의 상태 정보(복수 처리 요청 시 여러 항목 존재)

items 배열 내 필드

필드명 타입 설명
cmd string 처리 명령(ops)
code string 처리 결과 상태 코드:
0-대기
1-처리중
2-실패
3-성공
4-알림중
5-알림실패
6-알림성공
18-실패(알림중)
19-실패(알림실패)
20-실패(알림성공)
costTime int 트랜스코딩 소요 시간(특정 시나리오 제외 기본값 0)
desc string 상태 코드에 대한 상세 설명
error string 처리 실패 시 실패 원인
fsize int 결과 파일 크기
hash string 결과 파일의 해시값
key string 처리 결과의 key
url string 리소스 접근 경로
duration double 트랜스코딩 출력 영상의 지속 시간
bit_rate string 트랜스코딩 출력 영상의 비트레이트
resolution string 트랜스코딩 출력 영상의 해상도
detail array 복수 파일 출력(m3u8 등에서 여러 ts segment 등)일 때 각 파일 상세 정보

detail 배열 내 필드

필드명 타입 설명
fsize int 결과 파일 크기; m3u8일 경우 m3u8 파일 크기
tssize int m3u8일 경우 ts 파일 총크기; m3u8이 아니면 0
hash string 결과 파일의 해시값
key string 파일 키
url string 접근 URL
duration double 영상 길이
bit_rate string 비트레이트
resolution string 해상도
  • 요청이 실패하면 아래의 JSON 포맷으로 반환됩니다:
{
  "code": "<httpCode int>",
  "message": "<errMsg string>"
}
필드명 필수 설명
code HTTP 응답 코드. HTTP 응답 상태 코드 참고
message 에러 메시지

요청 예시

curl -v "http://mgrDomain/status/get/prefop?persistentId=e534f75d41534f468a7efe9a51dc90ad"
이 문서의 내용이 도움이 되었습니까?
아니오
정상적으로 제출되었습니다.피드백을 주셔서 감사합니다.앞으로도 개선을 위해 노력하겠습니다.