ライブストリームのストリームプル設定を変更します。

使用状況ノート

このインターフェイスは現在、通常のストリームプルに適用できます。 このインターフェイスを呼び出して、配信元URL、ストリームのプルが開始される時刻、およびストリームのプルが終了する時刻などのライブストリーミング構成情報を更新します。

注 設定を変更すると、ApsaraVideo Liveは変更された設定に基づいてストリームをプルします。 変更がオンラインビジネスに影響しないことを確認してください。

QPS制限

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

デバッグ

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

リクエストパラメーター

パラメーター データ型 必須／任意 例 説明
操作 String 必須 UpdateLivePullStreamInfoConfig

実行する操作です。 値を

UpdateLivePullStreamInfoConfig。

AppName String 必須 liveApp ****

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

DomainName String 必須 example.com

ストリームプルで使用されるドメイン名。 It is the main streaming domain.

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

ストリームのプルが終了する時間。

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

SourceUrl String 必須 rtmp:// guide.aliyundoc.com/liveApp****/liveStream****;rtmp://developer.aliyundoc.com/liveApp****/liveStream****

ライブストリームのオリジンURL。 複数のオリジンURLを指定できます。 セミコロン (;) で区切ります。

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

ストリームのプルが開始される時刻。

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

StreamName String 必須 liveStream ****

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

レスポンスパラメーター

パラメーター データ型 例 説明
RequestId String 16A96B9A-F203-4EC5-8E43-CB92E68F4CF8

リクエストの ID です。

例

リクエストの例

http(s):// live.aliyuncs.com/?Action=UpdateLivePullStreamInfoConfig
&AppName=liveApp ****
&DomainNam e=example.com
&EndTime=2017-12-22T08:00:00Z
&SourceUrl=rtmp:// guide.aliyundoc.com/liveApp****/liveStream****;rtmp://developer.aliyundoc.com/liveApp****/liveStream****
&StartTime=2017-12-21T08:00:00Z
&StreamName=liveStream ****

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

XML 形式 

<UpdateLivePullStreamInfoResponse>
              <RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CF8</RequestId>
</UpdateLivePullStreamInfoResponse>

JSON 形式 

{
    "RequestId":"16A96B9A-F203-4EC5-8E43-CB92E68F4CF8"
}

エラーコード

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

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

特殊エラーコード

エラーコード

エラーメッセージ

HTTP ステータスコード

説明

InternalError

不明なエラーにより、リクエスト処理が失敗しました。

500

不明なエラーが発生した場合に返されるエラーメッセージ。

InvalidDomain.NotFound

The domain provided does not exist in our records.

404

ドメイン名がAlibaba Cloudアカウントに属していない場合に返されるエラーメッセージ。

IllegalOperation

Illegal domain operate is not permitted.

403

現在の操作がサポートされていない場合に返されるエラーメッセージ。 たとえば、指定されたドメイン名はライブドメインではありません。

期間を超える

StartTimeとEndTimeの間の期間が長すぎます。

400

StartTimeパラメーターとEndTimeパラメーターで指定された時間範囲が制限を超えた場合に返されるエラーメッセージ。