DescribeLiveStreamTranscodeInfo - - Alibaba Cloud ドキュメントセンター

トランスコーディング設定を照会します。

操作説明

この API 操作を呼び出して、取り込み用のストリーミングドメインを取得した後にトランスコーディング設定を照会できます。

QPS 制限

1 ユーザーあたりの 1 秒あたりのクエリ数 (QPS) 制限は、60 コール/秒です。この制限を超えると、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:DescribeLiveStreamTranscodeInfo

get

*All Resource

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
RegionId	string	任意	リージョン ID。	cn-shanghai
DomainTranscodeName	string	必須	取り込み用のストリーミングドメイン。	example.com
AppName	string	任意	ストリームが属するアプリケーションの名前。	myapp

レスポンスフィールド

フィールド	型	説明	例
	object	トランスコーディング設定。
RequestId	string	リクエスト ID。	62136AE6-7793-45ED-B14A-60D19A9486D3
DomainTranscodeList	object
DomainTranscodeInfo	array<object>	トランスコーディング設定。
	array<object>	トランスコーディング設定。
TranscodeApp	string	アプリケーション名。	liveApp****
TranscodeTemplate	string	トランスコーディングテンプレート。有効な値：標準トランスコーディングテンプレート： lld：低解像度。 lsd：標準解像度。 lhd：高解像度。 lud：超高解像度。狭帯域 HD™ トランスコーディングテンプレート： ld：低解像度。 sd：標準解像度。 hd：高解像度。 ud：超高解像度。	lld
IsLazy	boolean	オンデマンドトランスコーディングが有効になっているかどうかを示します。有効な値： true：オンデマンドトランスコーディングが有効になっています。 false：強制トランスコーディングが有効になっています。	true
TranscodeName	string	取り込み用のストリーミングドメイン。	example.com
CustomTranscodeParameters	object	カスタムトランスコーディング設定。
BitrateWithSource	object	アダプティブビットレートの設定。	{\"UpLimit\":2500,\"LowerLimit\":800,\"Factor\":1}
VideoProfile	string	ビデオエンコードプロファイル。有効な値： baseline：モバイルデバイスに適しています。 main：標準解像度のデバイスに適しています。 high：高解像度のデバイスに適しています。	high
AudioBitrate	integer	トランスコーディングの音声ビットレート。単位：kbps。有効な値：1～1000。	64
Height	integer	トランスコーディングのビデオの高さ。	1200
RtsFlag	string	低遅延のタグ。値は true に固定されています。説明このパラメーターは、低遅延トランスコーディングが使用されている場合にのみ返されます。	true
TemplateType	string	カスタムトランスコーディングテンプレートのタイプ。有効な値： h264：カスタム H.264 標準テンプレート。 h264-nbhd：カスタム H.264 狭帯域 HD™ テンプレート。 h265：カスタム H.265 標準テンプレート。 h265-nbhd：カスタム H.265 狭帯域 HD テンプレート。 audio：音声のみのテンプレート。	h264
Bframes	string	B フレームの数。値は 0 に固定されています。	0
ExtWithSource	object	その他のアダプティブ設定。	{\"KeyFrameOpen\":\"yes\",\"Copyts\":\"yes\",\"SeiMode\":1}
AudioRate	integer	音声サンプルレート。有効な値：22050～96000。説明 AudioProfile が aac_ld に設定されている場合、サンプルレートは 44100 を超えることはできません。	44100
FpsWithSource	object	アダプティブフレームレートの設定。	{\"UpLimit\":60,\"LowerLimit\":1}
AudioCodec	string	音声コーディング形式。	ACC
FPS	integer	トランスコーディングのビデオフレームレート。単位：フレーム/秒 (FPS)。	15
Gop	string	ビデオの Group of Pictures (GOP) サイズ。単位：フレーム。有効な値：1～3000。	10
Width	integer	トランスコーディングのビデオの幅。	1000
VideoBitrate	integer	トランスコーディングのビデオビットレート。単位：kbps。	3000
AudioChannelNum	integer	音声チャンネルの数。有効な値： 1：モノラル。 2：ステレオ。	2
AudioProfile	string	音声エンコードプロファイル。有効な値： aac_low aac_he aac_he_v2 aac_ld	aac_low
ResWithSource	object	アダプティブレゾリューションの設定。	{\"Type\":\"short\",\"Value\":\"1080\"}
DeInterlaced	boolean	トランスコーディング中にインターレースを自動的に検出して削除するかどうかを示します。これにより、インターレースコンテンツがプログレッシブコンテンツに変換されます。 true：インターレース解除が有効になっています。 false：ソース形式が保持されます。処理は実行されません。これがデフォルト値です。
EncryptParameters	object	暗号化設定。
EncryptType	string	暗号化タイプ。値は aliyun に固定されています。	aliyun
KmsKeyID	string	Key Management Service (KMS) のユーザーのプライマリキーの ID。	afce5722-81d2-43c3-9930-7601da11****
KmsKeyExpireInterval	string	キーローテーション間隔。単位：秒。有効な値：60～3600。	3600

例

成功レスポンス

JSONJSON

{
  "RequestId": "62136AE6-7793-45ED-B14A-60D19A9486D3",
  "DomainTranscodeList": {
    "DomainTranscodeInfo": [
      {
        "TranscodeApp": "liveApp****",
        "TranscodeTemplate": "lld",
        "IsLazy": true,
        "TranscodeName": "example.com",
        "CustomTranscodeParameters": {
          "BitrateWithSource": {
            "test": "test",
            "test2": 1
          },
          "VideoProfile": "high",
          "AudioBitrate": 64,
          "Height": 1200,
          "RtsFlag": "true",
          "TemplateType": "h264",
          "Bframes": "0",
          "ExtWithSource": {
            "test": "test",
            "test2": 1
          },
          "AudioRate": 44100,
          "FpsWithSource": {
            "test": "test",
            "test2": 1
          },
          "AudioCodec": "ACC",
          "FPS": 15,
          "Gop": "10",
          "Width": 1000,
          "VideoBitrate": 3000,
          "AudioChannelNum": 2,
          "AudioProfile": "aac_low",
          "ResWithSource": {
            "test": "test",
            "test2": 1
          },
          "DeInterlaced": false
        },
        "EncryptParameters": {
          "EncryptType": "aliyun",
          "KmsKeyID": "afce5722-81d2-43c3-9930-7601da11****",
          "KmsKeyExpireInterval": "3600"
        }
      }
    ]
  }
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ	説明
400	InvalidParameters	%s Please check and try again later.

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

変更履歴

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