本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
撤銷檢視器工作階段
Amazon IVS 客戶可以撤銷與驗證符記關聯的檢視器工作階段,藉此防止和停止使用該符記的播放。範例使用案例是將公有串流轉換為私有串流,其中只有一部分公有串流觀眾可以繼續觀看。
如需有關下面的指示中提及的 viewer-id
欄位的資訊,請參閱 產生並簽章播放符記 下的「字符結構描述」。
CLI 說明
如果您擁有頻道 ARN 和檢視器 ID,則可以透過 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>
可讓您指定要一次撤銷的檢視器工作階段版本之篩選器。
如果區域位於本機 AWS 組態檔案中,您可以省略 --region <aws-region>
。
成功之後,沒有回應。
這是錯誤回應範例:
An error occurred (ValidationException) when calling the StartViewerSessionRevocation operation: ValidationException:
API 請求
POST /StartViewerSessionRevocation HTTP/1.1 { "channelArn": <channel ARN>, "viewerId": <viewer ID>, "viewerSessionVersionsLessThanOrEqualTo": <version> }
還有一個 BatchStartViewerSessionRevocation 端點。請參閱 IVS 低延遲串流 API 參考。