メディアファイルの基本情報を更新します。
操作説明
この操作で更新可能な基本情報には、メディアファイルのタイトル、説明、カテゴリが含まれます。本操作はフルアップデートを対象としており、特定のパラメーターの値を NULL で置き換える場合を除き、すべてのパラメーターを設定する必要があります。
QPS 制限
アカウントあたり、1 秒間に最大 100 回まで本操作を呼び出すことができます。この制限を超えたリクエストは破棄され、サービス中断が発生します。本操作を呼び出す際には、この制限を十分にご確認ください。詳細については、「QPS 制限」をご参照ください。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
mts:UpdateMedia |
update |
*All Resource
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| MediaId |
string |
必須 |
基本情報を更新するメディアファイルの ID です。メディアファイルの ID を取得するには、ApsaraVideo Media Processing (MPS) コンソールにログインし、左側ナビゲーションウィンドウから メディア管理 > メディア一覧 を選択します。 |
3e1cd21131a94525be55acf65888**** |
| Title |
string |
任意 |
メディアファイルのタイトルです。英字、数字など、複数の文字種がサポートされます。
|
hello |
| Description |
string |
任意 |
メディアファイルの説明です。英字、数字など、複数の文字種がサポートされます。
|
example description |
| CoverURL |
string |
任意 |
サムネイルの URL です。このパラメーターは、サムネイルの保存場所を指定するために使用します。URL を取得するには、MPS コンソールにログインし、左側ナビゲーションウィンドウから ワークフロー > メディアバケット を選択します。または、OSS コンソールにログインし、左側ナビゲーションウィンドウから バケット をクリックします。
|
http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/test****.jpg |
| CateId |
integer |
任意 |
メディアファイルが属するカテゴリの ID です。値は整数である必要があります。
|
1 |
| Tags |
string |
任意 |
メディアファイルに追加するタグです。
|
tag1,tag2 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
レスポンスパラメーターです。 |
||
| RequestId |
string |
リクエストの ID です。 |
6A88246F-C91F-42BD-BABE-DB0DF993F960 |
| Media |
object |
メディアファイルの情報です。 |
|
| CreationTime |
string |
メディアファイルが作成された時刻です。 |
2016-09-14T08:30:33Z |
| CateId |
integer |
メディアファイルが属するカテゴリの ID です。 |
1 |
| Height |
string |
メディアファイルの高さです。 |
1080 |
| CensorState |
string |
メディアファイルの審査状態です。有効な値は以下のとおりです。
|
Initiated |
| Tags |
object |
||
| Tag |
array |
タグの情報です。 |
|
|
string |
メディアファイルに追加するタグです。 |
tag1,tag2 |
|
| Bitrate |
string |
メディアファイルのビットレートです。 |
2659.326 |
| MediaId |
string |
メディアファイルの ID です。 |
3e1cd21131a94525be55acf65888**** |
| File |
object |
入力ファイルの情報です。 |
|
| State |
string |
入力ファイルの状態です。有効な値は以下のとおりです。
|
Normal |
| URL |
string |
入力メディアファイルが格納されている OSS バケットの名前です。 |
http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4 |
| PublishState |
string |
メディアファイルの公開状態です。有効な値は以下のとおりです。
|
Published |
| Description |
string |
メディアファイルの説明です。 |
example description |
| Width |
string |
メディアファイルの幅です。 |
1920 |
| Size |
string |
メディアファイルのサイズです。 |
2647692 |
| CoverURL |
string |
サムネイルの URL です。 |
http://example-bucket-****.oss-cn-shanghai.aliyuncs.com/example-****.jpg |
| RunIdList |
object |
||
| RunId |
array |
メディアワークフロー実行インスタンスの ID です。 |
|
|
string |
メディアワークフロー実行インスタンスの ID です。 |
{"RunId":["47b42486019c4f688bf144c1a6ba****"]} |
|
| Duration |
string |
メディアファイルの再生時間です。 |
7.965000 |
| Fps |
string |
メディアファイルのフレームレートです。 |
25.0 |
| Title |
string |
メディアファイルのタイトルです。 |
hello |
| Format |
string |
メディアファイルのフォーマットです。有効な値は、mov、mp4、m4a、3gp、3g2、mj2 です。 |
mov |
例
成功レスポンス
JSONJSON
{
"RequestId": "6A88246F-C91F-42BD-BABE-DB0DF993F960",
"Media": {
"CreationTime": "2016-09-14T08:30:33Z",
"CateId": 1,
"Height": "1080",
"CensorState": "Initiated",
"Tags": {
"Tag": [
"tag1,tag2"
]
},
"Bitrate": "2659.326",
"MediaId": "3e1cd21131a94525be55acf65888****",
"File": {
"State": "Normal",
"URL": "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4"
},
"PublishState": "Published",
"Description": "example description",
"Width": "1920",
"Size": "2647692",
"CoverURL": "http://example-bucket-****.oss-cn-shanghai.aliyuncs.com/example-****.jpg",
"RunIdList": {
"RunId": [
"{\"RunId\":[\"47b42486019c4f688bf144c1a6ba****\"]}"
]
},
"Duration": "7.965000",
"Fps": "25.0",
"Title": "hello",
"Format": "mov"
}
}エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。