ISnapshotOperations.ApplyWithHttpMessagesAsync Methode

Referenz

Definition

Namespace:: Microsoft.Azure.CognitiveServices.Vision.Face

Assembly:: Microsoft.Azure.CognitiveServices.Vision.Face.dll

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

Quelle:: ISnapshotOperations.cs

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Übermitteln Sie einen Vorgang, um eine Momentaufnahme auf das aktuelle Abonnement anzuwenden. Für jede Momentaufnahme können nur Abonnements angewendet werden, die im applyScope of Snapshot – Take enthalten sind. Die Momentaufnahme Schnittstellen dienen dazu, dass Benutzer ihre Gesichtsdaten aus einem Gesichtsabonnement in einem anderen, innerhalb derselben Region oder regionsübergreifend sichern und wiederherstellen können. Der Workflow enthält zwei Phasen. Der Benutzer ruft zunächst Snapshot – Take auf, um eine Kopie des Quellobjekts zu erstellen und es als Momentaufnahme zu speichern, und ruft dann Momentaufnahme – Anwenden auf, um die Momentaufnahme in das Zielabonnement einzufügen. Die Momentaufnahmen werden an einem zentralen Speicherort (gemäß Azure instance) gespeichert, sodass sie konten- und regionsübergreifend angewendet werden können. Anwenden von Momentaufnahme ist ein asynchroner Vorgang. Eine Vorgangs-ID kann aus dem Feld "Operation-Location" im Antwortheader abgerufen werden, das in OperationStatus – Get zum Nachverfolgen des Fortschritts beim Anwenden der Momentaufnahme verwendet werden soll. Die Zielobjekt-ID wird im Feld "resourceLocation" in OperationStatus – Abrufen der Antwort eingeschlossen, wenn der Vorgang status "erfolgreich" ist. Momentaufnahme: Anwendungszeit hängt von der Anzahl der Personen- und Gesichtseinträge im Momentaufnahme-Objekt ab. Dies kann in Sekunden oder bis zu 1 Stunde für 1.000.000 Personen mit mehreren Gesichtern sein. Snapshots werden automatisch abgelaufen und in 48 Stunden bereinigt, nachdem sie von Snapshot – Take erstellt wurden. Daher muss das Zielabonnement die Momentaufnahme in 48 Stunden seit seiner Erstellung anwenden. Durch das Anwenden eines Momentaufnahme werden keine anderen Vorgänge für das Zielobjekt blockiert. Dies wird jedoch nicht empfohlen, da die Richtigkeit während Momentaufnahme Anwendung nicht garantiert werden kann. Nachdem Momentaufnahme Anwendung abgeschlossen ist, können alle Vorgänge für das Zielobjekt wie gewohnt funktionieren. Die Momentaufnahme enthält auch die Trainingsergebnisse des Quellobjekts. Das bedeutet, dass das Zielabonnement, auf das Momentaufnahme angewendet wird, das Zielobjekt vor dem Aufruf von Identify/FindSimilar nicht erneut trainiert werden muss. Ein Momentaufnahme kann mehrmals parallel angewendet werden, während derzeit nur createNew apply mode unterstützt wird. Dies bedeutet, dass der Apply-Vorgang fehlschlägt, wenn das Zielabonnement bereits ein Objekt desselben Typs enthält und dieselbe objectId verwendet. Benutzer können die "objectId" im Anforderungstext angeben, um solche Konflikte zu vermeiden.

Free-Tarif-Abonnementkontingent: 100 Anwenden von Vorgängen pro Monat.
S0-Tarif-Abonnementkontingent: 100 Anwenden von Vorgängen pro Tag.

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

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

Parameter

snapshotId: Guid

Id, die auf einen bestimmten Momentaufnahme verweist.

objectId: String

Vom Benutzer angegebene Zielobjekt-ID, die aus dem Momentaufnahme erstellt werden soll.

mode: SnapshotApplyMode

Momentaufnahme-Anwendungsmodus. Derzeit wird nur CreateNew unterstützt. Dies bedeutet, dass der Apply-Vorgang fehlschlägt, wenn das Zielabonnement bereits ein Objekt desselben Typs enthält und dieselbe objectId verwendet. Benutzer können die "objectId" im Anforderungstext angeben, um solche Konflikte zu vermeiden. Mögliche Werte: "CreateNew"