LiveChannel のステータスを有効または無効に変更します。
使用上の注意
PutLiveChannelStatus を呼び出すときは、次の点に注意してください。
LiveChannel が無効になっている場合、OSS は LiveChannel へのストリームの取り込みを禁止します。無効になっている LiveChannel にストリームを取り込んでいる場合、クライアントは約 10 秒後に LiveChannel から切断されます。
LiveChannel にストリームが取り込まれない場合は、PutLiveChannel を呼び出して LiveChannel のステータスを変更することで、LiveChannel を再作成できます。
LiveChannel にストリームが取り込まれている場合は、PutLiveChannelStatus を呼び出して LiveChannel のステータスを無効に変更することのみ可能です。
権限
デフォルトでは、Alibaba Cloud アカウントは、アカウント内のリソースに対するすべての権限を持っています。一方、Alibaba Cloud アカウントに関連付けられた RAM ユーザーおよび RAM ロールは、最初は権限を持ちません。RAM ユーザーまたはロールを使用してリソースを管理するには、RAM ポリシーまたはバケットポリシーを使用して、必要な権限を付与する必要があります。
API | アクション | 説明 |
PutLiveChannelStatus | oss:PutLiveChannelStatus | LiveChannel のステータスを有効または無効に変更します。 |
リクエスト構文
PUT /ChannelName?live&status=NewStatus HTTP/1.1
Date: Tue, 25 Dec 2018 17:35:24 GMT
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValueリクエスト要素
要素 | タイプ | 必須 | 説明 |
status | String | はい | LiveChannel のステータス。 有効な値:
|
リクエストヘッダー
PutLiveChannelStatus リクエスト内のすべてのヘッダーは、共通のリクエストヘッダーです。詳細については、「共通の HTTP ヘッダー」をご参照ください。
レスポンスヘッダー
PutLiveChannelStatus リクエストへのレスポンス内のすべてのヘッダーは、共通のレスポンスヘッダーです。詳細については、「共通の HTTP ヘッダー」をご参照ください。
例
リクエストの例
PUT /test-channel?live&status=disabled HTTP/1.1
Date: Tue, 25 Dec 2018 17:35:24 GMT
Host: test-bucket.oss-cn-hangzhou.aliyuncs.com
Authorization: OSS qn6q**************:77Dv****************レスポンスの例
HTTP/1.1 200
Content-Length: 0
Server: AliyunOSS
Connection: close
x-oss-request-id: 57BE8422B92475920B00****
Date: Tue, 25 Dec 2018 17:35:24 GMT