SnapshotOperationsExtensions.ApplyAsync 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 aplicar una instantánea a la suscripción actual. Para cada instantánea, solo las suscripciones incluidas en applyScope of Snapshot - Take pueden aplicarla.< 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/> Applying 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 un seguimiento del progreso de la aplicación de la instantánea. El identificador de objeto de destino se incluirá en el campo "resourceLocation" de OperationStatus - Obtener respuesta cuando el estado de la operación sea "correcto".< Br/> Snapshot aplicar el tiempo depende del número de entradas de persona y cara en el objeto de instantánea. Podría estar en segundos o hasta 1 hora 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. Por lo tanto, la suscripción de destino es necesaria para aplicar la instantánea en 48 horas desde su creación.< Br/> Aplicar una instantánea no bloqueará ninguna otra operación en el objeto de destino, pero no se recomienda porque no se puede garantizar la corrección durante la aplicación de la instantánea. Una vez completada la aplicación de instantáneas, todas las operaciones hacia el objeto de destino pueden funcionar de la forma normal. La instantánea también incluye 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/> One snapshot se puede aplicar varias veces en paralelo, mientras que actualmente solo se admite el modo CreateNew apply, lo que significa que la operación de aplicación producirá un error si la suscripción de destino ya contiene un objeto de mismo tipo y con el mismo objectId. Los usuarios pueden especificar el "objectId" en el cuerpo de la solicitud para evitar estos conflictos.< Br/>

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

public static System.Threading.Tasks.Task<Microsoft.Azure.CognitiveServices.Vision.Face.Models.SnapshotApplyHeaders> ApplyAsync (this Microsoft.Azure.CognitiveServices.Vision.Face.ISnapshotOperations operations, Guid snapshotId, string objectId, Microsoft.Azure.CognitiveServices.Vision.Face.Models.SnapshotApplyMode mode = Microsoft.Azure.CognitiveServices.Vision.Face.Models.SnapshotApplyMode.CreateNew, System.Threading.CancellationToken cancellationToken = default);

static member ApplyAsync : Microsoft.Azure.CognitiveServices.Vision.Face.ISnapshotOperations * Guid * string * Microsoft.Azure.CognitiveServices.Vision.Face.Models.SnapshotApplyMode * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.CognitiveServices.Vision.Face.Models.SnapshotApplyHeaders>

<Extension()>
Public Function ApplyAsync (operations As ISnapshotOperations, snapshotId As Guid, objectId As String, Optional mode As SnapshotApplyMode = Microsoft.Azure.CognitiveServices.Vision.Face.Models.SnapshotApplyMode.CreateNew, Optional cancellationToken As CancellationToken = Nothing) As Task(Of SnapshotApplyHeaders)

Parámetros

operations

ISnapshotOperations

El grupo de operaciones de este método de extensión.

snapshotId

Guid

Identificador que hace referencia a una instantánea determinada.

objectId

String

Identificador de objeto de destino especificado por el usuario que se va a crear a partir de la instantánea.

mode

SnapshotApplyMode

Modo de aplicación de instantáneas. Actualmente solo se admite CreateNew, lo que significa que se producirá un error en la operación de aplicación si la suscripción de destino ya contiene un objeto de mismo tipo y usa el mismo objectId. Los usuarios pueden especificar el "objectId" en el cuerpo de la solicitud para evitar estos conflictos. Entre los valores posibles se incluyen: "CreateNew"

cancellationToken

CancellationToken

Token de cancelación.

Devoluciones

Task<SnapshotApplyHeaders>