Kinesis Video Streams 서비스 할당량

Kinesis Video Streams의 서비스 할당량은 다음과 같습니다.

중요

다음 서비스 할당량은 지원 티켓을 제출하여 업그레이드할 수 있는 소프트 [s] 와 늘릴 수 없는 하드 [h] 입니다. 아래 표의 개별 서비스 할당량 옆에 [s] 와 [h] 가 표시됩니다.

컨트롤 플레인 API 서비스 할당량

다음 섹션에서는 컨트롤 플레인 API의 서비스 할당량을 설명합니다. TPS는 초당 트랜잭션을 나타냅니다.

계정 수준 또는 리소스 수준 요청 한도에 도달하면 a가 발생합니다. ClientLimitExceededException

컨트롤 플레인 API 서비스 할당량
API	계정 한도: 요청	계정 한도: 스트림	스트림 레벨 한도	관련 예외 및 참고 사항
CreateStream	50TPS[s]	미국 동부 (버지니아 북부) 및 미국 서부 (오레곤) 지역에서는 계정당 10000개의 스트림이, 지원되는 다른 모든 지역에서는 계정당 5000개의 스트림이 있습니다. 참고 계정당 100,000개 이상의 스트림으로 최대 한도를 증가할 수 있습니다. 에 로그인하여 Kinesis Video Streams에 대한 서비스 한도 증가 사례를 제출하여 이 한도 증가를 요청하십시오. AWS Management Console https://console.aws.amazon.com/		디바이스, CLI, SDK 구동 액세스 및 콘솔은 모두 이 API를 호출할 수 있습니다. 스트림이 이미 존재하지 않는 경우 하나의 API 호출만 성공합니다.
DeleteEdgeConfiguration	10TPS[h]	N/A	1 TPS [h]
DeleteStream	50TPS[h]	N/A	5TPS[h]
DescribeEdgeConfiguration	50TPS[h]	N/A	5TPS[h]
DescribeImageGenerationConfiguration	50TPS[h]	N/A	5TPS[h]
DescribeMappedResourceConfiguration	50TPS[h]	N/A	5TPS[h]
DescribeNotificationConfiguration	50TPS[h]	N/A	5TPS[h]
DescribeStream	300TPS[h]	N/A	5TPS[h]
GetDataEndpoint	300TPS[h]	N/A	5TPS[h]	대부분의 PutMedia/GetMedia 사용 사례에서 스트리밍 토큰을 새로 고치기 위해 45분마다 호출됩니다. 애플리케이션이 실패 시 다시 로드하는 경우 데이터 엔드포인트를 캐시하는 것이 안전합니다.
ListEdgeAgentConfigurations	50TPS[h]	N/A	N/A
ListStreams	50TPS[h]	N/A
ListTagsForStream	50TPS[h]	N/A	5TPS[h]
StartEdgeConfigurationUpdate	10TPS[h]	N/A	1 TPS [h]
TagStream	50TPS[h]	N/A	5TPS[h]
UntagStream	50TPS[h]	N/A	5TPS[h]
UpdateDataRetention	50TPS[h]	N/A	5TPS[h]
UpdateImageGenerationConfiguration	50TPS[h]	N/A	5TPS[h]
UpdateNotificationConfiguration	50TPS[h]	N/A	5TPS[h]
UpdateStream	50TPS[h]	N/A	5TPS[h]

미디어 및 아카이브 미디어 API 서비스 할당량

다음 섹션에서는 미디어 및 아카이브 미디어 API의 서비스 할당량을 설명합니다.

계정 수준 또는 리소스 수준 요청 한도에 도달하면 a가 발생합니다. ClientLimitExceededException

연결 레벨 한도에 도달하면 ConnectionLimitExceededException이 발생합니다.

조각 레벨 한도에 도달하면 다음 오류 또는 ack가 발생합니다.

• 최소 기간 미만의 조각에 대해서는 MIN_FRAGMENT_DURATION_REACHED ack가 반환됩니다.

• 최대 기간을 초과하는 조각에 대해서는 MAX_FRAGMENT_DURATION_REACHED ack가 반환됩니다.

• 최대 데이터 크기를 초과하는 조각에 대해서는 MAX_FRAGMENT_SIZE ack가 반환됩니다.

• GetMediaForFragmentList 작업에서 조각 한도에 도달하면 FragmentLimitExceeded 예외가 발생합니다.

데이터 플레인 API 서비스 할당량
API	스트림 레벨 한도	연결 레벨 한도	대역폭 한도	조각 레벨 제한	관련 예외 및 참고 사항
PutMedia	5TPS[h]	1[s]	초당 12.5메가바이트 또는 스트림당 100Mbps	최소 조각 기간: 1초[h] 최대 프래그먼트 지속 시간: 20초 [h] 최대 조각 크기: 50MB[h] 최대 트랙 수: 3[s] 초당 전송되는 최대 조각 수: 5 [h] 최대 프래그먼트 메타데이터 제한: 10개 태그 [h]	일반적인 PutMedia 요청에는 여러 초 동안 데이터가 포함되므로 스트림당 TPS가 더 낮습니다. 할당량을 초과하는 동시 연결이 여러 개 있는 경우 마지막 연결이 허용됩니다.
GetClip	N/A	N/A	100MB 크기 제한[h]	최대 조각 수: 200[h]
GetDASHStreamingSessionURL	25 TPS [h]	N/A	해당 사항 없음	N/A
GetHLSStreamingSessionURL	25티스푼 [h]	N/A	해당 사항 없음	해당 사항 없음
GetImages	해당 사항 없음	N/A	100 메가바이트 [시간]	N/A	요청당 최대 이미지 수는 100 [h] 입니다. 참고 의 최소값은 200밀리초 (ms) 이며, 이는 초당 5개 이미지입니다. SamplingInterval
GetMedia	5TPS[h]	3[s]	25MB/s 또는 200Mbps[s]	초당 전송되는 최대 프래그먼트 수: 6 [h]	고유 소비 클라이언트는 TPS가 2~3개 이상 필요하지 않아야 합니다. 연결이 설정된 후에는 애플리케이션이 지속적으로 읽어야 하기 때문입니다. 일반적인 프래그먼트가 약 5MB인 경우 이 한도는 Kinesis 비디오 스트림당 최대 75MBps를 의미합니다. 이러한 스트림의 송신 비트 속도는 최대 수신 비트 속도의 2배입니다. 참고 GetMediaHLS/DASH 재생에는 사용되지 않습니다.
GetMediaForFragmentList	N/A	5[s]	25MB/s 또는 200Mbps[s]	최대 조각 수: 1000[h]	프래그먼트 기반 소비 애플리케이션 5개를 동시에 호출할 수 있습니다. GetMediaForFragmentList 그 이상의 연결은 거부됩니다.

동영상 재생 프로토콜 API 서비스 할당량
API	세션 레벨 제한	조각 레벨 제한
GetDash ManifestPlaylist	5TPS[h]	플레이리스트당 최대 프래그먼트 수: 5000 [h]
GetHLS MasterPlaylist	5TPS[h]	N/A
GETHLS MediaPlaylist	5TPS[h]	플레이리스트당 최대 프래그먼트 수: 5000 [h]
GetMP4 InitFragment	5TPS[h]	N/A
MP4를 받으세요 MediaFragment	20 팁 [h]	N/A
GetTSFragment	20티스푼 [h]	N/A

프래그먼트 메타데이터 및 프래그먼트 미디어 할당량

보관된 미디어에 액세스하기 위한 Kinesis Video Streams API는 API 호출 수가 아닌 요청된 프래그먼트 수에 따라 조절됩니다. API는 프래그먼트 메타데이터 수와 요청된 프래그먼트 미디어 수에 따라 속도가 제한됩니다. 프래그먼트 메타데이터와 프래그먼트 미디어 할당량은 스트림별로 적용됩니다. 즉, 한 스트림의 프래그먼트 메타데이터 또는 미디어에 대한 요청은 다른 스트림의 할당량에 적용되지 않습니다. 하지만 특정 스트림 내에서는 각 할당량이 여러 API에서 공유됩니다. 즉, 특정 스트림의 경우 여러 API에서 프래그먼트를 요청하면 동일한 할당량을 소비합니다. 스트림의 프래그먼트 메타데이터 또는 프래그먼트 미디어 할당량을 초과하면 API는 a를 반환합니다. ClientLimitExceededException 다음 표는 API가 두 가지 유형의 할당량 각각을 어떻게 소비하는지 보여줍니다. 이 표의 두 번째 열에서는 스트림의 할당량이 N이면 API가 해당 스트림의 할당량 유형에서 소비할 포인트가 N개라는 것을 의미합니다. GetClipAPI는 두 표에 모두 표시됩니다.

프래그먼트 메타데이터 할당량 소비
API	요청당 사용된 할당량 포인트 수	공유 할당량 (N)
ListFragments	MaxResults파라미터 값	스트림당 초당 10000개의 쿼터 포인트 [h]
GetClip	결과 클립의 프래그먼트 수
GetHLSMediaPlaylist	파라미터 값입니다. MaxMediaPlaylistFragmentResults
GetDASHManifest	MaxManifestFragmentResults파라미터 값.
GetImages	값: 요청된 최대 이미지 수 400개 이상

프래그먼트 미디어 할당량 소비
API	요청당 소비된 할당량 포인트 수	공유 할당량 (N)
GetMediaForFragmentList	프래그먼트 파라미터의 프래그먼트 수	스트림당 초당 쿼터 포인트 500개 [h]
GetClip	결과 클립의 프래그먼트 수
GetMP4MediaFragment	1
GetTSFragment	1
GetImages	요청된 최대 이미지 수

예를 들어 초당 500개의 프래그먼트 미디어 할당량이 있는 경우 특정 스트림에 대해 다음과 같은 호출 패턴이 지원됩니다.

• 초당 요청 5개, 각 클립에 프래그먼트 100개 GetClip 포함

• 초당 요청 100개, 각 클립에 프래그먼트 5개 GetClip 포함.

• 초당 요청 2개 - 각 클립에 프래그먼트 100개, 각 GetMediaForFragmentList 클립에 초당 요청 3개 GetClip

• ~로 초당 요청 400개GetMP4MediaFragment, GetTSFragment ~로 초당 요청 100개

이러한 할당량은 스트림당 지원할 수 있는 HLS 및 MPEG-DASH 세션 수와 관련하여 중요한 영향을 미칩니다. 미디어 플레이어가 특정 시간에 사용할 수 있는 HLS 및 DASH 세션 수에는 제한이 없습니다. 따라서 재생 응용 프로그램에서 너무 많은 세션을 동시에 사용할 수 없도록 하는 것이 중요합니다. 다음 두 예에서는 지원할 수 있는 동시 재생 세션 수를 결정하는 방법을 설명합니다.

예 1: 라이브 스트리밍

지속 시간이 1초이고 오디오 및 비디오 트랙이 5로 MaxMediaPlaylistFragmentResults 설정된 HLS가 있는 라이브 스트리밍 시나리오에서 미디어 플레이어는 일반적으로 GetHLSMediaPlaylist 초당 2회의 통화를 전송합니다. 한 호출은 최신 비디오 메타데이터에 대한 호출이고 다른 호출은 해당 오디오 메타데이터에 대한 호출입니다. 두 번의 호출은 각각 5개의 프래그먼트 메타데이터 할당량을 소비합니다. 또한 GetMP4MediaFragment 초당 두 번의 호출이 발생합니다. 한 번은 최신 비디오를 호출하고 다른 호출은 해당 오디오를 호출합니다. 각 호출은 하나의 프래그먼트 미디어 토큰을 소비하므로 총 두 개의 토큰이 소비됩니다.

이 시나리오에서는 최대 250개의 동시 재생 세션을 지원할 수 있습니다. 250개 세션에서 이 시나리오는 초당 2,500개의 프래그먼트 메타데이터 할당량 포인트 (할당량 10,000개보다 훨씬 적음) 와 초당 500개의 프래그먼트 미디어 쿼터 포인트를 소비합니다.

예 2: 온디맨드 재생

오디오 및 비디오 트랙을 1,000으로 MaxManifestFragmentResults 설정한 MPEG-DASH를 사용한 과거 이벤트의 온디맨드 재생 시나리오에서 미디어 플레이어는 일반적으로 세션 시작 시 GetDASHManifest 한 번 호출 (1,000개의 프래그먼트 메타데이터 쿼터 포인트 사용) 하고 모든 프래그먼트가 로드될 때까지 초당 최대 5회 (프래그먼트 미디어 쿼터 포인트 5개 사용) 의 GetMP4MediaFragment 속도로 호출합니다. 이 시나리오에서는 초당 최대 10개의 새 세션 (초당 10,000개의 프래그먼트 메타데이터 할당량) 을 시작할 수 있으며, 초당 5개의 속도 (초당 500개의 프래그먼트 미디어 할당량 기준) 로 최대 100개의 세션에서 프래그먼트 미디어를 활발하게 로드할 수 있습니다.

ArchivedFragmentsConsumed.Metadata및 ArchivedFragmentsConsumed.Media 를 사용하여 프래그먼트 메타데이터와 프래그먼트 미디어 쿼터 포인트의 사용량을 각각 모니터링할 수 있습니다. 모니터링에 대한 자세한 내용은 을 참조하십시오. 아마존 키네시스 비디오 스트림 모니터링

프래그먼트 메타데이터 할당량

Kinesis 비디오 스트림의 프래그먼트에 프래그먼트 메타데이터를 추가할 때는 다음과 같은 서비스 할당량이 적용됩니다.

• 1개의 조각에 최대 10개의 메타데이터 항목을 추가할 수 있습니다.

• 조각 메타데이터 이름의 길이는 최대 128바이트입니다.

• 조각 메타데이터 값의 길이는 최대 256바이트입니다.

• 프래그먼트 메타데이터 이름은 문자열 "“로 시작할 수 없습니다. AWS 그러한 메타데이터 항목이 추가된 경우 PIC의 putFragmentMetadata 메서드에서 STATUS_INVALID_METADATA_NAME 오류를 반환합니다(오류 코드 0x52000077). 이때 애플리케이션이 이 오류를 무시할 수도 있고(PIC가 메타데이터 항목을 추가하지 않음) 이 오류에 반응할 수도 있습니다.

스트림 태그

이러한 메타데이터 키-값 쌍은 Kinesis 비디오 스트림에 포함된 개별 프래그먼트가 아니라 전체 Kinesis Video Streams 리소스에 적용됩니다.

각 Kinesis 비디오 스트림은 최대 50개의 태그를 지원합니다.

스트림 태그의 키 및 값에 TagStream 대한 제한은 을 참조하십시오.