IMS の UploadMediaByURL を使用して URL からオーディオまたはビデオファイルをアップロード - IMS - Alibaba Cloud - Intelligent Media Services

操作説明

説明

コールバックが設定されている場合、サービスは URL アップロードの完了時にイベント通知を送信します。API を呼び出して URL アップロード情報を取得し、アップロードステータスを照会できます。
アップロードジョブの送信が成功すると、システムはクラウド内に非同期タスクを作成し、実行キューに追加します。アップロードが完了すると、イベント通知 (メッセージコールバック) の URL とメディア ID を使用してレコードを更新できます。

制限事項

この API は、VOD ストレージへのファイルのアップロードのみをサポートしており、独自の Object Storage Service (OSS) バケットへのアップロードはサポートしていません。独自の OSS ストレージを使用するには、まずファイルをローカルデバイスにプルし、OSS SDK を使用して OSS にアップロードしてから、RegisterMediaInfo API を呼び出して OSS オブジェクトをメディアアセットライブラリに登録する必要があります。
この API は現在、China (Shanghai)、China (Beijing)、China (Shenzhen) リージョンでのみ利用可能です。
この API は、オーディオおよびビデオファイルのアップロードのみをサポートしています。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

ice:UploadMediaByURL

create

*すべてのリソース

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
UploadURLs	string	任意	メディアファイルのソース URL。 URL には拡張子を含める必要があります。例えば、`https://****.mp4` の場合、mp4 が拡張子です。 URL に拡張子が含まれていない場合は、`MediaMetaData` の `FileExtension` パラメータで指定します。 URL と `FileExtension` パラメータの両方に拡張子が存在する場合、`FileExtension` の値が優先されます。 URL は URL エンコードする必要があります。複数の URL はカンマ (,) で区切ります。最大 20 個の URL を指定できます。特殊文字によるアップロード失敗を防ぐため、カンマで連結する前に各 URL を URL エンコードしてください。	https://diffurl.mp4
AppId	string	任意	アプリケーション ID。	app-1000000
UserData	string	任意	JSON 文字列形式のカスタム設定。このパラメータは、メッセージコールバックなどの設定をサポートします。	{"MessageCallback":{"CallbackURL":"http://example.aliyundoc.com"},"Extend":{"localId":"xxx","test":"www"}}
UploadTargetConfig	string	任意	アップロード先のストレージロケーション。 `StorageType` の有効な値は `oss` のみです。 `StorageLocation` は VOD ストレージのみをサポートし、独自の OSS バケットはサポートしていません。	{"StorageType":"oss","StorageLocation":"outin-***.oss-cn-shanghai.aliyuncs.com"}
MediaMetaData	string	任意	JSON 文字列形式のメディアファイルのメタデータ。このメタデータは、`UploadURLs` の URL と一致する場合にのみ有効になります。値は `[UploadMetadata, UploadMetadata, ...]` 形式の JSON 配列で、JSON 文字列として渡す必要があります。詳細については、以下の UploadMetadata テーブルをご参照ください。	[{"SourceURL":"https://example.aliyundoc.com/video01.mp4","Title":"urlUploadTest"}]
PostProcessConfig	string	任意	メディアファイルのタイプが `video` または `audio` の場合に、アップロード後の処理アクションを指定します。 `ProcessType` の有効な値は `Workflow` のみです。	{"ProcessType": "Workflow","ProcessID":"b72a06c6beeb4dcdb898feef067b1***"}
EntityId	string	任意	エンティティ ID。CreateEntity API を呼び出してエンティティを作成し、カスタム動的メタデータスキーマを定義できます。	d67281da3c8743b8823ad12976187***

UploadMetadata

パラメータ	タイプ	必須	説明
SourceURL	string	はい	アップロードするメディアファイルのソース URL。
Title	string	はい	メディアファイルのタイトル。最大長：128 バイト。UTF-8 でエンコードされている必要があります。
FileSize	string	いいえ	ファイルのサイズ。
Description	string	いいえ	メディアファイルの説明。最大長：1,024 バイト。UTF-8 でエンコードされている必要があります。
CoverURL	string	いいえ	カスタムビデオカバーの URL。
CateId	string	いいえ	カテゴリ ID。
Tags	string	いいえ	メディアファイルのタグ。最大 16 個のタグを指定でき、各タグは最大 32 バイトです。複数のタグはカンマ (,) で区切ります。タグは UTF-8 でエンコードされている必要があります。
WorkflowId	string	いいえ	ワークフロー ID。
FileExtension	string	いいえ	メディアファイルの拡張子。
DynamicMetaData	string	いいえ	動的メタデータ。例：`{"Uploader": "xxx"}`。
EntityId	string	いいえ	エンティティ ID。

説明

WorkflowId パラメータは非同期タスクをトリガーします。送信後、サービスはジョブを非同期実行のためにキューに追加するため、即座には完了しません。
UploadMetadata のパラメータ (Title、Description、Tags など) には絵文字を含めることはできません。
バッチでジョブを送信した場合、各 SourceURL に対して個別の通知が送信されます。
バッチジョブを送信すると、サービスは SourceURL ごとに通知を送信します。
バッチ送信の場合、 SourceURL ごとに個別の通知が送信されます。

レスポンスフィールド

フィールド	型	説明	例
	object	返される結果。
RequestId	string	リクエスト ID。	**83B7-7F87-4792-BFE9-63CD2137**
UploadJobs	array<object>	アップロードジョブの配列。
	object	アップロードジョブの詳細。
JobId	string	アップロードジョブ ID。	20ce1e05dba64576b96e9683879f0***
SourceURL	string	アップロードジョブに対応するソース URL。	http://example****.mp4
MediaId	string	メディア ID。	f476988629f54a7b8a4ba90d1a6c7***

例

成功レスポンス

JSON JSON

{
  "RequestId": "****83B7-7F87-4792-BFE9-63CD2137****",
  "UploadJobs": [
    {
      "JobId": "20ce1e05dba64576b96e9683879f0***",
      "SourceURL": "http://example****.mp4",
      "MediaId": "f476988629f54a7b8a4ba90d1a6c7***"
    }
  ]
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。