Video On Demand_Huawei Cloud

Help Center/ Video On Demand/ API Reference/

Updated on 2024-04-30 GMT+08:00

View PDF

Querying Hosted Media Asset Details (Not Available Soon)

Function

Queries details about a media asset hosted by OBS

URI

GET /v1.0/{project_id}/asset/obs/host/task/details

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. For details about how to obtain the project ID, see Obtaining a Project ID.

**Table 2** Query Parameters
Parameter	Mandatory	Type	Description
source_bucket	Yes	String	Bucket where the input media asset is stored
source_object	Yes	String	objectKey of the input media asset

Request Parameters

**Table 3** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	No	String	User token. This parameter is mandatory when token authentication is used. It can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is a token.
Authorization	No	String	Authentication information. This parameter is mandatory for AK/SK authentication.
X-Sdk-Date	No	String	Time when the request is sent. This parameter is mandatory for AK/SK authentication.

Response Parameters

Status code: 200

**Table 4** Response body parameters
Parameter	Type	Description
asset_id	String	Media asset ID assigned by VOD. This parameter can only be queried but cannot be modified.
asset_status	String	Media file status CREATING: The file is being uploaded. FAILED: Upload failed. CREATED: The file has been uploaded. PUBLISHED: The file has been published. DELETED: The task has been deleted.
transcode_status	String	Transcoding status UN_TRANSCODE: The file is not transcoded. WAITING_TRANSCODE: The file is to be transcoded. TRANSCODING: The file is being transcoded. TRANSCODE_SUCCEED: Transcoding succeeded. TRANSCODE_FAILED: Transcoding failed.
base_info	BaseInfo object	Basic media file information.
transcode_info	TranscodeInfo object	Information about the transcoded file NOTE: Such information can be queried only after the transcoding succeeded, and is unavailable when the transcoding is not performed, is being performed, or failed.

**Table 5** BaseInfo
Parameter	Type	Description
title	String	Media file title The value is UTF-8-encoded and contains a maximum of 128 characters.
video_name	String	Media asset file name
description	String	Media file description The value contains a maximum of 1024 characters.
category_id	Long	Media asset category ID
category_name	String	Media asset category name
create_time	String	Time when the media file was created The format is yyyymmddhhmmss. The value must be a UTC time irrelevant to the time zone.
last_modified	String	Time when the media file was last modified The format is yyyymmddhhmmss. The value must be a UTC time irrelevant to the time zone.
video_type	String	Audio/Video file type Possible values are: Video files: MP4, TS, MOV, MXF, MPG, FLV, WMV, AVI, M4V, F4V, MPEG, 3GP, ASF, and MKV Audio files: MP3, OGG, WAV, WMA, APE, FLAC, AAC, AC3, MMF, AMR, M4A, M4R, WV, and MP2
tags	String	Media file tag Each tag contains up to 16 characters and up to 16 tags are allowed. Use commas (,) to separate tags. The values are UTF-8-encoded.
meta_data	MetaData object	Video metadata It is generated after video parsing, including the packaging format, size, resolution, bitrate, and frame rate.
video_url	String	URL for accessing the original video file
sign_url	String	Temporary access URL of the original video file in OBS. A specific value is returned only when the API for Querying File Information is called.
cover_info_array	Array of CoverInfo objects	Cover information
subtitle_info	Array of SubtitleInfo objects	Subtitle information array
source_path	File_addr object	Media asset storage parameters.
output_path	File_addr object	Media asset storage parameters.

**Table 6** CoverInfo
Parameter	Type	Description
cover_url	String	URL for downloading the cover file

**Table 7** SubtitleInfo
Parameter	Type	Description
url	String	URL for downloading the subtitle file
id	Integer	Subtitle file ID
type	String	Subtitle file type
language	String	Subtitle file language

**Table 8** File_addr
Parameter	Type	Description
bucket	String	OBS bucket name
location	String	Name of the region where the bucket is located. For example, the region name of CN North-Beijing4 is cn-north-4. The created bucket must be in the region of the VOD service.
object	String	File path

**Table 9** TranscodeInfo
Parameter	Type	Description
template_group_name	String	Name of a transcoding template group
output	Array of Output objects	Array in the output file HLS or DASH: The number of members in this array is n + 1, where n indicates the number of channels in the output file. MP4: The number of members in this array is n, which indicates the number of channels in the output file.
exec_desc	String	Execution description
transcode_status	String	Transcoding status Possible values are: UN_TRANSCODE: The file is not transcoded. WAITING_TRANSCODE: The file is to be transcoded. TRANSCODING: The file is being transcoded. TRANSCODE_SUCCEED: Transcoding succeeded. TRANSCODE_FAILED: Transcoding failed.

**Table 10** Output
Parameter	Type	Description
play_type	String	Protocol type Possible values are: hls dash mp4
url	String	Streaming URL
group_id	String	Transcoding group ID.
group_name	String	Transcoding group name.
encrypted	Integer	Whether the stream is encrypted Possible values are: 0: not encrypted 1: encrypted
quality	String	Definition Possible values are: FLUENT: smooth SD: standard definition (SD) HD: high definition (HD) FULL_HD: ultra-high-definition (UHD)
meta_data	MetaData object	Video metadata It is generated after video parsing, including the packaging format, size, resolution, bitrate, and frame rate.

**Table 11** MetaData
Parameter	Type	Description
pack_type	String	Video container format Possible values are: MP4 TS MOV MXF MPG FLV WMV MP3 WMA APE FLAC AAC AC3 MMF AMR M4A M4R OGG WAV WV MP2 AVI F4V M4V MPEG HLS DASH
codec	String	Video encoding format. Options: MPEG-2 MPEG-4 H.264 H.265 WMV Vorbis AAC AC-3 AMR APE FLAC MP3 MP2 WMA PCM ADPCM WavPack NOTE: If unknown is returned for codec, the current audio/video encoding format sent by the user cannot be parsed.
duration	Long	Video duration. If the value of the original video duration is not an integer, the value of this field is rounded up.
video_size	Long	Video file size Unit: byte
width	Long	Video width, in pixels Possible values for H.264: a multiple of 2 between 32 and 3840 Possible values for H.265: a multiple of 4 between 320 and 3840
hight	Long	Video height, in pixels. Possible values for H.264: a multiple of 2 between 32 and 2,160 Possible values for H.265: a multiple of 4 between 240 and 2,160
bit_rate	Long	Average video bitrate
frame_rate	Long	Frame rate, in FPS Possible values are: FRAMERATE_AUTO = 1, FRAMERATE_10 = 2, FRAMERATE_15 = 3, FRAMERATE_2397 = 4, // 23.97 fps FRAMERATE_24 = 5, FRAMERATE_25 = 6, FRAMERATE_2997 = 7, // 29.97 fps FRAMERATE_30 = 8, FRAMERATE_50 = 9, FRAMERATE_60 = 10 The default value is 1. Unit: FPS
quality	String	Definition Possible values are: FULL_HD: ultra-high-definition (UHD) HD: high definition (HD) SD: standard definition (SD) FLUENT: smooth AD: adaptive 2K 4K
audio_channels	Integer	Number of audio channels

Status code: 403

**Table 12** Response body parameters
Parameter	Type	Description
error_code	String	Error code
error_msg	String	Error description

Example Requests

Queries details about a hosted media file.

GET https://{endpoint}/v1.0/{project_id}/asset/obs/host/task/details?source_bucket={source_bucket}&source_object={source_object}

Example Responses

Status code: 200

The information is returned when the request succeeds.

{
  "asset_id" : "41cff636d5b12a51e7eb2838bbf45201",
  "base_info" : {
    "title" : "Avatar",
    "video_name" : "Video on Demand (VOD).mp4",
    "description" : "Avatar, marketed as James Cameron's Avatar, is a 2009 American\nepic science fiction film directed, written, produced, and\nco-edited by James Cameron",
    "category_id" : -1,
    "category_name" : "Other",
    "create_time" : "20190612032250",
    "last_modified" : "20190613075030",
    "video_type" : "MP4",
    "tags" : "test1,test2",
    "meta_data" : {
      "pack_type" : null,
      "codec" : "H.264",
      "duration" : 131,
      "video_size" : 4942645,
      "width" : 1280,
      "hight" : 720,
      "height" : 720,
      "bit_rate" : 173,
      "frame_rate" : 30
    },
    "video_url" : "https://355.cdn-vod.huaweicloud.com/asset/41cff636d5b12a51e7eb2838bbf45201/5597e59de70722eaeb9b18c274e249b2.mp4",
    "sign_url" : "",
    "cover_info_array" : [ {
      "cover_url" : "https://355.cdn-vod.huaweicloud.com/asset/41cff636d5b12a51e7eb2838bbf45201/cover/Cover0.jpg"
    } ]
  },
  "transcode_info" : {
    "template_group_name" : "system_template_group",
    "output" : [ {
      "play_type" : "HLS",
      "url" : "https://355.cdn-vod.huaweicloud.com/asset/41cff636d5b12a51e7eb2838bbf45201/play_video/index.m3u8",
      "encrypted" : 0,
      "meta_data" : {
        "pack_type" : null,
        "codec" : "H.264",
        "duration" : 0,
        "video_size" : 0,
        "width" : 0,
        "hight" : 0,
        "height" : 0,
        "bit_rate" : 0,
        "frame_rate" : 0
      }
    }, {
      "play_type" : "HLS",
      "url" : "https://355.cdn-vod.huaweicloud.com/asset/41cff636d5b12a51e7eb2838bbf45201/play_video/VODVOD video _1_854X480_600_0.m3u8",
      "encrypted" : 0,
      "quality" : "SD",
      "meta_data" : {
        "pack_type" : null,
        "codec" : "H.264",
        "duration" : 130,
        "video_size" : 7976960,
        "width" : 854,
        "hight" : 480,
        "height" : 480,
        "bit_rate" : 421,
        "frame_rate" : 30000,
        "quality" : "SD"
      }
    }, {
      "play_type" : "DASH",
      "url" : "https://355.cdn-vod.huaweicloud.com/asset/41cff636d5b12a51e7eb2838bbf45201/play_video/index.mpd",
      "encrypted" : 0,
      "meta_data" : {
        "pack_type" : null,
        "codec" : "H.264",
        "duration" : 0,
        "video_size" : 0,
        "width" : 0,
        "hight" : 0,
        "height" : 0,
        "bit_rate" : 0,
        "frame_rate" : 0
      }
    }, {
      "play_type" : "DASH",
      "encrypted" : 0,
      "quality" : "SD",
      "meta_data" : {
        "pack_type" : null,
        "codec" : "H.264",
        "duration" : 130,
        "video_size" : 7976960,
        "width" : 854,
        "hight" : 480,
        "height" : 480,
        "bit_rate" : 421,
        "frame_rate" : 30000,
        "quality" : "SD"
      }
    } ],
    "exec_desc" : "Transcode success",
    "transcode_status" : "TRANSCODE_SUCCEED"
  }
}

Status code: 403

The information is returned when the request fails.

{
  "error_code" : "VOD.10064",
  "error_msg" : "Media asset classification does not exist, please check."
}

Status Codes

Status Code	Description
200	The information is returned when the request succeeds.
403	The information is returned when the request fails.

Error Codes

See Error Codes.

Feedback

Was this page helpful?

Helpful Not helpful

Provide feedback

Thank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.

The system is busy. Please try again later.

Which of the following issues have you encountered?

Content is inconsistent with the product UI

Unclear descriptions

Lack of examples or code

Incorrect steps

Can't find what I need

Lack of best practices

Feedback (optional)

0/500

Select at least one type of issue, and enter your comments or suggestions.

Enter a maximum of 500 characters.

Submit Cancel

For any further questions, feel free to contact us through the chatbot.

Chatbot