LiveChannelのステータスを有効または無効に変更します。
使用上の注意
PutLiveChannelStatusを呼び出すときは、次の項目に注意してください。
LiveChannelが無効になっている場合、OSSはLiveChannelへのストリームの取り込みを禁止します。 無効になっているLiveChannelにストリームを取り込む場合、クライアントは約10秒後にLiveChannelから切断されます。
ストリームがLiveChannelに取り込まれていない場合は、PutLiveChannelを呼び出してLiveChannelのステータスを変更することで、LiveChannelを再作成できます。
ストリームがLiveChannelに取り込まれている場合は、PutLiveChannelStatusのみを呼び出して、LiveChannelのステータスを無効に変更できます。
リクエスト構文
PUT /ChannelName?live&status=NewStatus HTTP/1.1
日付: 12月25日火曜日2018 17:35:24 GMT
ホスト: BucketName.oss-cn-hangzhou.aliyuncs.com
権限付与: SignatureValue
リクエスト要素
要素 | データ型 | 必須 | 説明 |
status | String | 必須 | LiveChannelのステータス。 有効な値:
|
リクエストヘッダー
PutLiveChannelStatusリクエストのすべてのヘッダーは、共通のリクエストヘッダーです。 詳細については、「共通HTTPヘッダー」をご参照ください。
レスポンスヘッダー
PutLiveChannelStatusリクエストに対するレスポンスのすべてのヘッダーは、共通のレスポンスヘッダーです。 詳細については、「共通HTTPヘッダー」をご参照ください。
例
リクエストの例
PUT /test-channel?live&status=disabled HTTP/1.1
日付: 12月25日火曜日2018 17:35:24 GMT
ホスト: test-bucket.oss-cn-hangzhou.aliyuncs.com
承認: OSS YJjHKOKWDWIN ****:X/mBrSbkNoqM/JoAfRC0ytyQ ****
レスポンスの例
HTTP/1.1 200
コンテンツ長: 0
サーバー: AliyunOSS
接続: 閉じる
x-oss-request-id: 57BE8422B92475920B00 ****
日付: 12月25日火曜日2018 17:35:24 GMT