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

Get Operation Result - Get Operation Result

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

GET {endpoint}/face/{apiVersion}/operations/{operationId}

URI 参数

名称 必需 类型 说明
apiVersion
path True

string

API 版本

endpoint
path True

string

uri

支持的认知服务终结点 (协议和主机名,例如:https://{resource-name}.cognitiveservices.azure.com) 。

operationId
path True

string

uuid

操作的操作 ID。

响应

名称 类型 说明
200 OK

OperationResult

成功的调用将返回长时间运行的操作状态。

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 Face Operation Status

示例请求

GET {endpoint}/face/v1.1-preview.1/operations/1b22ff44-c7dc-43ce-93be-67d3283ba86c

示例响应

{
  "operationId": "1b22ff44-c7dc-43ce-93be-67d3283ba86c",
  "status": "notStarted",
  "createdTime": "2024-03-05T11:08:20.193Z",
  "finishedTime": "2024-03-05T11:08:20.193Z",
  "lastActionTime": "2024-03-05T11:08:20.193Z",
  "message": null
}

定义

名称 说明
FaceError

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

FaceErrorResponse

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

OperationResult

人员目录的长时间运行的操作资源。

OperationStatus

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

FaceError

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

名称 类型 说明
code

string

服务器定义的一组错误代码中的一个。

message

string

错误的用户可读表示形式。

FaceErrorResponse

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

名称 类型 说明
error

FaceError

错误对象。

OperationResult

人员目录的长时间运行的操作资源。

名称 类型 说明
createdTime

string

创建操作的日期和时间。

finishedTime

string

完成操作的日期和时间。

lastActionTime

string

上次更新操作的日期和时间。

message

string

操作的消息。

operationId

string

操作的操作 ID。

status

OperationStatus

操作的当前状态。

OperationStatus

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

名称 类型 说明
failed

string

操作失败。

notStarted

string

操作未启动。

running

string

操作仍在运行。

succeeded

string

操作成功。