Large Person Group Person - Get

서비스:

Azure AI Services

API 버전:

1.0

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

GET {Endpoint}/face/v1.0/largepersongroups/{largePersonGroupId}/persons/{personId}

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
Endpoint	path	True	string	지원되는 Cognitive Services 엔드포인트(프로토콜 및 호스트 이름( 예: https://westus.api.cognitive.microsoft.com).
largePersonGroupId	path	True	string maxLength: 64 pattern: ^[a-z0-9-_]+$	특정 큰 사람 그룹을 참조하는 ID입니다.
personId	path	True	string (uuid)	특정 사용자를 참조하는 ID입니다.

요청 헤더

Name	필수	형식	Description
Ocp-Apim-Subscription-Key	True	string

응답

Name	형식	Description
200 OK	Person	성공한 호출은 해당 사용자의 정보를 반환합니다.
Other Status Codes	APIError	오류 응답입니다.

보안

Ocp-Apim-Subscription-Key

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

예제

Get person example

샘플 요청

HTTP

GET {Endpoint}/face/v1.0/largepersongroups/abc/persons/25985303-c537-4467-b41d-bdb45cd95ca1

샘플 응답

상태 코드:

200

{
  "personId": "25985303-c537-4467-b41d-bdb45cd95ca1",
  "persistedFaceIds": [
    "015839fb-fbd9-4f79-ace9-7675fc2f1dd9",
    "fce92aed-d578-4d2e-8114-068f8af4492e",
    "b64d5e15-8257-4af2-b20a-5a750f8940e7"
  ],
  "name": "person-name",
  "userData": "User-provided data attached to the person."
}

정의

Name	Description
APIError	API에서 반환된 오류 정보
Error	오류 본문입니다.
Person	Person 개체입니다.

APIError

Object

API에서 반환된 오류 정보

Name	형식	Description
error	Error	오류 본문입니다.

Error

Object

오류 본문입니다.

Name	형식	Description
code	string
message	string

Person

Object

Person 개체입니다.

Name	형식	Description
name	string maxLength: 128	사용자 정의 이름, 최대 길이는 128입니다.
persistedFaceIds	string[] (uuid)	사용자에 등록된 얼굴의 PersistedFaceIds입니다. 이러한 persistedFaceId는 Person - Add a Person Face에서 반환되며 만료되지 않습니다.
personId	string (uuid)	대상 얼굴 목록의 PersonId입니다.
userData	string maxLength: 16384	사용자가 지정한 데이터입니다. 길이는 16KB를 초과하면 안 됩니다.