メディアアセットを登録 - Intelligent Media Services

Intelligent Media Services (IMS) にメディアアセットを登録します。IMS は、登録されたメディアアセットに対して一意の ID を割り当てます。この操作は非同期で実行され、入力された URL をもとに、メディアアセットが格納されているメディアアセットサービス（OSS または ApsaraVideo VOD）にアクセスし、ファイル情報を取得します。また、タイトル、タグ、説明などの基本情報を指定することもできます。操作の応答として、メディアアセットの ID が返されます。その後、この ID を使用して GetMediaInfo 操作を呼び出すことで、メディアアセットの詳細情報を照会できます。InputURL には、Object Storage Service (OSS) のオブジェクト URL または ApsaraVideo VOD のメディアアセット URL のみを指定できます。

操作説明

メディアアセットの登録は非同期ジョブであり、通常 2～3 秒程度かかります。操作がメディアアセットの ID を返した時点では、登録処理が完了していない場合があります。このタイミングで GetMediaInfo 操作を呼び出すと、メディアアセットの情報が取得できないことがあります。

今すぐお試しください

この 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:RegisterMediaInfo

create

*All Resource

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
InputURL	string	必須	他サービスにおけるメディアアセットの URL。この URL は IMS 内のメディアアセット ID に関連付けられます。登録後は、この URL を変更することはできません。サポートされる URL の形式は以下のとおりです： OSS URL（以下のいずれかの形式）： http(s)://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4 oss://example-bucket/example.mp4：この形式では、メディアアセットが格納されている OSS バケットのリージョンは、IMS が有効化されているリージョンと同一であると見なされます。 ApsaraVideo VOD メディアアセットの URL vod://*20b48fb04483915d4f2cd8ac**	http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4 或 vod://**20b48fb04483915d4f2cd8ac**
MediaType	string	任意	メディアアセットの種別。有効な値は以下のとおりです： image video audio text ビジネス要件に応じて、このパラメーターを明示的に指定することを推奨します。ただし、`InputURL` に OSS URL を指定する場合は、ファイル名拡張子に基づいてメディアアセットの種別を自動判別できます。詳細については、「ファイル形式」をご参照ください。	video
BusinessType	string	任意	メディアアセットの業務種別。有効な値は以下のとおりです： subtitles watermark opening ending general	opening
Title	string	任意	タイトル。このパラメーターを指定しない場合、日付に基づいてデフォルトのタイトルが自動生成されます。最大長は 128 バイトです。 UTF-8 エンコーディングである必要があります。	defaultTitle
Description	string	任意	メディアアセットの説明文。最大長は 1,024 バイトです。 UTF-8 エンコーディングである必要があります。	defaultDescription
MediaTags	string	任意	メディアアセットのタグ。最大 16 個まで指定可能です。複数のタグはカンマ（,）で区切ります。各タグの最大長は 32 バイトです。 UTF-8 エンコーディングである必要があります。	tag1,tag2
CoverURL	string	任意	メディアアセットのサムネイル URL。最大長は 128 バイトです。 UTF-8 エンコーディングである必要があります。	http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png
UserData	string	任意	ユーザー定義データ。カスタムコールバック URL を指定できます。詳細については、「編集完了時のコールバック設定」をご参照ください。最大長は 1,024 バイトです。 UTF-8 エンコーディングである必要があります。 JSON 形式である必要があります。	{"NotifyAddress":"http://xx.xx.xxx"} 或{"NotifyAddress":"https://xx.xx.xxx"} 或{"NotifyAddress":"ice-callback-demo"}
Overwrite	boolean	任意	同一 URL で既に登録済みのメディアアセットを上書きするかどうかを指定します。デフォルト値は false です。有効な値は以下のとおりです：・true：同一 URL で既に登録済みのメディアアセットがある場合、元のメディアアセットは削除され、新しいメディアアセットが登録されます。・false：同一 URL で既に登録済みのメディアアセットがある場合、新しいメディアアセットは登録されません。1 つの URL で複数のメディアアセットを登録することはできません。	true
ClientToken	string	任意	リクエストのべき等性を保証するためのクライアントトークン。値は 32 文字の UUID である必要があります。	**0311a423d11a5f7dee713535**
RegisterConfig	string	任意	登録構成。デフォルトでは、メディアアセットに対してスプライトが自動生成されます。NeedSprite を false に設定することで、自動スプライト生成を無効化できます。デフォルトでは、メディアアセットに対してスナップショットが自動生成されます。NeedSnapshot を false に設定することで、自動スナップショット生成を無効化できます。	{ "NeedSprite": "false", "CoverConfig": { "StartTime": 1.0 }, "SearchLibName": "test" }
CateId	integer	任意	カテゴリ ID。	3048
WorkflowId	string	任意	ワークフロー ID。	****b4fb044839815d4f2cd8****
ReferenceId	string	任意	カスタム ID。長さは 6～64 文字で、英字、数字、ハイフン（-）、アンダースコア（_）のみを使用できます。ユーザー間で重複しないようにしてください。	123-123
SmartTagTemplateId	string	任意	スマートタグ付けテンプレートの ID。有効な値は以下のとおりです： S00000101-300080：自然言語処理（NLP）によるコンテンツ認識をサポートするシステムテンプレート。 S00000103-000001：NLP によるコンテンツ認識およびすべてのタグ付け機能をサポートするシステムテンプレート。 S00000103-000002：すべてのタグ付け機能をサポートするが、NLP によるコンテンツ認識はサポートしないシステムテンプレート。このパラメーターを設定すると、メディアアセット登録後に自動的にスマートタグ分析タスクが開始されます。課金項目の詳細については、「スマートタグ付け」をご参照ください。	S00000101-300080

レスポンスフィールド

フィールド	型	説明	例
	object	応答パラメーター。
RequestId	string	リクエスト ID。	****5A-CAAC-4850-A3AF-B74606****
MediaId	string	IMS 内のメディアアセット ID。	****b48fb04483915d4f2cd8****

例

成功レスポンス

JSONJSON

{
  "RequestId": "******5A-CAAC-4850-A3AF-B74606******",
  "MediaId": "******b48fb04483915d4f2cd8******"
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ	説明
403	Forbidden	User not authorized to operate on the specified resource.

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

変更履歴

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