ドメイン名でタイムシフト設定を照会します。
Usage note
This operation is applicable to the streaming domains.
QPS limit
1人のユーザーが1秒あたり最大10件のクエリ (QPS) を実行できます。 1秒あたりの呼び出し数がQPS制限を超えると、スロットリングがトリガーされます。 スロットルはビジネスに影響を与える可能性があります。 Thus, we recommend that you observe the QPS limit on this operation. シングルユーザーの意味とQPSの詳細については、「ApsaraVideo LiveのAPI操作のQPS制限」をご参照ください。
デバッグ
リクエストパラメーター
パラメーター | データ型 | 必須/任意 | 例 | 説明 |
操作 | String | 必須 | DescribeLiveShiftConfigs | 実行する操作です。 Set the value to DescribeLiveShiftConfigs. |
DomainName | String | 必須 | example.com | ストリーミングドメイン。 |
RegionId | String | 任意 | cn-shanghai | ストリーミングドメインが存在するリージョンのID。 |
レスポンスパラメーター
パラメーター | データ型 | 例 | 説明 |
Content | 構成の配列 | タイムシフト構成。 | |
Config | |||
AppName | String | liveApp **** | タイムシフトを設定するアプリケーション。 |
DomainName | String | example.com | タイムシフトを設定するドメイン名。 |
IgnoreTranscode | Boolean | true | トランスコードストリームのタイムシフト生成を無視するかどうか。
The default value is true. |
StreamName | String | liveStream **** | タイムシフトを設定するライブストリームの名前。 |
ビジョン | Integer | 7 | タイムシフト設定が保持される日数。 |
RequestId | String | B49E6DDA-F413-422B-B58E-2FA23F286726 | リクエストの ID です。 |
例
リクエストの例
http(s):// live.aliyuncs.com/?Action=DescribeLiveShiftConfigs
&DomainNam e=example.com
&<共通リクエストパラメーター>
正常に処理された場合のレスポンス例
XML
形式
<DescribeLiveShiftConfigsResponse>
<RequestId>B49E6DDA-F413-422B-B58E-2FA23F286726</RequestId>
<Content>
<Config>
<IgnoreTranscode>true</IgnoreTranscode>
<StreamName>liveStream ****</StreamName>
<DomainNam e>example.com</DomainName>
<ビジョン> 7</ビジョン>
<AppName>liveApp ****</AppName>
</Config>
</コンテンツ>
</DescribeLiveShiftConfigsResponse>
JSON
形式
{
"DescribeLiveShiftConfigsResponse": {
"RequestId": "B49E6DDA-F413-422B-B58E-2FA23F286726" 、
"コンテンツ": {
"Config": {
"IgnoreTranscode": true、
"StreamName": "liveStream ****" 、
"DomainName": "example.com",
"ビジョン": 7、
"AppName": "liveApp ****"
}
}
}
}
エラーコード
エラーコードリストについては、「API エラーセンター」をご参照ください。
特殊エラーコード
エラーコード | エラーメッセージ | HTTP ステータスコード | 説明 |
InvalidParam | param error | 400 | 指定された1つ以上のパラメーターが無効な場合に返されるエラーメッセージ。 |
InvalidDataNotFound | データが見つかりません | 404 | ユーザーデータが見つからない場合に返されるエラーメッセージ。 |