# 撤消 IVS 查看者会话
<a name="private-channels-start-session-revocation"></a>

Amazon IVS 客户能够撤消与身份验证令牌关联的查看者会话，以阻止和停止使用该令牌进行播放。一个示例用例是将公有流转换为私有流，其中只有一部分公有流查看者可以继续观看。

有关以下说明中提及的 `viewer-id` 字段的信息，请参阅 [生成并签名 IVS 播放令牌](private-channels-generate-tokens.md) 下的“令牌架构”。

## CLI 说明
<a name="private-channels-session-revocation-cli"></a>

如果您有通道 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>` 允许您指定一个筛选器，以便一次撤消查看者会话的哪个版本。

如果区域位于您的本地亚马逊云科技配置文件中，您可以忽略 `--region <aws-region>`。

如果成功，则没有响应。

以下是错误响应示例：

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

## API 请求
<a name="private-channels-session-revocation-api"></a>

有关使用情况信息，请参阅《IVS 低延迟直播功能 API 参考》**中的 [StartViewerSessionRevocation](https://docs.aws.amazon.com//ivs/latest/LowLatencyAPIReference/API_StartViewerSessionRevocation.html)。

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

还有一个 [BatchStartViewerSessionRevocation](https://docs.aws.amazon.com//ivs/latest/LowLatencyAPIReference/API_BatchStartViewerSessionRevocation.html) 操作。