최신 업데이트: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"