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

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

Amazon Kinesis Video Streams 服務配額

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

重要

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

控制平面API服務配額

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

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

API 帳戶限制:請求 帳戶限制:串流 串流層級限制 相關例外狀況和備註
CreateStream 50 TPS【秒】 在所有支援的區域中,每個帳戶 【s】 有 10,000 個串流。
注意

此限制可以提高到每個帳戶 100,000 個 (或更多) 串流。登入 AWS Management Console 位於 的 ,https://console.aws.amazon.com/並請求提高此限制。

裝置、CLIs、 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]
G etDASHStreaming工作階段URL 25 TPS【h】 N/A N/A N/A
G etHLSStreaming工作階段URL 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,則此限制表示MBps每個 Kinesis 影片串流約 75 個。此等串流會有串流傳入位元速率 2 倍的傳出位元速率。

注意

GetMedia 不會用於 HLS/DASH 播放。

GetMediaForFragmentList N/A 5 (s) 25 MB/秒或 200 Mbps (s) 片段數量上限:1000 [h] 五個片段型耗用應用程式可以同時叫用 GetMediaForFragmentList。多出的連接都會遭到拒絕。

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

API 工作階段層級限制 片段層級限制
G etDASHManifest播放清單 5 TPS【h】 每個播放清單的片段數量上限:5,000 【h】
G etHLSMaster播放清單 5 TPS【h】 N/A
G etHLSMedia播放清單 5 TPS【h】 每個播放清單的片段數量上限:5,000 【h】
取得MP4InitFragment 5 TPS【h】 N/A
取得MP4MediaFragment 20 TPS【h】 N/A
GetTSFragment 20 TPS【h】 N/A

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

APIs 用於存取封存媒體的 Kinesis Video Streams 會根據請求的片段數量而非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:即時串流

在HLS具有 1 秒持續時間片段的即時串流案例中,音訊和視訊音軌,並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.MetadataArchivedFragmentsConsumed.Media分別監控片段中繼資料和片段媒體配額點的消耗。如需監控的資訊,請參閱 監控 Amazon Kinesis Video Streams

串流中繼資料服務配額

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

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

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

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

  • 片段中繼資料名稱不能以字串 "AWS" 開頭。如果已新增這類中繼資料項目, 中的 putFragmentMetadata 方法會PIC傳回STATUS_INVALID_METADATA_NAME錯誤 (錯誤碼 0x52000077)。然後,您的應用程式可以忽略錯誤 ( PIC 不會新增中繼資料項目),或回應錯誤。

生產者SDK配額

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

注意

設定這些值之前,必須驗證您的輸入。SDK 不會驗證這些限制,如果超過限制,則會發生執行期錯誤。

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 單位指定,此為SDK標準值。
最大叢集持續時間 30 秒 此值以 100 ns 單位指定,此為SDK標準值。後端API可以強制執行較短的叢集持續時間。
最大區段大小 50 MB 如需詳細資訊,請參閱Amazon Kinesis Video Streams 服務配額
最長區段持續時間 20 秒 如需詳細資訊,請參閱Amazon Kinesis Video Streams 服務配額
最長連線持續時間 45 分鐘 過了此時間後,後端將關閉連線。會SDK輪換權杖,並在此期間建立新的連線。
ACK 區段長度上限 1,024 個字元 傳送至ACK剖析器函數的確認區段長度上限。
最長內容類型字串長度 128 個字元  
最大轉碼器 ID 字串長度 32 個字元  
最大音軌名稱字串長度 32 個字元  
最大轉碼器私有資料長度 1 MiB = 1 * 1024 * 1024 位元  
最小時間碼比例值長度 100 奈秒 (ns) 最小時間碼縮放值,代表產生MKV叢集中的影格時間戳記。值以 100 ns 的增量指定,這是SDK標準值。
最大時間碼比例值長度 1 秒鐘 時間碼縮放值上限,代表所產生MKV叢集中的影格時間戳記。值以 100 ns 的增量指定,這是SDK標準值。
最小內容檢視項目計數 10  
最短緩衝持續時間 20 秒 值以 100 ns 的增量指定,這是SDK標準值。
最大更新版本長度 128 個字元  
ARN 長度上限 1024 個字元  
最大區段序列長度 128 個字元  
最高保留期間 10 年