ライブストリームの録音を照会します。
使用状況ノート
この操作は、メインのストリーミングドメインに適用できます。
QPS制限
1人のユーザーが1秒あたり最大50件のクエリ (QPS) を実行できます。 1秒あたりの呼び出し数がQPS制限を超えると、スロットリングがトリガーされます。 スロットルはビジネスに影響を与える可能性があります。 したがって、この操作のQPS制限を遵守することをお勧めします。 シングルユーザーの意味とQPSの詳細については、「ApsaraVideo LiveのAPI操作のQPS制限」をご参照ください。
デバッグ
リクエストパラメーター
| パラメーター | データ型 | 必須／任意 | 例 | 説明 |
| 操作 | 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 エラーセンター」をご参照ください。