Amazon Kinesis Video Streams 终端节点和配额 - AWS 一般参考
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

Amazon Kinesis Video Streams 终端节点和配额

以下是此服务的服务终端节点和服务配额。要以编程方式连接到 AWS 服务,您需要使用终端节点。除标准 AWS 终端节点外,一些 AWS 服务还在选定区域中提供 FIPS 终端节点。有关更多信息,请参阅 AWS 服务终端节点。服务配额(也称为限制)是您的 AWS 账户使用的服务资源或操作的最大数量。有关更多信息,请参阅 AWS Service Quoas

服务终端节点

区域名称 区域 Endpoint 协议
美国东部 (俄亥俄) us-east-2 KinesisVideo .us-east-2.amazonaws.com HTTPS
美国东部 (弗吉尼亚北部) us-east-1 KinesisVideo .us-east-1.amazonaws.com HTTPS
美国西部 (俄勒冈) us-west-2 KinesisVideo .us-west-2.amazonaws.com HTTPS
亚太地区(香港) ap-east-1 kinesisvideo.ap-east-1.amazonaws.com HTTPS
亚太地区 (孟买) ap-south-1 kinesisvideo.ap-southeast-1.amazonaws.com HTTPS
亚太地区 (首尔) ap-northeast-2 KinesisVideo .ap-northeast-2.amazonaws.com HTTPS
亚太地区 (新加坡) ap-southeast-1 kinesisvideo.ap-southeast-1.amazonaws.com HTTPS
亚太地区 (悉尼) ap-southeast-2 kinesisvideo.ap-southeast-2.amazonaws.com HTTPS
亚太地区 (东京) ap-northeast-1 KinesisVideo .ap-northeast-1.amazonaws.com HTTPS
加拿大 (中部) ca-central-1 KinesisVideo .ca-central-1.amazonaws.com HTTPS
欧洲(法兰克福) eu-central-1 KinesisVideo .eu-central-1.amazonaws.com HTTPS
欧洲(爱尔兰) eu-west-1 kinesisvideo.eu-west-1.amazonaws.com HTTPS
欧洲(伦敦) eu-west-2 Kinesisvideo.eu-west-2.amazonaws.com HTTPS
欧洲(巴黎) eu-west-3 kinesisvideo.eu-west-3.amazonaws.com HTTPS
南美洲(圣保罗) sa-east-1 kinesisvideo.sa-east-1.amazonaws.com HTTPS

Service Quotas

下面的配额是软性配额 [s](可以通过提交支持票证进行升级)或硬性配额 [h](不能提高)。

控制层面 API 配额

下一节介绍控制层面 API 配额。

达到账户级别请求配额时,会引发 ClientLimitExceededException

达到账户级别流配额时,或达到流级别配额时,会引发 StreamLimitExceededException

控制层面 API 配额
API 账户配额:请求 账户配额:流 流级别配额 相关异常和说明
CreateStream 50 TPS [s] 每个账户 2500 个流,美国东部(弗吉尼亚北部)和美国西部(俄勒冈)区域。所有其他支持区域中每个账户 1000 个流。
注意

可将此配额提高至每个账户 100,000 个(或更多个)流。通过以下网址登录 AWS 管理控制台:https://console.amazonaws.cn/,并提交服务配额提高案例,Kinesis Video Streams 请求提高此限制。

设备、CLI、SDK 驱动的访问和控制台均可调用此 API。如果流尚不存在,则只有一个 API 调用会成功。
DescribeStream 300 TPS [h] 不适用 5 TPS [h]
UpdateStream 50 TPS [h] 不适用 5 TPS [h]
ListStreams 50 TPS [h] 不适用
DeleteStream 50 TPS [h] 不适用 5 TPS [h]
GetDataEndpoint 300 TPS [h] 不适用 5 TPS [h] 每 45 分钟调用一次,旨在刷新大多数 PutMedia/GetMedia 使用案例的流令牌。如果应用程序在失败时重新加载缓存数据终端节点,那么这些终端节点是安全的。
UpdateDataRetention 50 TPS [h] 不适用 5 TPS [h]
TagStream 50 TPS [h] 不适用 5 TPS [h]
UntagStream 50 TPS [h] 不适用 5 TPS [h]
ListTagsForStream 50 TPS [h] 不适用 5 TPS [h]

媒体和已存档媒体 API 配额

下一节介绍媒体和已存档媒体 API 的配额。

超出流级别配额时,会引发 StreamLimitExceededException

达到连接级别配额时,会引发 ConnectionLimitExceededException

达到片段级别配额时,会引发以下错误或确认:

  • 为低于最低持续时间的片段返回 MIN_FRAGMENT_DURATION_REACHED 确认。

  • 会为高于最高持续时间的片段返回 MAX_FRAGMENT_DURATION_REACHED 确认。

  • 会为高于最大数据大小的片段返回 MAX_FRAGMENT_SIZE 确认。

  • 如果在 GetMediaForFragmentList 操作中达到片段配额,则会引发 FragmentLimitExceeded 异常。

数据层面 API 配额
API 流级别配额 连接级别配额 带宽配额 片段级别配额 相关异常和说明
PutMedia 5 TPS [h] 1 [s] 12.5 MB/秒或 100 Mbps [s]
  • 最小片段持续时间:1 秒 [h]

  • 最大片段持续时间:10 秒 [h]

  • 最大片段大小:50 MB [h]

  • 轨道的最大数量:3 [s]

典型 PutMedia 请求包含几秒钟的数据,因而导致每个流较低的 TPS。对于多个超出配额的并发连接,会接受最后一个连接。
GetHLSStreamingSessionURL 5 TPS 突增,1 TPS 持续 [h] 不适用 不适用 不适用 每个流一次只有 10 个会话可以处于活动状态 [s]。达到配额后,当创建新会话时,将撤销最早的会话。
GetDASHStreamingSessionURL 5 TPS 突增,1 TPS 持续 [h] 不适用 不适用 不适用 每个流一次只有 10 个会话可以处于活动状态 [s]。达到配额后,当创建新会话时,将撤销最早的会话。
GetMedia 5 TPS [h] 3 [s] 25 MB/秒或 200 Mbps [s] 不适用

只有三个客户端可在任何时候从媒体流同时接收内容。后续客户端连接将被拒绝。唯一使用客户端应该不需要超过 2 或 3 TPS,因为建立连接后,我们预计应用程序将持续读取。

如果典型片段大约为 5 MB,则此配额意味着每个 Kinesis 视频流大约 75 MB/秒。此类流将具有流的最大传入比特率 2 倍的传出比特率。

ListFragments 5 TPS [h] 不适用 不适用 不适用
GetMediaForFragmentList 5 TPS [h] 5 [s] 25 MB/秒或 200 MbpsA [s] 最大片段数:1000 [h] 5 个基于片段的使用应用程序可以同时获取媒体。后续连接将被拒绝。
视频播放协议 API 配额
API 会话级别配额 片段级别配额
GetDASHManifestPlaylist 5 TPS [h] 每个播放列表的最大片段数:1000 [h]
GetHLSMasterPlaylist 5 TPS [h] 不适用
GetHLSMediaPlaylist 5 TPS [h] 每个播放列表的最大片段数:1000 [h]
GetMP4InitFragment 5 TPS [h] 不适用
GetMP4MediaFragment 10 TPS [h] 不适用
GetTSFragment 10 TPS [h] 不适用

Kinesis Video Streams with WebRTC 控制层面 API 配额

以下部分介绍控制层面 API 的服务配额。

控制层面 API 服务配额
API 账户服务配额:请求 账户服务配额:通道 通道级服务配额 相关异常和说明
CreateSignalingChannel 50 TPS [s] 在所有其他支持的区域,每个区域每账户 10000 个信令通道 [s]。
DescribeSignalingChannel 300 TPS [h] 不适用 5 TPS [h]
UpdateSignalingChannel 50 TPS [h] 不适用 5 TPS [h]
ListSignalingChannels 50 TPS [h] 不适用
DeleteStream 50 TPS [h] 不适用 5 TPS [h]
GetSignalingChannelEndpoint 300 TPS [h] 不适用
TagResource 50 TPS [h] 不适用 5 TPS [h]
UntagResource 50 TPS [h] 不适用 5 TPS [h]
ListTagsForResource 50 TPS [h] 不适用 5 TPS [h]

Kinesis Video Streams with WebRTC 信令 API Service Quotas

以下部分介绍 Kinesis Video Streams with WebRTC 中的信令组件的服务配额。

  • ConnectAsMaster

    • API - 每个通道 3 个 TPS(硬性)

    • 每个信令通道的最大主连接数 - 1(硬性)

    • 连接持续时间限制 - 1 小时(硬性)

    • 空闲连接超时 - 10 分钟(硬性)

    • 当客户端收到来自服务器的 GO_AWAY 消息时,连接将在 1 分钟的宽限期后终止(硬性)。

  • ConnectAsViewer

    • API - 每个通道 3 个 TPS(硬性)

    • 每个通道的查看者连接最大数 - 10(软性)

    • 连接持续时间限制 - 1 小时(硬性)

    • 空闲连接超时 - 10 分钟(硬性)

    • 一旦客户端收到来自服务器的 GO_AWAY 消息,连接将在 1 分钟的宽限期后终止(硬性)。

  • SendSDPOffer

    • API:每个 WebSocket 连接 5 个 TPS(硬性)

    • 消息负载大小限制 - 10k(硬性)

  • SendSDPAnswer

    • API:每个 WebSocket 连接 5 个 TPS(硬性)

    • 消息负载大小限制 - 10k(硬性)

  • SendICECandidate

    • API:每个 WebSocket 连接 20 个 TPS(硬性)

    • 消息负载大小限制 - 10k(硬性)

  • SendAlexaOffertoMaster

    • API:每个信令通道 5 个 TPS(硬性)

  • GetIceServerConfig

    • API:每个信令通道 5 个 TPS(硬性)

  • Disconnect

    • 不适用

Kinesis Video Streams with WebRTC TURN Service Quotas

以下部分介绍了 Kinesis Video Streams with WebRTC 中 Traversal Use Relays Relays Relays BURN 组件的配额。

  • 比特率 - 5Mbps(硬性)

  • 凭证生命周期 - 5 分钟(硬性)

  • 分配数 - 每个信令通道 50(硬性)