Revocar sesiones de espectadores

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 Generar y firmar tokens de reproducción.

Instrucciones de la CLI

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

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

También hay un BatchStartViewerSessionRevocation punto final. Consulte la Referencia de la API de streaming de baja latencia de IVS.