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

# Amazon Kinesis Video Streams 服務配額
<a name="limits"></a>

Kinesis Video Streams 具有下列服務配額：

**重要**  
下列服務配額為軟式 **【s】**，可透過提交支援票證進行升級，或硬式 **【h】**，無法增加。您會在下表中看到個別服務配額旁的 【s】 和 【h】。

## 控制平面 API 服務配額
<a name="limits-akv-control"></a>

下一節說明控制平面 APIs 的服務配額。TPS 代表*每秒的交易*。

達到帳戶層級或資源層級請求限制時，`ClientLimitExceededException`會擲回 。


| API | 帳戶限制：請求 | 帳戶限制：串流 | 串流層級限制 | 相關例外狀況和備註 | 
| --- | --- | --- | --- | --- | 
| CreateStream | 50 TPS [s] | 在所有支援的區域中，每個帳戶 【s】 有 10，000 個串流。 此限制可以提高到每個帳戶 100,000 個 (或更多) 串流。登入 AWS 管理主控台 位於 的 ，[https://console.aws.amazon.com/](https://console.aws.amazon.com/)並請求提高此限制。  |  | 裝置、CLI、SDK 導向的存取和主控台，全都可以呼叫此 API。如果串流不存在，只會有一個 API 呼叫成功。 | 
| DeleteEdgeConfiguration | 10 TPS [h] | N/A | 1 TPS [h] |  | 
| DeleteStream | 50 TPS [h] | N/A | 5 TPS [h] |  | 
| DescribeEdgeConfiguration | 50 TPS [h] | N/A | 5 TPS [h] |  | 
| DescribeImageGenerationConfiguration | 50 TPS [h]  | N/A | 5 TPS [h] |  | 
| DescribeMappedResourceConfiguration | 50 TPS [h]  | N/A | 5 TPS [h] |  | 
| DescribeNotificationConfiguration | 50 TPS [h]  | N/A | 5 TPS [h] |  | 
| DescribeStream | 300 TPS [h] | N/A | 5 TPS [h] |  | 
| GetDataEndpoint | 300 TPS [h] | N/A | 5 TPS [h] | 每 45 分鐘進行呼叫，以為大部分的 PutMedia/GetMedia 使用案例重新整理串流字符。若應用程式在故障時重新載入快取資料端點，快取資料端點仍是安全的。 | 
| ListEdgeAgentConfigurations | 50 TPS [h] | N/A | N/A |  | 
| ListStreams | 50 TPS [h] | N/A |  |  | 
| ListTagsForStream | 50 TPS [h]  | N/A | 5 TPS [h] |  | 
| StartEdgeConfigurationUpdate | 10 TPS [h] | N/A | 1 TPS [h] |  | 
| TagStream | 50 TPS [h]  | N/A | 5 TPS [h] |  | 
| UntagStream | 50 TPS [h]  | N/A | 5 TPS [h] |  | 
| UpdateDataRetention | 50 TPS [h]  | N/A | 5 TPS [h] |  | 
| UpdateImageGenerationConfiguration | 50 TPS [h]  | N/A | 5 TPS [h] |  | 
| UpdateNotificationConfiguration | 50 TPS [h]  | N/A | 5 TPS [h] |  | 
| UpdateStream | 50 TPS [h] | N/A | 5 TPS [h] |  | 
| UpdateStreamStorageConfiguration | 50 TPS [h] | N/A | 5 TPS [h] |  | 
| DescribeStreamStorageConfiguration | 50 TPS [h] | N/A | 5 TPS [h] |  | 

## 媒體和封存媒體 API 服務配額
<a name="limits-akv-data"></a>

下一節說明媒體和封存媒體 APIs 的服務配額。

達到帳戶層級或資源層級請求限制時，`ClientLimitExceededException`會擲回 。

當達到連接層級限制時，就會擲出 `ConnectionLimitExceededException`。

當達到片段層級的限制時，就會擲出以下錯誤或 ack：
+ 傳回的片段 `MIN_FRAGMENT_DURATION_REACHED` ack 低於持續時間下限。
+ 傳回的片段 `MAX_FRAGMENT_DURATION_REACHED` ack 高於持續時間上限。
+ 傳回的片段 `MAX_FRAGMENT_SIZE` ack 高於資料大小上限。
+ 如果 `FragmentLimitExceeded` 操作中達到片段限制，就會擲出 `GetMediaForFragmentList` 例外。

**資料平面 API 服務配額**


| API | 串流層級限制 | 連接層級限制 | 頻寬限制 | 片段層級限制 | 相關例外狀況和備註 | 
| --- | --- | --- | --- | --- | --- | 
| PutMedia | 5 TPS [h] | 1 【h】 | 每秒 12.5 MB，或每個串流 100 Mbps 【s】 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/kinesisvideostreams/latest/dg/limits.html) | [PutMedia](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_PutMedia.html) 請求是串流、長時間執行的連線。您不需要為每個資料開啟新的連線，因為您可以在單一持久性連線中傳送多個片段。如果您嘗試多個並行PutMedia連線，Kinesis Video Streams 會使用ConnectionLimitExceededException錯誤訊息調節最新的連線。 | 
| GetClip | N/A | N/A | 100 MB 的大小限制 [h] | 片段數量上限：200 [h] |  | 
| GetDASHStreamingSessionURL | 25 TPS 【h】 | N/A | N/A | N/A |  | 
| GetHLSStreamingSessionURL | 25 TPS 【h】 | N/A | N/A | N/A |  | 
| GetImages | N/A | N/A | 100 MB 【h】  | N/A | 每個請求的影像數量上限為 100 【h】。  的最小值`SamplingInterval`為 200 毫秒 (ms)，即每秒 5 個影像。   | 
| GetMedia | 5 TPS [h] | 3 【h】 | 25 MB/秒或 200 Mbps (s) | 每秒最多傳送 5 個片段 【h】 | [GetMedia](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_GetMedia.html) 請求是串流、長時間執行的連線。您不需要為每個資料開啟新的連線，因為您可以在單一持久性連線中傳送多個片段。如果您嘗試三個以上的並行GetMedia連線，Kinesis Video Streams 會使用ConnectionLimitExceededException錯誤訊息調節最新的連線。如果典型片段約為 5 MB，則此限制表示每個 Kinesis 影片串流約 75 MBps。此等串流會有串流傳入位元速率 2 倍的傳出位元速率。  `GetMedia` 不會用於 HLS/DASH 播放。  | 
| GetMediaForFragmentList | N/A | 5 (s) | 25 MB/秒或 200 Mbps (s) | 片段數量上限：1000 [h] | 五個片段型消費應用程式可以同時叫用 GetMediaForFragmentList。多出的連接都會遭到拒絕。 | 

**影片播放通訊協定 API 服務配額**


| API | 工作階段層級限制 | 片段層級限制 | 
| --- | --- | --- | 
| GetDASHManifestPlaylist | 5 TPS [h] | 每個播放清單的片段數目上限：5，000 【h】 | 
| GetHLSMasterPlaylist | 5 TPS [h] | N/A | 
| GetHLSMediaPlaylist | 5 TPS [h] | 每個播放清單的片段數目上限：5，000 【h】 | 
| GetMP4InitFragment | 5 TPS [h] | N/A | 
| GetMP4MediaFragment | 20 TPS 【h】 | N/A | 
| GetTSFragment | 20 TPS 【h】 | N/A | 

## 片段中繼資料和片段媒體配額
<a name="fragment_based_throttling"></a>

[用於存取封存媒體的 Kinesis Video Streams APIs ](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_Reference.html) 會根據請求的片段數目而非 API 呼叫數目進行調節。APIs受片段中繼資料數量和請求的片段媒體數量的速率限制。片段中繼資料和片段媒體配額會套用至每個串流。換句話說，一個串流中片段中繼資料或媒體的請求不適用於另一個串流的配額。不過，在指定的串流中，每個配額會跨多個 APIs 共用。這表示對於指定的串流，不同 APIs 的片段請求會使用相同配額。當超過串流的片段中繼資料或片段媒體配額時，API 會傳回 `ClientLimitExceededException`。下表顯示 APIs 如何從這兩種類型的配額中取用。對於這些資料表中的第二個資料欄，假設如果串流具有 N 的配額，則表示 APIs 從該串流的配額類型中要使用 N 點。`GetClip` API 會顯示在兩個資料表中。

**片段中繼資料配額消耗**

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/kinesisvideostreams/latest/dg/limits.html)

**片段媒體配額消耗**

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/kinesisvideostreams/latest/dg/limits.html)

例如，配額為每秒 500 個片段媒體時，支援特定串流的下列呼叫模式：
+ 每秒 5 個請求至 `GetClip`，每個剪輯中有 100 個片段。
+ 每秒 100 個請求至 `GetClip` ，每個剪輯中有 5 個片段。
+ 每秒 2 個請求至 `GetClip`，每個剪輯有 100 個片段，`GetMediaForFragmentList`每個剪輯有 3 個請求至 。
+ 每秒 400 個請求至 `GetMP4MediaFragment`，每秒 100 個請求至 `GetTSFragment`。

這些配額對於每個串流可支援的 HLS 和 MPEG-DASH 工作階段數量具有重要意義。媒體播放器在特定時間可以使用的 HLS 和 DASH 工作階段數量沒有限制。因此，播放應用程式不允許太多工作階段同時使用。下列兩個範例說明如何判斷可支援的並行播放工作階段數量：

*範例 1：即時串流*

在具有 1 秒持續時間片段的 HLS、音訊和視訊軌，並`MaxMediaPlaylistFragmentResults`設為 5 的即時串流案例中，媒體播放器通常會`GetHLSMediaPlaylist`每秒對 進行兩次呼叫。一個呼叫用於最新的視訊中繼資料，另一個呼叫用於對應的音訊中繼資料。這兩個呼叫各耗用五個片段中繼資料配額點。它也會`GetMP4MediaFragment`每秒對 進行兩次呼叫：一個呼叫最新的視訊，另一個呼叫對應的音訊。每個呼叫都會耗用單一片段媒體字符，因此總共會耗用兩個字符。

在此案例中，最多可支援 250 個並行播放工作階段。透過 250 個工作階段，此案例每秒耗用 2，500 個片段中繼資料配額 （遠低於 10，000 個配額） 和每秒 500 個片段媒體配額。

*範例 2：隨需播放*

在 MPEG-DASH 過去事件的隨需播放案例中，音訊和視訊軌`MaxManifestFragmentResults`設定為 1，000，媒體播放器通常會在工作階段開始時呼叫`GetDASHManifest`一次 （耗用 1，000 個片段中繼資料配額點），並以每秒最多 5 次的`GetMP4MediaFragment`速率呼叫 （耗用 5 個片段媒體配額點），直到載入所有片段為止。在此案例中，每秒最多可以啟動 10 個新工作階段 （右側為每秒 10，000 個片段中繼資料配額），而最多 100 個工作階段可以每秒 5 個速率主動載入片段媒體 （右側為每秒 500 個片段媒體配額）。

您可以使用 `ArchivedFragmentsConsumed.Metadata`和 `ArchivedFragmentsConsumed.Media` 分別監控片段中繼資料和片段媒體配額點的消耗。如需監控的資訊，請參閱 [監控 Amazon Kinesis Video Streams](monitoring.md)。

## 串流中繼資料服務配額
<a name="limits-streaming-metadata"></a>

下列服務配額適用於將串流中繼資料新增至 Kinesis 影片串流：
+ 您可以在一個片段之前最多新增 10 個中繼資料項目。
+ 片段中繼資料*名稱*長度上限為 128 位元組。
+ 片段中繼資料*數值*長度上限為 256 位元組。
+ 片段中繼資料*名稱*不能以字串 "`AWS`" 開頭。若新增上述中繼資料項目，PIC 中的 `putFragmentMetadata`​ 方法將回報 `STATUS_INVALID_METADATA_NAME`​ 錯誤 (錯誤代碼 `0x52000077`)。您的應用程式可以忽略該錯誤 (PIC 將不會新增中繼資料項目) 或回應錯誤。

## 生產者開發套件配額
<a name="producer-sdk-limits"></a>

下表包含 SDK 中值的目前配額。如需詳細資訊，請參閱[上傳至 Kinesis Video Streams](producer-sdk.md)。

**注意**  
設定這些值之前，必須驗證您的輸入。開發套件不驗證這些限制，如果超過限制則執行時間會發生錯誤。


| Value | 限制 | 備註 | 
| --- | --- | --- | 
| 最大的串流計數 | 128 | 製作者物件可建立的最高串流數量。此為軟限制 (您可以請求提高)。它保證生產者不會意外地以遞迴方式建立串流。 | 
| 最高裝置名稱長度 | 128 個字元 |   | 
| 最高標籤計數 | 每個串流 50 個 |   | 
| 最高串流名稱長度 | 256 個字元 |   | 
| 最低儲存空間大小 | 10 MiB = 10 \$1 1024 \$1 1024 位元 |   | 
| 最高儲存空間大小 | 10 GiB = 10 \$1 1024 \$1 1024 \$1 1024 位元 |   | 
| 最高根目錄路徑長度 | 4,096 個字元 |   | 
| 最高授權資訊長度 | 10,000 位元組 |   | 
| 最高 URI 字串長度 | 10,000 個字元 |   | 
| 最高標籤名稱長度 | 128 個字元 |   | 
| 最高標籤數值長度 | 1,024 個字元 |   | 
| 最短安全字符期間 | 30 秒 |   | 
| 安全字符寬限期間 | 40 分鐘 | 如果指定的持續時間較長，則僅限於此值。 | 
| 保留期間 | 0 或大於 1 小時 | 0 代表沒有保留。 | 
| 最小叢集持續時間 | 1 秒鐘 | 該值是以 100 奈秒 (ns) 為單位表示，採用軟體開發套件標準。 | 
| 最大叢集持續時間 | 30 秒 | 該值是以 100 奈秒 (ns) 為單位表示，採用軟體開發套件標準。後端 API 可以強制執行較短的叢集持續時間。 | 
| 最大區段大小 | 50 MB | 如需詳細資訊，請參閱[Amazon Kinesis Video Streams 服務配額](#limits)。 | 
| 最長區段持續時間 | 20 秒 | 如需詳細資訊，請參閱[Amazon Kinesis Video Streams 服務配額](#limits)。 | 
| 最長連線持續時間 | 45 分鐘 | 過了此時間後，後端將關閉連線。軟體開發套件在該時間內輪換字符並建立新連接。 | 
| 最常 ACK 區段長度 | 1,024 個字元 | 傳送到 ACK 解析器函數的最高確認區段長度。 | 
| 最長內容類型字串長度 | 128 個字元 |   | 
| 最大轉碼器 ID 字串長度 | 32 個字元 |   | 
| 最大音軌名稱字串長度 | 32 個字元 |   | 
| 最大轉碼器私有資料長度 | 1 MiB = 1 \$1 1024 \$1 1024 位元 |   | 
| 最小時間碼比例值長度 | 100 奈秒 (ns) | 在產生的 MKV 叢集中表示影格時間戳記的最小時間碼比例值。該值是以 100 奈秒 (ns) 為增加幅度，採用軟體開發套件標準。 | 
| 最大時間碼比例值長度 | 1 秒鐘 | 在產生的 MKV 叢集中表示影格時間戳記的最大時間碼比例值。該值是以 100 奈秒 (ns) 為增加幅度，採用軟體開發套件標準。 | 
| 最小內容檢視項目計數 | 10 |   | 
| 最短緩衝持續時間 | 20 秒 | 該值是以 100 奈秒 (ns) 為增加幅度，採用軟體開發套件標準。 | 
| 最大更新版本長度 | 128 個字元 |   | 
| 最大 ARN 長度 | 1024 個字元 |   | 
| 最大區段序列長度 | 128 個字元 |   | 
| 最高保留期間 | 10 年 |   |