LargePersonGroupOperations.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:

LargePersonGroupOperations.cs

Hiermit erstellen Sie eine neue umfangreiche Personengruppe mit benutzerseitigen Angaben für „largePersonGroupId“, Name und optional „userData“ und „recognitionModel“. <br /> Eine große Personengruppe ist der Container der hochgeladenen Personendaten, einschließlich Gesichtsbilder und Gesichtserkennungsfunktion, und bis zu 1.000.000 Personen. <br /> Verwenden Sie nach der Erstellung LargePersonGroup Person – Create , um eine Person zur Gruppe hinzuzufügen, und rufen Sie LargePersonGroup – Train auf, um diese Gruppe für Face – Identify vorzubereiten. <br /> Die Person face, image, und userData werden auf dem Server gespeichert, bis LargePersonGroup Person – Delete oder LargePersonGroup – Delete aufgerufen wird. <Br/>

• Free-Tarif-Abonnementkontingent: 1.000 große Personengruppen.
• S0-Tarif-Abonnementkontingent: 1.000.000 große Personengruppen. <br/> "recognitionModel" sollte angegeben werden, um dieser großen 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 großen Personengruppe hinzugefügt werden, verwenden das Erkennungsmodell, das bereits der Sammlung zugeordnet ist. Vorhandene Gesichtsfeatures in einer großen 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 largePersonGroupId, 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 (largePersonGroupId 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

largePersonGroupId

String

Id, die auf eine bestimmte große 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