Person Group Operations - Create Person Group Person

Service:

Azure AI Services

API Version:

v1.1-preview.1

Skapa en ny person i en angiven persongrupp. Om du vill lägga till ansikte till den här personen anropar du "Lägg till persongruppperson ansikte".

Anteckning

• • Prenumerationskvot på kostnadsfri nivå:
    • 1 000 personer i alla person Grupper.
  • Prenumerationskvot på S0-nivå:
    • 10 000 personer per persongrupp.
    • 1 000 000 personer Grupper.
    • 100.000.000 personer i alla Person Grupper.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
apiVersion	path	True	string	API-version
endpoint	path	True	string uri	Cognitive Services-slutpunkter som stöds (protokoll och värdnamn, till exempel: https://{resource-name}.cognitiveservices.azure.com).
personGroupId	path	True	string	ID för containern. Regex pattern: ^[a-z0-9-_]+$

Begärandetext

Name	Obligatorisk	Typ	Description
name	True	string	Användardefinierat namn, maximal längd är 128.
userData		string	Valfria användardefinierade data. Längden får inte överstiga 16 K.

Svar

Name	Typ	Description
200 OK	CreatePersonResult	Ett lyckat anrop returnerar ett nytt personId som skapats.
Other Status Codes	FaceErrorResponse	Ett oväntat felsvar. Headers x-ms-error-code: string

Säkerhet

Ocp-Apim-Subscription-Key

Den hemliga nyckeln för din Azure AI Face-prenumeration.

Type: apiKey
In: header

AADToken

The Azure Active Directory OAuth2 Flow

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

Exempel

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"
}

Definitioner

Name	Description
CreatePersonResult	Svar från skapa person.
FaceError	Felobjektet. Omfattande information om felkoder och meddelanden som returneras av ansiktstjänsten finns i följande länk: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Ett svar som innehåller felinformation.

CreatePersonResult

Svar från skapa person.

Name	Typ	Description
personId	string	Person-ID för personen.

FaceError

Felobjektet. Omfattande information om felkoder och meddelanden som returneras av ansiktstjänsten finns i följande länk: https://aka.ms/face-error-codes-and-messages.

Name	Typ	Description
code	string	En av en serverdefinierad uppsättning felkoder.
message	string	En läsbar återgivning av felet.

FaceErrorResponse

Ett svar som innehåller felinformation.

Name	Typ	Description
error	FaceError	Felobjektet.