UpdateMedia API は、タイトル、説明、カテゴリといったメディアセットの基本情報を更新します。本 API はすべてを更新します。各属性を設定する必要があります。設定されなかった場合は、NULL 値で上書きされます。

リクエスト パラメーター

パラメーター データ型 必須 説明
Action String はい 操作 API、システム必須パラメーター。パラメーターの値は UpdateMedia にします。
MediaId String はい メディア ID
Title String いいえ メディアのタイトル。設定されない場合、本パラメーターは削除されます。パラメーター値は、UTF-8 符号化された最大 128 バイトにします。
Description String いいえ 説明。設定されない場合、本パラメーターは削除されます。パラメーター値は、UTF-8 符号化された最大 1024 バイトにします。
CateId Long いいえ カテゴリ ID。設定されない場合、本パラメーターは削除されます。パラメーター値を負の数値にすることはできません。
Tags String いいえ コンマ (,) で区切られたタグのリスト。最大 16 個のタグを入力できます。各タグの名前は、UTF-8 符号化された最大 32 バイトにします。
CoverURL String いいえ カバー。URL 形式は RFC 2396 標準に準拠し、UTF-8 および URL エンコードで符号化された、最大 3200 バイトにします。

応答パラメーター

パラメーター データ型 説明
Media Media メディア

例

リクエスト例

    http://mts.cn-hangzhou.aliyuncs.com?Title=hello&<public parameter>

応答例

XML 形式

    <UpdateMediaResponse>
      <Media>
        <Format>mov,mp4,m4a,3gp,3g2,mj2</Format>
        <PublishState>Published</PublishState>
        <File>
          <State>Normal</State>
          <URL>http://zzzinput-test.oss-cn-hangzhou.aliyuncs.com/output-2016-01-07-09%3A37%3A17.mp485191.mp4</URL>
        </File>
        <Height>1080</Height>
        <MediaId>3e1cd21131a94525be55acf65888bf46</MediaId>
        <Title>hello</Title>
        <CreationTime>2016-09-14T08:30:33Z</CreationTime>
        <RunIdList>
          <RunId>47b42486019c4f688bf144c1a6ba059a</RunId>
        </RunIdList>
        <CateId>0</CateId>
        <Duration>7.965000</Duration>
        <Width>1920</Width>
        <Fps>25.0</Fps>
        <Bitrate>2659.326</Bitrate>
        <Size>2647692</Size>
      </Media>
      <RequestId>C876E3A4-4CA1-40E7-BB29-D541E6B9D9D9</RequestId>
    </UpdateMediaResponse>

JSON 形式

    {
        "Media": {
            "Format": "mov,mp4,m4a,3gp,3g2,mj2", 
            "PublishState": "Published", 
            "File": {
                "State": "Normal", 
                "URL": "http://zzzinput-test.oss-cn-hangzhou.aliyuncs.com/output-2016-01-07-09%3A37%3A17.mp485191.mp4"
            }, 
            "Height": "1080", 
            "MediaId": "3e1cd21131a94525be55acf65888bf46", 
            "Title": "hello", 
            "CreationTime": "2016-09-14T08:30:33Z", 
            "RunIdList": {
                "RunId": [
                    "47b42486019c4f688bf144c1a6ba059a"
                ]
            }, 
            "CateId": 0, 
            "Duration": "7.965000", 
            "Width": "1920", 
            "Fps": "25.0", 
            "Bitrate": "2659.326", 
            "Size": "2647692"
        }, 
        "RequestId": "C481C0BC-FD8F-448B-8C67-1C48716764D1"
    }