Person Group Operations - Create Person Group Person
Create einer neuen Person in einer angegebenen Personengruppe. Um dieser Person ein Gesicht hinzuzufügen, rufen Sie "Person Group Person Face hinzufügen" an.
Hinweis
-
- Free-Tarif-Abonnementkontingent:
- 1.000 Personen in allen personen Gruppen.
- S0-Tarif-Abonnementkontingent:
- 10.000 Personen pro Person Gruppe.
- 1.000.000 Personen Gruppen.
- 100.000.000 Personen in allen Personen Gruppen.
- Free-Tarif-Abonnementkontingent:
POST {endpoint}/face/{apiVersion}/persongroups/{personGroupId}/persons
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
api
|
path | True |
string |
API-Version |
endpoint
|
path | True |
string uri |
Unterstützte Cognitive Services-Endpunkte (Protokoll und Hostname, z. B. https://{resource-name}.cognitiveservices.azure.com). |
person
|
path | True |
string |
ID des Containers. Regex pattern: |
Anforderungstext
Name | Erforderlich | Typ | Beschreibung |
---|---|---|---|
name | True |
string |
Benutzerdefinierter Name, maximale Länge ist 128. |
userData |
string |
Optionale benutzerdefinierte Daten. Die Länge sollte 16.000 nicht überschreiten. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Ein erfolgreicher Aufruf gibt eine neue personId zurück, die erstellt wurde. |
|
Other Status Codes |
Eine unerwartete Fehlerantwort. Headers x-ms-error-code: string |
Sicherheit
Ocp-Apim-Subscription-Key
Der geheime Schlüssel für Ihr Azure KI-Gesichtserkennungsabonnement.
Type:
apiKey
In:
header
AADToken
Der 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 | Beschreibung |
---|---|
https://cognitiveservices.azure.com/.default |
Beispiele
Create Person in PersonGroup
Sample Request
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
{
"personId": "25985303-c537-4467-b41d-bdb45cd95ca1"
}
Definitionen
Name | Beschreibung |
---|---|
Create |
Antwort der Erstellen-Person. |
Face |
Das Fehlerobjekt. Ausführliche Informationen zu Fehlercodes und Meldungen, die vom Gesichtserkennungsdienst zurückgegeben werden, finden Sie unter folgendem Link: https://aka.ms/face-error-codes-and-messages. |
Face |
Eine Antwort, die Fehlerdetails enthält. |
CreatePersonResult
Antwort der Erstellen-Person.
Name | Typ | Beschreibung |
---|---|---|
personId |
string |
Personen-ID der Person. |
FaceError
Das Fehlerobjekt. Ausführliche Informationen zu Fehlercodes und Meldungen, die vom Gesichtserkennungsdienst zurückgegeben werden, finden Sie unter folgendem Link: https://aka.ms/face-error-codes-and-messages.
Name | Typ | Beschreibung |
---|---|---|
code |
string |
Einer von einem serverdefiniertem Satz von Fehlercodes. |
message |
string |
Eine lesbare Darstellung des Fehlers. |
FaceErrorResponse
Eine Antwort, die Fehlerdetails enthält.
Name | Typ | Beschreibung |
---|---|---|
error |
Das Fehlerobjekt. |