다음을 통해 공유

Person Group Operations - Get Person Group Training Status

  • 참조
서비스:
Azure AI Services
API 버전:
v1.2-preview.1

개인 그룹 학습 상태가 완료되었는지 또는 계속 진행 중인지 확인합니다. 개인 그룹 학습은 "개인 그룹 학습" API에 의해 트리거되는 비동기 작업입니다.

GET {endpoint}/face/{apiVersion}/persongroups/{personGroupId}/training

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
apiVersion
 path True

string

API 버전
endpoint
 path True

string

uri

지원되는 Cognitive Services 엔드포인트(프로토콜 및 호스트 이름, 예: https://{resource-name}.cognitiveservices.azure.com).
personGroupId
 path True

string

컨테이너의 ID입니다.

regex 패턴: ^[a-z0-9-_]+$

응답

Name 형식 Description
200 OK

TrainingResult

호출이 성공하면 개인 그룹의 학습 상태가 반환됩니다.
Other Status Codes

FaceErrorResponse

예기치 않은 오류 응답입니다.

헤더

x-ms-error-code: string

보안

Ocp-Apim-Subscription-Key

Azure AI Face 구독의 비밀 키입니다.

형식: apiKey
In(다음 안에): header

AADToken

Azure Active Directory OAuth2 흐름

형식: oauth2
Flow: accessCode
권한 부여 URL: https://api.example.com/oauth2/authorize
토큰 URL: https://api.example.com/oauth2/token

범위

Name Description
https://cognitiveservices.azure.com/.default

예제

Get Training Status of PersonGroup

샘플 요청

GET {endpoint}/face/v1.2-preview.1/persongroups/your_person_group_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
}

정의

Name Description
FaceError

오류 개체입니다. Face Service에서 반환된 오류 코드 및 메시지에 대한 포괄적인 세부 정보는 다음 링크를 참조하세요. https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse

오류 세부 정보가 포함된 응답입니다.
OperationStatus

장기 실행 작업의 상태입니다.
TrainingResult

컨테이너의 학습 결과

FaceError

오류 개체입니다. Face Service에서 반환된 오류 코드 및 메시지에 대한 포괄적인 세부 정보는 다음 링크를 참조하세요. https://aka.ms/face-error-codes-and-messages.

Name 형식 Description
code

string

서버에서 정의한 오류 코드 집합 중 하나입니다.
message

string

사람이 읽을 수 있는 오류 표현입니다.

FaceErrorResponse

오류 세부 정보가 포함된 응답입니다.

Name 형식 Description
error

FaceError

오류 개체입니다.

OperationStatus

장기 실행 작업의 상태입니다.

Name 형식 Description
failed

string

작업이 실패했습니다.
notStarted

string

작업이 시작되지 않았습니다.
running

string

작업이 계속 실행 중입니다.
succeeded

string

작업이 성공했습니다.

TrainingResult

컨테이너의 학습 결과

Name 형식 Description
createdDateTime

string

사용자 그룹, 큰 사람 그룹 또는 큰 얼굴 목록의 생성된 시간을 설명하는 결합된 UTC 날짜 및 시간 문자열입니다.
lastActionDateTime

string

그룹이 성공적으로 학습되지 않은 경우 사용자 그룹, 큰 사람 그룹 또는 큰 얼굴 목록의 마지막 수정 시간을 설명하는 결합된 UTC 날짜 및 시간 문자열은 null 값일 수 있습니다.
lastSuccessfulTrainingDateTime

string

개인 그룹, 큰 사람 그룹 또는 큰 얼굴 목록의 마지막으로 성공한 학습 시간을 설명하는 결합된 UTC 날짜 및 시간 문자열입니다.
message

string

학습이 실패했을 때 실패 메시지를 표시합니다(학습이 성공하면 생략됨).
status

OperationStatus

컨테이너의 학습 상태입니다.