Person Group Operations - Get Person Group

서비스:

Azure AI Services

API 버전:

v1.2-preview.1

개인 그룹 이름, userData 및 recognitionModel을 검색합니다. 이 personGroup에서 개인 정보를 얻으려면 "사람 그룹 사용자 가져오기"를 사용합니다.

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

선택적 매개 변수:

GET {endpoint}/face/{apiVersion}/persongroups/{personGroupId}?returnRecognitionModel={returnRecognitionModel}

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-_]+$
returnRecognitionModel	query		boolean	'recognitionModel'을 반환합니다. 기본값은 false입니다.

응답

Name	형식	Description
200 OK	PersonGroup	성공한 호출은 개인 그룹의 정보를 반환합니다.
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 PersonGroup

샘플 요청

HTTP

GET {endpoint}/face/v1.2-preview.1/persongroups/your_person_group_id?returnRecognitionModel=True

샘플 응답

상태 코드:

200

{
  "name": "your_person_group_name",
  "userData": "your_user_data",
  "recognitionModel": "recognition_01",
  "personGroupId": "your_person_group_id"
}

정의

Name	Description
FaceError	오류 개체입니다. Face Service에서 반환된 오류 코드 및 메시지에 대한 포괄적인 세부 정보는 다음 링크를 참조하세요. https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	오류 세부 정보가 포함된 응답입니다.
PersonGroup	얼굴 인식 기능 및 최대 10,000명을 포함하여 업로드된 사람 데이터의 컨테이너입니다. 더 큰 규모의 얼굴 식별 문제를 처리하려면 큰 사람 그룹을 사용하는 것이 좋습니다.
RecognitionModel	얼굴의 인식 모델입니다.

FaceError

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

Name	형식	Description
code	string	서버에서 정의한 오류 코드 집합 중 하나입니다.
message	string	사람이 읽을 수 있는 오류 표현입니다.

FaceErrorResponse

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

Name	형식	Description
error	FaceError	오류 개체입니다.

PersonGroup

얼굴 인식 기능 및 최대 10,000명을 포함하여 업로드된 사람 데이터의 컨테이너입니다. 더 큰 규모의 얼굴 식별 문제를 처리하려면 큰 사람 그룹을 사용하는 것이 좋습니다.

Name	형식	Description
name	string	사용자 정의 이름, 최대 길이는 128입니다.
personGroupId	string	컨테이너의 ID입니다.
recognitionModel	RecognitionModel	인식 모델의 이름입니다. 인식 모델은 얼굴 기능을 추출하고 감지된 faceIds와 연결할 때 사용됩니다.
userData	string	선택적 사용자 정의 데이터입니다. 길이는 16K를 초과하지 않아야 합니다.

RecognitionModel

얼굴의 인식 모델입니다.

Name	형식	Description
recognition_01	string	"Detect"의 기본 인식 모델입니다. 2019년 3월 이전에 만든 모든 faceId는 이 인식 모델과 결합됩니다.
recognition_02	string	인식 모델은 2019년 3월에 출시되었습니다.
recognition_03	string	인식 모델은 2020년 5월에 출시됩니다.
recognition_04	string	인식 모델은 2021년 2월에 출시되었습니다. 더 나은 인식 정확도를 위해 이 인식 모델을 사용하는 것이 좋습니다.