Person Group Operations - Create Person Group Person

Service:

Azure AI Services

API Version:

v1.1-preview.1

Twórca nową osobę w określonej grupie osób. Aby dodać twarz do tej osoby, zadzwoń do "Dodaj twarz osoby grupy osób".

Uwaga

• • Limit przydziału subskrypcji w warstwie Bezpłatna:
    • 1000 osób we wszystkich osobach Grupy.
  • Limit przydziału subskrypcji warstwy S0:
    • 10 000 osób na grupę osób.
    • 1000 000 Osoba Grupy.
    • 100 000 000 osób we wszystkich osobach Grupy.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
apiVersion	path	True	string	Wersja interfejsu API
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).
personGroupId	path	True	string	Identyfikator kontenera. Regex pattern: ^[a-z0-9-_]+$

Treść żądania

Nazwa	Wymagane	Typ	Opis
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
200 OK	CreatePersonResult	Pomyślne wywołanie zwraca utworzony nowy identyfikator personId.
Other Status Codes	FaceErrorResponse	Nieoczekiwana odpowiedź na błąd. Headers x-ms-error-code: string

Zabezpieczenia

Ocp-Apim-Subscription-Key

Klucz tajny subskrypcji rozpoznawania twarzy usługi Azure AI.

Type: apiKey
In: header

AADToken

Przepływ OAuth2 usługi Azure Active Directory

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

Scopes

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

Przykłady

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

Definicje

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

CreatePersonResult

Odpowiedź na tworzenie osoby.

Nazwa	Typ	Opis
personId	string	Identyfikator osoby.

FaceError

Obiekt error. Aby uzyskać szczegółowe informacje na temat kodów błędów i komunikatów zwracanych przez usługę rozpoznawania twarzy, skorzystaj z następującego linku: 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 error.