IPersonGroupOperations.CreateWithHttpMessagesAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Hiermit erstellen Sie eine neue Personengruppe auf der Grundlage von Personengruppen-ID (personGroupId), Name und den benutzerseitigen Angaben für Benutzerdaten (userData) und Erkennungsmodell (recognitionModel). <br /> Eine Personengruppe ist der Container der hochgeladenen Personendaten, einschließlich Gesichtsbilder und Gesichtserkennungsfeatures. <br /> Verwenden Sie nach der Erstellung PersonGroup Person - Create , um Personen zur Gruppe hinzuzufügen, und rufen Sie dann PersonGroup - Train auf, um diese Gruppe für Face - Identify vorzubereiten. <br /> Gesicht, Bild und UserData der Person werden auf dem Server gespeichert, bis PersonGroup Person – Delete oder PersonGroup – Delete aufgerufen wird. <Br/>
- Abonnementkontingent für den kostenlosen Tarif: 1.000 Personengruppen. Jeder fasst bis zu 1.000 Personen.
- S0-Tarif-Abonnementkontingent: 1.000.000 Personengruppen. Jeder fasst bis zu 10.000 Personen.
- Um ein größeres Problem mit der Gesichtserkennung zu behandeln, sollten Sie Die Verwendung von LargePersonGroup in Erwägung ziehen. <br/> "recognitionModel" sollte angegeben werden, um dieser Personengruppe zuzuordnen. Der Standardwert für "recognitionModel" ist "recognition_01". Wenn das neueste Modell erforderlich ist, geben Sie bitte explizit das modell an, das Sie in diesem Parameter benötigen. Neue Gesichter, die einer vorhandenen Personengruppe hinzugefügt werden, verwenden das Erkennungsmodell, das bereits der Sammlung zugeordnet ist. Vorhandene Gesichtsfeatures in einer Personengruppe können nicht auf Features aktualisiert werden, die von einer anderen Version des Erkennungsmodells extrahiert wurden.
public System.Threading.Tasks.Task<Microsoft.Rest.HttpOperationResponse> CreateWithHttpMessagesAsync (string personGroupId, string name, string userData = default, string recognitionModel = default, System.Collections.Generic.Dictionary<string,System.Collections.Generic.List<string>> customHeaders = default, System.Threading.CancellationToken cancellationToken = default);
abstract member CreateWithHttpMessagesAsync : string * string * string * string * System.Collections.Generic.Dictionary<string, System.Collections.Generic.List<string>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Rest.HttpOperationResponse>
Public Function CreateWithHttpMessagesAsync (personGroupId As String, name As String, Optional userData As String = Nothing, Optional recognitionModel As String = Nothing, Optional customHeaders As Dictionary(Of String, List(Of String)) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of HttpOperationResponse)
Parameter
- personGroupId
- String
Id, die auf eine bestimmte Personengruppe verweist.
- name
- String
Benutzerdefinierter Name, maximale Länge ist 128.
- userData
- String
Vom Benutzer angegebene Daten. Die Länge sollte 16 KB nicht überschreiten.
- recognitionModel
- String
Mögliche Werte: "recognition_01", "recognition_02"
- customHeaders
- Dictionary<String,List<String>>
Die Header, die der Anforderung hinzugefügt werden.
- cancellationToken
- CancellationToken
Das Abbruchtoken.
Gibt zurück
Ausnahmen
Wird ausgelöst, wenn der Vorgang einen ungültigen status Code zurückgegeben hat.
Wird ausgelöst, wenn ein erforderlicher Parameter NULL ist
Gilt für:
Azure SDK for .NET