ApsaraVideo VOD は、メディアアセット管理およびコントロールシナリオ向けに多数の OpenAPI を提供しています。Alibaba Cloud SDK、Alibaba Cloud CLI、および Infrastructure as Code (IaC) ツールを使用して、これらの API 操作を呼び出すことができます。
ApsaraVideo VOD OpenAPI
ApsaraVideo VOD は、メディアのアップロード、管理、処理、配信、再生など、メディアのライフサイクル全体に対応する OpenAPI を提供しています。これらの OpenAPI を必要に応じてビジネスに統合し、クラウドリソースをコントロールできます。OpenAPI とその原則に慣れていない場合は、「OpenAPI とは」をご参照ください。
OpenAPI バージョンガイド
Alibaba Cloud API は、バージョン番号を使用して、クラウドサービス API のメジャーバージョンにおける操作のリストを管理します。
たとえば、ApsaraVideo VOD は現在、API リストの 2017-03-21 バージョンをサポートしています。2017-03-21 は、時刻の概念ではなく API のバージョン番号を表し、最新の公開 API データを表示します。
API バージョン番号 | 説明 |
推奨 |
オンラインデバッグ
ApsaraVideo VOD は、OpenAPI ポータルでの API デバッグなどの機能をサポートしています。API 操作を呼び出す前に、API バージョン、エンドポイント、統合メソッドなどの概念を理解していることを確認してください。
API デバッグのエントリ: https://next.api.alibabacloud.com/api/vod/2017-03-21/
エンドポイントの説明
レイテンシーを削減するために、リソースが存在するリージョンに基づいてエンドポイントを選択します。
ApsaraVideo VOD サービスは、複数のリージョンに管理およびコントロールサービスをデプロイします。vod.{regionId}.aliyuncs.com の形式でリージョン固有のドメイン名を使用できます。
応答時間を短縮するために、vod-vpc.{regionId}.aliyuncs.com の形式で VPC ドメイン名を使用することもできます。
詳細については、「サービスエンドポイント」をご参照ください。
サポートされている ID
次の ID を使用して API 操作を呼び出すことができます。API 操作を呼び出す前に、ビジネス要件に基づいて必要な権限を付与した RAM ユーザーまたは RAM ロールを使用することを推奨します。
Alibaba Cloud アカウントで OpenAPI Web サイトにログインすると、OpenAPI はデフォルトで現在の Alibaba Cloud ユーザー ID を使用してオンライン OpenAPI デバッグを行います。RAM ユーザーとして API 操作を呼び出すか、日常の O&M を実行することを強く推奨します。API 操作を呼び出す前に、ビジネス要件に基づいて RAM ユーザーに必要な権限を付与してください。RAM ユーザーは必要な権限を持っている必要があります。詳細については、「RAM を使用したアクセスの制御」をご参照ください。
ID | サポート |
サポート済み | |
RAM ユーザー (推奨) | サポート済み |
RAM ロール (推奨) | サポート済み |
詳細情報
サポートされている呼び出しメソッド
ApsaraVideo VOD API を呼び出すには、次のいずれかのメソッドを使用できます。
Alibaba Cloud SDK (推奨)
Alibaba Cloud SDK は、OpenAPI 操作を呼び出すための最も統合しやすく、最もサポートされているメソッドです。SDK の使用を推奨します。ApsaraVideo VOD は、複数の主流プログラミング言語で SDK を提供しています。Alibaba Cloud SDK に基づいてコードを記述し、ApsaraVideo VOD API 操作を呼び出すことができます。複雑なプログラミングなしで、ビデオ再生、ビデオの画像およびテキストウォーターマーク、ビデオクリップ、ライブから VOD への変換などの機能を実装できます。詳細については、「サーバー SDK」をご参照ください。
Alibaba Cloud CLI
Alibaba Cloud CLI は、aliyun コマンドを使用してコマンドラインターミナルを使用する際に、Alibaba Cloud サービスと対話し、クラウドリソースを管理するのに役立ちます。Alibaba Cloud CLI の詳細については、「Alibaba Cloud CLI とは」をご参照ください。
カスタム API 呼び出しのカプセル化
上記の方法のいずれもビジネス要件を満たさない場合は、API リクエストを独自にカプセル化できます。ネイティブ HTTP 呼び出しを行うには、署名アルゴリズムを自分で実装し、カスタムリクエストを構築し、HTTP 呼び出しを開始する必要があります。署名メカニズムの詳細については、「V3 リクエストボディ & 署名メカニズム」をご参照ください。
注意
ApsaraVideo VOD API を呼び出した後にエラーが返された場合は、エラーコードに基づいてリクエストパラメーターが有効かどうかを確認してください。詳細については、「共通エラーコード」をご参照ください。
呼び出しによって返された RequestID または SDK エラーメッセージを記録し、Alibaba Cloud OpenAPI 診断プラットフォームを使用して自己診断することもできます。