PersonGroupOperations.CreateWithHttpMessagesAsync Méthode

Définition

Espace de noms:

Microsoft.Azure.CognitiveServices.Vision.Face

Assembly:

Microsoft.Azure.CognitiveServices.Vision.Face.dll

Paquet:

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

Source:

PersonGroupOperations.cs

Crée un nouveau groupe de personnes avec les valeurs personGroupId, name, userData et recognitionModel fournies par l’utilisateur. <br /> Un groupe de personnes est le conteneur des données de personne chargées, y compris les images faciales et les fonctionnalités de reconnaissance faciale. <br /> Après la création, utilisez PersonGroup Person - Create pour ajouter des personnes au groupe, puis appelez PersonGroup - Entraîner pour préparer ce groupe pour Visage - Identifier. <br /> Le visage, l’image et l’userData de la personne sont stockés sur le serveur jusqu’à ce que PersonGroup Person - Delete ou PersonGroup - Delete soit appelé. <Br/>

• Quota d’abonnement de niveau gratuit : 1 000 groupes de personnes. Chacune peut contenir jusqu’à 1 000 personnes.
• Quota d’abonnement de niveau S0 : 1 000 000 groupes de personnes. Chacune peut contenir jusqu’à 10 000 personnes.
• pour gérer le problème d’identification de visage à plus grande échelle, envisagez d’utiliser LargePersonGroup. <br /> 'recognitionModel' doit être spécifié pour être associé à ce groupe de personnes. La valeur par défaut de « recognitionModel » est « recognition_01 ». Si le dernier modèle est nécessaire, spécifiez explicitement le modèle dont vous avez besoin dans ce paramètre. Les nouveaux visages ajoutés à un groupe de personnes existant utilisent le modèle de reconnaissance déjà associé à la collection. Les fonctionnalités de visage existantes dans un groupe de personnes ne peuvent pas être mises à jour vers les fonctionnalités extraites par une autre version du modèle de reconnaissance.

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)

Paramètres

personGroupId

String

ID référençant un groupe de personnes particulier.

name

String

Nom défini par l’utilisateur, la longueur maximale est 128.

userData

String

Données spécifiées par l’utilisateur. La longueur ne doit pas dépasser 16 Ko.

recognitionModel

String

Les valeurs possibles sont les suivantes : « recognition_01 », « recognition_02 »

customHeaders

Dictionary<String,List<String>>

En-têtes qui seront ajoutés à la demande.

cancellationToken

CancellationToken

Jeton d'annulation.

Retours

Task<HttpOperationResponse>

Implémente

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

Exceptions

APIErrorException

Levée lorsque l’opération a retourné un code de status non valide

ValidationException

Levée lorsqu’un paramètre obligatoire a la valeur Null

ArgumentNullException

Levée lorsqu’un paramètre obligatoire a la valeur Null