查询持久化处理状态_API_Object Storage-文档中心

该接口用于查询CDNetworks对象存储平台中音视频转码、解压缩等持久化处理任务的状态。

说明：
有关音视频转码服务的详细信息，请参考视频转码和音频转码。

请求说明

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

参数说明

参数名	是否必填	描述
Host	是	管理域名，可在控制台空间概览界面获取。
persistentId	是	上传预处理或触发持久化处理接口返回的 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	上传预处理或触发持久化处理接口返回的 persistentId。
code	int	处理进展状态码：0-待处理，1-处理中，3-处理完成，4-通知中，5-通知失败，6-通知成功。
desc	string	对应状态码的详细描述。
separate	int	分开通知选项。0表示一次性通知，1表示分开通知。
inputkey	string	原始文件名。
inputbucket	string	原始文件空间。
inputfsize	int	原始文件大小。
items	array	每个操作的状态信息（当请求包含多个操作时，items数组包含多条信息）。

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 片），每个数据文件的具体信息。

detail 内字段

字段名	类型	说明
fsize	int	处理后的文件大小。若输出视频格式为 m3u8 时，表示 m3u8 文件的大小。
tssize	int	输出视频格式为 m3u8 时，表示 ts 文件的总大小；非 m3u8 格式时为 0。
hash	string	处理结果的 hash 值。
key	string	处理结果的 key 值。
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"

Media Delivery

Cloud Security

Web Performance

Enterprise Application

Storage

Edge Computing

Console Guide

API Docs

查询持久化处理状态

请求说明

参数说明

响应说明

字段说明

调用示例

目录