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

如果我们为英文版本指南提供翻译,那么如果存在任何冲突,将以英文版本指南为准。在提供翻译时使用机器翻译。

Amazon Kinesis Video Streams 终端节点和配额

以下是此服务的服务终端节点和服务配额。要通过编程方式连接到 AWS 服务,您需要使用终端节点。有关更多信息,请参阅 AWS 服务终端节点。服务配额(也称为限制)是您的 AWS 账户的最大服务资源或操作数量。有关更多信息,请参阅 AWS 服务配额

服务终端节点

区域名称 区域 终端节点 协议
美国东部 (俄亥俄) 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-south-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 服务配额

以下部分介绍 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 服务配额

以下部分介绍了 Kinesis Video Streams with WebRTC 中 Traversal Using Relays around NAT (TURN) 组件的配额。

  • 比特率 - 5Mbps(硬性)

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

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