本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
Amazon Kinesis Video Streams 服務配額
Kinesis Video Streams 具有下列服務配額:
重要
下列服務配額為 soft [s],可透過提交支援票證來升級,或是 hard [h] (無法增加)。你會在下表中看到個別服務配額旁邊的 [s] 及 [h]。
控制平面API服務配額
下節說明控制平面的服務配額APIs。TPS代表每秒交易。
達到帳戶層級或資源層級要求限制時,就會擲回 a。ClientLimitExceededException
控制平面API服務配額 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
API | 帳戶限制:請求 | 帳戶限制:串流 | 串流層級限制 | 相關例外情況及備註 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
CreateStream | 50 TPS [秒] | 在美國東部 (維吉尼亞北部) 和美國西部 (奧勒岡) 區域中,每個帳戶有 10000 個串流。在所有其他支援的區域中,每個帳戶有 5000 個串流。注意此限制可以提高到每個帳戶 100,000 個 (或更多) 串流。登入位 AWS Management Console 於https://console.aws.amazon.com/ |
設備CLIs,SDK驅動訪問和控制台都可以調用它API。如果流不存在,只有一個API調用成功。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
DeleteEdgeConfiguration | 10 TPS [小時] | N/A | 1 TPS [小時] | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
DeleteStream | 50 TPS [小時] | N/A | 5 TPS [小時] | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
DescribeEdgeConfiguration | 50 TPS [小時] | N/A | 5 TPS [小時] | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
DescribeImageGenerationConfiguration | 50 TPS [小時] | N/A | 5 TPS [小時] | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
DescribeMappedResourceConfiguration | 50 TPS [小時] | N/A | 5 TPS [小時] | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
DescribeNotificationConfiguration | 50 TPS [小時] | N/A | 5 TPS [小時] | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
DescribeStream | 300 TPS [小時] | N/A | 5 TPS [小時] | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GetDataEndpoint | 300 TPS [小時] | N/A | 5 TPS [小時] | 每 45 分鐘進行呼叫,以為大部分的 PutMedia /GetMedia 使用案例重新整理串流字符。若應用程式在故障時重新載入快取資料端點,快取資料端點仍是安全的。 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ListEdgeAgentConfigurations | 50 TPS [小時] | N/A | N/A | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ListStreams | 50 TPS [小時] | N/A | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ListTagsForStream | 50 TPS [小時] | N/A | 5 TPS [小時] | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
StartEdgeConfigurationUpdate | 10 TPS [小時] | N/A | 1 TPS [小時] | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TagStream | 50 TPS [小時] | N/A | 5 TPS [小時] | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
UntagStream | 50 TPS [小時] | N/A | 5 TPS [小時] | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
UpdateDataRetention | 50 TPS [小時] | N/A | 5 TPS [小時] | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
UpdateImageGenerationConfiguration | 50 TPS [小時] | N/A | 5 TPS [小時] | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
UpdateNotificationConfiguration | 50 TPS [小時] | N/A | 5 TPS [小時] | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
UpdateStream | 50 TPS [小時] | N/A | 5 TPS [小時] |
媒體和封存媒體服務配API額
下節說明媒體和封存媒體的服務配額APIs。
達到帳戶層級或資源層級要求限制時,就會擲回 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 [小時] | 1 (s) | 每秒 12.5 MB,或每個串流 100 兆比特 |
|
典型的PutMedia 要求包含數秒的資料,導致TPS每個串流的資料較低。如果有多個並行連線超出配額,則會接受最後一個連線。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GetClip | N/A | N/A | 100 MB 的大小限制 [h] | 片段數量上限:200 [h] | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
G etDASHStreaming 工作階段 URL | 25 TPS [小時] | N/A | N/A | N/A | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
G etHLSStreaming 工作階段 URL | 25 TPS [小時] | N/A | N/A | N/A | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GetImages | N/A | N/A | 100 MB [小] | N/A | 每個請求的最大影像數量為 100 [h]。 注意的最小值 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GetMedia | 5 TPS [小時] | 3 (s) | 25 MB/秒或 200 Mbps (s) | 每秒最多發送 5 個片段 [h] | 一個獨特的消費客戶端不應該需要超過兩個或三個,TPS因為建立連接後,應用程序應該連續讀取。 如果一般片段大約為 5 MB,則此限制表示MBps每個 Kinesis 視訊串流約 75。此等串流會有串流傳入位元速率 2 倍的傳出位元速率。 注意
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GetMediaForFragmentList | N/A | 5 (s) | 25 MB/秒或 200 Mbps (s) | 片段數量上限:1000 [h] | 五個以片段為基礎的消費應用程式可以同時叫用。GetMediaForFragmentList 多出的連接都會遭到拒絕。 |
視頻播放協議API服務配額 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
API | 工作階段層級限制 | 片段層級限制 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
G etDASHManifest 播放清單 | 5 TPS [小時] | 每個播放清單的片段數目上限:5000 [h] | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
G etHLSMaster 播放清單 | 5 TPS [小時] | N/A | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
G etHLSMedia 播放清單 | 5 TPS [小時] | 每個播放清單的片段數目上限:5000 [h] | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
獲取 MP4InitFragment | 5 TPS [小時] | N/A | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
獲取 MP4MediaFragment | 20 TPS [小時] | N/A | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
G etTSFragment | 20 TPS [小時] | N/A |
片段中繼資料和片段媒體配額
Kinesis Video Streams APIs用於存取封存媒體的速度會根據要求的片段數量而非呼叫次數進行限制。APIAPIs速率受到片段元數量和請求的片段媒體數量的限制。片段中繼資料和片段媒體配額會針對每個串流套用。換句話說,一個串流中繼資料或媒體的要求不適用於另一個串流的配額。但是,在給定的流中,每個配額是跨多個共享APIs。這意味著,對於給定的流,跨不同片段的請求APIs消耗相同的配額。當超過串流的片段中繼資料或片段媒體配額時,會API傳回 aClientLimitExceededException
. 下表顯示了兩種配額類型中每種類型的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 個片段,每個剪輯每秒 3 個請求。GetMediaForFragmentList
每秒 400 個請求
GetMP4MediaFragment
,每秒 100 個請求到GetTSFragment
.
這些配額對於每個串流可支援的HLS和MPEGDASH工作階段數量具有重要意義。媒體播放器在特定時間可以使用的DASH工作階段數量HLS和工作階段沒有限制。因此,重要的是,播放應用程式不允許同時使用太多工作階段。下列兩個範例說明如何判斷可支援的同時播放工作階段數目:
範例 1:即時串流
在具有 HLS 1 秒持續時間片段、音訊和視訊軌道且MaxMediaPlaylistFragmentResults
設定為 5 的即時串流案例中,媒體播放程式通常會GetHLSMediaPlaylist
每秒撥打兩次呼叫。一個呼叫用於最新的視訊中繼資料,另一個呼叫用於對應的音訊中繼資料。這兩個呼叫會消耗五個片段中繼資料配額點。它還GetMP4MediaFragment
每秒撥打兩次電話:一個呼叫最新視頻,另一個呼叫相應的音頻。每個調用都會消耗一個片段媒體令牌,因此總共消耗了兩個令牌。
在這個案例中,最多可支援 250 個同時播放工作階段。在 250 個工作階段中,此案例每秒耗用 2,500 個片段中繼資料配額點 (遠低於 10,000 個配額) 和每秒 500 個片段媒體配額點。
範例 2:隨選播放
在過去事件的隨選播放案例中DASH,音訊和視訊音軌並MaxManifestFragmentResults
設為 1,000 時,媒體播放程式通常會在工作階段開始時呼叫GetDASHManifest
一次 (消耗 1,000 個片段中繼資料配額點),並以每秒 5 次的速率呼叫 GetMP4MediaFragment
(消耗 5 個片段媒體配額點),直到載入所有片段為止。MPEG在這個案例中,每秒最多可啟動 10 個新工作階段 (右邊是每秒 10,000 個片段中繼資料配額),而最多 100 個工作階段可以以每秒 5 次的速率主動載入片段媒體 (就在每秒 500 個片段媒體配額上)。
您可以分別使ArchivedFragmentsConsumed.Media
用ArchivedFragmentsConsumed.Metadata
和監控片段中繼資料和片段媒體配額點的使用情況。如需監視的相關資訊,請參閱監控 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 年 |