# 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) 작업도 있습니다.