UpdateStreamStorageConfiguration - Amazon Kinesis Video Streams
請求語法URI 請求參數請求主體回應語法回應元素錯誤另請參閱

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

UpdateStreamStorageConfiguration

更新現有 Kinesis 影片串流的儲存組態。

此操作可讓您修改串流的儲存層設定，讓您根據存取模式來最佳化儲存成本和效能。

UpdateStreamStorageConfiguration 是一種非同步操作。

您必須具備 KinesisVideo:UpdateStreamStorageConfiguration 動作的許可。

請求語法

POST /updateStreamStorageConfiguration HTTP/1.1
Content-type: application/json

{
   "CurrentVersion": "string",
   "StreamARN": "string",
   "StreamName": "string",
   "StreamStorageConfiguration": { 
      "DefaultStorageTier": "string"
   }
}

URI 請求參數

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

請求主體

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

CurrentVersion

您要變更其儲存組態的串流版本。若要取得 版本，請呼叫 DescribeStream或 ListStreams API。

類型：字串

長度限制：長度下限為 1。長度上限為 64。

模式：[a-zA-Z0-9]+

必要：是

StreamARN

您要更新儲存體組態之串流的 Amazon Resource Name (ARN)。

類型：字串

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

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

必要：否

StreamName

您要更新儲存體組態的串流名稱。

類型：字串

長度限制：長度下限為 1。長度上限為 256。

模式：[a-zA-Z0-9_.-]+

必要：否

StreamStorageConfiguration

串流的新儲存組態。這包括預設儲存層，可決定串流資料的儲存和存取方式。

不同的儲存層提供不同層級的效能和成本最佳化，以符合您的特定使用案例需求。

類型：StreamStorageConfiguration 物件

必要：是

回應語法

HTTP/1.1 200

回應元素

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

錯誤

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

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。

  2. 用於判斷指定串流所對應的頻道的 DescribeMappedResourceConfiguration API。

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

HTTP 狀態碼：400

ResourceNotFoundException

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

HTTP 狀態碼：404

VersionMismatchException

您指定的串流版本不是最新版本。若要取得最新版本，請使用 DescribeStream API。

HTTP 狀態碼：400

另請參閱

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：