Person Directory Operations - Create Dynamic Person Group

Služba:

Azure AI Services

Verze rozhraní API:

v1.2-preview.1

Vytvoří novou dynamickou skupinu osob se zadaným dynamicPersonGroupId, jménem a uživatelem zadanými userData.
Dynamická skupina osob je kontejner, který odkazuje na adresář person "Create Person". Po vytvoření použijte adresář osoby Aktualizovat dynamickou skupinu osob a přidejte nebo odeberte osoby do nebo z dynamické skupiny osob.

Dynamická skupina osob a uživatelská data budou uložena na serveru, dokud se nevolá adresář osoby "Odstranit dynamickou skupinu osob". K identifikaci osob použijte výraz "Identify From Dynamic Person Group" s parametrem dynamicPersonGroupId.

Neuloží se žádná image. Na serveru budou uloženy pouze extrahované funkce tváře a userData osoby, dokud nebude volána osoba "Odstranit osobu" nebo "Odstranit tvář osoby".

Objekt recognitionModel není nutné zadávat pomocí dynamických skupin osob. Dynamické skupiny osob jsou odkazy na adresář Person "Create Person" (Vytvořit osobu), a proto fungují s většinou "recognitionModels". Id tváře zadané během "Identifikace" určuje použitou vlastnost recognitionModel.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
apiVersion	path	True	string	Verze rozhraní API
dynamicPersonGroupId	path	True	string	ID dynamické skupiny osob. Vzor regulárního výrazu: ^[a-z0-9-_]+$
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).

Text požadavku

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

Odpovědi

Name	Typ	Description
200 OK		Požadavek byl úspěšný.
Other Status Codes	FaceErrorResponse	Neočekávaná chybová odpověď Hlavičky x-ms-error-code: string

Zabezpečení

Ocp-Apim-Subscription-Key

Tajný klíč předplatného 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 DynamicPersonGroup

Ukázkový požadavek

HTTP

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

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

Ukázková odpověď

Stavový kód:

200

Definice

Name	Description
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ě.

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	Jedna ze serverově definovaných kódů chyb.
message	string	Čitelné znázornění chyby člověkem.

FaceErrorResponse

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

Name	Typ	Description
error	FaceError	Objekt chyby.