

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

# Amazon Rekognition 中的准则和配额
<a name="limits"></a>

以下几个部分提供了使用 Amazon Rekognition 时的准则和配额。有两种配额。无法更改*设置的配额*，例如最大图像大小。[AWS 服务限额](https://docs.aws.amazon.com/general/latest/gr/rekognition.html#limits_rekognition)页面上列出的*默认限额*可通过 [默认限额](#changeable-quotas) 部分中描述的步骤进行更改。

**Topics**
+ [支持的区域](#supported-regions)
+ [设置配额](#quotas)
+ [默认限额](#changeable-quotas)

## 支持的区域
<a name="supported-regions"></a>

有关提供了 Amazon Rekognition 的 AWS 区域的列表，请参阅**《Amazon Web Services 一般参考》中的 [AWS 区域和端点](https://docs.aws.amazon.com/general/latest/gr/rekognition.html)。

## 设置配额
<a name="quotas"></a>

以下是 Amazon Rekognition 中不可更改的限制列表。有关您可更改的限制的信息，例如每秒事务数 (TPS) 限制，请参阅 [默认限额](#changeable-quotas)。

有关 Amazon Rekognition Custom Labels 限制，请参阅 [Amazon Rekognition Custom Labels 中的准则和配额](https://docs.aws.amazon.com/rekognition/latest/customlabels-dg/limits.html)。

### Amazon Rekognition Image
<a name="limits-image"></a>
+ 存储为 Amazon S3 对象的最大图像大小限制为 15 MB。
+ `DetectModerationLabels` 最大图像尺寸的宽和高均为 10K 像素。
+ `DetectLabels` 最大图像尺寸的宽和高均为 10K 像素。
+ 要被检测到，人脸在 1920X1080 像素的图像中的大小不得小于 40x40 像素。对于尺寸大于 1920X1080 像素的图像，人脸的尺寸也需要相应增加。
+ 最小图像尺寸的高和宽均为 80 像素。`DetectProtectiveEquipment` 最小图像尺寸的高和宽均为 64 像素。
+ `DetectProtectiveEquipment` 最大图像尺寸的宽和高均为 4096 像素。
+ 要被 `DetectProtectiveEquipment` 检测到，人脸在 800x1300 像素的图像中的大小不得小于 100x100 像素。对于尺寸大于 800x1300 像素的图像，最小人脸的尺寸也需要相应增加。
+ 作为参数传入 API 的最大图像大小（原始字节数）为 5 MB。`DetectProtectiveEquipment` API 的限制为 4 MB。
+ Amazon Rekognition 支持 PNG 和 JPEG 图像格式。也就是说，您作为输入提供给各种 API 操作（例如 `DetectLabels` 和 `IndexFaces`）的图像必须采用受支持的格式之一。
+ 一个人脸集合中可存储的人脸向量最大数目为 2000 万。
+ 一个人脸集合中可存储的人脸向量的默认最大数目为 1000 万。
+ 搜索 API 返回的最大匹配人脸向量为 4096。
+ 搜索 API 返回的最大匹配用户向量为 4096。
+ `DetectText` 可以检测图像中最多 100 个单词。
+ `DetectProtectiveEquipment` 最多可以检测到 15 个人身上的个人防护设备。

有关图像和人脸比较的最佳实践信息，请参阅[传感器、输入图像和视频的最佳实践](best-practices.md)。

### Amazon Rekognition Image 批量分析
<a name="limits-image"></a>
+ Amazon Rekognition Image 批量分析可以分析多达 1 万张图像。
+ Amazon Rekognition Image 批量分析支持大小不超过 50MB 的输入清单。

### Amazon Rekognition Video 存储视频
<a name="limits-vstored-video"></a>
+ Amazon Rekognition Video 可以分析存储的大小不超过 10 GB 的视频。
+ Amazon Rekognition Video 可以分析长达 6 小时的存储视频。
+ Amazon Rekognition Video 最多支持每个账户 20 个并发任务。
+ 存储视频必须使用 H.264 编解码器进行编码。支持的文件格式为 MPEG-4 和 MOV。
+ 任何分析音频数据的 Amazon Rekognition Video API 仅支持 AAC 音频编解码器。
+ 分页标记的生存时间 (TTL) 期间为 24 小时。分页标记位于 Get 操作返回的 `NextToken` 字段中，例如 `GetLabeldetection`。

### Amazon Rekognition Video 流视频
<a name="limits-streaming-video"></a>
+ 一个 Kinesis Video 输入流最多可关联一个 Amazon Rekognition Video 流处理器。
+ 一个 Kinesis Data 输出流最多可关联一个 Amazon Rekognition Video 流处理器。
+ 与一个 Amazon Rekognition Video 流处理器关联的 Kinesis Video 输入流和 Kinesis Data 输出流无法由多个处理器共享。
+ 任何分析音频数据的 Amazon Rekognition Video API 仅支持 ACC 音频编解码器。

## 默认限额
<a name="changeable-quotas"></a>

默认配额列表可在 [AWS 服务限额](https://docs.aws.amazon.com/general/latest/gr/rekognition.html#limits_rekognition)中找到。这些限制为默认值，可以更改。要请求提高限制，请创建案例。要查看您当前的配额限制（应用的配额值），请参阅 [Amazon Rekognition 服务限额](https://us-west-2.console.aws.amazon.com/servicequotas/home/services/rekognition/quotas)。要查看 [Amazon Rekognition Image API](https://docs.aws.amazon.com/rekognition/latest/dg/API_Reference.html) 的 TPS 使用历史记录，请参阅 [Amazon Rekognition 服务限额页面](https://us-west-2.console.aws.amazon.com/servicequotas/home/services/rekognition/quotas)，然后选择特定的 API 操作以查看该操作的历史记录。

**Topics**
+ [计算 TPS 限额更改](#quotas-calculating)
+ [TPS 限额的最佳实践](#quotas-best-practices)
+ [创建更改 TPS 配额的案例](#quotas-create-case)

### 计算 TPS 限额更改
<a name="quotas-calculating"></a>

您要求的新限额是多少？ 每秒事务数 (TPS) 在预期工作负载达到峰值时最为相关。了解工作负载峰值时的最大并发 API 调用量和响应时间（5-15 秒）非常重要。请注意，最少应为 5 秒。下面是两个示例：
+ 示例 1：我预计在最繁忙时段开始时的最大并发人脸身份验证 (CompareFaces API) 用户数为 1000。这些响应将在 10 秒钟内传播。因此，我所在的相关地区的 CompareFaces API 所需的 TPS 为 100 (1000/10)。
+ 示例 2：我预计在最繁忙时段开始时的最大并发对象检测 (DetectLabels API) 调用为 250。这些响应将在 5 秒钟内传播。因此，我所在的相关地区的 DetectLabels API 所需的 TPS 为 50 (250/5)。

### TPS 限额的最佳实践
<a name="quotas-best-practices"></a>

每秒事务数 (TPS) 的推荐最佳实践包括平滑峰值流量、配置重试次数以及配置指数回退和抖动。

1. 平稳的峰值流量。流量激增会影响吞吐量。要获得分配的每秒事务数 (TPS) 的最大吞吐量，请使用队列无服务器架构或其他机制来“平滑”流量，使其更加一致。有关使用 Rekognition 进行无服务器大规模图像和视频处理的代码示例和参考，请参阅[使用 Amazon Rekognition 进行大规模图像和视频处理](https://github.com/aws-samples/amazon-rekognition-serverless-large-scale-image-and-video-processing)。

1. 配置重试次数。请遵循 [错误处理](error-handling.md) 中的准则，为允许出现的错误配置重试次数。

1. 配置指数回退和抖动。在配置重试次数时配置指数回退和抖动可以提高可实现的吞吐量。请参阅 [AWS 中的错误重试次数和指数回退](https://docs.aws.amazon.com/general/latest/gr/api-retries.html)。

### 创建更改 TPS 配额的案例
<a name="quotas-create-case"></a>

要创建案例，请前往[创建案例](https://console.aws.amazon.com/support/v1#/case/create?issueType=service-limit-increase)并回答以下问题：
+ 您是否实施了[TPS 限额的最佳实践](#quotas-best-practices)来平滑流量峰值并配置重试次数、指数回退和抖动？ 
+ 您是否计算过所需的 TPS 配额变更？ 如果不是，请参阅[计算 TPS 限额更改](#quotas-calculating)。
+ 您是否查看了 TPS 使用历史记录，以便更准确地预测未来的需求？ 要查看您的 TPS 使用历史记录，请参阅 [Amazon Rekognition 服务限额页面](https://us-west-2.console.aws.amazon.com/servicequotas/home/services/rekognition/quotas)。
+ 您的使用案例是什么？
+ 您计划使用哪些 API？
+ 您计划在哪些区域使用这些 API？
+ 您能否将负载分散到多个区域？
+ 您每天处理多少张图片？
+ 您预计这个交易量能维持多久（是一次性激增还是持续增长）？
+ 您是如何被默认限制阻止的？ 查看以下异常表以确认您遇到的情况。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/rekognition/latest/dg/limits.html)

  要详细了解错误代码，请参阅[错误处理](error-handling.md)。

**注意**  
这些限制取决于您所在的区域。请求更改限制会影响您请求的区域中的 API 操作。其他 API 操作和区域不受影响。