SnapshotOperationsExtensions.TakeAsync Método

Definição

Namespace:

Microsoft.Azure.CognitiveServices.Vision.Face

Assembly:

Microsoft.Azure.CognitiveServices.Vision.Face.dll

Pacote:

Microsoft.Azure.CognitiveServices.Vision.Face v2.8.0-preview.3

Origem:

SnapshotOperationsExtensions.cs

Envie uma operação para obter um instantâneo de lista de rostos, lista de rostos grandes, grupo de pessoas ou grupo de pessoas grandes, com tipo de instantâneo especificado pelo usuário, ID do objeto de origem, escopo de aplicação e dados de usuário opcionais.< 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 />Taking 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 criação do instantâneo. A ID de instantâneo será incluída no campo "resourceLocation" em OperationStatus – Obter resposta quando a operação status for "bem-sucedida".< br />Snapshot taking time depende do número de entradas de pessoa e rosto no objeto de origem. Pode ser em segundos, ou até várias horas 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. O usuário pode excluir a instantâneo usando Instantâneo – Excluir por conta própria a qualquer momento antes da expiração.< br/>Tomando instantâneo para um determinado objeto não bloqueará nenhuma outra operação contra o objeto. Todas as operações somente leitura (Obter/Listar e Identificar/LocalizarSimilar/Verificar) podem ser realizadas normalmente. Para todas as operações graváveis, incluindo Adicionar/Atualizar/Excluir o objeto de origem ou suas pessoas/rostos e Treinar, elas não são bloqueadas, mas não são recomendadas porque as atualizações graváveis podem não ser refletidas no instantâneo durante sua tomada. Depois que instantâneo tomada for concluída, todas as operações legíveis e graváveis poderão funcionar normalmente. O instantâneo também incluirá 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/>

• Cota de assinatura de camada gratuita: 100 operações de uso por mês.
• Cota de assinatura de nível S0: 100 operações de uso por dia.

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

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

type

SnapshotObjectType

Tipo especificado pelo usuário para o objeto de origem a ser instantâneo. Atualmente, há suporte para FaceList, PersonGroup, LargeFaceList e LargePersonGroup. Os valores possíveis incluem: 'FaceList', 'LargeFaceList', 'LargePersonGroup', 'PersonGroup'

objectId

String

ID de objeto de origem especificada pelo usuário para instantâneo.

applyScope

IList<Guid>

Matriz especificada pelo usuário de IDs de assinatura de detecção facial de destino para o instantâneo. Para cada instantâneo, somente as assinaturas incluídas no applyScope of Snapshot – Take podem aplicá-lo.

userData

String

Os dados especificados pelo usuário sobre o instantâneo para qualquer finalidade. O comprimento não deve exceder 16 KB.

cancellationToken

CancellationToken

O token de cancelamento.

Retornos

Task<SnapshotTakeHeaders>