你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Face List Operations - Get Large Face List Training Status

服务:

Azure AI Services

API 版本:

v1.2-preview.1

检查大型人脸列表训练状态已完成或仍在进行。 大型人脸列表训练是由“训练大型人脸列表”触发的异步操作。

训练时间取决于大型人脸列表中的人脸条目数。 它可以是几秒钟，或长达半小时，1,000,000张人脸。

GET {endpoint}/face/{apiVersion}/largefacelists/{largeFaceListId}/training

URI 参数

名称	在	必需	类型	说明
apiVersion	path	True	string	API 版本
endpoint	path	True	string uri	支持的认知服务终结点（协议和主机名，例如：https://{resource-name}.cognitiveservices.azure.com）。
largeFaceListId	path	True	string	有效字符是小写字母或数字或“-”或“_”，最大长度为 64。 正则表达式模式: ^[a-z0-9-_]+$

响应

名称	类型	说明
200 OK	TrainingResult	成功的调用返回大型人脸列表的训练状态。
Other Status Codes	FaceErrorResponse	意外的错误响应。 标头 x-ms-error-code: string

安全性

Ocp-Apim-Subscription-Key

Azure AI 人脸订阅的密钥。

类型: apiKey
在: header

AADToken

Azure Active Directory OAuth2 流

类型: oauth2
流向: accessCode
授权 URL: https://api.example.com/oauth2/authorize
令牌 URL: https://api.example.com/oauth2/token

作用域

名称	说明
https://cognitiveservices.azure.com/.default

示例

Get Training Status of LargeFaceList

示例请求

HTTP

GET {endpoint}/face/v1.2-preview.1/largefacelists/your_large_face_list_id/training

示例响应

状态代码:

200

{
  "status": "notStarted",
  "createdDateTime": "2024-03-05T11:07:58.371Z",
  "lastActionDateTime": "2024-03-05T11:07:58.371Z",
  "lastSuccessfulTrainingDateTime": "2024-03-05T11:07:58.371Z",
  "message": null
}

定义

名称	说明
FaceError	错误对象。 有关人脸服务返回的错误代码和消息的综合详细信息，请参阅以下链接：https://aka.ms/face-error-codes-and-messages。
FaceErrorResponse	包含错误详细信息的响应。
OperationStatus	长时间运行的操作的状态。
TrainingResult	容器的训练结果

FaceError

错误对象。 有关人脸服务返回的错误代码和消息的综合详细信息，请参阅以下链接：https://aka.ms/face-error-codes-and-messages。

名称	类型	说明
code	string	服务器定义的错误代码集之一。
message	string	错误的人工可读表示形式。

FaceErrorResponse

包含错误详细信息的响应。

名称	类型	说明
error	FaceError	错误对象。

OperationStatus

长时间运行的操作的状态。

名称	类型	说明
failed	string	操作失败。
notStarted	string	操作未启动。
running	string	该操作仍在运行。
succeeded	string	操作成功。

TrainingResult

容器的训练结果

名称	类型	说明
createdDateTime	string	一个组合的 UTC 日期和时间字符串，描述人员组、大型人员组或大型人脸列表的创建时间。
lastActionDateTime	string	描述人员组、大型人员组或大型人脸列表的上次修改时间的组合 UTC 日期和时间字符串在组未成功训练时可以为 null 值。
lastSuccessfulTrainingDateTime	string	一个组合的 UTC 日期和时间字符串，描述人员组、大型人员组或大型人脸列表的最后一次成功训练时间。
message	string	训练失败时显示失败消息（训练成功时省略）。
status	OperationStatus	容器的训练状态。