Queries the information about media refresh or prefetch jobs, such as the job status and filtering conditions.
Operation description
You can query the information about all media files or a specific media file in a refresh or prefetch job.
QPS limits
You can call this operation up to 50 times per second per account. Requests that exceed this limit are dropped and you will experience service interruptions. We recommend that you take note of this limit when you call this operation. For more information, see QPS limits on API operations in ApsaraVideo VoD.
Debugging
Authorization information
Request parameters
Parameter | Type | Required | Description | Example |
---|---|---|---|---|
MediaRefreshJobId | string | Yes | The ID of the refresh or prefetch job. It is the value of the MediaRefreshJobId parameter that is returned from the call to the RefreshMediaPlayUrls operation. | 41d465e31957**** |
MediaId | string | No | The ID of the media file. It is the value of the If you leave this parameter empty, information about all media files in the refresh or prefetch job specified by | ca3a8f6e4957b658067095869**** |
Response parameters
Examples
Sample success responses
JSON
format
{
"RequestId": "25818875-5F78-4AF6-D7393642CA58****",
"MediaRefreshJobs": [
{
"MediaRefreshJobId": "41d465e31957****",
"MediaId": "ca3a8f6e4957b658067095869****",
"TaskType": "Preload",
"FilterPolicy": "{\"Formats\":\"mp4,m3u8\", \"Definitions\":\"HD,SD\", \" StreamType\":\"video\", \"ResultType\":\"Single\", \" SliceFlag\":false, \"SliceCount\": 3}",
"Status": "success",
"SuccessPlayUrls": "https://shenzhen.****.aliyuncdn.com/74401a4f546007bf845cd8840****.m3u8,https://shenzhen.****.aliyuncdn.com/24041e7d13582d86604d8****.m3u8",
"TaskIds": "70422****,9524****",
"ErrorCode": "PreloadQueueFull",
"ErrorMessage": "Preload queue is full, please try again later!",
"UserData": "{\"MessageCallback\":{\"CallbackURL\":\"http://example.aliyundoc.com\"}, \"Extend\":{\"localId\":\"xxx\",\"test\":\"www\"}}",
"GmtCreate": "2022-05-20T08:23:22Z",
"GmtModified": "2022-05-21T08:23:22Z"
}
]
}
Error codes
For a list of error codes, visit the Service error codes.
Change history
Change time | Summary of changes | Operation |
---|---|---|
2022-03-31 | Add Operation | View Change Details |