本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
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】 |
|
典型的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】。 注意的最小值 |
GetMedia | 5 TPS【h】 | 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【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.Metadata
和 ArchivedFragmentsConsumed.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 年 |