SnapshotOperationsExtensions.TakeAsync 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:

SnapshotOperationsExtensions.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, aplicar el á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 una 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 - Get response when the operation status is "succeeded".< br/> Snapshot tardando tiempo depende del número de entradas de persona y cara en el objeto de origen. Podría estar en segundos o hasta varias horas para 1.000.000 personas con varias caras.< br/> Snapshots expirará automáticamente y se limpiará en 48 horas después de crearla 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, incluidas 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 gratuito: 100 realizan operaciones al mes.
• Cuota de suscripción de nivel S0: 100 realizan operaciones al día.

public static System.Threading.Tasks.Task<Microsoft.Azure.CognitiveServices.Vision.Face.Models.SnapshotTakeHeaders> TakeAsync (this Microsoft.Azure.CognitiveServices.Vision.Face.ISnapshotOperations operations, Microsoft.Azure.CognitiveServices.Vision.Face.Models.SnapshotObjectType type, string objectId, System.Collections.Generic.IList<Guid> applyScope, string userData = default, System.Threading.CancellationToken cancellationToken = default);

static member TakeAsync : Microsoft.Azure.CognitiveServices.Vision.Face.ISnapshotOperations * Microsoft.Azure.CognitiveServices.Vision.Face.Models.SnapshotObjectType * string * System.Collections.Generic.IList<Guid> * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.CognitiveServices.Vision.Face.Models.SnapshotTakeHeaders>

<Extension()>
Public Function TakeAsync (operations As ISnapshotOperations, type As SnapshotObjectType, objectId As String, applyScope As IList(Of Guid), Optional userData As String = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of SnapshotTakeHeaders)

Parámetros

operations

ISnapshotOperations

Grupo de operaciones para este método de extensión.

type

SnapshotObjectType

Tipo especificado por el usuario del objeto de origen del que se va a tomar la 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 instantáneas.

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.

cancellationToken

CancellationToken

Token de cancelación.

Devoluciones

Task<SnapshotTakeHeaders>