ビューアーセッションを取り消す

Amazon IVS の顧客は、認証トークンに関連付けられたビューアーセッションを取り消して、そのトークンを使用した再生を禁止または停止できます。ユースケースとして、パブリックストリームをプライベートストリームに移行して、パブリックストリームの一部の視聴者だけが引き続き視聴できるようにすることが挙げられます。

以下の手順に記載されている viewer-id フィールドの情報については、再生トークンの生成と署名 の「トークンスキーマ」を参照してください。

CLI の手順

チャネル ARN とビューアー ID があれば、AWS CLI を使用してビューアーセッションを取り消すことができます。

aws ivs start-viewer-session-revocation --channel-arn arn:aws:ivs:us-west-2:991729659840:channel/abcdABCDefgh --viewer-id UDbh1u6M8nrOoarrzuKe --region <aws-region>

オプション入力で、--viewer-session-versions-less-than-or-equal-to <version> はビューアーセッションのどのバージョンを一度に取り消すかのフィルターを指定できます。

リージョンがローカルの AWS 設定ファイルにある場合、--region <aws-region> を省略できます。

成功した場合はレスポンスがありません。

エラーレスポンスの例を次に示します。

An error occurred (ValidationException) when calling the StartViewerSessionRevocation operation: ValidationException:

API リクエスト

POST /StartViewerSessionRevocation HTTP/1.1
{
  "channelArn": <channel ARN>,
  "viewerId": <viewer ID>,
  "viewerSessionVersionsLessThanOrEqualTo": <version>
}

BatchStartViewerSessionRevocation エンドポイントもあります。IVS 低レイテンシーストリーミング API リファレンスを参照してください。