Partager via


IPersonGroupOperations.CreateWithHttpMessagesAsync Méthode

Définition

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 de visage 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 userData de la personne seront 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. Chacun peut contenir jusqu’à 1 000 personnes.
  • Quota d’abonnement de niveau S0 : 1 000 000 de groupes de personnes. Chacun peut contenir jusqu’à 10 000 personnes.
  • Pour gérer le problème d’identification des visages à plus grande échelle, envisagez d’utiliser LargePersonGroup. <br /> 'recognitionModel' doit être spécifié pour l’associer à ce groupe de personnes. La valeur par défaut de « recognitionModel » est « recognition_01 ». Si le modèle le plus récent 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 des 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>
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

Exceptions

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

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

S’applique à