Kinesis Video Streams 服務配額 - Amazon Kinesis Video Streams

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

Kinesis Video Streams 服務配額

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

重要

下列服務配額為 soft [s],可透過提交支援票證來升級,或是 hard [h] (無法增加)。你會在下表中看到個別服務配額旁邊的 [s] 及 [h]。

控制平面 API 服務配額

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

達到帳戶層級或資源層級要求限制時,就會擲回 a。ClientLimitExceededException

控制平面 API 服務配額
API 帳戶限制:請求 帳戶限制:串流 串流層級限制 相關例外情況及備註
CreateStream 50 TPS [s] 在美國東部 (維吉尼亞北部) 和美國西部 (奧勒岡) 區域中,每個帳戶有 10000 個串流。在所有其他支援的區域中,每個帳戶有 5000 個串流。
注意

此限制可以提高到每個帳戶 100,000 個 (或更多) 串流。登入位 AWS Management Console 於https://console.aws.amazon.com/並提交 Kinesis Video Streams 提高服務限制案例,以要求提高此限制。

N/A 裝置、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 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 服務配額

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

達到帳戶層級或資源層級要求限制時,就會擲回 a。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 兆比特
  • 片段持續時間下限: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 租售價 [h] N/A N/A N/A
GetHLSStreamingSessionURL 25 租售價 [h] N/A N/A N/A
GetImages N/A N/A 100 MB [小時] N/A

每個請求的最大影像數量為 100 [h]。

注意

的最小值SamplingInterval為 200 毫秒 (ms),也就是每秒 5 個影像。

GetMedia 5 TPS [h] 3 (s) 25 MB/秒或 200 Mbps (s) 每秒傳送的最大片段數:6 [h]

一個獨特的消費客戶端不應該需要超過兩個或三個 TPS,因為建立連接後,應用程序應該連續讀取。

如果一般片段大約為 5 MB,則此限制表示每個 Kinesis 視訊串流約 75 Mbps。此等串流會有串流傳入位元速率 2 倍的傳出位元速率。

注意

GetMedia不會用於 HLS/ 破折號播放。

GetMediaForFragmentList N/A 5 (s) 25 MB/秒或 200 Mbps (s) 片段數量上限:1000 [h] 五個以片段為基礎的消費應用程式可以同時叫用。GetMediaForFragmentList多出的連接都會遭到拒絕。
視訊播放通訊協定 API 服務配額
API 工作階段層級限制 片段層級限制
獲取破折號 ManifestPlaylist 5 TPS [h] 每個播放清單的片段數目上限:5000 [h]
GETHLS MasterPlaylist 5 TPS [h] N/A
GETHLS MediaPlaylist 5 TPS [h] 每個播放清單的片段數目上限:5000 [h]
獲取 MP4 InitFragment 5 TPS [h] N/A
獲取 MP4 MediaFragment 20 租置標準 [h] N/A
GetTSFragment 20 租置標準 [h] N/A

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

Kinesis Video Streams API 存取封存媒體會根據要求的片段數量而非 API 呼叫次數進行限制。API 受片段中繼資料數量和要求的片段媒體數量的速率限制。片段中繼資料和片段媒體配額會針對每個串流套用。換句話說,一個串流中繼資料或媒體的要求不適用於另一個串流的配額。但是,在給定的流中,每個配額都會跨多個 API 共享。這意味著,對於給定的流,跨不同 API 的片段請求消耗相同的配額。當超出串流的片段中繼資料或片段媒體配額時,API 會傳回ClientLimitExceededException. 下表顯示 API 如何從兩種類型的配額中使用。對於這些表中的第二列,假設如果流的配額為 N,這意味著 API 有 N 個點可以從該流的配額類型中消耗。GetClipAPI 會出現在兩個表格中。

片段元數據配額消耗
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 個片段,每個剪輯每秒 3 個請求。GetMediaForFragmentList

  • 每秒 400 個請求GetMP4MediaFragment,每秒 100 個請求GetTSFragment

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

範例 1:即時串流

在具有 1 秒持續時間片段、音訊和視訊軌道且MaxMediaPlaylistFragmentResults設定為 5 的 HLS 的即時串流案例中,媒體播放程式通常會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.MediaArchivedFragmentsConsumed.Metadata和監控片段中繼資料和片段媒體配額點的使用情況。如需監視的相關資訊,請參閱監控 Amazon Kinesis Video Streams

片段元數據配額

下列服務配額適用於將片段中繼資料新增至 Kinesis 視訊串流中的片段:

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

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

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

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

串流標籤

這些中繼資料索引鍵值配對會套用至整體 Kinesis Video Streams 資源,而非 Kinesis 視訊串流中包含的個別片段。

每個 Kinesis 視訊串流最多支援 50 個標籤。

TagStream需串流標籤的索引鍵和值的限制,請參閱。