SnapshotOperationsExtensions クラス

定義

SnapshotOperations の拡張メソッド。

public static class SnapshotOperationsExtensions
type SnapshotOperationsExtensions = class
Public Module SnapshotOperationsExtensions
継承
SnapshotOperationsExtensions

メソッド

ApplyAsync(ISnapshotOperations, Guid, String, SnapshotApplyMode, CancellationToken)

現在のサブスクリプションにスナップショットを適用する操作を送信します。 スナップショットごとに、スナップショットの 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 個の操作が適用されます。
DeleteAsync(ISnapshotOperations, Guid, CancellationToken)

snapshotId に従って既存のスナップショットを削除します。 スナップショット内のすべてのオブジェクト データと情報も削除されます。 スナップショットを取得したソース サブスクリプションのみがスナップショットを削除できます。 ユーザーがこの API でスナップショットを削除しない場合でも、スナップショットは作成後 48 時間以内に自動的に削除されます。

GetAsync(ISnapshotOperations, Guid, CancellationToken)

スナップショットに関する情報を取得します。 スナップショットには、スナップショットを取得したソース サブスクリプションと、スナップショット - Take の applyScope に含まれるターゲット サブスクリプションのみがアクセスできます。

GetOperationStatusAsync(ISnapshotOperations, Guid, CancellationToken)

取得/適用スナップショット操作の状態を取得します。

ListAsync(ISnapshotOperations, Nullable<SnapshotObjectType>, IList<Guid>, CancellationToken)

ユーザーが取得したスナップショット、またはユーザーに適用されるスナップショット (サブスクリプション ID がスナップショット - 取得で applyScope に含まれていた) など、関連する情報を含むすべてのアクセス可能なスナップショットを一覧表示します。

TakeAsync(ISnapshotOperations, SnapshotObjectType, String, IList<Guid>, String, CancellationToken)

ユーザー指定のスナップショットの種類、ソース オブジェクト ID、適用スコープ、およびオプションのユーザー データを使用して、顔リスト、大きな顔リスト、人物グループ、または大きな人物グループのスナップショットを取得する操作を送信します。<br /> スナップショット インターフェイスは、ユーザーが顔のデータをバックアップし、同じリージョン内またはリージョン間で、ある顔サブスクリプションから別の顔のサブスクリプションに復元するためのインターフェイスです。 ワークフローには 2 つのフェーズが含まれています。ユーザーは最初に Snapshot - Take を呼び出してソース オブジェクトのコピーを作成し、それをスナップショットとして格納し、Snapshot - Apply を呼び出してターゲット サブスクリプションにスナップショットを貼り付けます。 スナップショットは一元化された場所 (Azure インスタンスごと) に格納されるため、クロス アカウントとリージョンに適用できます。<br /> taking スナップショットは非同期操作です。 操作 ID は、応答ヘッダーの "Operation-Location" フィールドから取得でき、OperationStatus - Get で使用して、スナップショットの作成の進行状況を追跡できます。 スナップショット ID は、OperationStatus - 操作の状態が "成功" の場合に応答を取得するの "resourceLocation" フィールドに含まれます。<br /> Snapshot の時間は、ソース オブジェクト内の人物と顔のエントリの数によって異なります。 数秒で、または複数の顔を持つ 1,000,000 人の場合は最大数時間です。<br /> Snapshots は、スナップショット - Take によって作成された後、48 時間以内に自動的に期限切れになり、クリーンアップされます。 ユーザーは、有効期限の前にいつでもスナップショット - 削除を使用してスナップショットを削除できます。<br /> 特定のオブジェクトに対してスナップショットを取得しても、オブジェクトに対する他の操作はブロックされません。 すべての読み取り専用操作 (Get/List および Identify/FindSimilar/Verify) は、通常どおりに実行できます。 ソース オブジェクトまたはその人物/顔の追加/更新/削除、トレーニングなど、すべての書き込み可能な操作ではブロックされませんが、書き込み可能な更新プログラムが実行中にスナップショットに反映されない可能性があるため、推奨されません。 スナップショットの取得が完了すると、すべての読み取り可能な操作と書き込み可能な操作を通常どおりに動作させることができます。 スナップショットには、ソース オブジェクトのトレーニング結果も含まれます。つまり、スナップショット適用先のターゲット サブスクリプションは、Identify/FindSimilar を呼び出す前にターゲット オブジェクトを再トレーニングする必要はありません。<Br/>

  • Free レベルのサブスクリプション クォータ: 1 か月あたり 100 回の操作を受け取ります。
  • S0 レベルのサブスクリプション クォータ: 1 日あたり 100 回の操作を受け取ります。
UpdateAsync(ISnapshotOperations, Guid, IList<Guid>, String, CancellationToken)

スナップショットの情報を更新します。 スナップショットを取得したソース サブスクリプションのみがスナップショットを更新できます。

適用対象