你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Azure AI 人脸 API 错误代码
常见错误代码
这些错误代码可由任何人脸 API 调用返回。
| Http 状态代码 | 错误代码 | 错误消息 | 说明 |
|---|---|---|---|
| 错误的请求 (400) | BadArgument | 请求正文无效。 | |
| 错误的请求 (400) | BadArgument | JSON 分析错误。 | 错误或无法识别的请求 JSON 正文。 |
| 错误的请求 (400) | BadArgument | “recognitionModel”无效。 | |
| 错误的请求 (400) | BadArgument | “detectionModel”无效。 | |
| 错误的请求 (400) | BadArgument | “name”为空。 | |
| 错误的请求 (400) | BadArgument | “name”太长。 | |
| 错误的请求 (400) | BadArgument | “userData”太长。 | |
| 错误的请求 (400) | BadArgument | “start”太长了。 | |
| 错误的请求 (400) | BadArgument | “top”无效。 | |
| 错误的请求 (400) | BadArgument | 参数 targetFace 范围不足。 | |
| 错误的请求 (400) | BadArgument | 参数 targetFace 无效。 | 由无效的字符串格式或左侧/顶部/高度/宽度值无效引起的。 |
| 错误的请求 (400) | InvalidURL | 无效的图像 URL。 | 支持的格式包括 JPEG、PNG、GIF（第一帧）和 BMP。 |
| 错误的请求 (400) | InvalidURL | 从目标服务器下载图像 URL 无效或错误。 返回远程服务器错误：“发送请求时出错。 | |
| 错误的请求 (400) | InvalidImage | 解码错误，图像格式不受支持。 | |
| 错误的请求 (400) | InvalidImage | 图像中未检测到人脸。 | |
| 错误的请求 (400) | InvalidImage | 图像中有 1 个以上的人脸。 | |
| 错误的请求 (400) | InvalidImageSize | 图像尺寸过小。 | 有效的图像文件大小应大于或等于 1 KB。 |
| 错误的请求 (400) | InvalidImageSize | 图像尺寸过大。 | 有效的图像文件大小不应大于 6 MB。 |
| 未授权 (401) | 401 | 由于订阅密钥无效或 API 终结点错误，访问被拒绝。 请确保为活动订阅提供有效的密钥，并为资源使用正确的区域 API 终结点。 | |
| 禁止访问 (403) | UnsupportedFeature | 不支持此功能，缺少对以下一个或多个功能的批准：标识、验证。 | 通过提交 注册表单注册访问权限。 |
| 冲突 (409) | ConcurrentOperationConflict | 资源 <resourceName>存在冲突操作，请稍后尝试。 |
|
| 请求过多（429） | 429 | 超出比率限制。 |
人脸检测错误代码
人脸检测操作可以返回这些错误代码。
| Http 状态代码 | 错误代码 | 错误消息 | 说明 |
|---|---|---|---|
| 错误的请求 (400) | BadArgument | 参数 returnFaceAttributes 无效。 | |
| 错误的请求 (400) | BadArgument | detection_02 不支持“returnFaceAttributes”。 | |
| 错误的请求 (400) | BadArgument | detection_02 不支持“returnLandmarks”。 | |
| 禁止访问 (403) | UnsupportedFeature | 返回属性（情感，性别，年龄，微笑，面部头发，头发和化妆）已被弃用，不再受支持。 | 如果你有一个负责任的用例，则向 Azure 人脸团队发送电子邮件，该用例将受益于使用任何有限的功能。 |
人脸实时会话错误代码
人脸 Liveness 会话操作可以返回这些错误代码。
| Http 状态代码 | 错误代码 | 错误消息 | 说明 |
|---|---|---|---|
| 错误的请求 (400) | BadArgument | Start 参数无效。 请指定最后一个条目的“ID”字段以继续列出过程。 | |
| 错误的请求 (400) | BadArgument | Top 参数无效。 有效范围为 1 到 1000（含 1000）。 | |
| 错误的请求 (400) | InvalidRequestBody | 提供的请求正文不正确。 请检查操作架构，然后重试。 | |
| 错误的请求 (400) | InvalidTokenLifetime | 指定的 authTokenTimeToLiveInSeconds 无效。 必须位于 60 到 86400 以内。 | |
| 错误的请求 (400) | InvalidLivenessOperationMode | 指定的 livenessOperationMode 无效。 必须是“被动”。 | |
| 错误的请求 (400) | InvalidDeviceCorrelationId | 在会话创建或会话启动期间，请求正文中需要设备关联 ID。 不得为 null 或为空，且不超过 64 个字符。 | |
| 找不到 (404) | SessionNotFound | 找不到会话 ID。 会话 ID 已过期或不存在。 |
人脸识别错误代码
人脸识别操作可以返回这些错误代码。
| Http 状态代码 | 错误代码 | 错误消息 | 说明 |
|---|---|---|---|
| 错误的请求 (400) | BadArgument | “recognitionModel”不兼容。 | |
| 错误的请求 (400) | BadArgument | 人员组 ID 无效。 | |
| 错误的请求 (400) | BadArgument | 大型人员组 ID 无效。 | |
| 错误的请求 (400) | BadArgument | 动态人员组 ID 无效。 | |
| 错误的请求 (400) | BadArgument | 参数 maxNumOfCandidatesReturned 无效。 | 有效范围为 [1， 100]。 |
| 错误的请求 (400) | BadArgument | 参数 confidenceThreshold 无效。 | 有效范围为 [0， 1]。 |
| 错误的请求 (400) | BadArgument | faceIds 的长度不在有效范围内。 | 有效范围为 [1， 10]。 |
| 错误的请求 (400) | FaceNotFound | 找不到人脸。 | |
| 错误的请求 (400) | PersonGroupNotFound | 找不到人员组。 | |
| 错误的请求 (400) | LargePersonGroupNotFound | 找不到大型人员组。 | |
| 错误的请求 (400) | DynamicPersonGroupNotFound | 找不到动态人员组。 | |
| 错误的请求 (400) | PersonGroupNotTrained | 未训练的人员组。 | |
| 错误的请求 (400) | LargePersonGroupNotTrained | 大人组没有训练。 | |
| 错误的请求 (400) | PersonGroupIdAndLargePersonGroupIdBothNotNull | 大型人员组 ID 和人员组 ID 均不为 null。 | |
| 错误的请求 (400) | PersonGroupIdAndLargePersonGroupIdBothNull | 大型人员组 ID 和人员组 ID 均为 null。 | |
| 错误的请求 (400) | MissingIdentificationScopeParameters | 请求中不存在标识范围参数。 | |
| 错误的请求 (400) | IncompatibleIdentificationScopeParametersCombination | 请求中存在不兼容的标识范围参数。 | |
| 冲突 (409) | PersonGroupTrainingNotFinished | 人员组正在接受培训。 | |
| 冲突 (409) | LargePersonGroupTrainingNotFinished | 大型人员组正在接受培训。 |
人脸验证错误代码
人脸验证操作可以返回这些错误代码。
| Http 状态代码 | 错误代码 | 错误消息 | 说明 |
|---|---|---|---|
| 错误的请求 (400) | BadArgument | “recognitionModel”不兼容。 | |
| 错误的请求 (400) | BadArgument | 人脸 ID 无效。 | 有效的 faceId 来自人脸 - 检测。 |
| 错误的请求 (400) | BadArgument | 人员 ID 无效。 | 从创建人员组人员、创建大型人员组人员或人员目录 - 创建人员生成有效的 personId。 |
| 错误的请求 (400) | BadArgument | 人员组 ID 无效。 | |
| 错误的请求 (400) | BadArgument | 大型人员组 ID 无效。 | |
| 错误的请求 (400) | PersonNotFound | 找不到人员。 | |
| 错误的请求 (400) | PersonGroupNotFound | 找不到人员组。 | |
| 错误的请求 (400) | LargePersonGroupNotFound | 找不到大型人员组。 | |
| 找不到 (404) | FaceNotFound | 找不到人脸。 | |
| 找不到 (404) | PersonNotFound | 找不到人员。 | |
| 找不到 (404) | PersistedFaceNotFound | 找不到此人的持久面孔。 |
查找类似的错误代码
人脸查找相似操作可以返回这些错误代码。
| Http 状态代码 | 错误代码 | 错误消息 | 说明 |
|---|---|---|---|
| 错误的请求 (400) | BadArgument | “recognitionModel”不兼容。 | |
| 错误的请求 (400) | BadArgument | 模式无效。 | |
| 错误的请求 (400) | BadArgument | 人脸列表 ID 无效。 | |
| 错误的请求 (400) | BadArgument | 大型人脸列表 ID 无效。 | |
| 错误的请求 (400) | BadArgument | LargeFaceListId、faceListId 和 faceIds，不完全是其中一个有效。 | |
| 错误的请求 (400) | BadArgument | LargeFaceListId、faceListId 和 faceId 均为 null。 | |
| 错误的请求 (400) | BadArgument | 2 个或多个 largeFaceListId、faceListId 和 faceId 不为 null。 | |
| 错误的请求 (400) | BadArgument | 参数 maxNumOfCandidatesReturned 无效。 | 有效范围为 [1， 1000]。 |
| 错误的请求 (400) | BadArgument | faceIds 的长度不在有效范围内。 | 有效范围为 [1， 1000]。 |
| 错误的请求 (400) | FaceNotFound | 找不到人脸。 | |
| 错误的请求 (400) | FaceListNotFound | 找不到人脸列表。 | |
| 错误的请求 (400) | LargeFaceListNotFound | 找不到大型人脸列表。 | |
| 错误的请求 (400) | LargeFaceListNotTrained | 未训练大型人脸列表。 | |
| 错误的请求 (400) | FaceListNotReady | 人脸列表为空。 | |
| 冲突 (409) | LargeFaceListTrainingNotFinished | 大型人脸列表正在训练中。 |
人脸组错误代码
人脸组操作可以返回这些错误代码。
| Http 状态代码 | 错误代码 | 错误消息 | 说明 |
|---|---|---|---|
| 错误的请求 (400) | BadArgument | “recognitionModel”不兼容。 | |
| 错误的请求 (400) | BadArgument | faceIds 的长度不在有效范围内。 | 有效范围为 [2， 1000]。 |
人员组操作
人员组操作可以返回这些错误代码。
人员组错误代码
| Http 状态代码 | 错误代码 | 错误消息 | 说明 |
|---|---|---|---|
| 错误的请求 (400) | BadArgument | 人员组 ID 无效。 | 有效字符是小写字母、数字、“-”或“_”。 最大长度为 64。 |
| 禁止访问 (403) | QuotaExceeded | 人员组编号达到订阅级别限制。 | |
| 禁止访问 (403) | QuotaExceeded | 人员人数达到人员组级别限制。 | |
| 禁止访问 (403) | QuotaExceeded | 人员人数达到订阅级别限制。 | |
| 禁止访问 (403) | QuotaExceeded | 持久化人脸数达到限制。 | |
| 找不到 (404) | PersonGroupNotFound | 找不到人员组。 | |
| 找不到 (404) | PersonGroupNotFound | 人员组 ID 无效。 | |
| 找不到 (404) | PersonNotFound | 找不到人员 <personId> 。 |
|
| 找不到 (404) | PersonNotFound | 人员 ID 无效。 | |
| 找不到 (404) | PersistedFaceNotFound | 找不到持久化人脸。 | |
| 找不到 (404) | PersistedFaceNotFound | 找不到持久化人脸 <faceId> 。 |
|
| 找不到 (404) | PersistedFaceNotFound | 持久化人脸 ID 无效。 | |
| 找不到 (404) | PersonGroupNotTrained | 未训练的人员组。 | 此错误显示在获取从未训练过的组的训练状态上。 |
| 冲突 (409) | PersonGroupExists | 人员组已存在。 | |
| 冲突 (409) | PersonGroupTrainingNotFinished | 人员组正在接受培训。 | 训练完成后重试。 |
大型人员组错误代码
| Http 状态代码 | 错误代码 | 错误消息 | 说明 |
|---|---|---|---|
| 错误的请求 (400) | BadArgument | 大型人员组 ID 无效。 | 有效字符是小写字母、数字、“-”或“_”。 最大长度为 64。 |
| 错误的请求 (400) | BadArgument | “name”和“userData”均为空。 | |
| 禁止访问 (403) | QuotaExceeded | 大型人员组数达到订阅级别限制。 | |
| 禁止访问 (403) | QuotaExceeded | 人员人数达到大型人员组级别限制。 | |
| 禁止访问 (403) | QuotaExceeded | 人员人数达到订阅级别限制。 | |
| 禁止访问 (403) | QuotaExceeded | 持久化人脸数达到限制。 | |
| 找不到 (404) | LargePersonGroupNotFound | 找不到大型人员组。 | |
| 找不到 (404) | LargePersonGroupNotFound | 大型人员组 ID 无效。 | |
| 找不到 (404) | PersonNotFound | 找不到人员 <personId> 。 |
|
| 找不到 (404) | PersonNotFound | 人员 ID 无效。 | |
| 找不到 (404) | PersistedFaceNotFound | 找不到持久化人脸。 | |
| 找不到 (404) | PersistedFaceNotFound | 找不到持久化人脸 <faceId> 。 |
|
| 找不到 (404) | PersistedFaceNotFound | 持久化人脸 ID 无效。 | |
| 找不到 (404) | LargePersonGroupNotTrained | 大人组没有训练。 | 此错误显示在获取从未训练过的组的训练状态上。 |
| 冲突 (409) | LargePersonGroupExists | 大型人员组已存在。 | |
| 冲突 (409) | LargePersonGroupTrainingNotFinished | 大型人员组正在接受培训。 | 训练完成后重试。 |
人脸列表操作
人脸列表操作可以返回这些错误代码。
人脸列表错误代码
| Http 状态代码 | 错误代码 | 错误消息 | 说明 |
|---|---|---|---|
| 错误的请求 (400) | BadArgument | 人脸列表 ID 无效。 | 有效字符是小写字母、数字、“-”或“_”。 最大长度为 64。 |
| 禁止访问 (403) | QuotaExceeded | 持久化人脸数达到限制。 | |
| 找不到 (404) | FaceListNotFound | 找不到人脸列表。 | |
| 找不到 (404) | FaceListNotFound | 人脸列表 ID 无效。 | |
| 找不到 (404) | PersistedFaceNotFound | 找不到持久化人脸。 | |
| 找不到 (404) | PersistedFaceNotFound | 持久化人脸 ID 无效。 | |
| 冲突 (409) | FaceListExists | 人脸列表已存在。 |
大型人脸列表错误代码
| Http 状态代码 | 错误代码 | 错误消息 | 说明 |
|---|---|---|---|
| 错误的请求 (400) | BadArgument | 大型人脸列表 ID 无效。 | 有效字符是小写字母、数字、“-”或“_”。 最大长度为 64。 |
| 错误的请求 (400) | BadArgument | “name”和“userData”均为空。 | |
| 禁止访问 (403) | QuotaExceeded | 大人脸列表数达到限制。 | |
| 禁止访问 (403) | QuotaExceeded | 持久化人脸数达到限制。 | |
| 找不到 (404) | LargeFaceListNotFound | 找不到大型人脸列表。 | |
| 找不到 (404) | LargeFaceListNotFound | 大型人脸列表 ID 无效。 | |
| 找不到 (404) | PersistedFaceNotFound | 找不到大型人脸列表人脸 <faceId> 。 |
|
| 找不到 (404) | PersistedFaceNotFound | 持久化人脸 ID 无效。 | |
| 找不到 (404) | LargeFaceListNotTrained | 未训练的大型人脸列表。 | 此错误显示在获取从未训练的大型人脸列表的训练状态上。 |
| 冲突 (409) | LargeFaceListExists | 已存在大型人脸列表。 | |
| 冲突 (409) | LargeFaceListTrainingNotFinished | 大型人脸列表正在训练中。 | 训练完成后重试。 |
人员目录操作
人员目录操作可以返回这些错误代码。
人员目录错误代码
| Http 状态代码 | 错误代码 | 错误消息 | 说明 |
|---|---|---|---|
| 错误的请求 (400) | BadArgument | 此功能不支持识别模型。 | |
| 错误的请求 (400) | BadArgument | “start”不是有效的人员 ID。 | |
| 错误的请求 (400) | BadArgument | “name”和“userData”均为空。 | |
| 错误的请求 (400) | DynamicPersonGroupNotFound | 动态人员组 ID 无效。 | |
| 禁止访问 (403) | QuotaExceeded | 人员人数达到订阅级别限制。 | |
| 禁止访问 (403) | QuotaExceeded | 持久化人脸数达到限制。 | |
| 找不到 (404) | DynamicPersonGroupNotFound | 找不到动态人员组。 | |
| 找不到 (404) | DynamicPersonGroupNotFound | 找不到 DynamicPersonGroupPersonReference <groupId> 。 |
|
| 找不到 (404) | PersonNotFound | 找不到人员。 | |
| 找不到 (404) | PersonNotFound | 人员 ID 无效。 | |
| 找不到 (404) | PersistedFaceNotFound | 找不到持久化人脸。 | |
| 找不到 (404) | PersistedFaceNotFound | 找不到持久化人脸 <faceId> 。 |
|
| 找不到 (404) | PersistedFaceNotFound | 持久化人脸 ID 无效。 | |
| 冲突 (409) | DynamicPersonGroupExists | 动态人员组 ID <groupId> 已存在。 |
后续步骤