# Revoca delle sessioni dello spettatore IVS
<a name="private-channels-start-session-revocation"></a>

I clienti di Amazon IVS possono revocare la sessione dello spettatore associata a un token di autenticazione per impedire e interrompere la riproduzione con il token in questione. Un esempio di utilizzo è la transizione da uno streaming pubblico a uno privato in cui solo un sottoinsieme degli spettatori dello streaming pubblico può continuare a guardare.

Per informazioni sul campo `viewer-id` menzionato nelle istruzioni riportate di seguito, consulta la sezione "Schema dei token" in [Generare e firmare token di riproduzione IVS](private-channels-generate-tokens.md).

## Istruzioni per la CLI
<a name="private-channels-session-revocation-cli"></a>

È possibile revocare la sessione dello spettatore attraverso AWS CLI, se si dispone dell'ARN del canale e dell'ID dello spettatore.

```
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>` è un input facoltativo che consente di specificare un filtro per le versioni della sessione dello spettatore da revocare contemporaneamente.

Puoi omettere `--region <aws-region>` se la Regione è nel tuo file di configurazione AWS locale.

Se l'operazione va a buon fine, non c'è risposta.

Di seguito puoi trovare un esempio di risposta di errore:

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

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

Per informazioni sull'utilizzo, consulta [StartViewerSessionRevocation](https://docs.aws.amazon.com//ivs/latest/LowLatencyAPIReference/API_StartViewerSessionRevocation.html) nella *Documentazione di riferimento dell'API di streaming a bassa latenza IVS*. 

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

Esiste anche un'operazione [BatchStartViewerSessionRevocation](https://docs.aws.amazon.com//ivs/latest/LowLatencyAPIReference/API_BatchStartViewerSessionRevocation.html).