本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # UpdateSignalingChannel 更新現有的訊號頻道。這是非同步操作，需要一些時間才能完成。如果`MessageTtlSeconds`值已更新（增加或減少），則僅適用於更新後透過此頻道傳送的新訊息。現有訊息仍會根據先前的`MessageTtlSeconds`值過期。 ## 請求語法 ``` POST /updateSignalingChannel HTTP/1.1 Content-type: application/json { "ChannelARN": "{{string}}", "CurrentVersion": "{{string}}", "SingleMasterConfiguration": { "MessageTtlSeconds": {{number}} } } ``` ## URI 請求參數請求不會使用任何 URI 參數。 ## 請求主體請求接受採用 JSON 格式的下列資料。 ** [ChannelARN](#API_UpdateSignalingChannel_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]+` 必要：是 ** [CurrentVersion](#API_UpdateSignalingChannel_RequestSyntax) ** 您要更新的訊號頻道目前版本。類型：字串長度限制：長度下限為 1。長度上限為 64。模式：`[a-zA-Z0-9]+` 必要：是 ** [SingleMasterConfiguration](#API_UpdateSignalingChannel_RequestSyntax) ** 包含您要更新之訊號頻道`SINGLE_MASTER`類型的組態的結構。具有頻道類型的頻道需要此參數和`SINGLE_MASTER`頻道訊息的time-to-live。類型：[SingleMasterConfiguration](API_SingleMasterConfiguration.md) 物件必要：否 ## 回應語法 ``` HTTP/1.1 200 ``` ## 回應元素如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤類型](CommonErrors.md)。 ** AccessDeniedException ** 您沒有執行此操作所需的許可。 HTTP 狀態碼：401 ** ClientLimitExceededException ** Kinesis Video Streams 已調節請求，因為您已超過允許的用戶端呼叫限制。稍後嘗試進行呼叫。 HTTP 狀態碼：400 ** InvalidArgumentException ** 此輸入參數的值無效。 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 ** VersionMismatchException ** 您指定的串流版本不是最新版本。若要取得最新版本，請使用 [DescribeStream](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_DescribeStream.html) API。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/UpdateSignalingChannel) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/UpdateSignalingChannel) + [AWS 適用於 C\+\+ 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/UpdateSignalingChannel) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/UpdateSignalingChannel) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/UpdateSignalingChannel) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/UpdateSignalingChannel) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/UpdateSignalingChannel) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/UpdateSignalingChannel) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/UpdateSignalingChannel) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/UpdateSignalingChannel)