Person Group Operations - Get Person Group Person

서비스:

Azure AI Services

API 버전:

v1.2-preview.1

사용자의 이름 및 userData 및 등록된 사람 얼굴 기능을 나타내는 지속형 faceId를 검색합니다.

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

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-_]+$
personId	path	True	string uuid	사용자의 ID입니다.

응답

Name	형식	Description
200 OK	PersonGroupPerson	성공한 호출은 해당 사용자의 정보를 반환합니다.
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 Person from PersonGroup

샘플 요청

HTTP

GET {endpoint}/face/v1.2-preview.1/persongroups/your_person_group_id/persons/25985303-c537-4467-b41d-bdb45cd95ca1

샘플 응답

상태 코드:

200

{
  "personId": "25985303-c537-4467-b41d-bdb45cd95ca1",
  "name": "your_person_group_person_name",
  "userData": "your_user_data",
  "persistedFaceIds": [
    "43897a75-8d6f-42cf-885e-74832febb055"
  ]
}

정의

Name	Description
FaceError	오류 개체입니다. Face Service에서 반환된 오류 코드 및 메시지에 대한 포괄적인 세부 정보는 다음 링크를 참조하세요. https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	오류 세부 정보가 포함된 응답입니다.
PersonGroupPerson	지정된 사용자 그룹의 사용자입니다. 이 사람에게 얼굴을 추가하려면 "큰 사람 그룹 사람 얼굴 추가"를 호출하세요.

FaceError

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

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

FaceErrorResponse

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

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

PersonGroupPerson

지정된 사용자 그룹의 사용자입니다. 이 사람에게 얼굴을 추가하려면 "큰 사람 그룹 사람 얼굴 추가"를 호출하세요.

Name	형식	Description
name	string	사용자 정의 이름, 최대 길이는 128입니다.
persistedFaceIds	string[]	사용자에 등록된 얼굴의 얼굴 ID입니다.
personId	string	사용자의 ID입니다.
userData	string	선택적 사용자 정의 데이터입니다. 길이는 16K를 초과하지 않아야 합니다.