# Revocación de las sesiones del espectador de IVS
<a name="private-channels-start-session-revocation"></a>

Los clientes de Amazon IVS ahora pueden revocar la sesión de espectadores asociada a un token de autenticación para impedir y detener la reproducción con ese token. Un ejemplo de uso es la transición de una transmisión pública a una privada en la que solo un subconjunto de los espectadores de la transmisión pública pueda seguir viendo.

Para obtener información sobre el campo `viewer-id` mencionado en las instrucciones siguientes, consulte “Esquema de tokens” en [Generación y firma de tokens de reproducción de IVS](private-channels-generate-tokens.md).

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

Puede revocar la sesión del espectador a través de la CLI de AWS, si tiene el ARN del canal y el ID del espectador.

```
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>`, una entrada opcional, le permite especificar un filtro para ver qué versiones de la sesión de espectadores se van a revocar a la vez.

Puede omitir `--region <aws-region>` si la región se encuentra en su archivo de configuración local de AWS.

Si la operación se realiza con éxito, no hay respuesta.

Aquí tiene un ejemplo de respuesta de error:

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

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

Para obtener información sobre el uso, consulte [StartViewerSessionRevocation](https://docs.aws.amazon.com//ivs/latest/LowLatencyAPIReference/API_StartViewerSessionRevocation.html) en la *Referencia de la API de transmisión de baja latencia de IVS*. 

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

También existe una operación [BatchStartViewerSessionRevocation](https://docs.aws.amazon.com//ivs/latest/LowLatencyAPIReference/API_BatchStartViewerSessionRevocation.html).