Revogar sessões de visualizador

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.

Instruções da CLI

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

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

Também há um BatchStartViewerSessionRevocation endpoint. Confira a Referência de API do streaming de baixa latência do IVS.