SnapshotOperations.TakeWithHttpMessagesAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Envie uma operação para obter uma 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 os usuários fazer backup e restaurar 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 Instantâneo – 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 do instantâneo será incluída no campo "resourceLocation" em OperationStatus – Obter resposta quando a operação status for "bem-sucedida".< br/> A tomada de tempo do instantâneo 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ários rostos.< br /> Snapshots serão expirados e limpos automaticamente em 48 horas após serem criados pelo Snapshot – Take. O usuário pode excluir o 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 em relação ao 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 recomendadas porque 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 são operações por dia.
public System.Threading.Tasks.Task<Microsoft.Rest.HttpOperationHeaderResponse<Microsoft.Azure.CognitiveServices.Vision.Face.Models.SnapshotTakeHeaders>> TakeWithHttpMessagesAsync (Microsoft.Azure.CognitiveServices.Vision.Face.Models.SnapshotObjectType type, string objectId, System.Collections.Generic.IList<Guid> applyScope, string userData = default, System.Collections.Generic.Dictionary<string,System.Collections.Generic.List<string>> customHeaders = default, System.Threading.CancellationToken cancellationToken = default);abstract member TakeWithHttpMessagesAsync : Microsoft.Azure.CognitiveServices.Vision.Face.Models.SnapshotObjectType * string * System.Collections.Generic.IList<Guid> * string * 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.SnapshotTakeHeaders>>
override this.TakeWithHttpMessagesAsync : Microsoft.Azure.CognitiveServices.Vision.Face.Models.SnapshotObjectType * string * System.Collections.Generic.IList<Guid> * string * 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.SnapshotTakeHeaders>>Public Function TakeWithHttpMessagesAsync (type As SnapshotObjectType, objectId As String, applyScope As IList(Of Guid), Optional userData As String = Nothing, Optional customHeaders As Dictionary(Of String, List(Of String)) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of HttpOperationHeaderResponse(Of SnapshotTakeHeaders))Parâmetros
- type
- SnapshotObjectType
Tipo especificado pelo usuário para o objeto de origem do qual tirar 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 tirar instantâneo.
Matriz especificada pelo usuário de IDs de assinatura de detecção facial de destino para o instantâneo. Para cada instantâneo, somente assinaturas incluídas no applyScope de Snapshot – Take podem aplicá-lo.
- userData
- String
O usuário especificou dados sobre o instantâneo para qualquer finalidade. O comprimento não deve exceder 16 KB.
- customHeaders
- Dictionary<String,List<String>>
Cabeçalhos que serão adicionados à solicitação.
- cancellationToken
- CancellationToken
O token de cancelamento.
Retornos
Implementações
Exceções
Gerado quando a operação retornou um código de status inválido
Gerado quando um parâmetro necessário é nulo
Gerado quando um parâmetro necessário é nulo
Aplica-se a
Azure SDK for .NET