기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon Kinesis Video Streams 서비스 할당량
Kinesis Video Streams에는 다음과 같은 서비스 할당량이 있습니다.
**중요**
다음 서비스 할당량은 지원 티켓을 제출하여 업그레이드할 수 있는 소프트 **[s]**이거나 늘릴 수 없는 하드 **[h]**입니다. 아래 표의 개별 서비스 할당량 옆에 [s]와 [h]가 표시됩니다.
## 컨트롤 플레인 API 서비스 할당량
다음 섹션에서는 컨트롤 플레APIs의 서비스 할당량을 설명합니다. TPS는 *초당 트랜잭션*을 나타냅니다.
계정 수준 또는 리소스 수준 요청 한도에 도달하면 `ClientLimitExceededException`이 발생합니다.
| API | 계정 제한: 요청 | 계정 제한: 스트림 | 스트림 레벨 한도 | 관련 예외 및 참고 사항 |
| --- | --- | --- | --- | --- |
| CreateStream | 50TPS[s] | 지원되는 모든 리전에서 계정당 [s] 10,000개의 스트림. 계정당 100,000개 이상의 스트림으로 최대 한도를 증가할 수 있습니다. AWS Management Console 에서에 로그인[https://console.aws.amazon.com/](https://console.aws.amazon.com/)하고이 한도 증가를 요청합니다. | | 디바이스, CLI, SDK 구동 액세스 및 콘솔은 모두 이 API를 호출할 수 있습니다. 스트림이 이미 존재하지 않는 경우 하나의 API 호출만 성공합니다. |
| DeleteEdgeConfiguration | 10TPS[h] | 해당 사항 없음 | 1 TPS [h] | |
| DeleteStream | 50TPS[h] | 해당 사항 없음 | 5TPS[h] | |
| DescribeEdgeConfiguration | 50TPS[h] | 해당 사항 없음 | 5TPS[h] | |
| DescribeImageGenerationConfiguration | 50TPS[h] | 해당 사항 없음 | 5TPS[h] | |
| DescribeMappedResourceConfiguration | 50TPS[h] | 해당 사항 없음 | 5TPS[h] | |
| DescribeNotificationConfiguration | 50TPS[h] | 해당 사항 없음 | 5TPS[h] | |
| DescribeStream | 300TPS[h] | 해당 사항 없음 | 5TPS[h] | |
| GetDataEndpoint | 300TPS[h] | 해당 사항 없음 | 5TPS[h] | 대부분의 PutMedia/GetMedia 사용 사례에서 스트리밍 토큰을 새로 고치기 위해 45분마다 호출됩니다. 애플리케이션이 실패 시 다시 로드하는 경우 데이터 엔드포인트를 캐시하는 것이 안전합니다. |
| ListEdgeAgentConfigurations | 50TPS[h] | 해당 사항 없음 | 해당 사항 없음 | |
| ListStreams | 50TPS[h] | 해당 사항 없음 | | |
| ListTagsForStream | 50TPS[h] | 해당 사항 없음 | 5TPS[h] | |
| StartEdgeConfigurationUpdate | 10TPS[h] | 해당 사항 없음 | 1 TPS [h] | |
| TagStream | 50TPS[h] | 해당 사항 없음 | 5TPS[h] | |
| UntagStream | 50TPS[h] | 해당 사항 없음 | 5TPS[h] | |
| UpdateDataRetention | 50TPS[h] | 해당 사항 없음 | 5TPS[h] | |
| UpdateImageGenerationConfiguration | 50TPS[h] | 해당 사항 없음 | 5TPS[h] | |
| UpdateNotificationConfiguration | 50TPS[h] | 해당 사항 없음 | 5TPS[h] | |
| UpdateStream | 50TPS[h] | 해당 사항 없음 | 5TPS[h] | |
| UpdateStreamStorageConfiguration | 50TPS[h] | 해당 사항 없음 | 5TPS[h] | |
| DescribeStreamStorageConfiguration | 50TPS[h] | 해당 사항 없음 | 5TPS[h] | |
## 미디어 및 아카이빙된 미디어 API 서비스 할당량
다음 섹션에서는 미디어 및 아카이브된 미디어 APIs 대한 서비스 할당량을 설명합니다.
계정 수준 또는 리소스 수준 요청 한도에 도달하면 `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[h] | 스트림당 12.5MB/초 또는 100Mbps[s] | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/kinesisvideostreams/latest/dg/limits.html) | [PutMedia](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_PutMedia.html) 요청은 스트리밍되는 장기 실행 연결입니다. 단일 영구 연결로 여러 조각을 전송할 수 있으므로 각 데이터 조각에 대해 새 연결을 열 필요가 없습니다. 동시 PutMedia 연결을 두 개 이상 시도하면 Kinesis Video Streams는 ConnectionLimitExceededException 오류 메시지와 함께 최신 연결을 제한합니다. |
| GetClip | 해당 사항 없음 | 해당 사항 없음 | 100MB 크기 제한[h] | 최대 조각 수: 200[h] | |
| GetDASHStreamingSessionURL | 25TPS[h] | 해당 사항 없음 | 해당 사항 없음 | 해당 사항 없음 | |
| GetHLSStreamingSessionURL | 25TPS[h] | 해당 사항 없음 | 해당 사항 없음 | 해당 사항 없음 | |
| GetImages | 해당 사항 없음 | 해당 사항 없음 | 100MB[h] | 해당 사항 없음 | 요청당 최대 이미지 수는 100[h]입니다. 의 최소값`SamplingInterval`은 초당 5개의 이미지인 200밀리초(ms)입니다. |
| GetMedia | 5TPS[h] | 3[h] | 25MB/s 또는 200Mbps[s] | 초당 최대 5개의 조각 전송 [h] | [GetMedia](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_GetMedia.html) 요청은 스트리밍되는 장기 실행 연결입니다. 단일 영구 연결로 여러 조각을 전송할 수 있으므로 각 데이터 조각에 대해 새 연결을 열 필요가 없습니다. 동시 GetMedia 연결을 3개 이상 시도하면 Kinesis Video Streams는 ConnectionLimitExceededException 오류 메시지와 함께 최신 연결을 제한합니다.일반적인 조각이 약 5MB인 경우이 제한은 Kinesis 비디오 스트림당 약 75MBps를 의미합니다. 이러한 스트림의 송신 비트 속도는 최대 수신 비트 속도의 2배입니다. `GetMedia`는 HLS/DASH 재생에 사용되지 않습니다. |
| GetMediaForFragmentList | 해당 사항 없음 | 5[s] | 25MB/s 또는 200Mbps[s] | 최대 조각 수: 1000[h] | 5개의 조각 기반 소비 애플리케이션은를 동시에 호출할 수 있습니다GetMediaForFragmentList. 그 이상의 연결은 거부됩니다. |
**비디오 재생 프로토콜 API 서비스 할당량**
| API | 세션 레벨 제한 | 조각 레벨 제한 |
| --- | --- | --- |
| GetDASHManifestPlaylist | 5TPS[h] | 재생 목록당 최대 조각 수: 5,000[h] |
| GetHLSMasterPlaylist | 5TPS[h] | 해당 사항 없음 |
| GetHLSMediaPlaylist | 5TPS[h] | 재생 목록당 최대 조각 수: 5,000[h] |
| GetMP4InitFragment | 5TPS[h] | 해당 사항 없음 |
| GetMP4MediaFragment | 20TPS[h] | 해당 사항 없음 |
| GetTSFragment | 20TPS[h] | 해당 사항 없음 |
## 조각 메타데이터 및 조각 미디어 할당량
[아카이브된 미디어에 액세스하기 위한 Kinesis Video Streams APIs](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_Reference.html)는 API 호출 수가 아닌 요청된 조각 수에 따라 제한됩니다. APIs는 조각 메타데이터 수와 요청된 조각 미디어 수에 따라 속도가 제한됩니다. 조각 메타데이터 및 조각 미디어 할당량은 스트림당 적용됩니다. 즉, 한 스트림의 조각 메타데이터 또는 미디어에 대한 요청은 다른 스트림의 할당량에 적용되지 않습니다. 그러나 지정된 스트림 내에서 각 할당량은 여러 APIs에서 공유됩니다. 즉, 지정된 스트림에 대해 서로 다른 APIs의 조각에 대한 요청은 동일한 할당량에서 소비됩니다. 스트림에 대한 조각 메타데이터 또는 조각 미디어 할당량을 초과하면 API가를 반환합니다`ClientLimitExceededException`. 다음 표는 APIs 두 가지 유형의 할당량 각각에서 어떻게 소비하는지 보여줍니다. 이러한 테이블의 두 번째 열의 경우 스트림의 할당량이 N인 경우 APIs에 해당 스트림의 할당량 유형에서 소비할 N 포인트가 있다고 가정합니다. `GetClip` API는 두 테이블 모두에 나타납니다.
**조각 메타데이터 할당량 소비**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/kinesisvideostreams/latest/dg/limits.html)
**조각 미디어 할당량 소비**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/kinesisvideostreams/latest/dg/limits.html)
예를 들어 초당 500개의 조각 미디어 할당량을 사용하면 특정 스트림에 대해 다음과 같은 호출 패턴이 지원됩니다.
+ 각 클립에 조각이 100`GetClip`개인에 대한 초당 요청 5개.
+ 각 클립에 조각이 5`GetClip`개인에 대한 초당 요청 100개.
+ 각 클립에 조각`GetClip`이 100개인 초당 2개의 요청과 각 클립`GetMediaForFragmentList`에 초당 3개의 요청.
+ 에 대한 초당 400개의 요청 `GetMP4MediaFragment` 및에 대한 초당 100개의 요청`GetTSFragment`.
이러한 할당량은 스트림당 지원할 수 있는 HLS 및 MPEG-DASH 세션 수에 중요한 영향을 미칩니다. 특정 시간에 미디어 플레이어가 사용할 수 있는 HLS 및 DASH 세션 수에는 제한이 없습니다. 따라서 재생 애플리케이션에서 너무 많은 세션을 동시에 사용할 수 없도록 하는 것이 중요합니다. 다음 두 예제에서는 지원할 수 있는 동시 재생 세션 수를 결정하는 방법을 설명합니다.
*예제 1: 라이브 스트리밍*
지속 시간 조각이 1초이고 오디오 및 비디오 트랙이 5로 `MaxMediaPlaylistFragmentResults` 설정된 HLS가 있는 라이브 스트리밍 시나리오에서 미디어 플레이어는 일반적으로 초`GetHLSMediaPlaylist`당 2회의 호출을 수행합니다. 한 호출은 최신 비디오 메타데이터용이고 다른 호출은 해당 오디오 메타데이터용입니다. 두 호출은 각각 5개의 조각 메타데이터 할당량을 사용합니다. 또한 초`GetMP4MediaFragment`당 두 번의 호출을 수행합니다. 하나는 최신 비디오에 대한 호출이고 다른 하나는 해당 오디오에 대한 호출입니다. 각 호출은 단일 조각 미디어 토큰을 사용하므로 총 2개의 토큰이 사용됩니다.
이 시나리오에서는 최대 250개의 동시 재생 세션을 지원할 수 있습니다. 250개의 세션에서이 시나리오는 초당 2,500개의 조각 메타데이터 할당량 포인트(10,000개의 할당량 미만)와 초당 500개의 조각 미디어 할당량을 사용합니다.
*예제 2: 온디맨드 재생*
MPEG-DASH, 오디오 및 비디오 트랙이 1,000으로 `MaxManifestFragmentResults` 설정된 과거 이벤트의 온디맨드 재생 시나리오에서 미디어 플레이어는 일반적으로 세션 시작 시 한 `GetDASHManifest` 번 호출하고(1,000개의 조각 메타데이터 할당량 포인트 사용) 모든 조각`GetMP4MediaFragment`이 로드될 때까지 초당 최대 5회(5개의 조각 미디어 할당량 포인트 사용)의 속도로 호출합니다. 이 시나리오에서는 초당 최대 10개의 새 세션을 시작할 수 있으며(초당 10,000개의 조각 메타데이터 할당량에서 바로) 최대 100개의 세션이 초당 5개의 속도로 조각 미디어를 적극적으로 로드할 수 있습니다(초당 500개의 조각 미디어 할당량에서 바로).
`ArchivedFragmentsConsumed.Metadata` 및 `ArchivedFragmentsConsumed.Media`를 사용하여 각각 조각 메타데이터 및 조각 미디어 할당량 포인트의 소비를 모니터링할 수 있습니다. 모니터링에 대한 자세한 내용은 섹션을 참조하세요[Amazon Kinesis Video Streams 모니터링](monitoring.md).
## 스트리밍 메타데이터 서비스 할당량
다음 서비스 할당량은 Kinesis 비디오 스트림에 스트리밍 메타데이터를 추가하는 데 적용됩니다.
+ 1개의 조각에 최대 10개의 메타데이터 항목을 추가할 수 있습니다.
+ 조각 메타데이터 *이름*의 길이는 최대 128바이트입니다.
+ 조각 메타데이터 *값*의 길이는 최대 256바이트입니다.
+ 조각 메타데이터 *이름은* 문자열 "`AWS`"로 시작할 수 없습니다. 그러한 메타데이터 항목이 추가된 경우 PIC의 `putFragmentMetadata` 메서드에서 `STATUS_INVALID_METADATA_NAME` 오류를 반환합니다(오류 코드 `0x52000077`). 이때 애플리케이션이 이 오류를 무시할 수도 있고(PIC가 메타데이터 항목을 추가하지 않음) 이 오류에 반응할 수도 있습니다.
## 생산자 SDK 할당량
다음 표에는 SDK의 값에 대한 현재 할당량이 포함되어 있습니다. 자세한 정보는 [Kinesis Video Streams에 업로드](producer-sdk.md)을 참조하세요.
**참고**
이러한 값을 설정하기 전에 입력을 확인해야 합니다. SDK는 이러한 제한을 확인하지 않으며 제한이 초과되면 실행 시간 오류가 발생합니다.
| 값 | Limit | 참고 |
| --- | --- | --- |
| 최대 스트림 개수 | 128 | 생산자 객체에서 생성할 수 있는 최대 스트림 개수입니다. 이 제한은 소프트 제한으로, 제한을 늘리도록 요청할 수 있습니다. 생산자가 실수로 스트림을 재귀적으로 생성하지 않도록 보장합니다. |
| 디바이스의 최대 이름 길이 | 128자 | |
| 최대 태그 개수 | 스트림당 50개 | |
| 최대 스트림 이름 길이 | 256자 | |
| 최소 스토리지 크기 | 10MiB = 10 \$1 1024 \$1 1024바이트 | |
| 최대 스토리지 크기 | 10 GiB = 10 \$1 1024 \$1 1024 \$1 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 서비스 할당량](#limits) 단원을 참조하십시오. |
| 최대 조각 기간 | 20초 | 자세한 내용은 [Amazon Kinesis Video Streams 서비스 할당량](#limits) 단원을 참조하십시오. |
| 최대 연결 기간 | 45분 | 이 시간이 경과하면 백엔드가 연결을 닫습니다. SDK는 이 시간 이내에 토큰을 교체하고 새 연결을 설정합니다. |
| 최대 ACK 세그먼트 길이 | 1,024자 | ACK 구문 분석기 함수로 전송된 승인의 최대 세그먼트 길이입니다. |
| 최대 콘텐츠 유형 문자열 길이 | 128자 | |
| 최대 코덱 ID 문자열 길이 | 32자 | |
| 최대 추적 이름 문자열 길이 | 32자 | |
| 최대 코덱 프라이빗 데이터 길이 | 1MiB = 1 \$1 1024 \$1 1024바이트 | |
| 최소 타임코드 스케일 값 길이 | 100ns | 결과 MKV 클러스터에서 프레임 타임스탬프를 나타내는 최소 타임코드 스케일 값입니다. 이 값은 SDK 표준인 100ns 단위씩 증분되어 지정됩니다. |
| 최대 타임코드 스케일 값 길이 | 1초 | 결과 MKV 클러스터에서 프레임 타임스탬프를 나타내는 최대 타임코드 스케일 값입니다. 이 값은 SDK 표준인 100ns 단위씩 증분되어 지정됩니다. |
| 최소 콘텐츠 보기 항목 수 | 10 | |
| 최소 버퍼 기간 | 20초 | 이 값은 SDK 표준인 100ns 단위씩 증분되어 지정됩니다. |
| 최대 업데이트 버전 길이 | 128자 | |
| 최대 ARN 길이 | 1024자 | |
| 최대 조각 시퀀스 길이 | 128자 | |
| 최대 보존 기간 | 10년 | |