SnapshotOperations.TakeWithHttpMessagesAsync 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:

SnapshotOperations.cs

Envíe una operación para tomar una instantánea de la lista de caras, la lista de caras grandes, el grupo de personas o el grupo de personas grandes, con el tipo de instantánea especificado por el usuario, el identificador de objeto de origen, la aplicación del ámbito y los datos de usuario opcionales.< br/> Las interfaces de instantáneas son para que los usuarios realicen copias de seguridad y restauren sus datos faciales de una suscripción de cara a otra, dentro de la misma región o entre regiones. El flujo de trabajo contiene dos fases: el usuario llama primero a Snapshot - Take para crear una copia del objeto de origen y almacenarlo como instantánea y, a continuación, llama a Snapshot - Apply para pegar la instantánea en la suscripción de destino. Las instantáneas se almacenan en una ubicación centralizada (por instancia de Azure), para que se puedan aplicar entre cuentas y regiones.< br/> Taking snapshot es una operación asincrónica. Se puede obtener un identificador de operación del campo "Operation-Location" en el encabezado de respuesta, que se usará en OperationStatus - Get para realizar el seguimiento del progreso de la creación de la instantánea. El identificador de instantánea se incluirá en el campo "resourceLocation" de OperationStatus - Obtener respuesta cuando el estado de la operación sea "correcto".< br/> Snapshot que tarda tiempo depende del número de entradas de persona y cara en el objeto de origen. Podría ser en segundos o hasta varias horas para 1.000.000 personas con varias caras.< br/> Snapshots se expirará automáticamente y se limpiará en 48 horas después de que se cree mediante Snapshot - Take. El usuario puede eliminar la instantánea mediante Snapshot - Delete por sí mismo en cualquier momento antes de la expiración.< br/> Taking snapshot for a certain object will not block any other operations against the object. Todas las operaciones de solo lectura (Get/List e Identify/FindSimilar/Verify) se pueden realizar como de costumbre. Para todas las operaciones grabables, incluidos Add/Update/Delete el objeto de origen o sus personas/caras y Train, no se bloquean, pero no se recomiendan porque es posible que las actualizaciones grabables no se reflejen en la instantánea durante su toma. Una vez completada la toma de instantáneas, todas las operaciones legibles y grabables pueden funcionar de la forma normal. La instantánea también incluirá los resultados de entrenamiento del objeto de origen, lo que significa que la suscripción de destino a la que se aplica la instantánea no necesita volver a entrenar el objeto de destino antes de llamar a Identify/FindSimilar.< Br/>

• Cuota de suscripción de nivel gratis: 100 realizan operaciones al mes.
• Cuota de suscripción de nivel S0: 100 realizan operaciones al día.

public System.Threading.Tasks.Task<Microsoft.Rest.HttpOperationHeaderResponse<Microsoft.Azure.CognitiveServices.Vision.Face.Models.SnapshotTakeHeaders>> TakeWithHttpMessagesAsync (Microsoft.Azure.CognitiveServices.Vision.Face.Models.SnapshotObjectType type, string objectId, System.Collections.Generic.IList<Guid> applyScope, string userData = default, System.Collections.Generic.Dictionary<string,System.Collections.Generic.List<string>> customHeaders = default, System.Threading.CancellationToken cancellationToken = default);

abstract member TakeWithHttpMessagesAsync : Microsoft.Azure.CognitiveServices.Vision.Face.Models.SnapshotObjectType * string * System.Collections.Generic.IList<Guid> * string * System.Collections.Generic.Dictionary<string, System.Collections.Generic.List<string>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Rest.HttpOperationHeaderResponse<Microsoft.Azure.CognitiveServices.Vision.Face.Models.SnapshotTakeHeaders>>
override this.TakeWithHttpMessagesAsync : Microsoft.Azure.CognitiveServices.Vision.Face.Models.SnapshotObjectType * string * System.Collections.Generic.IList<Guid> * string * System.Collections.Generic.Dictionary<string, System.Collections.Generic.List<string>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Rest.HttpOperationHeaderResponse<Microsoft.Azure.CognitiveServices.Vision.Face.Models.SnapshotTakeHeaders>>

Public Function TakeWithHttpMessagesAsync (type As SnapshotObjectType, objectId As String, applyScope As IList(Of Guid), Optional userData As String = Nothing, Optional customHeaders As Dictionary(Of String, List(Of String)) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of HttpOperationHeaderResponse(Of SnapshotTakeHeaders))

Parámetros

type

SnapshotObjectType

Tipo especificado por el usuario para el objeto de origen del que se va a tomar una instantánea. Actualmente se admiten FaceList, PersonGroup, LargeFaceList y LargePersonGroup. Entre los valores posibles se incluyen: 'FaceList', 'LargeFaceList', 'LargePersonGroup', 'PersonGroup'

objectId

String

Identificador de objeto de origen especificado por el usuario para tomar una instantánea.

applyScope

IList<Guid>

Matriz especificada por el usuario de identificadores de suscripción de Face de destino para la instantánea. Para cada instantánea, solo las suscripciones incluidas en applyScope of Snapshot - Take pueden aplicarla.

userData

String

Los datos especificados por el usuario sobre la instantánea para cualquier propósito. La longitud no debe superar los 16 KB.

customHeaders

Dictionary<String,List<String>>

Encabezados que se agregarán a la solicitud.

cancellationToken

CancellationToken

Token de cancelación.

Devoluciones

Task<HttpOperationHeaderResponse<SnapshotTakeHeaders>>

Implementaciones

TakeWithHttpMessagesAsync(SnapshotObjectType, String, IList<Guid>, 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