Person Group Operations - Get Large Person Group Training Status
대규모 사용자 그룹 학습 상태가 완료되었는지 또는 계속 진행 중인지 확인합니다. 대규모 개인 그룹 학습은 "대규모 사용자 그룹 학습" API에 의해 트리거되는 비동기 작업입니다.
학습 시간은 개인 항목 수와 큰 사람 그룹의 얼굴에 따라 달라집니다. 그것은 초, 또는 1,000,000 명을위한 반 시간까지 될 수 있습니다.
GET {endpoint}/face/{apiVersion}/largepersongroups/{largePersonGroupId}/training
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
api
|
path | True |
string |
API 버전 |
endpoint
|
path | True |
string uri |
지원되는 Cognitive Services 엔드포인트(프로토콜 및 호스트 이름, 예: https://{resource-name}.cognitiveservices.azure.com). |
large
|
path | True |
string |
컨테이너의 ID입니다. regex 패턴: |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
호출이 성공하면 대규모 사용자 그룹의 학습 상태가 반환됩니다. |
|
Other Status Codes |
예기치 않은 오류 응답입니다. 헤더 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 LargePersonGroup
샘플 요청
GET {endpoint}/face/v1.2-preview.1/largepersongroups/your_large_person_group_id/training
샘플 응답
{
"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 |
---|---|
Face |
오류 개체입니다. Face Service에서 반환된 오류 코드 및 메시지에 대한 포괄적인 세부 정보는 다음 링크를 참조하세요. https://aka.ms/face-error-codes-and-messages. |
Face |
오류 세부 정보가 포함된 응답입니다. |
Operation |
장기 실행 작업의 상태입니다. |
Training |
컨테이너의 학습 결과 |
FaceError
오류 개체입니다. Face Service에서 반환된 오류 코드 및 메시지에 대한 포괄적인 세부 정보는 다음 링크를 참조하세요. https://aka.ms/face-error-codes-and-messages.
Name | 형식 | Description |
---|---|---|
code |
string |
서버에서 정의한 오류 코드 집합 중 하나입니다. |
message |
string |
사람이 읽을 수 있는 오류 표현입니다. |
FaceErrorResponse
오류 세부 정보가 포함된 응답입니다.
Name | 형식 | Description |
---|---|---|
error |
오류 개체입니다. |
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 |
컨테이너의 학습 상태입니다. |