SnapshotOperations.ApplyWithHttpMessagesAsync 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 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 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/> Aplicar instantánea 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 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 expirará automáticamente y se limpiará en 48 horas después de crearla 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 instantáneas. 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 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 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 gratuito: 100 aplican operaciones al mes.
• Cuota de suscripción de nivel S0: 100 aplican operaciones al día.

public System.Threading.Tasks.Task<Microsoft.Rest.HttpOperationHeaderResponse<Microsoft.Azure.CognitiveServices.Vision.Face.Models.SnapshotApplyHeaders>> ApplyWithHttpMessagesAsync (Guid snapshotId, string objectId, Microsoft.Azure.CognitiveServices.Vision.Face.Models.SnapshotApplyMode mode = Microsoft.Azure.CognitiveServices.Vision.Face.Models.SnapshotApplyMode.CreateNew, System.Collections.Generic.Dictionary<string,System.Collections.Generic.List<string>> customHeaders = default, System.Threading.CancellationToken cancellationToken = default);

abstract member ApplyWithHttpMessagesAsync : Guid * string * Microsoft.Azure.CognitiveServices.Vision.Face.Models.SnapshotApplyMode * 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.SnapshotApplyHeaders>>
override this.ApplyWithHttpMessagesAsync : Guid * string * Microsoft.Azure.CognitiveServices.Vision.Face.Models.SnapshotApplyMode * 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.SnapshotApplyHeaders>>

Public Function ApplyWithHttpMessagesAsync (snapshotId As Guid, objectId As String, Optional mode As SnapshotApplyMode = Microsoft.Azure.CognitiveServices.Vision.Face.Models.SnapshotApplyMode.CreateNew, Optional customHeaders As Dictionary(Of String, List(Of String)) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of HttpOperationHeaderResponse(Of SnapshotApplyHeaders))

Parámetros

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"

customHeaders

Dictionary<String,List<String>>

Encabezados que se agregarán a la solicitud.

cancellationToken

CancellationToken

Token de cancelación.

Devoluciones

Task<HttpOperationHeaderResponse<SnapshotApplyHeaders>>

Implementaciones

ApplyWithHttpMessagesAsync(Guid, String, SnapshotApplyMode, 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