Compartilhar via


SnapshotOperationsExtensions.ApplyAsync Método

Definição

Envie uma operação para aplicar um instantâneo à assinatura atual. Para cada instantâneo, somente as assinaturas incluídas no applyScope of Snapshot – Take podem aplicá-lo.< br /> As interfaces instantâneo são para que os usuários faça backup e restaurem seus dados faciais de uma assinatura facial para outra, dentro da mesma região ou entre regiões. O fluxo de trabalho contém duas fases, o usuário primeiro chama Snapshot – Take para criar uma cópia do objeto de origem e armazená-lo como um instantâneo e, em seguida, chama Snapshot – Aplicar para colar o instantâneo à assinatura de destino. Os instantâneos são armazenados em um local centralizado (por instância do Azure), para que possam ser aplicados entre contas e regiões.< br/>Aplicar instantâneo é uma operação assíncrona. Uma ID de operação pode ser obtida do campo "Operation-Location" no cabeçalho de resposta, a ser usado em OperationStatus – Get para acompanhar o progresso da aplicação do instantâneo. A ID do objeto de destino será incluída no campo "resourceLocation" em OperationStatus – Obter resposta quando a operação status for "bem-sucedida".< br/>Tempo de aplicação de instantâneo depende do número de entradas de pessoa e rosto no objeto instantâneo. Pode ser em segundos, ou até 1 hora para 1.000.000 pessoas com várias faces.< br/> Snapshots serão expirados e limpos automaticamente em 48 horas depois de serem criados pelo Snapshot – Take. Portanto, a assinatura de destino é necessária para aplicar o instantâneo em 48 horas desde sua criação.< br/> A aplicação de um instantâneo não bloqueará nenhuma outra operação em relação ao objeto de destino, no entanto, não é recomendável porque a correção não pode ser garantida durante instantâneo aplicação. Depois que instantâneo a aplicação for concluída, todas as operações para o objeto de destino poderão funcionar normalmente. O instantâneo também inclui os resultados de treinamento do objeto de origem, o que significa que a assinatura de destino à qual o instantâneo aplicado não precisa treinar novamente o objeto de destino antes de chamar Identifi/FindSimilar.< br/> Um instantâneo pode ser aplicado várias vezes em paralelo, enquanto atualmente há suporte apenas para CreateNew modo de aplicação, o que significa que a operação de aplicação falhará se a assinatura de destino já contiver um objeto do mesmo tipo e usando a mesma objectId. Os usuários podem especificar a "objectId" no corpo da solicitação para evitar esses conflitos.< Br/>

  • Cota de assinatura de camada gratuita: 100 operações de aplicação por mês.
  • Cota de assinatura de nível S0: 100 operações de aplicação por dia.
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

O grupo de operações para esse método de extensão.

snapshotId
Guid

ID que faz referência a uma instantâneo específica.

objectId
String

ID de objeto de destino especificada pelo usuário a ser criada a partir do instantâneo.

mode
SnapshotApplyMode

Modo de aplicação de instantâneo. Atualmente, há suporte apenas para CreateNew, o que significa que a operação de aplicação falhará se a assinatura de destino já contiver um objeto do mesmo tipo e usando a mesma objectId. Os usuários podem especificar a "objectId" no corpo da solicitação para evitar esses conflitos. Os valores possíveis incluem: 'CreateNew'

cancellationToken
CancellationToken

O token de cancelamento.

Retornos

Aplica-se a