# Revogar sessões de visualizador do IVS
<a name="private-channels-start-session-revocation"></a>

Os clientes do Amazon IVS podem revogar a sessão do visualizador associada a um token de autenticação para impedir e interromper a reprodução usando esse token. Um exemplo de caso de uso é a transição de uma transmissão pública para uma transmissão privada na qual somente um subconjunto dos visualizadores da transmissão pública pode continuar assistindo.

Para obter informações sobre o campo `viewer-id` mencionado nas instruções abaixo, consulte o “Esquema de token” em [Gerar e assinar tokens de reprodução do IVS](private-channels-generate-tokens.md).

## Instruções da CLI
<a name="private-channels-session-revocation-cli"></a>

Você pode revogar a sessão do visualizador por meio da AWS CLI caso tenha o ARN do canal e o ID do visualizador.

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

Por ser uma entrada opcional, `--viewer-session-versions-less-than-or-equal-to <version>` permite especificar um filtro para quais versões da sessão do visualizador revogar de uma só vez.

É possível omitir `--region <aws-region>` se a região estiver em seu arquivo de configuração local da AWS.

No sucesso, não há resposta.

Esta é uma resposta de exemplo:

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

## Solicitações de API
<a name="private-channels-session-revocation-api"></a>

Para obter informações de uso, consulte [StartViewerSessionRevocation](https://docs.aws.amazon.com//ivs/latest/LowLatencyAPIReference/API_StartViewerSessionRevocation.html) na *Referência de API do streaming de baixa latência do IVS*. 

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

Também há uma operação [BatchStartViewerSessionRevocation](https://docs.aws.amazon.com//ivs/latest/LowLatencyAPIReference/API_BatchStartViewerSessionRevocation.html).