SnapshotOperations.ApplyWithHttpMessagesAsync 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 aplicar um instantâneo à assinatura atual. Para cada instantâneo, somente as assinaturas incluídas no applyScope de Snapshot – Take podem aplicá-lo.< 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 /> 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 /> O 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 múltiplas faces.< br /> Snapshots serão expirados e limpos automaticamente em 48 horas após 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 apply, 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 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

Id referenciando um instantâneo específico.

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 apply falhará se a assinatura de destino já contiver um objeto do mesmo tipo e usar o mesmo objectId. Os usuários podem especificar a "objectId" no corpo da solicitação para evitar esses conflitos. Os valores possíveis incluem: 'CreateNew'

customHeaders

Dictionary<String,List<String>>

Cabeçalhos que serão adicionados à solicitação.

cancellationToken

CancellationToken

O token de cancelamento.

Retornos

Task<HttpOperationHeaderResponse<SnapshotApplyHeaders>>

Implementações

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