Person Group Operations - Create Person Group Person

Služba:

Azure AI Services

Verze rozhraní API:

v1.1-preview.1

Create novou osobu v zadané skupině osob. Pokud chcete této osobě přidat tvář, zavolejte prosím na "Přidat tvář osoby ve skupině osob".

Poznámka

• • Kvóta předplatného úrovně Free:
    • 1 000 osob ve všech osobních Skupiny.
  • Kvóta předplatného úrovně S0:
    • 10 000 osob na skupinu osob.
    • 1 000 000 osobních Skupiny.
    • 100 000 000 osob ve všech Skupiny.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
apiVersion	path	True	string	Verze rozhraní API
endpoint	path	True	string uri	Podporované koncové body služeb Cognitive Services (protokol a název hostitele, například: https://{název_prostředku}.cognitiveservices.azure.com)
personGroupId	path	True	string	ID kontejneru. Vzor regulárního výrazu: ^[a-z0-9-_]+$

Text požadavku

Name	Vyžadováno	Typ	Description
name	True	string	Jméno definované uživatelem, maximální délka je 128.
userData		string	Volitelná uživatelem definovaná data. Délka by neměla překročit 16 kB.

Odpovědi

Name	Typ	Description
200 OK	CreatePersonResult	Úspěšné volání vrátí nové vytvořené personId.
Other Status Codes	FaceErrorResponse	Neočekávaná chybová odpověď. Hlavičky x-ms-error-code: string

Zabezpečení

Ocp-Apim-Subscription-Key

Tajný klíč pro vaše předplatné Azure AI Face.

Typ: apiKey
V: header

AADToken

Tok Azure Active Directory OAuth2

Typ: oauth2
Tok: accessCode
URL autorizace: https://api.example.com/oauth2/authorize
URL tokenu: https://api.example.com/oauth2/token

Rozsahy

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

Příklady

Create Person in PersonGroup

Ukázkový požadavek

HTTP

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

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

Ukázková odpověď

Stavový kód:

200

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

Definice

Name	Description
CreatePersonResult	Odpověď vytvořené osoby.
FaceError	Objekt chyby. Podrobné informace o kódech chyb a zprávách vrácených službou Rozpoznávání tváře najdete na následujícím odkazu: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Odpověď obsahující podrobnosti o chybě.

CreatePersonResult

Odpověď vytvořené osoby.

Name	Typ	Description
personId	string	ID osoby.

FaceError

Objekt chyby. Podrobné informace o kódech chyb a zprávách vrácených službou Rozpoznávání tváře najdete na následujícím odkazu: https://aka.ms/face-error-codes-and-messages.

Name	Typ	Description
code	string	Jeden ze serverem definovaných chybových kódů.
message	string	Lidsky čitelná reprezentace chyby.

FaceErrorResponse

Odpověď obsahující podrobnosti o chybě.

Name	Typ	Description
error	FaceError	Objekt chyby.