UpdateMediaCover - - Alibaba Cloud ドキュメントセンター

メディアファイルのサムネイルを更新します。

使用上の注意

この操作では、メディアファイルのサムネイルのみを更新します。メディアファイルに関するすべての情報を更新する方法の詳細については、「UpdateMedia」をご参照ください。

QPSの制限

この操作は1秒間に最大100回呼び出すことができます。 1秒あたりの呼び出し数が制限を超えると、スロットリングがトリガーされます。その結果、あなたのビジネスが影響を受ける可能性があります。この操作を呼び出すときは、制限に注意することをお勧めします。詳細については、「QPS制限」をご参照ください。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

パラメーター	データ型	必須／任意	例	説明
操作	String	必須	UpdateMediaCover	実行する操作です。値をUpdateMediaCoverに設定します。
MediaId	String	必須	6cc3aa66d1cb4bb2adf14e726c0a ****	サムネイルを更新するメディアファイルのID。メディアファイルのIDを取得するには、AddMedia操作を呼び出します。または、ApsaraVideo Media Processing (MPS) コンソールで次の操作を実行します。左側のナビゲーションウィンドウで、[メディア管理] > [メディアリスト] を選択します。必要なビデオを見つけて、[管理] をクリックします。ビデオのIDが [基本] タブに表示されます。
CoverURL	String	任意	http:// example-bucket-** .oss-cn-hangzhou.aliyuncs.com//example-**.mp4	メディアファイルに指定するサムネイルのURL。 URLはRFC 2396に準拠し、UTF-8でエンコードされます。 URLの長さは最大3,200バイトです。説明 To obtain the thumbnail URL, you can find the image in the Object Storage Service (OSS) bucket and click the image to view details. [詳細表示] パネルで、URLフィールドから疑問符 (?) の前の部分をコピーします。 HTTP URLのみを入力できます。

レスポンスパラメーター

パラメーター	データ型	例	説明
RequestId	String	0DC39B9E-13D4-40BA-AE76-CFF9BD64239D	リクエストの ID です。

例

リクエストの例

http(s):// mts.cn-hangzhou.aliyuncs.com/?Action=UpdateMediaCover
&MediaId=6cc3aa66d1cb4bb2adf14e726c0a ****
&CoverURL=http:// example-bucket-**** .oss-cn-hangzhou.aliyuncs.com//example-****.mp4
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式

HTTP/1.1 200 OK
Content-Type:application/xml

<UpdateMediaCoverResponse>
    <RequestId>0DC39B9E-13D4-40BA-AE76-CFF9BD64239D</RequestId>
</UpdateMediaCoverResponse>

JSON 形式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "0DC39B9E-13D4-40BA-AE76-CFF9BD64239D"
}

エラーコード

エラーコードリストについては、「API エラーセンター」をご参照ください。