すべてのプロダクト
Search
ドキュメントセンター

ApsaraVideo Live:HotLiveRtcStream

最終更新日:Jan 14, 2026

リアルタイムコミュニケーション (RTC) ストリームをプリフェッチします。

操作説明

QPS 制限

単一ユーザーの 1 秒あたりのクエリ数 (QPS) 制限は、1 秒あたり 10 呼び出しです。この制限を超えた 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:HotLiveRtcStream

none

*Domain

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

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

RegionId

string

任意

リージョン ID。

cn-shanghai

DomainName

string

必須

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

example.com

AppName

string

必須

プリフェッチするライブストリームのアプリケーション名。

app

StreamName

string

必須

プリフェッチするライブストリームの名前。

stream

RegionCode

string

必須

プリフェッチエリア。詳細については、RegionCode ルックアップテーブルをご参照ください。

説明

中国国内のリージョンについては、「中国のリージョンコード」テーブルから対応するコードを指定してください。その他のすべてのリージョンについては、国別コードを指定してください。

  • RegionCode を指定した後に CodeRegionHasNoNode エラーが返された場合、対応するエリアは L1 ノードでカバーされておらず、プリフェッチできません。この場合は、別の RegionCode を指定してください。

ZHJ

AudioMsid

string

必須

オーディオ Msid。

rts audio

VideoMsid

string

必須

ビデオ Msid。

rts video

ConnectionTimeout

string

任意

プリフェッチ接続を維持する期間。単位:ミリ秒。デフォルト値の 0 は、接続が常に維持されることを意味します。

0

MediaTimeout

string

任意

タイムアウトイベントのカスタムタイムアウト期間。単位:ミリ秒。

100000

RegionCode ルックアップテーブル

中国のリージョンコード

名前コード
北京BEJ
天津TAJ
河北HEB
山西SHX
内モンゴルNMG
遼寧LIA
吉林JIL
黒竜江HLJ
上海SHH
江蘇JSU
浙江ZHJ
安徽ANH
福建FUJ
江西JXI
山東SHD
河南HEN
湖北HUB
湖南HUN
広東GUD
広西GXI
海南HAI
重慶CHQ
四川SCH
貴州GUI
雲南YUN
チベットTIB
陝西SHA
甘粛GAN
青海QIH
寧夏NXA
新疆XIN
台湾TAI
香港HKG
マカオMAC

国別コード

名前コード
パプアニューギニアPG
スロバキアSK
ペルーPE
ラトビアLV
アラブ首長国連邦AE
カナダCA
キューバCU
モーリタニアMR
日本JP
アルメニアAM
トルクメニスタンTM
ロシアRU
ベラルーシBY
ギニアGN
イラクIQ
アルゼンチンAR
チリCL
エスワティニSZ
コンゴ (DRC)CD
ベルギーBE
カザフスタンKZ
セルビアRS
トルコTR
ナミビアNA
リトアニアLT
プエルトリコPR
コンゴ (ブラザビル)CG
ニューカレドニアNC
モロッコMA
グリーンランドGL
クウェートKW
リベリアLR
ウクライナUA
インドネシアID
ミャンマーMM
ボリビアBO
モルドバMD
ギリシャGR
ニュージーランドNZ
ソロモン諸島SB
エチオピアET
フィジーFJ
イエメンYE
キプロスCY
ボスニア・ヘルツェゴビナBA
エリトリアER
ドイツDE
パキスタンPK
中央アフリカ共和国CF
クロアチアHR
エジプトEG
タイTH
コスタリカCR
タンザニアTZ
ラオスLA
リビアLY
チュニジアTN
ポーランドPL
イギリスGB
赤道ギニアGQ
中国CN
アイスランドIS
オマーンOM
モンゴルMN
チャドTD
米国US
メキシコMX
キルギスKG
スリナムSR
インドIN
ギニアビサウGW
ベネズエラVE
イタリアIT
アルジェリアDZ
カタールQA
フランスFR
南アフリカZA
ノルウェーNO
ポルトガルPT
ハンガリーHU
韓国KR
ウズベキスタンUZ
ブルンジBI
エストニアEE
バングラデシュBD
ブータンBT
アフガニスタンAF
スイスCH
ベリーズBZ
東ティモールTL
ハイチHT
トーゴTG
アルバニアAL
カメルーンCM
ニカラグアNI
ナイジェリアNG
ホンジュラスHN
ブルキナファソBF
モザンビークMZ
ジョージアGE
バヌアツVU
パラグアイPY
ルクセンブルクLU
レバノンLB
ウガンダUG
マリML
サウジアラビアSA
パレスチナPS
モンテネグロME
コロンビアCO
フィリピンPH
スウェーデンSE
フィンランドFI
ケニアKE
ルーマニアRO
パナマPA
ヨルダンJO
ルワンダRW
レソトLS
北マケドニアMK
ザンビアZM
シリアSY
スペインES
エクアドルEC
ガボンGA
アイルランドIE
ドミニカ共和国DO
ガーナGH
マダガスカルMG
マレーシアMY
オーストリアAT
タジキスタンTJ
デンマークDK
ウルグアイUY
カンボジアKH
セネガルSN
エルサルバドルSV
シエラレオネSL
ブルネイ・ダルサラームBN
西サハラEH
ニジェールNE
イランIR
ガイアナGY
アンゴラAO
ボツワナBW
ブラジルBR
オーストラリアAU
コートジボワールCI
チェコ共和国CZ
ガンビアGM
ベナンBJ
ベトナムVN
スーダンSD
オランダNL
ジブチDJ
スロベニアSI
ネパールNP
ジンバブエZW
ジャマイカJM
マラウイMW
アゼルバイジャンAZ
ソマリアSO
イスラエルIL
フォークランド諸島 (マルビナス)FK
北朝鮮KP
グアテマラGT
バハマBS
スリランカLK
シンガポールSG
バーレーンBH

レスポンスフィールド

フィールド

説明

object

リクエストの ID。

RequestId

string

リクエスト ID。

16BFE188-B193-4C3C-ADC5-79A7E31486EA

成功レスポンス

JSONJSON

{
  "RequestId": "16BFE188-B193-4C3C-ADC5-79A7E31486EA"
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 InvalidParam Parameter invalid.
400 NoSpecialConfiguration no special configuration for domain name.
400 CodeRegionHasNoNode this region has no corresponding node.
500 InternalError The request processing has failed due to backend service exception.

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

変更履歴

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