# 撤銷 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>` 可讓您指定要一次撤銷的檢視器工作階段版本之篩選器。

如果區域位於本機 AWS 組態檔案中，您可以省略 `--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) 操作。