ライブストリームの録音を照会します。

使用状況ノート

この操作は、メインのストリーミングドメインに適用できます。

QPS制限

1人のユーザーが1秒あたり最大50件のクエリ (QPS) を実行できます。 1秒あたりの呼び出し数がQPS制限を超えると、スロットリングがトリガーされます。 スロットルはビジネスに影響を与える可能性があります。 したがって、この操作のQPS制限を遵守することをお勧めします。 シングルユーザーの意味とQPSの詳細については、「ApsaraVideo LiveのAPI操作のQPS制限」をご参照ください。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

パラメーター データ型 必須/任意 説明
操作 String 必須 DescribeLiveStreamRecordContent

実行したい操作。 値をDescribeLiveStreamRecordContentに設定します。

AppName String 必須 liveApp ****

ライブストリームが属するアプリケーションの名前。

DomainName String 必須 example.com

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

EndTime String 必須 2017-12-22T08:00:00Z

照会する時間範囲の終わり。 StartTimeパラメーターとEndTimeパラメーターで指定された期間は、4日を超えることはできません。 ISO 8601標準のyyyy-MM-dd T HH:mm:ss Z形式で時刻を指定します。 時刻はUTCである必要があります。

StartTime String 必須 2017-12-21T08:00:00Z

クエリする時間範囲の先頭。 過去6か月以内のレコードのみをクエリできます。 ISO 8601標準のyyyy-MM-dd T HH:mm:ss Z形式で時刻を指定します。 時刻はUTCである必要があります。

StreamName String 必須 liveStream ****

ライブストリームの名前。

レスポンスパラメーター

パラメーター データ型 説明
RecordContentInfoList RecordContentInfoの配列

録音。

RecordContentInfo
OssEndpoint String oss-cn-shanghai.aliyuncs.com

Object Storage Service (OSS) のエンドポイント。

OssBucket String liveBucket ****

記録が保存されているOSSバケットの名前。

OssObjectPrefix String レコード /{日付}/{UnixTimestamp }_{ シーケンス}

OSSでの録音の命名規則。

StartTime String 2015-12-01T07:36:00Z

録音の開始時間。 時間は、 Z形式のISO 8601標準に従います。 時刻はUTCで表示されます。

EndTime String 2015-12-01T07:46:00Z

録音の終了時間。 時間は、 Z形式のISO 8601標準に従います。 時刻はUTCで表示されます。

有効期間 Float 10

記録の長さ。 (単位:秒)

RequestId String 62136AE6-7793-45ED-B14A-60D19A9486D3

リクエストの ID です。

リクエストの例

http(s):// live.aliyuncs.com/? アクション=DescribeLiveStreamRecordContent
&AppName=liveApp ****
&DomainNam e=example.com
&EndTime=2017-12-22T08:00:00Z
&StartTime=2017-12-21T08:00:00Z
&StreamName=liveStream ****
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式

<DescribeLiveStreamRecordContentResponse>
      <RecordContentInfoList>
            <RecordContentInfo>
                  <期間> 14638</期間>
                  <EndTime>2016-05-25T09:41:09Z</EndTime>
                  <OssBucket>liveBucket ****</OssBucket>
                  <OssEndpoin t>oss-cn-hangzhou.aliyuncs.com</OssEndpoint>
                  <OssObjectPrefix>record/{Date}/{UnixTimestamp }_{ Sequence}</OssObjectPrefix>
                  <StartTime>2016-05-25T05:37:11Z</StartTime>
            </RecordContentInfo>
      </RecordContentInfoList>
      <RequestId>62136AE6-7793-45ED-B14A-60D19A9486D3</RequestId>
</DescribeLiveStreamRecordContentResponse>

JSON 形式

{
    "RecordContentInfoList":{
        "RecordContentInfo":[{
            "期間":14638.0、
            "EndTime":"2016-05-25T09:41:09Z" 、
            "OssBucket":"liveBucket ****" 、
            "OssEndpoint":"oss-cn-hangzhou.aliyuncs.com" 、
            "OssObjectPrefix":"record/{Date}/{UnixTimestamp }_{ Sequence}" 、
            "StartTime":"2016-05-25T05:37:11Z"
        }]
    },
    "RequestId":"62136AE6-7793-45ED-B14A-60D19A9486D3"
}

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明
400 InvalidStartTime.Malformed 指定された StartTime は不正です。 開始時刻の形式が無効な場合に返されるエラーメッセージ。 StartTimeパラメーターの値が正しいかどうかを確認します。
400 InvalidEndTime.Malformed 指定された EndTime は不正です。 終了時刻の形式が無効な場合に返されるエラーメッセージ。 EndTimeパラメーターの値が正しいかどうかを確認します。
400 InvalidEndTime. ミスマッチ 指定された終了時間は、指定された開始時間を計算しません。 終了時刻が開始時刻より前の場合に返されるエラーメッセージ。 StartTimeパラメーターとEndTimeパラメーターの値が正しいかどうかを確認します。

エラーコードリストについては、「API エラーセンター」をご参照ください。