Person Group Operations - Create Person Group Person

Service:

Azure AI Services

API Version:

v1.1-preview.1

지정된 사람 그룹에 새 사용자를 Create. 이 사람에게 얼굴을 추가하려면 "사람 그룹 사람 얼굴 추가"를 호출하세요.

참고

• • 무료 계층 구독 할당량:
    • 모든 사람 그룹 1,000명.
  • S0 계층 구독 할당량:
    • 1인 그룹당 10,000명
    • 1,000,000명 그룹.
    • 모든 사람 그룹 100,000,000명.

POST {endpoint}/face/{apiVersion}/persongroups/{personGroupId}/persons

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 pattern: ^[a-z0-9-_]+$

요청 본문

Name	필수	형식	Description
name	True	string	사용자 정의 이름, 최대 길이는 128입니다.
userData		string	선택적 사용자 정의 데이터입니다. 길이가 16K를 초과하면 안 됩니다.

응답

Name	형식	Description
200 OK	CreatePersonResult	성공한 호출은 만든 새 personId를 반환합니다.
Other Status Codes	FaceErrorResponse	예기치 않은 오류 응답입니다. Headers x-ms-error-code: string

보안

Ocp-Apim-Subscription-Key

Azure AI Face 구독의 비밀 키입니다.

Type: apiKey
In: header

AADToken

Azure Active Directory OAuth2 흐름

Type: oauth2
Flow: accessCode
Authorization URL: https://api.example.com/oauth2/authorize
Token URL: https://api.example.com/oauth2/token

Scopes

Name	Description
https://cognitiveservices.azure.com/.default

예제

Create Person in PersonGroup

Sample Request

HTTP

POST {endpoint}/face/v1.1-preview.1/persongroups/your_person_group_id/persons

{
  "name": "your_person_group_person_name",
  "userData": "your_user_data"
}

Sample Response

Status code:

200

{
  "personId": "25985303-c537-4467-b41d-bdb45cd95ca1"
}

정의

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

CreatePersonResult

만들기 사람의 응답입니다.

Name	형식	Description
personId	string	사람의 사람 ID입니다.

FaceError

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

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

FaceErrorResponse

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

Name	형식	Description
error	FaceError	Error 개체.