Person Directory Operations - Create Dynamic Person Group With Person

서비스:

Azure AI Services

API 버전:

v1.2-preview.1

지정된 dynamicPersonGroupId, 이름 및 사용자가 제공한 userData를 사용하여 새 동적 인물 그룹을 만듭니다.
동적 인물 그룹은 "사람 만들기" 디렉터리를 참조하는 컨테이너입니다. 만든 후에는 Person Directory "Update Dynamic Person Group"을 사용하여 동적 인물 그룹에 사용자를 추가/제거합니다.

동적 개인 그룹 및 사용자 데이터는 "동적 인물 그룹 삭제" 개인 디렉터리가 호출될 때까지 서버에 저장됩니다. dynamicPersonGroupId 매개 변수와 함께 "동적 사람 그룹에서 식별"을 사용하여 사용자를 식별합니다.

이미지가 저장되지 않습니다. 인물 디렉터리 "사람 삭제" 또는 "사람 얼굴 삭제"가 호출될 때까지 사용자의 추출된 얼굴 기능 및 userData만 서버에 저장됩니다.

'recognitionModel'은 동적 인물 그룹으로 지정할 필요가 없습니다. 동적 인물 그룹은 "사람 만들기" 개인 디렉터리에 대한 참조이므로 대부분의 'recognitionModels'에서 작동합니다. "식별" 중에 제공된 faceId는 사용되는 'recognitionModel'을 결정합니다.

PUT {endpoint}/face/{apiVersion}/dynamicpersongroups/{dynamicPersonGroupId}

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
apiVersion	path	True	string	API 버전
dynamicPersonGroupId	path	True	string	동적 사용자 그룹의 ID입니다. regex 패턴: ^[a-z0-9-_]+$
endpoint	path	True	string uri	지원되는 Cognitive Services 엔드포인트(프로토콜 및 호스트 이름, 예: https://{resource-name}.cognitiveservices.azure.com).

요청 본문

Name	필수	형식	Description
addPersonIds	True	string[]	추가할 Person Directory "Create Person"에서 만든 personId의 배열입니다.
name	True	string	사용자 정의 이름, 최대 길이는 128입니다.
userData		string	선택적 사용자 정의 데이터입니다. 길이는 16K를 초과하지 않아야 합니다.

응답

Name	형식	Description
202 Accepted		호출이 성공하면 빈 응답 본문이 반환됩니다. 서비스가 요청을 수락했으며 곧 처리를 시작할 예정입니다. 클라이언트는 'Operation-Location' 응답 헤더에 지정된 URL을 사용하여 작업 상태 및 결과를 쿼리할 수 있습니다. URL은 48시간 후에 만료됩니다. URL은 Person Directory "동적 사람 그룹 참조 가져오기"가 이 요청에서 변경한 내용을 반환하는 시점의 상태를 제공합니다. 헤더 operation-Location: string
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

예제

Create DynamicPersonGroup

샘플 요청

HTTP

PUT {endpoint}/face/v1.2-preview.1/dynamicpersongroups/your_dynamic_person_group_id

{
  "name": "your_dynamic_person_group_name",
  "userData": "your_user_data",
  "addPersonIds": [
    "85c0c630-c9c9-40f8-8a4e-f9ae4f926ea5"
  ]
}

샘플 응답

상태 코드:

202

operation-Location: https://contoso.com/operationstatus

정의

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

FaceError

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

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

FaceErrorResponse

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

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