本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 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](#API_UpdateMediaStorageConfiguration_RequestSyntax) ** 頻道的 Amazon Resource Name (ARN)。類型：字串長度限制：長度下限為 1。長度上限為 1024。模式：`arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` 必要：是 ** [MediaStorageConfiguration](#API_UpdateMediaStorageConfiguration_RequestSyntax) ** 封裝或包含媒體儲存組態屬性的結構。類型：[MediaStorageConfiguration](API_MediaStorageConfiguration.md) 物件必要：是 ## 回應語法 ``` HTTP/1.1 200 ``` ## 回應元素如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤類型](CommonErrors.md)。 ** AccessDeniedException ** 您沒有執行此操作所需的許可。 HTTP 狀態碼：401 ** ClientLimitExceededException ** Kinesis Video Streams 已調節請求，因為您已超過允許的用戶端呼叫限制。稍後嘗試進行呼叫。 HTTP 狀態碼：400 ** InvalidArgumentException ** 此輸入參數的值無效。 HTTP 狀態碼：400 ** NoDataRetentionException ** 串流資料保留小時數等於零。 HTTP 狀態碼：400 ** ResourceInUseException ** 當輸入`StreamARN`或 `ChannelARN` 中的 `CLOUD_STORAGE_MODE` 已映射至不同的 Kinesis Video Stream 資源，或提供的輸入`StreamARN`或 `ChannelARN` 未處於作用中狀態時，請嘗試下列其中一個： 1. 用於判斷串流指定頻道所對應的 `DescribeMediaStorageConfiguration` API。 1. 用於判斷指定串流所對應的頻道的 `DescribeMappedResourceConfiguration` API。 1. 用於判斷資源狀態的 `DescribeStream`或 `DescribeSignalingChannel` API。 HTTP 狀態碼：400 ** ResourceNotFoundException ** Amazon Kinesis Video Streams 找不到您指定的串流。 HTTP 狀態碼：404 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/UpdateMediaStorageConfiguration) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/UpdateMediaStorageConfiguration) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/UpdateMediaStorageConfiguration) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/UpdateMediaStorageConfiguration) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/UpdateMediaStorageConfiguration) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/UpdateMediaStorageConfiguration) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/UpdateMediaStorageConfiguration) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/UpdateMediaStorageConfiguration) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/UpdateMediaStorageConfiguration) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/UpdateMediaStorageConfiguration)