PersonGroupOperations.CreateWithHttpMessagesAsync Methode

Definition

Namespace:

Microsoft.Azure.CognitiveServices.Vision.Face

Assembly:

Microsoft.Azure.CognitiveServices.Vision.Face.dll

Paket:

Microsoft.Azure.CognitiveServices.Vision.Face v2.8.0-preview.3

Quelle:

PersonGroupOperations.cs

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 - Trainieren auf, um diese Gruppe für Gesichtserkennung vorzubereiten. <br /> Das Gesicht, das Bild und die userData der Person werden auf dem Server gespeichert, bis PersonGroup Person – Delete oder PersonGroup – Delete aufgerufen wird. <Br/>

• Free-Tarif-Abonnementkontingent: 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 probleme mit der Gesichtserkennung in größerem Umfang zu behandeln, sollten Sie Die Verwendung von LargePersonGroup in Betracht 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 in diesem Parameter explizit das modell an, das Sie 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>
override this.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>>

Header, die der Anforderung hinzugefügt werden.

cancellationToken

CancellationToken

Das Abbruchtoken.

Gibt zurück

Task<HttpOperationResponse>

Implementiert

CreateWithHttpMessagesAsync(String, String, String, String, Dictionary<String,List<String>>, CancellationToken)

Ausnahmen

APIErrorException

Wird ausgelöst, wenn der Vorgang einen ungültigen status Code zurückgegeben hat.

ValidationException

Wird ausgelöst, wenn ein erforderlicher Parameter NULL ist

ArgumentNullException

Wird ausgelöst, wenn ein erforderlicher Parameter NULL ist