Person Directory Operations - Create Dynamic Person Group With Person

Usługa:

Azure AI Services

Wersja interfejsu API:

v1.2-preview.1

Tworzy nową grupę osób dynamicznych z określonym parametrem dynamicPersonGroupId, name i user-provided userData.
Grupa osób dynamicznych to kontener, który odwołuje się do katalogu person "Create Person". Po utworzeniu użyj katalogu person directory "Zaktualizuj grupę osób dynamicznych", aby dodać/usunąć osoby do/z grupy osób dynamicznych.

Dynamiczna grupa osób i dane użytkowników będą przechowywane na serwerze do momentu wywołania katalogu person directory "Delete Dynamic Person Group". Użyj parametru "Zidentyfikuj z grupy osób dynamicznych" z parametrem dynamicPersonGroupId, aby zidentyfikować osoby.

Nie będzie przechowywany żaden obraz. Tylko wyodrębnione funkcje twarzy i userData osoby będą przechowywane na serwerze, dopóki nie zostanie wywołana funkcja "Usuń osobę" lub "Usuń twarz osoby".

Element "recognitionModel" nie musi być określony w grupach osób dynamicznych. Dynamiczne grupy osób są odwołaniami do katalogu osób "Tworzenie osoby" i dlatego pracują z większością "recognitionModels". Identyfikator faceId podany podczas "Identyfikowanie" określa używany model rozpoznawania.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
apiVersion	path	True	string	Wersja interfejsu API
dynamicPersonGroupId	path	True	string	Identyfikator grupy osób dynamicznych. Wzorzec wyrażenia regularnego: ^[a-z0-9-_]+$
endpoint	path	True	string uri	Obsługiwane punkty końcowe usług Cognitive Services (protokół i nazwa hosta, na przykład: https://{nazwa-zasobu}.cognitiveservices.azure.com).

Treść żądania

Nazwa	Wymagane	Typ	Opis
addPersonIds	True	string[]	Tablica identyfikatorów personId utworzonych przez katalog person "Create Person" do dodania.
name	True	string	Nazwa zdefiniowana przez użytkownika, maksymalna długość to 128.
userData		string	Opcjonalne dane zdefiniowane przez użytkownika. Długość nie powinna przekraczać 16 tys.

Odpowiedzi

Nazwa	Typ	Opis
202 Accepted		Pomyślne wywołanie zwraca pustą treść odpowiedzi. Usługa zaakceptowała żądanie i wkrótce rozpocznie przetwarzanie. Klient może wysyłać zapytania dotyczące stanu operacji i wyniku przy użyciu adresu URL określonego w nagłówku odpowiedzi "Operation-Location". Adres URL wygasa w ciągu 48 godzin. Adres URL określa stan, gdy katalog osób "Pobierz odwołania do grupy osób dynamicznych" zwróci zmiany wprowadzone w tym żądaniu. Nagłówki operation-Location: string
Other Status Codes	FaceErrorResponse	Nieoczekiwana odpowiedź na błąd. Nagłówki x-ms-error-code: string

Zabezpieczenia

Ocp-Apim-Subscription-Key

Klucz tajny subskrypcji rozpoznawania twarzy w usłudze Azure AI.

Typ: apiKey
W: header

AADToken

Przepływ OAuth2 usługi Azure Active Directory

Typ: oauth2
Flow: accessCode
Adres URL autoryzacji: https://api.example.com/oauth2/authorize
Adres URL tokenu: https://api.example.com/oauth2/token

Zakresy

Nazwa	Opis
https://cognitiveservices.azure.com/.default

Przykłady

Create DynamicPersonGroup

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:

202

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

Definicje

Nazwa	Opis
FaceError	Obiekt błędu. Aby uzyskać szczegółowe informacje na temat kodów błędów i komunikatów zwracanych przez usługę rozpoznawania twarzy, zapoznaj się z następującym linkiem: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Odpowiedź zawierająca szczegóły błędu.

FaceError

Obiekt błędu. Aby uzyskać szczegółowe informacje na temat kodów błędów i komunikatów zwracanych przez usługę rozpoznawania twarzy, zapoznaj się z następującym linkiem: https://aka.ms/face-error-codes-and-messages.

Nazwa	Typ	Opis
code	string	Jeden z zdefiniowanych przez serwer zestaw kodów błędów.
message	string	Czytelna dla człowieka reprezentacja błędu.

FaceErrorResponse

Odpowiedź zawierająca szczegóły błędu.

Nazwa	Typ	Opis
error	FaceError	Obiekt błędu.