SnapshotOperationsExtensions.ApplyAsync メソッド

定義

現在のサブスクリプションにスナップショットを適用する操作を送信します。 スナップショットごとに、スナップショットの applyScope - Take に含まれるサブスクリプションのみが適用できます。<br /> スナップショット インターフェイスは、ユーザーが顔のデータをバックアップし、同じリージョン内またはリージョン間で、ある顔サブスクリプションから別の顔のサブスクリプションに復元するためのインターフェイスです。 ワークフローには 2 つのフェーズが含まれています。ユーザーは最初に Snapshot - Take を呼び出してソース オブジェクトのコピーを作成し、それをスナップショットとして格納し、Snapshot - Apply を呼び出してターゲット サブスクリプションにスナップショットを貼り付けます。 スナップショットは一元化された場所 (Azure インスタンスごと) に格納されるため、クロス アカウントとリージョンに適用できます。<br /> スナップショットの適用は非同期操作です。 操作 ID は、応答ヘッダーの "Operation-Location" フィールドから取得できます。これは、OperationStatus - Get で使用され、スナップショットの適用の進行状況を追跡するために使用されます。 ターゲット オブジェクト ID は、OperationStatus - 操作の状態が "成功" の場合に応答を取得するの "resourceLocation" フィールドに含まれます。<br /> Snapshot applying time は、スナップショット オブジェクト内の人物と顔のエントリの数によって異なります。 これは秒単位で、複数の顔を持つ 1,000,000 人の場合は最大 1 時間です。<br /> Snapshots は、スナップショット - Take によって作成された後、48 時間以内に自動的に期限切れになり、クリーンアップされます。 そのため、ターゲット サブスクリプションは、作成から 48 時間以内にスナップショットを適用する必要があります。<br /> スナップショットを適用してもターゲット オブジェクトに対する他の操作はブロックされませんが、適用中に正確性を保証できないため、推奨スナップショット。 スナップショット適用が完了すると、ターゲット オブジェクトに対するすべての操作が正常に動作します。 スナップショットには、ソース オブジェクトのトレーニング結果も含まれます。つまり、スナップショット適用先のターゲット サブスクリプションは、Identify/FindSimilar を呼び出す前にターゲット オブジェクトを再トレーニングする必要はありません。<br /> 1 つのスナップショットは並列で複数回適用できますが、現在は CreateNew 適用モードのみがサポートされています。つまり、ターゲット サブスクリプションに同じ種類のオブジェクトが既に含まれており、同じ objectId を使用している場合、適用操作は失敗します。 ユーザーは、このような競合を回避するために、要求本文で "objectId" を指定できます。<Br/>

  • Free レベルのサブスクリプション クォータ: 1 か月あたり 100 個の適用操作。
  • S0 レベルのサブスクリプション クォータ: 1 日あたり 100 個の操作が適用されます。
public static System.Threading.Tasks.Task<Microsoft.Azure.CognitiveServices.Vision.Face.Models.SnapshotApplyHeaders> ApplyAsync (this Microsoft.Azure.CognitiveServices.Vision.Face.ISnapshotOperations operations, Guid snapshotId, string objectId, Microsoft.Azure.CognitiveServices.Vision.Face.Models.SnapshotApplyMode mode = Microsoft.Azure.CognitiveServices.Vision.Face.Models.SnapshotApplyMode.CreateNew, System.Threading.CancellationToken cancellationToken = default);
static member ApplyAsync : Microsoft.Azure.CognitiveServices.Vision.Face.ISnapshotOperations * Guid * string * Microsoft.Azure.CognitiveServices.Vision.Face.Models.SnapshotApplyMode * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.CognitiveServices.Vision.Face.Models.SnapshotApplyHeaders>
<Extension()>
Public Function ApplyAsync (operations As ISnapshotOperations, snapshotId As Guid, objectId As String, Optional mode As SnapshotApplyMode = Microsoft.Azure.CognitiveServices.Vision.Face.Models.SnapshotApplyMode.CreateNew, Optional cancellationToken As CancellationToken = Nothing) As Task(Of SnapshotApplyHeaders)

パラメーター

operations
ISnapshotOperations

この拡張メソッドの操作グループ。

snapshotId
Guid

特定のスナップショットを参照する ID。

objectId
String

スナップショットから作成するユーザー指定のターゲット オブジェクト ID。

mode
SnapshotApplyMode

スナップショット適用モード。 現在、CreateNew のみがサポートされています。つまり、ターゲット サブスクリプションに同じ種類のオブジェクトが既に含まれており、同じ objectId を使用している場合、適用操作は失敗します。 ユーザーは、このような競合を回避するために、要求本文で "objectId" を指定できます。 使用可能な値は次のとおりです: 'CreateNew'

cancellationToken
CancellationToken

キャンセル トークン。

戻り値

適用対象