Freigeben über


IPersonGroupOperations.CreateWithHttpMessagesAsync Methode

Definition

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: