UpdateMediaStorageConfiguration - Amazon Kinesis Video Streams

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

UpdateMediaStorageConfiguration

關聯SignalingChannel到一個流來存儲媒體。您可以指定兩種信號模式:

  • StorageStatus果啟用,資料將儲存在StreamARN提供的。為了讓 WebRTC 技術擷取能夠運作,串流必須啟用資料保留。

  • 如果StorageStatus停用,則不會儲存任何資料,也不需要StreamARN參數。

重要

如果啟StorageStatus用,則不會再發生直接 peer-to-peer (主要檢視器) 連線。對等直接連線至儲存區工作階段。您必須呼叫 JoinStorageSession API 來觸發 SDP 選件傳送,並建立對等與儲存工作階段之間的連線。

請求語法

POST /updateMediaStorageConfiguration HTTP/1.1 Content-type: application/json { "ChannelARN": "string", "MediaStorageConfiguration": { "Status": "string", "StreamARN": "string" } }

URI 請求參數

請求不會使用任何 URI 參數。

請求主體

請求接受採用 JSON 格式的下列資料。

ChannelARN

Amazon 資源名稱(ARN)的通道。

類型:字串

長度限制:長度下限為 1。長度上限為 1024。

模式:arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+

必要:是

MediaStorageConfiguration

封裝或包含媒體儲存裝置組態屬性的結構。

類型:MediaStorageConfiguration 物件

必要:是

回應語法

HTTP/1.1 200

回應元素

如果動作成功,則服務會傳回具空 HTTP 內文的 HTTP 200 回應。

錯誤

如需所有動作常見錯誤的資訊,請參閱常見錯誤

AccessDeniedException

您沒有執行此作業所需的權限。

狀態碼:4

ClientLimitExceededException

Kinesis Video Streams 已限制要求,因為您已經超過允許的用戶端呼叫限制。稍後再嘗試撥打電話。

HTTP 狀態碼:400

InvalidArgumentException

此輸入參數的值無效。

HTTP 狀態碼:400

NoDataRetentionException

以小時為單位的串流資料保留等於零。

HTTP 狀態碼:400

ResourceInUseException

當輸入StreamARNChannelARN in CLOUD_STORAGE_MODE 已對應至不同的 Kinesis Video Stream 資源,或者如果提供的輸入StreamARN或不處ChannelARN於作用中狀態,請嘗試下列其中一種方法:

  1. 用於確定給定通道的流映射到的 DescribeMediaStorageConfiguration API。

  2. 用於確定給定流映射到的信道的 DescribeMappedResourceConfiguration API。

  3. DescribeSignalingChannel用來判斷資源狀態的DescribeStream或 API。

HTTP 狀態碼:400

ResourceNotFoundException

Amazon Kinesis Video Streams 找不到您指定的串流。

HTTP 狀態碼:404

另請參閱

如需在其中一個特定語言 AWS SDK 中使用此 API 的詳細資訊,請參閱下列內容: