SnapshotOperations.TakeWithHttpMessagesAsync 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:

SnapshotOperations.cs

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.

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 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

Task<HttpOperationHeaderResponse<SnapshotTakeHeaders>>

Implementações

TakeWithHttpMessagesAsync(SnapshotObjectType, String, IList<Guid>, String, Dictionary<String,List<String>>, CancellationToken)

Exceções

APIErrorException

Gerado quando a operação retornou um código de status inválido

ValidationException

Gerado quando um parâmetro necessário é nulo

ArgumentNullException

Gerado quando um parâmetro necessário é nulo