Amazon Kinesis Video Streams 服務配額

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

重要

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

控制平面 API 服務配額

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

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

API	帳戶限制：請求	帳戶限制：串流	串流層級限制	相關例外狀況和備註
CreateStream	50 TPS [s]	在所有支援的區域中，每個帳戶 【s】 有 10，000 個串流。 注意 此限制可以提高到每個帳戶 100,000 個 (或更多) 串流。登入 AWS Management Console 的 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]

媒體和封存媒體 API 服務配額

下一節說明媒體和封存媒體 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 (s)	每秒 12.5 MB，或每個串流 100 Mbps 【s】	片段持續時間下限：1 秒 (h) 片段持續時間上限：20 秒 【h】 片段大小上限：50 MB (h) 軌道數目上限：3 [s] 每秒傳送的最大片段數：5 【h】 片段中繼資料上限：10 個標籤 【h】	典型的 PutMedia 請求包含數秒鐘的資料，使每個串流產生較低的 TPS。如果多個並行連線超過配額，則會接受最後一個連線。
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 (s)	25 MB/秒或 200 Mbps (s)	每秒傳送最多 5 個片段 【h】	唯一的耗用用戶端不應需要超過兩個或三個 TPS，因為建立連線後，應用程式應該持續讀取。 如果典型片段約為 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

片段中繼資料和片段媒體配額

用於存取封存媒體的 Kinesis Video Streams APIs 會根據請求的片段數量而非 API 呼叫數量進行調節。APIs 受片段中繼資料數量和請求的片段媒體數量限制。片段中繼資料和片段媒體配額會套用到每個串流。換言之，對某個串流中的片段中繼資料或媒體的請求不適用於另一個串流的配額。不過，在指定的串流中，每個配額會跨多個 APIs 共用。這表示，對於指定的串流，不同 APIs 的片段請求會使用相同配額。當超過串流的片段中繼資料或片段媒體配額時，API 會傳回 ClientLimitExceededException。下表顯示 APIs 如何從兩種配額類型中取用。對於這些表格中的第二欄，假設如果串流具有 N 的配額，則表示 APIs 從該串流的配額類型中要使用 N 點。GetClip API 會顯示在兩個資料表中。

片段中繼資料配額消耗

API	每個請求消耗的配額點數量	共用配額 (N)
ListFragments	MaxResults 參數的值	每個串流每秒 10，000 個配額 【h】
GetClip	產生的剪輯中的片段數量
GetHLSMediaPlaylist	MaxMediaPlaylistFragmentResults 參數的值
GetDASHManifest	MaxManifestFragmentResults 參數的值
GetImages	值為 400 + 請求的影像數量上限

片段媒體配額消耗

API	每個請求消耗的配額點數量	共用配額 (N)
GetMediaForFragmentList	片段參數中的片段數量	每個串流每秒 500 個配額 【h】
GetClip	產生的剪輯中的片段數量
GetMP4MediaFragment	1
GetTSFragment	1
GetImages	請求的影像數量上限

例如，配額為每秒 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。

串流中繼資料服務配額

下列服務配額適用於將串流中繼資料新增至 Kinesis 影片串流：

• 您可以在一個片段之前最多新增 10 個中繼資料項目。

• 片段中繼資料名稱長度上限為 128 位元組。

• 片段中繼資料數值長度上限為 256 位元組。

• 片段中繼資料名稱不能以字串 "AWS" 開頭。若新增上述中繼資料項目，PIC 中的 putFragmentMetadata​ 方法將回報 STATUS_INVALID_METADATA_NAME​ 錯誤 (錯誤代碼 0x52000077)。您的應用程式可以忽略該錯誤 (PIC 將不會新增中繼資料項目) 或回應錯誤。

Producer SDK 配額

下表包含 SDK 中值的目前配額。如需更多資訊，請參閱上傳至 Kinesis Video Streams。

注意

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

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