SnapshotOperations.ApplyWithHttpMessagesAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
現在のサブスクリプションにスナップショットを適用する操作を送信します。 スナップショットごとに、スナップショットの applyScope - Take に含まれるサブスクリプションのみが適用できます。<br /> スナップショット インターフェイスは、ユーザーが顔データを 1 つの顔サブスクリプションから別の顔サブスクリプション、同じリージョン内、またはリージョン間でバックアップおよび復元するためのインターフェイスです。 ワークフローには 2 つのフェーズが含まれています。ユーザーは最初に Snapshot - Take を呼び出してソース オブジェクトのコピーを作成し、それをスナップショットとして格納し、Snapshot - Apply を呼び出してターゲット サブスクリプションにスナップショットを貼り付けます。 スナップショットは(Azure インスタンスごとに) 一元化された場所に格納されるため、クロス アカウントとリージョンに適用できます。<br /> スナップショットの適用は非同期操作です。 操作 ID は、応答ヘッダーの "Operation-Location" フィールドから取得して、OperationStatus - Get で使用して、スナップショットの適用の進行状況を追跡できます。 ターゲット オブジェクト ID は、OperationStatus - 操作の状態が "成功" の場合に応答を取得するの "resourceLocation" フィールドに含まれます。<br/>Snapshot の適用時間は、スナップショット オブジェクト内の人物と顔のエントリの数によって異なります。 複数の顔を持つ 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 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))パラメーター
- snapshotId
- Guid
特定のスナップショットを参照する ID。
- objectId
- String
スナップショットから作成されるユーザー指定のターゲット オブジェクト ID。
- mode
- SnapshotApplyMode
スナップショット適用モード。 現在、CreateNew のみがサポートされています。つまり、ターゲット サブスクリプションに同じ種類のオブジェクトが既に含まれており、同じ objectId を使用している場合、適用操作は失敗します。 ユーザーは、このような競合を回避するために、要求本文で "objectId" を指定できます。 使用可能な値は次のとおりです: 'CreateNew'
- customHeaders
- Dictionary<String,List<String>>
要求に追加されるヘッダー。
- cancellationToken
- CancellationToken
キャンセル トークン。
戻り値
実装
例外
操作が無効な状態コードを返したときにスローされます
必須パラメーターが null の場合にスローされます
必須パラメーターが null の場合にスローされます
適用対象
Azure SDK for .NET