# Révoquer des sessions d’utilisateur IVS
<a name="private-channels-start-session-revocation"></a>

Les clients d'Amazon IVS peuvent désormais révoquer la session d'utilisateur associée à un jeton d'authentification, afin d'empêcher et d'interrompre la lecture à l'aide de ce jeton. Un exemple de cas d’utilisation est la transition d’un flux public vers un flux privé au cours de laquelle seul un sous-ensemble des utilisateurs du flux public peut continuer à le regarder.

Pour plus d’informations sur le champ `viewer-id` mentionné dans les instructions ci-dessous, consultez « Schéma de jetons » sous [Générer et signer des jetons de lecture IVS](private-channels-generate-tokens.md).

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

Si vous disposez de l'ARN du canal et de l'ID de l'utilisateur, vous pouvez révoquer la session de l'utilisateur via l'interface de ligne de commande AWS (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>`, une entrée facultative, vous permet de spécifier un filtre pour les versions de la session d'utilisateur à révoquer simultanément.

Vous pouvez omettre `--region <aws-region>` si la région se trouve dans votre fichier de configuration AWS local.

Lorsque l’opération réussit, il n’y a pas de réponse.

Voici un exemple de réponse d’erreur :

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

## Requête d’API
<a name="private-channels-session-revocation-api"></a>

Pour plus d’informations sur l’utilisation, consultez [StartViewerSessionRevocation](https://docs.aws.amazon.com//ivs/latest/LowLatencyAPIReference/API_StartViewerSessionRevocation.html) dans la *Référence de l’API de diffusion à faible latence IVS*. 

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

Il existe également une opération [BatchStartViewerSessionRevocation](https://docs.aws.amazon.com//ivs/latest/LowLatencyAPIReference/API_BatchStartViewerSessionRevocation.html).