API 標準および多言語対応の SDK
本製品 (Mts/2014-06-18) の API は、RPC 標準に準拠した OpenAPI 仕様を採用しています。Alibaba Cloud には主要なプログラミング言語に対応した SDK が用意され、リクエスト署名のような手間がかかる手順を省略できます。そのため、開発者は HTTP 通信の詳細を意識することなく、各言語の構文で API を呼び出すことが可能になります。
カスタム署名
署名のカスタマイズが必要な場合、「署名メカニズム」を参照してリクエストに手動で署名できます。手動署名プロセスは非常に煩雑で、通常はおよそ 5 営業日かかります。詳細については、DingTalk サポート窓口 (グループチャット ID：147535001692) までお問い合わせください。
はじめに
Alibaba Cloud アカウント (root ユーザー) は最高レベルの管理権限を持ち、その AccessKey ペアが悪用されると、関連するすべてのリソースが不正にアクセスされ、重大なセキュリティリスクを引き起こす可能性があります。そのため、必要な場合以外は、Alibaba Cloud アカウントを使用しないでください。その代わりに、API のみでのアクセスを許可された Resource Access Management (RAM) ユーザーを作成し、RAM ポリシーを設定することで、最小権限の原則 (PoLP) を徹底してください。
API セキュリティを確保するには、以下を作成し、設定する必要があります。
RAM ユーザー
RAM ユーザー用の AccessKey ペア
メディア情報
|
API |
タイトル |
説明 |
| SubmitMediaInfoJob | SubmitMediaInfoJob | ApsaraVideo Media Processing (MPS) にメディア情報分析ジョブを送信します。この操作を呼び出すと、MPS は入力ファイルのメディア情報を分析し、その結果を返します。 |
| QueryMediaInfoJobList | QueryMediaInfoJobList | メディア情報分析ジョブを照会します。 |
トランスコーディング
|
API |
タイトル |
説明 |
| SubmitJobs | SubmitJobs | この操作は、トランスコーディングジョブを送信します。コンソールで作成したトランスコーディングタスクやワークフローが要件を満たさない場合、この操作を使用して、ビジネスロジックに基づいて必要なトランスコーディングパラメーターを設定できます。 |
| CancelJob | CancelJob | トランスコーディングジョブをキャンセルします。 |
| QueryJobList | トランスコードジョブの照会 | トランスコードジョブIDを指定して、トランスコードジョブを一括照会します。 |
| ListJob | ListJob | トランスコーディングジョブの一覧を取得します |
プリセットインテリジェントテンプレート推奨
|
API |
タイトル |
説明 |
| SubmitAnalysisJob | SubmitAnalysisJob | プリセットテンプレート分析ジョブを送信します。 |
| QueryAnalysisJobList | QueryAnalysisJobList | テンプレート分析ジョブを照会し、テンプレート分析ジョブが完了したときに利用可能なプリセットテンプレートのリストを返します。 |
カスタムトランスコーディングテンプレート
|
API |
タイトル |
説明 |
| AddTemplate | AddTemplate | カスタムトランスコーディングテンプレートを作成します。コンテナフォーマット、ビデオストリーム設定、オーディオストリーム設定などの情報を設定する必要があります。 |
| UpdateTemplate | Update custom transcoding template | カスタムトランスコーディングテンプレートの設定を更新します。 |
| QueryTemplateList | QueryTemplateList | この操作を呼び出して、一度に最大 10 個のトランスコーディングテンプレートをクエリできます。 |
| SearchTemplate | SearchTemplate | 指定された状態のカスタムトランスコーディングテンプレートを照会するために、この操作を呼び出すことができます。 |
| DeleteTemplate | DeleteTemplate | カスタムトランスコーディングテンプレートを削除します。 |
ウォーターマークテンプレート
|
API |
タイトル |
説明 |
| AddWaterMarkTemplate | AddWaterMarkTemplate | ウォーターマークテンプレートを作成します。 |
| DeleteWaterMarkTemplate | DeleteWaterMarkTemplate | ウォーターマークテンプレートを削除します。 |
| UpdateWaterMarkTemplate | UpdateWaterMarkTemplate | 指定されたウォーターマークテンプレートの名前と構成を更新します。 |
| SearchWaterMarkTemplate | SearchWaterMarkTemplate | ウォーターマークテンプレートを検索します。 |
| QueryWaterMarkTemplateList | QueryWaterMarkTemplateList | ウォーターマークテンプレートをクエリします。 |
スナップショット
|
API |
タイトル |
説明 |
| SubmitSnapshotJob | Submit a snapshot job | スナップショットジョブを送信します。Media Processing Service (MPS) は、入力ファイルからスクリーンショットを取得し、スプライトイメージを生成します。 |
| QuerySnapshotJobList | Query snapshot job results | スナップショットジョブを照会します。 |
MPS キュー
|
API |
タイトル |
説明 |
| UpdatePipeline | Update pipeline: name, status, and notification settings | MPS キューを更新します。 |
| QueryPipelineList | QueryPipelineList | パイプライン ID を指定してパイプラインをクエリします。 |
| SearchPipeline | Search pipelines | ステータスに基づいてパイプラインを検索します。 |
| AddPipeline | AddPipeline | ApsaraVideo Media Processing (MPS) キューを追加します。 |
| DeletePipeline | DeletePipeline | ApsaraVideo Media Processing (MPS) キューを削除します。 |
media workflow
|
API |
タイトル |
説明 |
| AddMediaWorkflow | AddMediaWorkflow | メディアワークフローを作成します。 |
| ActivateMediaWorkflow | ActivateMediaWorkflow | メディアワークフローをアクティブ化します。 |
| DeactivateMediaWorkflow | DeactivateMediaWorkflow | メディアワークフローを無効にします。 |
| DeleteMediaWorkflow | DeleteMediaWorkflow | メディアワークフローを削除します。これは、実行中のワークフローインスタンスには影響しません。 |
| UpdateMediaWorkflow | Update the topology of a media workflow | メディアワークフローを更新します。 |
| QueryMediaWorkflowList | QueryMediaWorkflowList | 登録済みのメディアワークフローをクエリします。 |
| SearchMediaWorkflow | SearchMediaWorkflow | 指定された状態のメディアワークフローをクエリします。 |
| UpdateMediaWorkflowTriggerMode | UpdateMediaWorkflowTriggerMode | メディアワークフローのトリガーモードを更新します。 |
media workflow 実行インスタンス
|
API |
タイトル |
説明 |
| QueryMediaWorkflowExecutionList | QueryMediaWorkflowExecutionList | メディアワークフローの実行インスタンスを照会します。 |
| ListMediaWorkflowExecutions | ListMediaWorkflowExecutions | メディアワークフローの実行インスタンスを照会します。 |
メディアバケット
|
API |
タイトル |
説明 |
| BindInputBucket | BindInputBucket | 入力メディアバケットをバインドします。 |
| BindOutputBucket | BindOutputBucket | 出力メディアバケットをバインドします。メディアバケットとは、ApsaraVideo Media Processing (MPS) がメディアリソースを保存するために使用する Object Storage Service (OSS) バケットです。OSS バケットを MPS の入力メディアバケットまたは出力メディアバケットとしてバインドすると、MPS はそのバケットにファイルがアップロードされたことを示すメッセージをリッスンできるようになります。これにより、MPS はワークフローをトリガーし、処理済みファイルを返却できます。本操作は、メディアライブラリに対して出力メディアバケットをバインドする場合に使用します。 |
| UnbindInputBucket | UnbindInputBucket | メディアライブラリから入力メディアバケットの紐付けを解除します。 |
| UnbindOutputBucket | UnbindOutputBucket | 出力メディアバケットをデタッチします。 |
| ListAllMediaBucket | ListAllMediaBucket | メディアライブラリにバインドされているすべてのメディアバケットを照会します。 |
メディア
|
API |
タイトル |
説明 |
| AddMedia | AddMedia | 新しいメディアジョブを作成します。 |
| DeleteMedia | DeleteMedia | ApsaraVideo Media Processing (MPS) からメディアファイルを削除します。 |
| UpdateMedia | UpdateMedia | メディアファイルの基本情報を更新します。 |
| UpdateMediaCategory | UpdateMediaCategory | メディアファイルが属するカテゴリを更新します。 |
| UpdateMediaCover | UpdateMediaCover | メディアファイルのサムネイルを更新します。 |
| AddMediaTag | AddMediaTag | メディアファイルにタグを追加します。 |
| DeleteMediaTag | DeleteMediaTag | メディアファイルに付与されたタグを削除します。 |
| UpdateMediaPublishState | UpdateMediaPublishState | メディアファイルの公開状態を更新します。 |
| QueryMediaList | Query media list | この操作を呼び出して、メディア ID に基づいてメディアファイルをクエリできます。 |
| QueryMediaListByURL | Query media information by media input URL | Object Storage Service (OSS) のファイル URL に基づいてメディアファイルをクエリします。 |
インテリジェントプロダクション
|
API |
タイトル |
説明 |
| SubmitMediaCensorJob | SubmitMediaCensorJob | メディア審査ジョブを送信します。 |
| QueryMediaCensorJobDetail | Query content moderation job details | コンテンツモデレーションジョブの詳細を照会します。 |
| QueryMediaCensorJobList | QueryMediaCensorJobList | コンテンツモデレーションジョブのリストを照会します。 |
インテリジェントタグ付け
|
API |
タイトル |
説明 |
| SubmitFpShotJob | SubmitFpShotJob | この操作は、DNA ライブラリで一致または類似する指紋を検索します。 |
| QueryFpShotJobList | QueryFpShotJobList | メディア指紋分析ジョブをクエリします。 この操作を呼び出して、ビデオ指紋分析ジョブとテキスト指紋分析ジョブをクエリできます。 |
| CreateFpShotDB | CreateFpShotDB | メディアフィンガープリントライブラリを作成するジョブを送信します。 |
| ListFpShotDB | ListFpShotDB | DNA データベースをクエリします。 |
| SubmitFpFileDeleteJob | SubmitFpFileDeleteJob | メディア指紋ライブラリからメディアファイルを削除するジョブを送信します。 |
| QueryFpFileDeleteJobList | QueryFpFileDeleteJobList | メディア指紋ライブラリからメディアファイルを削除するジョブをクエリします。 |
| SubmitFpDBDeleteJob | SubmitFpDBDeleteJob | DNA ライブラリを削除またはパージするジョブを送信します。 |
| QueryFpDBDeleteJobList | QueryFpDBDeleteJobList | メディアフィンガープリントライブラリ (FpDB) をクリアまたは削除するために送信された 1 つ以上のジョブのステータスを照会します。 |
Content Moderation
|
API |
タイトル |
説明 |
| QueryCopyrightExtractJob | QueryCopyrightExtractJob | 著作権ウォーターマーク抽出情報タスクを照会します。 |
| QueryCopyrightJob | 動画の著作権ウォーターマークタスクを照会します | 動画の著作権ウォーターマークタスクを照会します。 |
| QueryIProductionJob | Query an intelligent production job | インテリジェントプロダクションジョブを照会します。 |
| QueryTraceAbJob | ビデオトレースウォーターマーク AB ストリームタスクを照会します | ビデオトレースウォーターマーク AB ストリームタスクを照会します。 |
| QueryTraceExtractJob | トレースウォーターマーク抽出タスクを照会します | この API を呼び出して、トレースウォーターマーク抽出タスクの情報をクエリします。 |
| QueryTraceM3u8Job | 動画追跡ウォーターマーク M3U8 タスクを照会します | 動画追跡ウォーターマーク M3U8 タスクを照会します。 |
| SubmitCopyrightExtractJob | 著作権ウォーターマーク抽出タスクを送信します | 著作権ウォーターマーク抽出タスクを送信します。 |
| SubmitCopyrightJob | 動画著作権ウォーターマークジョブを送信 | SubmitCopyrightJobを呼び出して、動画著作権ウォーターマークタスクを送信します。 |
| SubmitIProductionJob | SubmitIProductionJob | インテリジェント制作ジョブを送信します。 |
| SubmitTraceAbJob | 動画追跡電子透かし AB ストリームタスクを送信します | SubmitTraceAbJob 操作を呼び出して、動画追跡電子透かし AB ストリームタスクを送信します。 |
| SubmitTraceExtractJob | 追跡電子透かし抽出タスクを送信します | 追跡電子透かし抽出タスクを送信します。 |
| SubmitTraceM3u8Job | 動画追跡電子透かし M3U8 タスクを送信します | 動画追跡電子透かし M3U8 タスクを送信します。 |