Amazon Kinesis Video Streams 서비스 할당량

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

중요

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

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

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

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

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

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

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

다음 섹션에서는 미디어 및 보관된 미디어의 서비스 할당량에 대해 설명합니다. APIs

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

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

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

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

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

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

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

API데이터 플레인 서비스 할당량

API	스트림 레벨 한도	연결 레벨 한도	대역폭 한도	조각 레벨 제한	관련 예외 및 참고 사항
PutMedia	5 TPS [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]
G 세션 etDASHStreaming URL	25 TPS [시간]	N/A	해당 사항 없음	N/A
G etHLSStreaming 세션 URL	25 TPS [시간]	N/A	해당 사항 없음	해당 사항 없음
GetImages	해당 사항 없음	N/A	100 메가바이트 [h]	N/A	요청당 최대 이미지 수는 100 [h] 입니다. 참고 의 최소값은 200밀리초 (ms) 이며, 이는 초당 5개 이미지입니다. SamplingInterval
GetMedia	5 TPS [h]	3[s]	25MB/s 또는 200Mbps[s]	초당 최대 5개 프래그먼트 전송 [h]	고유한 소비 클라이언트는 연결이 설정된 후 애플리케이션이 지속적으로 읽어야 TPS 하므로 2~3개를 초과할 필요가 없습니다. 일반적인 프래그먼트가 약 5MB인 경우 이 제한은 MBps Kinesis 비디오 스트림당 최대 75개를 의미합니다. 이러한 스트림의 송신 비트 속도는 최대 수신 비트 속도의 2배입니다. 참고 GetMedia/재생에는 사용되지 HLS 않습니다. DASH
GetMediaForFragmentList	N/A	5[s]	25MB/s 또는 200Mbps[s]	최대 조각 수: 1000[h]	프래그먼트 기반 소비 애플리케이션 5개를 동시에 호출할 수 있습니다. GetMediaForFragmentList 그 이상의 연결은 거부됩니다.

비디오 재생 프로토콜 서비스 할당량 API

API	세션 레벨 제한	조각 레벨 제한
G 플레이리스트 etDASHManifest	TPS[5 시간]	플레이리스트당 최대 프래그먼트 수: 5000 [h]
G 플레이리스트 etHLSMaster	TPS[5 시간]	N/A
G etHLSMedia 플레이리스트	TPS[5 시간]	플레이리스트당 최대 프래그먼트 수: 5000 [h]
가져오기 MP4InitFragment	TPS[5 시간]	N/A
가져와 MP4MediaFragment	20 TPS [시간]	N/A
G etTSFragment	20 TPS [시간]	N/A

프래그먼트 메타데이터 및 프래그먼트 미디어 쿼터

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

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

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

예 1: 라이브 스트리밍

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

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

예 2: 온디맨드 재생

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

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

스트리밍 메타데이터 서비스 할당량

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

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

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

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

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

프로듀서 SDK 할당량

다음 표에는 의 값에 대한 현재 할당량이 나와 있습니다. SDK 자세한 내용은 Kinesis Video Streams에 업로드 섹션을 참조하세요.

참고

이러한 값을 설정하기 전에 입력을 확인해야 합니다. 는 이러한 한도를 검증하지 SDK 않으며 한도를 초과할 경우 런타임 오류가 발생합니다.

값	Limit	참고
최대 스트림 개수	128	생산자 객체에서 생성할 수 있는 최대 스트림 개수입니다. 이 제한은 소프트 제한으로, 제한을 늘리도록 요청할 수 있습니다. 이를 통해 제작자가 실수로 스트림을 재귀적으로 생성하는 일이 발생하지 않습니다.
디바이스의 최대 이름 길이	128자
최대 태그 개수	스트림당 50개
최대 스트림 이름 길이	256자
최소 스토리지 크기	10MiB = 10 * 1024 * 1024바이트
최대 스토리지 크기	10 GiB = 10 * 1024 * 1024 * 1024바이트
최대 루트 디렉터리 경로 길이	4,096자
최대 인증 정보 길이	10,000바이트
최대 URI 문자열 길이	10,000자
최대 태그 이름 길이	128자
최대 태그 값 길이	1,024자
최소 보안 토큰 기간	30초
보안 토큰 유예 기간	40분	지정된 지속 시간이 더 길면 이 값으로 제한됩니다.
보존 기간	0 또는 한 시간 이상	0은 보관하지 않음을 나타냅니다.
최소 클러스터 기간	1초	값은 SDK 표준인 100ns 단위로 지정됩니다.
최대 클러스터 기간	30초	값은 SDK 표준인 100ns 단위로 지정됩니다. 백엔드는 클러스터 기간을 더 짧게 적용할 API 수 있습니다.
최대 조각 크기	50MB	자세한 내용은 Amazon Kinesis Video Streams 서비스 할당량 단원을 참조하십시오.
최대 조각 기간	20초	자세한 내용은 Amazon Kinesis Video Streams 서비스 할당량 단원을 참조하십시오.
최대 연결 기간	45분	이 시간이 경과하면 백엔드가 연결을 닫습니다. 는 이 시간 내에 토큰을 SDK 순환시키고 새 연결을 설정합니다.
최대 세그먼트 길이 ACK	1,024자	ACK파서 함수로 전송되는 승인 메시지의 최대 세그먼트 길이.
최대 콘텐츠 유형 문자열 길이	128자
최대 코덱 ID 문자열 길이	32자
최대 추적 이름 문자열 길이	32자
최대 코덱 프라이빗 데이터 길이	1MiB = 1 * 1024 * 1024바이트
최소 타임코드 스케일 값 길이	100ns	결과 클러스터의 프레임 타임스탬프를 나타내는 최소 타임코드 스케일 값입니다. MKV 값은 표준인 100ns 단위로 지정됩니다. SDK
최대 타임코드 스케일 값 길이	1초	결과 클러스터의 프레임 타임스탬프를 나타내는 최대 타임코드 스케일 값입니다. MKV 값은 표준인 100ns 단위로 지정됩니다. SDK
최소 콘텐츠 보기 항목 수	10
최소 버퍼 기간	20초	값은 표준인 100ns 단위로 지정됩니다. SDK
최대 업데이트 버전 길이	128자
최대 길이 ARN	1024자
최대 조각 시퀀스 길이	128자
최대 보존 기간	10년