API 標準および多言語対応の SDK
本製品 (vod/2017-03-21) の 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 |
タイトル |
説明 |
| CreateUploadVideo | CreateUploadVideo | ApsaraVideo VOD は、安全で認可されたアップロードのためのアップロードアドレスと認証情報を提供します。この操作を呼び出して、アップロードアドレスと認証情報を取得し、メディア ID（VideoId として返されます）を作成し、メディアファイルの基本情報を設定します。 |
| RefreshUploadVideo | RefreshUploadVideo | 元のアップロード認証情報の有効期限が切れた後、動画ファイルの新しいアップロード認証情報を取得します。 |
| CreateUploadImage | CreateUploadImage | この操作を呼び出すと、イメージのアップロードに使用するアップロード URL とアップロード認証情報を取得し、イメージ ID を生成できます。ApsaraVideo VOD は、権限付与とセキュリティを確保し、悪意のあるアップロードを防止するために、アップロード URL と認証情報を返します。 |
| CreateUploadAttachedMedia | CreateUploadAttachedMedia | アップロード認証情報を取得し、ウォーターマークや字幕などの補助メディアアセットを作成します。アップロード URL と認証情報は ApsaraVideo VOD によって提供され、権限付与とセキュリティの問題を解決し、悪意のあるアップロードを防ぎ、管理と処理のためにメディア ID (Mediaid) を自動的に作成します。 |
| UploadMediaByURL | UploadMediaByURL | ソース URL からメディアファイルを取得してオーディオまたはビデオメディアファイルをアップロードします。この操作はバッチアップロードをサポートしています。 |
| GetURLUploadInfos | GetURLUploadInfos | URL ベースのアップロードジョブに関する情報を取得します。 |
| CancelUrlUploadJobs | CancelUrlUploadJobs | キュー内の URL ベースのアップロードジョブをキャンセルします。 |
| UploadStreamByURL | UploadStreamByURL | 外部ストレージから ApsaraVideo VOD にトランスコードされたストリームをアップロードします。 |
| DeleteMultipartUpload | DeleteMultipartUpload | アップロード中に生成されたパーツを削除します。 |
| GetUploadDetails | GetUploadDetails | メディア ID に基づいて、1 つ以上のメディアファイルのアップロード時間、アップロード率、アップロード元などのアップロード詳細を照会します。 |
| RegisterMedia | RegisterMedia | OSSバケットのメディアファイルをApsaraVideo VODに登録します。トランスコーディングやスナップショットなどの機能をメディアに適用するには、まずファイルを登録して必要なメタデータを生成する必要があります。 |
オーディオおよびビデオ再生
|
API |
タイトル |
説明 |
| GetPlayInfo | GetPlayInfo | この操作を呼び出し、オーディオまたはビデオ ID を指定して再生 URL を取得します。その後、ApsaraVideo Player または、ネイティブ、オープンソース、プロプライエタリなどのサードパーティ製プレーヤーを使用してコンテンツを再生できます。 |
| GetVideoPlayAuth | GetVideoPlayAuth | この操作を呼び出して、オーディオまたはビデオファイルの再生認証情報 (PlayAuth) を取得します。ApsaraVideo Player SDK は、この認証情報を使用して再生 URL を自動的に取得します。再生認証情報は有効期間が限定されており、特定のオーディオまたはビデオファイルにバインドされます。異なるファイルに同じ認証情報を使用しないでください。認証情報の有効期限が切れたり、無効になったりすると、再生は失敗します。このメソッドは、高いセキュリティが要求される再生シナリオに適しています。 |
メディアアセット管理
|
API |
タイトル |
説明 |
| メディアアセット検索 | メディアアセット検索 | |
| SearchMedia | SearchMedia | この操作は、ApsaraVideo VOD 内の動画、音声、画像などのメディアアセットを検索します。この操作を呼び出し、メディア検索プロトコルを使用して、多次元検索を実行できます。返すフィールドの指定、完全一致、あいまい検索、複数値クエリ、範囲クエリの実行、およびソート用のフィールドの指定が可能です。 |
| 階層型ストレージ | 階層型ストレージ | |
| UpdateMediaStorageClass | UpdateMediaStorageClass | メディアアセットのストレージクラスを変更します。 |
| RestoreMedia | RestoreMedia | メディアアセットを解凍します。 |
| カテゴリ管理 | カテゴリ管理 | |
| AddCategory | AddCategory | ApsaraVideo VOD に保存されているメディアアセットを分類するためのカテゴリを作成します。これにより、より効率的かつ便利にリソースのクエリと管理ができます。 |
| UpdateCategory | UpdateCategory | カテゴリ名を更新します。 |
| DeleteCategory | DeleteCategory | カテゴリとそのサブカテゴリを削除します。 |
| GetCategories | GetCategories | カテゴリの ID またはタイプに基づいて、特定のカテゴリとそのサブカテゴリに関する情報を照会します。 |
| オーディオおよびビデオ管理 | オーディオおよびビデオ管理 | |
| GetVideoInfo | GetVideoInfo | この操作を呼び出して、ID に基づいて単一の音声または動画ファイルのタイトル、説明、長さ、サムネイル URL、ステータス、作成時刻、サイズ、スナップショット、カテゴリ、タグを取得します。 |
| GetVideoInfos | GetVideoInfos | この操作を呼び出すと、ID を使用して複数の音声または動画ファイルの情報を一括で取得できます。取得できる情報には、タイトル、説明、長さ、サムネイル URL、ステータス、作成時刻、サイズ、スナップショット、カテゴリ分類、タグなどがあります。 |
| GetVideoList | GetVideoList | ビデオ情報の一覧を取得します。 |
| GetMezzanineInfo | GetMezzanineInfo | オーディオまたはビデオファイルのソースファイル情報 (ファイル URL、解像度、ビットレートなど) を取得します。 |
| UpdateVideoInfo | UpdateVideoInfo | 単一の音声または動画ファイルの情報を更新します。 |
| UpdateVideoInfos | UpdateVideoInfos | 複数の音声または動画ファイルの情報を更新します。 |
| DeleteMezzanines | DeleteMezzanines | 1 つ以上のオーディオファイルまたはビデオファイルのソースファイルを削除します。 |
| DeleteStream | DeleteStream | ビデオストリームやオーディオストリームなどのメディアストリームに関連する情報と保存ファイルを削除します。 |
| DeleteVideo | DeleteVideo | ソースファイル、トランスコードされたストリーム、サムネイルなど、ビデオ全体を削除します。 |
| BatchGetMediaInfos | BatchGetMediaInfos | 複数のメディアアセットの基本情報とソースファイル情報を取得します。 |
| DescribeMediaDistribution | DescribeMediaDistribution | メディアアセットデータの分布を時間別にクエリします。最大クエリ期間は 6 ヶ月です。 |
| 補助メディアアセット管理 | 補助メディアアセット管理 | |
| GetAttachedMediaInfo | GetAttachedMediaInfo | ID に基づいて、ウォーターマークイメージ、字幕ファイル、素材などの 1 つ以上の補助メディアアセットの URL と基本情報をクエリします。 |
| UpdateAttachedMediaInfos | UpdateAttachedMediaInfos | 複数の補助メディアアセットの情報を一括で変更します。 ウォーターマークを含むイメージ、字幕ファイル、またはその他の素材などの補助メディアアセットを ApsaraVideo VOD にアップロードした後、この操作を呼び出して、補助メディアアセットの一意の識別子 (ID) に基づいて、タイトル、説明、タグ、カテゴリを一括で更新できます。 |
| DeleteAttachedMedia | DeleteAttachedMedia | ApsaraVideo VOD から補助メディアアセットを削除します。ウォーターマークイメージ、字幕ファイル、素材などの補助メディアアセットを 1 つ以上バッチで削除できます。 |
| イメージ管理 | イメージ管理 | |
| GetImageInfo | GetImageInfo | ApsaraVideo VOD にイメージをアップロードした後、イメージ ID に基づいて、イメージの基本情報と URL を照会します。 |
| GetImageInfos | GetImageInfos | 一度に複数のイメージの基本情報を照会します。 |
| UpdateImageInfos | UpdateImageInfos | 複数のイメージの情報を一度に変更します。 ApsaraVideo VOD にイメージをアップロードした後、この操作を呼び出すことで、イメージの ID に基づいて、タイトル、説明、タグ、カテゴリを一度に更新できます。 |
| ListSnapshots | ListSnapshots | スナップショットジョブを送信してキャプチャされたスナップショット、またはビデオのアップロード時にシステムによって生成されたサムネイルを照会します。 |
| DeleteImage | DeleteImage | アップロードされたイメージと自動的にキャプチャされたビデオスナップショットを削除します。 |
| アニメーションステッカー管理 | アニメーションステッカー管理 | |
| ListDynamicImage | ListDynamicImage | ビデオ ID を指定して、ビデオの動的画像に関する情報を取得します。 |
| DeleteDynamicImage | DeleteDynamicImage | アニメーションステッカーに関する情報を削除します。 |
メディア処理
|
API |
タイトル |
説明 |
| 処理の開始 | 処理の開始 | |
| SubmitTranscodeJobs | SubmitTranscodeJobs | この API を呼び出してメディアトランスコーディングジョブを送信し、非同期トランスコーディングを開始します。 |
| SubmitSnapshotJob | SubmitSnapshotJob | この操作を呼び出して、スナップショットジョブを送信し、動画から非同期でスナップショットをキャプチャします。 |
| SubmitPreprocessJobs | SubmitPreprocessJobs | この操作は、Caster 用に動画をトランスコードするために使用します。 |
| SubmitDynamicImageJob | SubmitDynamicImageJob | この操作を呼び出して、動的イメージジョブを非同期処理のために送信します。 |
| SubmitWorkflowJob | SubmitWorkflowJob | ワークフロージョブを送信してビデオを処理します。 |
| トランスコーディングテンプレート | トランスコーディングテンプレート | |
| AddTranscodeTemplateGroup | AddTranscodeTemplateGroup | この操作を使用して、トランスコーディングテンプレートグループを作成するか、既存のグループにトランスコーディングテンプレートを追加します。 |
| UpdateTranscodeTemplateGroup | UpdateTranscodeTemplateGroup | トランスコードテンプレートグループの設定、またはトランスコードテンプレートグループ内のトランスコードテンプレートの設定を変更します。 |
| SetDefaultTranscodeTemplateGroup | SetDefaultTranscodeTemplateGroup | トランスコーディングテンプレートグループをデフォルトとして指定します。 |
| ListTranscodeTemplateGroup | ListTranscodeTemplateGroup | トランスコーディングテンプレートグループをクエリします。 |
| GetTranscodeTemplateGroup | GetTranscodeTemplateGroup | テンプレートグループ ID に基づいて、トランスコーディングテンプレートグループの詳細を照会します。 |
| DeleteTranscodeTemplateGroup | DeleteTranscodeTemplateGroup | トランスコーディングテンプレートグループから 1 つ以上のトランスコーディングテンプレートを削除するか、トランスコーディングテンプレートグループを強制的に削除します。 |
| スナップショットテンプレート | スナップショットテンプレート | |
| AddVodTemplate | AddVodTemplate | スナップショットテンプレートまたはフレームアニメーションテンプレートを追加します。 |
| UpdateVodTemplate | UpdateVodTemplate | スナップショットテンプレートを変更します。 |
| GetVodTemplate | GetVodTemplate | スナップショットテンプレートの詳細を照会します。 |
| ListVodTemplate | ListVodTemplate | 使用可能なスナップショットテンプレートを一覧表示します。 |
| DeleteVodTemplate | DeleteVodTemplate | スナップショットテンプレートを削除します。 |
| イメージおよびテキストウォーターマークテンプレート | イメージおよびテキストウォーターマークテンプレート | |
| AddWatermark | AddWatermark | イメージまたはテキストのウォーターマークテンプレートを作成します。ApsaraVideo VOD では、ウォーターマークテンプレートを作成して、ウォーターマークの位置、サイズ、フォント、色などのパラメーター構成を再利用できます。各ウォーターマークテンプレートには一意の ID が割り当てられます。これにより、ウォーターマークタスクの処理が簡素化されます。 |
| UpdateWatermark | UpdateWatermark | ウォーターマークテンプレートを作成した後、その名前と構成を変更します。 |
| DeleteWatermark | DeleteWatermark | イメージウォーターマークまたはテキストウォーターマークのテンプレートを削除します。 |
| SetDefaultWatermark | SetDefaultWatermark | ウォーターマークテンプレートをデフォルトとして設定します。 |
| GetWatermark | GetWatermark | ID に基づいて、イメージまたはテキストのウォーターマークテンプレートの構成を照会します。この操作を呼び出すことで、イメージウォーターマークの位置、サイズ、表示時間や、テキストウォーターマークのコンテンツ、位置、フォント、フォントカラーなどの情報を取得できます。 |
| ListWatermark | ListWatermark | 指定されたリージョン内のすべてのイメージウォーターマークテンプレートとテキストウォーターマークテンプレートの設定情報をクエリします。この操作を呼び出すことで、イメージウォーターマークの位置、サイズ、表示時間や、テキストウォーターマークのコンテンツ、位置、フォント、フォントカラーなどの情報を取得できます。 |
| トランスコーディングタスク | トランスコーディングタスク | |
| GetTranscodeSummary | GetTranscodeSummary | ファイル ID に基づいて、音声ファイルと動画ファイルのトランスコーディングの概要を照会します。トランスコーディングの概要には、トランスコーディングのステータスと進捗が含まれます。 |
| ListTranscodeTask | ListTranscodeTask | メディア ID に基づいてトランスコーディングタスクをクエリします。この操作は、特定のジョブ情報を返しません。 |
| GetTranscodeTask | GetTranscodeTask | トランスコーディングタスク ID を使用して、トランスコーディングジョブの詳細を照会します。 |
| タスク管理 | タスク管理 | |
| ListJobInfo | ListJobInfo | メディアアセット ID に基づいて履歴タスクを照会します。 |
| GetJobDetail | GetJobDetail | この API を呼び出して、`jobId` に基づいて非同期タスクの詳細を取得します。 |
ビデオ編集 (オンライン編集)
|
API |
タイトル |
説明 |
| ProduceEditingProjectVideo | ProduceEditingProjectVideo | 1 つ以上の動画を合成して、最終的な合成ビデオを制作します。`Timeline` パラメーターを使用してソースビデオを直接送信するか、最初にクラウド編集プロジェクトを作成してから制作のために送信することができます。 |
| オンライン編集プロジェクト管理 | オンライン編集プロジェクト管理 | |
| AddEditingProject | AddEditingProject | オンライン編集プロジェクト（ビデオ編集タスク）を作成するには、この操作を呼び出します。 |
| UpdateEditingProject | UpdateEditingProject | オンライン編集プロジェクトを変更します。 |
| DeleteEditingProject | DeleteEditingProject | オンライン編集プロジェクトを削除します。 |
| SetEditingProjectMaterials | SetEditingProjectMaterials | オンライン編集プロジェクトで編集するメディアアセットを指定します。 |
| GetEditingProject | GetEditingProject | オンライン編集プロジェクトの詳細を照会します。 |
| GetEditingProjectMaterials | GetEditingProjectMaterials | オンライン編集プロジェクトで編集待ちのマテリアルを照会します。 |
| SearchEditingProject | SearchEditingProject | オンライン編集プロジェクトをクエリします。 |
| AddEditingProjectMaterials | AddEditingProjectMaterials | 1 つ以上の素材をオンライン編集プロジェクトに追加します。 |
| DeleteEditingProjectMaterials | DeleteEditingProjectMaterials | オンライン編集プロジェクトの編集対象の素材を削除します。 |
メディアレビュー
|
API |
タイトル |
説明 |
| レビュー設定 | レビュー設定 | |
| SetAuditSecurityIp | SetAuditSecurityIp | レビューセキュリティグループに IP アドレスを設定します。 |
| ListAuditSecurityIp | ListAuditSecurityIp | セキュリティグループ内の IP アドレスをクエリします。 |
| 自動レビュー | 自動レビュー | |
| SubmitAIMediaAuditJob | SubmitAIMediaAuditJob | 音声または動画ファイルのインテリジェント審査ジョブを送信します。送信後、ジョブは非同期で処理されます。正常なレスポンスは、ジョブがキューに追加されたことを意味し、ジョブが完了したことを意味するものではありません。 |
| SubmitAIImageAuditJob | SubmitAIImageAuditJob | この操作を呼び出して、イメージのインテリジェントメディアモデレーションジョブを送信します。ジョブが送信されると、非同期に処理されます。応答はジョブの完了を意味するものではありません。 |
| GetAIMediaAuditJob | GetAIMediaAuditJob | インテリジェント審査ジョブの情報を照会します。ジョブが送信されると、非同期で処理されます。この操作を呼び出して、ジョブ情報をリアルタイムで照会できます。 |
| GetMediaAuditResult | GetMediaAuditResult | 自動レビュー結果の概要を照会します。 |
| GetMediaAuditResultDetail | GetMediaAuditResultDetail | 自動レビュー結果の詳細を照会します。この操作を呼び出すことで、レビュー結果の詳細をリアルタイムで照会できます。 |
| GetMediaAuditResultTimeline | GetMediaAuditResultTimeline | コンテンツ規定に違反するすべてのスナップショットのタイムラインを照会します。 |
| GetMediaAuditAudioResultDetail | GetMediaAuditAudioResultDetail | この操作を呼び出して、音声監査の詳細を取得できます。 |
| 手動レビュー | 手動レビュー | |
| CreateAudit | CreateAudit | オーディオやビデオなどのメディアファイルに対して手動レビューを実行します。 |
| GetAuditHistory | GetAuditHistory | 手動レビューの履歴を照会します。 |
Video AI
|
API |
タイトル |
説明 |
| AI テンプレート | AI テンプレート | |
| AddAITemplate | AddAITemplate | この操作を呼び出して、自動レビューとインテリジェント サムネイル タスク用の AI テンプレートを追加します。 |
| DeleteAITemplate | DeleteAITemplate | AI テンプレートを削除します。 |
| UpdateAITemplate | UpdateAITemplate | AI テンプレートを変更します。 |
| SetDefaultAITemplate | SetDefaultAITemplate | AI テンプレートをデフォルトテンプレートとして指定します。 |
| GetAITemplate | GetAITemplate | AI テンプレートをクエリします。 |
| ListAITemplate | ListAITemplate | AI テンプレートをクエリします。 |
| GetDefaultAITemplate | GetDefaultAITemplate | デフォルトの AI テンプレートをクエリします。 |
| AI タスク | AI タスク | |
| ListAIJob | ListAIJob | スマートタギングまたはビデオ指紋ジョブを照会します。スマートタギングまたはビデオ指紋ジョブを送信すると、ApsaraVideo VOD は非同期でジョブを処理します。この操作を呼び出して、ジョブ情報をリアルタイムで照会できます。 |
| SubmitAIJob | SubmitAIJob | この操作は、スマートタグまたは動画 DNA ジョブを送信するために使用します。 |
| メディアフィンガープリント | メディアフィンガープリント | |
| GetMediaDNAResult | GetMediaDNAResult | ビデオ指紋ジョブの結果を照会します。メディア指紋ジョブの完了後、この操作を呼び出すことで、メディア指紋の結果を照会できます。 |
| SubmitMediaDNADeleteJob | SubmitMediaDNADeleteJob | ビデオ指紋ジョブを削除します。 |
| スマートタグ付け | スマートタグ付け | |
| GetAIVideoTagResult | GetAIVideoTagResult | スマートタギングタスクの結果を照会します。 |
| スマートサムネイル | スマートサムネイル | |
| SubmitAIImageJob | SubmitAIImageJob | AI 画像処理ジョブを送信します。 |
| GetAIImageJobs | GetAIImageJobs | イメージ AI 処理のジョブをクエリします。 |
| ListAIImageInfo | ListAIImageInfo | 指定されたビデオのイメージに関する AI 処理結果をクエリします。 |
| DeleteAIImageInfos | DeleteAIImageInfos | AI 処理のために送信された 1 つ以上のイメージに関する情報を削除します。 |
ライブから VOD へ
|
API |
タイトル |
説明 |
| ListLiveRecordVideo | ListLiveRecordVideo | ライブ録画ビデオを照会します。 |
VOD CDN
|
API |
タイトル |
説明 |
| モニタリングとクエリ | モニタリングとクエリ | |
| リソースアクセスデータ | リソースアクセスデータ | |
| DescribeVodDomainTrafficData | DescribeVodDomainTrafficData | この操作を呼び出して、高速化ドメイン名のトラフィックデータをクエリできます。 DescribeVodDomainRealTimeTrafficData 操作と比較して、この操作はより長い期間にわたる既存データのクエリをサポートしています。過去 366 日間のデータをクエリできます。ただし、この操作は時間粒度が大きく、最小 5 分で、データ遅延が大きくなります。 |
| DescribeVodDomainBpsData | DescribeVodDomainBpsData | 1 つ以上の指定された CDN ドメイン名の帯域幅をクエリします。 |
| DescribeVodDomainBpsDataByLayer | DescribeVodDomainBpsDataByLayer | プロトコルタイプ別に、1 つ以上の高速化ドメイン名の帯域幅データをクエリします。 |
| DescribeVodDomainQpsData | DescribeVodDomainQpsData | 1 つ以上の高速化ドメイン名の秒間クエリ数 (QPS) を照会します。データは 5 分ごとに収集されます。過去 90 日間に収集されたデータを照会できます。 |
| DescribeVodDomainHitRateData | DescribeVodDomainHitRateData | 高速化ドメイン名のバイトヒット率を照会します。バイトヒット率の単位はパーセントです。 |
| DescribeVodDomainReqHitRateData | DescribeVodDomainReqHitRateData | 1 つ以上の高速化ドメイン名のバイトヒット率を照会します。リクエストヒット率はパーセンテージで測定されます。 |
| DescribeVodRangeDataByLocateAndIspService | DescribeVodRangeDataByLocateAndIspService | インターネットサービスプロバイダー (ISP) とリージョン別に帯域幅データをクエリします。 |
| リソースバックツーオリジンデータ | リソースバックツーオリジンデータ | |
| DescribeVodDomainSrcTrafficData | DescribeVodDomainSrcTrafficData | ApsaraVideo VOD の高速化ドメイン名の back-to-origin トラフィックデータを照会します。トラフィックの単位はバイトです。 |
| DescribeVodDomainSrcBpsData | DescribeVodDomainSrcBpsData | 1 つ以上の高速化ドメイン名の back-to-origin ルーティング中の帯域幅データをクエリします。 |
| リアルタイムアクセスデータ | リアルタイムアクセスデータ | |
| DescribeVodDomainRealTimeTrafficData | DescribeVodDomainRealTimeTrafficData | 1つ以上の高速化ドメイン名のトラフィックデータを照会します。時間の粒度は最小で 1 分、データ遅延は最小で 5 分です。過去 186 日以内のデータを照会できます。DescribeVodDomainTrafficData 操作と比較して、この操作は時間の粒度がより細かく、データ遅延がより短く、より短い期間内の履歴データを照会できます。 |
| DescribeVodDomainRealTimeBpsData | DescribeVodDomainRealTimeBpsData | 1 つ以上の高速化ドメイン名の帯域幅データをクエリします。時間の最小粒度は 1 分です。データの最小遅延は 5 分です。過去 186 日間のデータをクエリできます。DescribeVodDomainBpsData 操作と比較して、この操作は時間の粒度がより細かく、データ遅延がより短く、より短い期間内の既存データをクエリできます。 |
| DescribeVodDomainRealTimeHttpCodeData | DescribeVodDomainRealTimeHttpCodeData | 1 つ以上の高速化ドメイン名について、HTTP ステータスコードの総数と各 HTTP ステータスコードの割合を照会します。最小時間の粒度は 1 分です。最小データ遅延は 5 分です。過去 186 日間のデータを照会できます。 |
| DescribeVodDomainRealTimeQpsData | DescribeVodDomainRealTimeQpsData | 1つ以上の高速化ドメイン名の秒間クエリ数 (QPS) を照会します。時間の最小粒度は 1 分です。データの最小遅延は 5 分です。過去 186 日間のデータを照会できます。 |
| DescribeVodDomainRealTimeReqHitRateData | DescribeVodDomainRealTimeReqHitRateData | 1 つ以上の高速化ドメイン名のリクエストヒット率データをクエリします。時間の最小粒度は 1 分です。データの最小遅延は 5 分です。過去 186 日間のデータをクエリできます。 |
| DescribeVodDomainRealTimeByteHitRateData | DescribeVodDomainRealTimeByteHitRateData | この操作を呼び出して、高速化ドメイン名のバイトヒット率をクエリできます。クエリの最小時間の粒度は 1 分で、データの遅延は少なくとも 5 分です。過去 186 日間のデータをクエリできます。 |
| DescribeVodDomainRealTimeDetailData | DescribeVodDomainRealTimeDetailData | 1 つ以上の高速化ドメイン名のリアルタイムモニタリングデータを照会します。 |
| ドメイン名管理 | ドメイン名管理 | |
| AddVodDomain | AddVodDomain | ApsaraVideo VOD に高速化ドメイン名を追加します。 |
| DeleteVodDomain | DeleteVodDomain | ApsaraVideo VOD から CDN 用ドメイン名を削除します。 |
| UpdateVodDomain | UpdateVodDomain | 特定の CDN ドメイン名を変更します。 |
| DescribeVodUserDomains | DescribeVodUserDomains | Alibaba Cloud アカウント内の CDN のドメイン名を照会します。 |
| DescribeVodDomainDetail | DescribeVodDomainDetail | 指定された CDN ドメイン名の基本情報を照会します。 |
| BatchStartVodDomain | BatchStartVodDomain | 無効状態の高速化ドメイン名を有効化します。 |
| BatchStopVodDomain | BatchStopVodDomain | 高速化ドメイン名を無効にします。 |
| ドメイン名の検証 | ドメイン名の検証 | |
| VerifyVodDomainOwner | VerifyVodDomainOwner | 指定されたドメイン名の所有権を検証します。 |
| DescribeVodVerifyContent | DescribeVodVerifyContent | 所有権検証コンテンツを照会します。 |
| ドメイン名設定 | ドメイン名設定 | |
| DeleteVodSpecificConfig | DeleteVodSpecificConfig | CDN のドメイン名の構成を削除します。 |
| SetVodDomainCertificate | SetVodDomainCertificate | ドメイン名の証明書を有効化または無効化し、証明書情報を変更します。 |
| DescribeVodDomainConfigs | DescribeVodDomainConfigs | この操作を呼び出して、ドメイン名の構成をクエリできます。複数の機能の構成を同時にクエリできます。 |
| DescribeVodCertificateList | DescribeVodCertificateList | 指定された CDN ドメイン名、または Alibaba Cloud アカウント内のすべての CDN ドメイン名の証明書を照会します。 |
| DescribeVodDomainCertificateInfo | DescribeVodDomainCertificateInfo | この操作は、指定された高速化ドメイン名の証明書情報を照会します。 |
| BatchSetVodDomainConfigs | BatchSetVodDomainConfigs | 1 つ以上の CDN ドメイン名を設定します。 |
| パージとプリフェッチ | パージとプリフェッチ | |
| DescribeVodRefreshTasks | DescribeVodRefreshTasks | 1 つ以上のリフレッシュタスクまたはプリフェッチタスクに関する情報をクエリします。 |
| DescribeVodRefreshQuota | DescribeVodRefreshQuota | 当日にファイルをリフレッシュまたはプリフェッチするためのリクエストの最大数と残り数を照会します。URL に基づいてファイルをプリフェッチしたり、URL またはディレクトリに基づいてファイルをリフレッシュしたりできます。 |
| PreloadVodObjectCaches | PreloadVodObjectCaches | オリジンサーバーから L2 ノードにリソースをプリフェッチします。 これにより、ユーザーは初回アクセス時に直接キャッシュにヒットでき、オリジンサーバーのワークロードを削減できます。 |
| RefreshVodObjectCaches | RefreshVodObjectCaches | Alibaba Cloud CDN ノード上のファイルをリフレッシュします。URL に基づいて一度に複数のファイルをリフレッシュできます。 |
| RefreshMediaPlayUrls | RefreshMediaPlayUrls | メディア ID に基づいて、メディアのリフレッシュタスクまたはプリフェッチタスクを送信します。 |
| GetMediaRefreshJobs | GetMediaRefreshJobs | メディアリフレッシュまたはプリフェッチジョブのステータスやフィルター条件などの情報をクエリします。 |
| ログ管理 | ログ管理 | |
| DescribeVodDomainLog | DescribeVodDomainLog | ドメイン名の CDN アクセスログ情報 (ログパスを含む) をクエリします。 |
ビデオセキュリティ
|
API |
タイトル |
説明 |
| HLS 暗号化 | HLS 暗号化 | |
| GenerateKMSDataKey | GenerateKMSDataKey | ApsaraVideo VOD の HLS 暗号化に使用されるランダムな Key Management Service (KMS) データキーを生成します。 |
| DecryptKMSDataKey | DecryptKMSDataKey | Key Management Service (KMS) のデータキーにおいて、CiphertextBlob で指定された暗号文を復号します。 |
| 電子透かし | 電子透かし | |
| SubmitDigitalWatermarkExtractJob | SubmitDigitalWatermarkExtractJob | この操作を呼び出して、電子透かしを非同期で抽出するジョブを送信します。ウォーターマークは、著作権ウォーターマークまたは追跡ウォーターマークです。 |
| GetDigitalWatermarkExtractResult | GetDigitalWatermarkExtractResult | デジタルウォーターマーク抽出ジョブの結果を照会します。この操作を呼び出すことで、ジョブのステータス、著作権ウォーターマークまたはユーザートレースウォーターマークの内容などの情報を取得できます。 |
| 安全なダウンロード (キャッシュ) | 安全なダウンロード (キャッシュ) | |
| GenerateDownloadSecretKey | GenerateDownloadSecretKey | セキュアダウンロード用のキーを生成します。ApsaraVideo Player SDK は、セキュアダウンロード機能を提供します。このモードでローカルデバイスにダウンロードされた動画は暗号化されます。暗号化された動画は、指定したアプリから生成されたキーファイルを使用することによってのみ再生できます。セキュアダウンロードは、動画を不正な再生や配信から保護します。 |
データ統計
|
API |
タイトル |
説明 |
| 使用量データ | 使用量データ | |
| DescribeVodDomainUsageData | DescribeVodDomainUsageData | 1 つ以上の高速化ドメイン名のトラフィックまたは帯域幅データを照会します。 |
| DescribeVodStorageData | DescribeVodStorageData | ストレージ容量やアウトバウンドトラフィックなど、ストレージ関連リソースの使用状況を照会します。 |
| DescribeVodTranscodeData | DescribeVodTranscodeData | トランスコードの統計情報をクエリします。 |
| DescribeVodAIData | DescribeVodAIData | 自動レビューやメディアフィンガープリントなど、さまざまな種類のビデオ AI に関する統計をクエリします。 |
| DescribeVodTieringStorageData | DescribeVodTieringStorageData | メディアアセットの階層型ストレージの使用量を照会します。 |
| DescribeVodTieringStorageRetrievalData | DescribeVodTieringStorageRetrievalData | メディアアセット管理における階層型ストレージのデータ取得使用量を照会します。 |
| 再生品質 (QOS/QOE) | 再生品質 (QOS/QOE) | |
| DescribeVodPlayerMetricData | DescribeVodPlayerMetricData | プレーヤーメトリックデータをクエリします。 |
| DescribeVodPlayerCollectData | DescribeVodPlayerCollectData | プレーヤー再生データの概要をクエリします。 |
| DescribeVodPlayerDimensionData | DescribeVodPlayerDimensionData | プレーヤーディメンションのメタデータをクエリします。 |
| 再生データ (新) | 再生データ (新) | |
| GetDailyPlayRegionStatis | GetDailyPlayRegionStatis | この操作は、指定された日付の指定されたリージョンにあるすべてのメディアアセットのトラフィックデータを取得します。 データは CDN トラフィックログから生成され、動画で消費されたトラフィックを表します。 生成される CSV ファイルには、日付、動画 ID、ドメイン名、トラフィック、アプリケーション ID、カテゴリ ID などの情報が含まれています。 このファイルをダウンロードして、データ分析などのシナリオで使用できます。 |
| DescribeVodMediaPlayData | DescribeVodMediaPlayData | メディア ID を使用して、指定された日付のオーディオまたはビデオファイルの再生データを取得します。データには、ユニークビジター数、ユーザーあたりの平均再生回数、総再生回数、ユーザーあたりの平均再生時間、および総再生時間が含まれます。 |
| 再生データ (レガシ) | 再生データ (レガシ) | |
| DescribePlayTopVideos | DescribePlayTopVideos | この操作を呼び出すと、上位動画の再生統計情報を日単位で取得できます。統計情報には、視聴回数、ユニークビジター数（UV）、合計再生時間が含まれます。 |
| DescribePlayUserAvg | DescribePlayUserAvg | 指定された時間範囲内における、1日あたりの平均再生に関する統計を照会します。 |
| DescribePlayUserTotal | DescribePlayUserTotal | 指定された時間範囲内の日次再生統計を照会します。再生統計には、総視聴回数、総視聴者数、総再生時間、および再生時間分布が含まれます。 |
| DescribePlayVideoStatis | DescribePlayVideoStatis | 指定された時間範囲内における、動画の毎日の再生統計を照会します。 |
マルチアプリケーションシステム
|
API |
タイトル |
説明 |
| アプリケーション管理 | アプリケーション管理 | |
| CreateAppInfo | CreateAppInfo | この API 操作を呼び出して、新しいアプリケーションを作成できます。 |
| DeleteAppInfo | DeleteAppInfo | アプリケーション情報を削除します。 |
| UpdateAppInfo | UpdateAppInfo | アプリケーションの情報を更新します。 |
| GetAppInfos | GetAppInfos | アプリケーション ID に基づいて、1 つ以上のアプリケーションの情報を照会します。 |
| ListAppInfo | ListAppInfo | この操作を呼び出して、指定されたクエリ条件に基づいてアプリケーション情報のリストを取得します。 |
| AddVodStorageForApp | AddVodStorageForApp | ApsaraVideo VOD の 1 つ以上のアプリケーションにストレージバケットをバインドします。 |
| 権限付与管理 | 権限付与管理 | |
| AttachAppPolicyToIdentity | AttachAppPolicyToIdentity | RAM ユーザーまたは RAM ロールに ApsaraVideo VOD アプリケーションへのアクセス権限を付与します。 |
| DetachAppPolicyFromIdentity | DetachAppPolicyFromIdentity | 指定された ID からアプリケーション権限を取り消します。ID は RAM ユーザーまたは RAM ロールです。 |
| ListAppPoliciesForIdentity | ListAppPoliciesForIdentity | 指定された ID にアタッチされているアプリケーションポリシーを照会します。ID は、RAM ユーザーまたは RAM ロールの場合があります。 |
| リソース移行 | リソース移行 | |
| MoveAppResource | MoveAppResource | アプリケーション間でリソースを移行します。アプリケーション管理者は、アプリケーション間でリソースを直接移行できます。Resource Access Management (RAM) ユーザーまたは RAM ロールがアプリケーション間でリソースを移行するには、移行元と移行先のアプリケーションに対する書き込み権限を取得する必要があります。一度に複数のリソースを移行できます。 |
| 再生キー | 再生キー | |
| GetAppPlayKey | GetAppPlayKey | アプリケーションの再生キーを取得します。 |
| SetAppPlayKey | SetAppPlayKey | アプリケーションの再生キーを設定します。 |
グローバル設定
|
API |
タイトル |
説明 |
| ストレージ管理 | ストレージ管理 | |
| SetCrossdomainContent | SetCrossdomainContent | クロスドメインポリシーファイル crossdomain.xml を更新します。 |
| イベント通知 | イベント通知 | |
| DeleteMessageCallback | DeleteMessageCallback | イベント通知のコールバックメソッド、コールバック URL、イベントタイプを削除します。 |
| SetMessageCallback | SetMessageCallback | この操作を呼び出して、イベント通知のコールバックメソッド、Webhook アドレス、およびイベントタイプを設定できます。 |
| GetMessageCallback | GetMessageCallback | イベント通知のコールバックメソッド、コールバック URL、イベントタイプを照会します。 |
その他
|
API |
タイトル |
説明 |
| ChangeResourceGroup | ChangeResourceGroup | 指定されたリソースグループにリソースを転送します。 |
| DescribeVodDomainMax95BpsData | DescribeVodDomainMax95BpsData | 高速化ドメイン名の 95 パーセンタイル帯域幅データをクエリします。 |
| DescribeVodSSLCertificateList | DescribeVodSSLCertificateList | この操作を呼び出して、ドメイン名の証明書リストをクエリできます。 |
| SetVodDomainSSLCertificate | SetVodDomainSSLCertificate | この操作は、ドメイン名の SSL 証明書機能を有効または無効にし、証明書情報を更新します。 |
| DescribeVodEditingUsageData | DescribeVodEditingUsageData | この API を呼び出すと、ビデオオンデマンド（VOD）のオンライン編集機能の使用量を照会できます。 |
| DescribeVodUserVipsByDomain | DescribeVodUserVipsByDomain | ドメイン名に関連付けられた IP アドレスのリストを照会します。 |