PersonGroupOperations.CreateWithHttpMessagesAsync Método

Definición

Espacio de nombres:

Microsoft.Azure.CognitiveServices.Vision.Face

Ensamblado:

Microsoft.Azure.CognitiveServices.Vision.Face.dll

Paquete:

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

Source:

PersonGroupOperations.cs

Crea un nuevo grupo de personas con el elemento personGroupId especificado, el elemento name, el elemento userData proporcionado por el usuario y el elemento recognitionModel. <br/> A person group is the container of the uploaded person data, including face images and face recognition features. <br/> Después de la creación, use PersonGroup Person - Create para agregar personas al grupo y, a continuación, llame a PersonGroup - Train para preparar este grupo para Face - Identify. <br/> La cara, la imagen y userData de la persona se almacenarán en el servidor hasta que se llame a PersonGroup Person - Delete o PersonGroup - Delete . <Br/>

• Cuota de suscripción de nivel gratis: 1000 grupos de personas. Cada uno ocupa hasta 1.000 personas.
• Cuota de suscripción de nivel S0: 1000 000 grupos de personas. Cada uno tiene hasta 10.000 personas.
• para controlar el problema de identificación facial a mayor escala, considere la posibilidad de usar LargePersonGroup. <br/> 'recognitionModel' debe especificarse para asociarlo a este grupo de personas. El valor predeterminado de "recognitionModel" es "recognition_01", si es necesario el modelo más reciente, especifique explícitamente el modelo que necesita en este parámetro. Las caras nuevas que se agregan a un grupo de personas existente usarán el modelo de reconocimiento que ya está asociado a la colección. Las características faciales existentes de un grupo de personas no se pueden actualizar a las características extraídas por otra versión del modelo de reconocimiento.

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)

Parámetros

personGroupId

String

Identificador que hace referencia a un grupo de personas determinado.

name

String

Nombre definido por el usuario, la longitud máxima es 128.

userData

String

Datos especificados por el usuario. La longitud no debe superar los 16 KB.

recognitionModel

String

Entre los valores posibles se incluyen: "recognition_01", "recognition_02"

customHeaders

Dictionary<String,List<String>>

Encabezados que se agregarán a la solicitud.

cancellationToken

CancellationToken

Token de cancelación.

Devoluciones

Task<HttpOperationResponse>

Implementaciones

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

Excepciones

APIErrorException

Se produce cuando la operación devolvió un código de estado no válido

ValidationException

Se produce cuando un parámetro obligatorio es NULL

ArgumentNullException

Se produce cuando un parámetro obligatorio es NULL