すべてのプロダクト
Search

このプロダクト

    ApsaraVideo Live:AddLiveRecordVodConfig

    ドキュメントセンター

    ApsaraVideo Live:AddLiveRecordVodConfig

    最終更新日:May 27, 2026

    ApsaraVideo VOD に録画を保存する、ライブから VOD 設定を作成します。

    操作説明

    • ApsaraVideo for VOD に録画を保存すると、動画結合やトランスコードなどの自動処理がトリガーされ、サービス内で動画処理料金が発生します。詳細については、動画編集の課金および動画トランスコーディングの課金をご参照ください。自動結合およびトランスコードに関するよくある質問は、ライブから VOD のよくある質問をご参照ください。

    • Alibaba Finance Cloud のアカウントでは、ライブから VOD 機能は利用できません。

    QPS 制限

    この API の QPS 制限は、1 ユーザーあたり毎分 1,000 回です。この制限を超えると、API 呼び出しがスロットリングされ、ビジネスに影響を与える可能性があります。スロットリングを回避するには、適切なレートで 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 ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    live:AddLiveRecordVodConfig

    create

    *Domain

    acs:cdn:*:{#accountId}:domain/{#DomainName}

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    RegionId

    string

    任意

    リージョン ID です。値の例 cn-shanghai は、China (Shanghai) リージョンを示します。

    cn-shanghai
    DomainName

    string

    必須

    ストリーミングドメインです。

    説明

    ApsaraVideo VOD がストリーミングドメインと同じリージョンで有効になっていることを確認してください。

    example.com
    AppName

    string

    必須

    ストリームが属するアプリケーションの名前です。この値は、ストリーム管理ページで確認できます。

    testName
    StreamName

    string

    任意

    ストリーム名です。この値は、ストリーム管理ページで確認できます。

    stream
    VodTranscodeGroupId

    string

    任意

    重要 RecordFormat が指定されている場合、このパラメーターは無視されます。
    録画した動画をトランスコードするための ApsaraVideo VOD トランスコードテンプレートグループの ID です。

    e2d796d3bb5fd8049d32bff62f94****
    CycleDuration

    integer

    任意

    サイクル期間 (秒単位) です。デフォルト値は 3600 です。値の範囲は 300～21600 です。

    300
    AutoCompose

    string

    任意

    重要 RecordFormat が指定されている場合、このパラメーターは無視されます。
    ライブストリームの終了後に、複数の録画サイクルのファイルを自動的に 1 つのファイルに結合するかどうかを指定します。

    値が ON の場合、自動結合が有効になります。有効にした場合は、ComposeVodTranscodeGroupId パラメーターも指定する必要があります。デフォルトでは、自動結合は無効です。

    ON
    SpaceId

    string

    任意

    VOD アプリケーションスペースの ID です。この ID は、VOD コンソールから、またはアプリケーション情報をクエリする API オペレーションを呼び出すことによって取得できます。このパラメーターは、VOD アプリケーションスペース機能が有効になっている場合にのみ適用されます。

    app-1000000
    StorageLocation

    string

    任意

    ストレージロケーションです。

    ****-tjptr2vatm.oss-cn-shanghai.aliyuncs.com
    ComposeVodTranscodeGroupId

    string

    任意

    重要 RecordFormat が指定されている場合、このパラメーターは無視されます。
    結合されたビデオをトランスコードするための ApsaraVideo VOD トランスコードテンプレートグループの ID です。AutoCompose が ON に設定されている場合、このパラメーターは必須です。

    *****
    OnDemand

    integer

    任意

    録画トリガーモードです。有効な値：

    • 0 (デフォルト) ：自動録画。

    • 1：HTTP コールバックによってトリガーされるオンデマンド録画。

    • 2：インジェストパラメーターによってトリガーされるオンデマンド録画。

    • 7：手動録画。RealTimeRecordCommand API を呼び出して録画を開始および停止できます。

    0
    RecordContent

    string

    任意

    録画するコンテンツです。有効な値：

    • raw (デフォルト) ：ソースストリームを録画します。

    • transcode：トランスコード済みストリームを録画します。

    ソースストリームとトランスコード済みストリームの両方を録画するには、raw,transcode のようにカンマ区切りのリストを指定します。

    説明

    このパラメーターに transcode を含める場合、TranscodeTemplates パラメーターに少なくとも 1 つのテンプレートを指定する必要があります。

    raw
    DelayTime

    integer

    任意

    ストリームの中断タイムアウト (秒) です。ストリームの中断がこの期間より短い場合、録画は同じファイルで続行されます。中断がこの期間より長い場合は、新しいファイルが作成されます。有効な値：15～21600

    180
    RecordFormat

    array<object>

    任意

    フォーマット固有の録画設定のリストです。

    object

    任意

    録画フォーマットの設定です。

    Format

    string

    任意

    録画フォーマットです。有効な値：

    • m3u8

    • flv

    • mp4

    m3u8
    SliceDuration

    integer

    任意

    スライス期間 (秒単位) です。

    このパラメーターは m3u8 フォーマットにのみ適用されます。

    値は 5～30 の範囲でなければなりません。デフォルトは 30 です。

    30
    AutoCompose

    string

    任意

    ストリーム終了後に、このフォーマットの録画ファイルを自動的に結合するかどうかを指定します。有効な値：

    • ON：自動結合を有効にします。

    • OFF：自動結合を無効にします。

    ON
    VideoProcess

    string

    任意

    処理するビデオソースです。有効な値：

    • origin (デフォルト) ：サイクルごとの録画ファイル。

    • compose：すべてのサイクルから構成された単一のビデオファイル。

    両方のビデオソースを処理するには、origin,compose のように値をカンマ (,) で区切ります。

    origin
    ProcessMethod

    string

    任意

    ビデオ処理方法です。有効な値：

    • transcode：トランスコードテンプレートグループを使用してビデオを処理します。

    • workflow：ワークフローを使用してビデオを処理します。

    transcode
    ProcessTemplateId

    string

    任意

    トランスコードテンプレートグループまたはワークフローの ID です。

    説明

    指定された ID は ProcessMethod と一致する必要があります。たとえば、ProcessMethod が transcode の場合はトランスコードテンプレートグループ ID を、ProcessMethod が workflow の場合はワークフロー ID を指定します。

    e2d796d3bb5fd8049d32bff62f94****
    Tags

    string

    任意

    動画分類用のタグです。

    sports
    TranscodeTemplates

    array

    任意

    トランスコード済みストリームを録画するためのトランスコードテンプレートのリストです。

    string

    任意

    • トランスコードテンプレートの名前。最大 10 個のテンプレートを指定できます。

    • RecordContent に transcode を含める場合は、少なくとも 1 つのテンプレートを指定する必要があります。

    • 利用可能なすべてのトランスコード済みストリームを録画するには、値としてワイルドカード文字 (*) を指定します。例： TranscodeTemplates.1=*。

    説明

    値 raw は予約されており、使用できません。
    TranscodeTemplates.N の N は、1 から始まる各テンプレートのインデックスです。例： TranscodeTemplates.1=sd および TranscodeTemplates.2=hd。

    sd

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    レスポンスボディです。

    RequestId

    string

    リクエスト ID です。

    16A96B9A-F203-4EC5-8E43-CB92E68F****

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F****"
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 ConfigAlreadyExists Config has already exist.
    400 CommomLiveRcordConfigExisted Commom liverecord config has already exist.
    400 InvalidAutoCompose.Malformed Specified parameter AutoCompose is not valid.
    400 InvalidAutoComposeAndComposeVodTranscodeGroupId.Malformed Specified parameter AutoCompose and ComposeVodTranscodeGroupId is not valid, must both empty or input
    400 InvalidParam %s.
    500 InternalError The request processing has failed due to backend service exception.
    403 InvalidRegion.Conflict Specified parameter StorageLocation and Region is not match
    404 InvalidStorage.NotFound Specified parameter StorageLocation is not exist
    404 InvalidTemplateGroupId.NotFound Specified parameter vodTranscodeGroupId or composeVodTranscodeGroupId is not exist

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

    変更履歴

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