ISnapshotOperations インターフェイス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
SnapshotOperations 操作。
public interface ISnapshotOperationstype ISnapshotOperations = interfacePublic Interface ISnapshotOperations- 派生
メソッド
| ApplyWithHttpMessagesAsync(Guid, String, SnapshotApplyMode, Dictionary<String,List<String>>, CancellationToken) |
現在のサブスクリプションにスナップショットを適用する操作を送信します。 スナップショットごとに、スナップショットの 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/>
|
| DeleteWithHttpMessagesAsync(Guid, Dictionary<String,List<String>>, CancellationToken) |
snapshotId に従って既存のスナップショットを削除します。 スナップショット内のすべてのオブジェクト データと情報も削除されます。 スナップショットを取得したソース サブスクリプションのみがスナップショットを削除できます。 ユーザーがこの API を使用してスナップショットを削除しない場合でも、スナップショットは作成後 48 時間以内に自動的に削除されます。 |
| GetOperationStatusWithHttpMessagesAsync(Guid, Dictionary<String,List<String>>, CancellationToken) |
take/apply スナップショット操作の状態を取得します。 |
| GetWithHttpMessagesAsync(Guid, Dictionary<String,List<String>>, CancellationToken) |
スナップショットに関する情報を取得します。 スナップショットには、スナップショットを取得したソース サブスクリプションと、スナップショット - 取得で applyScope に含まれるターゲット サブスクリプションのみがアクセスできます。 |
| ListWithHttpMessagesAsync(Nullable<SnapshotObjectType>, IList<Guid>, Dictionary<String,List<String>>, CancellationToken) |
ユーザーが取得したスナップショット、またはユーザーに適用するスナップショット (サブスクリプション ID が[スナップショット - 取得] の applyScope に含まれていた) など、関連情報を含むすべてのアクセス可能なスナップショットを一覧表示します。 |
| TakeWithHttpMessagesAsync(SnapshotObjectType, String, IList<Guid>, String, Dictionary<String,List<String>>, CancellationToken) |
ユーザー指定のスナップショットの種類、ソース オブジェクト ID、スコープの適用、オプションのユーザー データを使用して、顔リスト、大きな顔リスト、人物グループ、または大きな人物グループのスナップショットを実行する操作を送信します。<br /> スナップショット インターフェイスは、ユーザーが顔データを 1 つの顔サブスクリプションから別の顔サブスクリプション、同じリージョン内、またはリージョン間でバックアップおよび復元するためのインターフェイスです。 ワークフローには 2 つのフェーズが含まれています。ユーザーは最初に Snapshot - Take を呼び出してソース オブジェクトのコピーを作成し、それをスナップショットとして格納し、Snapshot - Apply を呼び出してターゲット サブスクリプションにスナップショットを貼り付けます。 スナップショットは(Azure インスタンスごとに) 一元化された場所に格納されるため、クロス アカウントとリージョンに適用できます。<br /> スナップショットの取得は非同期操作です。 操作 ID は、応答ヘッダーの "Operation-Location" フィールドから取得して、OperationStatus - Get で使用して、スナップショットの作成の進行状況を追跡できます。 スナップショット ID は、OperationStatus - 操作の状態が "成功" のときに応答を取得するの "resourceLocation" フィールドに含まれます。<br/> Snapshot taking time は、ソース オブジェクト内の人物と顔のエントリの数によって異なります。 数秒で、または複数の顔を持つ 1,000,000 人の場合は最大数時間です。<br /> Snapshots は、スナップショット - Take によって作成されてから 48 時間後に自動的に期限切れになり、クリーンアップされます。 ユーザーは、有効期限の前にいつでもスナップショット - 削除を使用してスナップショットを削除できます。<br /> 特定のオブジェクトに対してスナップショットを取得しても、オブジェクトに対する他の操作はブロックされません。 すべての読み取り専用操作 (Get/List および Identify/FindSimilar/Verify) は、通常どおり実行できます。 ソース オブジェクトまたはその人物/顔の追加/更新/削除、トレーニングなど、すべての書き込み可能な操作ではブロックされませんが、書き込み可能な更新が実行中にスナップショットに反映されない可能性があるため、推奨されません。 スナップショットの取得が完了すると、すべての読み取り可能な操作と書き込み可能な操作が正常に機能します。 スナップショットには、ソース オブジェクトのトレーニング結果も含まれます。つまり、スナップショットが適用されるターゲット サブスクリプションでは、Identify/FindSimilar を呼び出す前にターゲット オブジェクトを再トレーニングする必要はありません。<Br/>
|
| UpdateWithHttpMessagesAsync(Guid, IList<Guid>, String, Dictionary<String,List<String>>, CancellationToken) |
スナップショットの情報を更新します。 スナップショットを取得したソース サブスクリプションのみがスナップショットを更新できます。 |
拡張メソッド
| ApplyAsync(ISnapshotOperations, Guid, String, SnapshotApplyMode, CancellationToken) |
現在のサブスクリプションにスナップショットを適用する操作を送信します。 スナップショットごとに、スナップショットの 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/>
|
| DeleteAsync(ISnapshotOperations, Guid, CancellationToken) |
snapshotId に従って既存のスナップショットを削除します。 スナップショット内のすべてのオブジェクト データと情報も削除されます。 スナップショットを取得したソース サブスクリプションのみがスナップショットを削除できます。 ユーザーがこの API を使用してスナップショットを削除しない場合でも、スナップショットは作成後 48 時間以内に自動的に削除されます。 |
| GetAsync(ISnapshotOperations, Guid, CancellationToken) |
スナップショットに関する情報を取得します。 スナップショットには、スナップショットを取得したソース サブスクリプションと、スナップショット - 取得で applyScope に含まれるターゲット サブスクリプションのみがアクセスできます。 |
| GetOperationStatusAsync(ISnapshotOperations, Guid, CancellationToken) |
take/apply スナップショット操作の状態を取得します。 |
| ListAsync(ISnapshotOperations, Nullable<SnapshotObjectType>, IList<Guid>, CancellationToken) |
ユーザーが取得したスナップショット、またはユーザーに適用するスナップショット (サブスクリプション ID が[スナップショット - 取得] の applyScope に含まれていた) など、関連情報を含むすべてのアクセス可能なスナップショットを一覧表示します。 |
| TakeAsync(ISnapshotOperations, SnapshotObjectType, String, IList<Guid>, String, CancellationToken) |
ユーザー指定のスナップショットの種類、ソース オブジェクト ID、スコープの適用、オプションのユーザー データを使用して、顔リスト、大きな顔リスト、人物グループ、または大きな人物グループのスナップショットを実行する操作を送信します。<br /> スナップショット インターフェイスは、ユーザーが顔データを 1 つの顔サブスクリプションから別の顔サブスクリプション、同じリージョン内、またはリージョン間でバックアップおよび復元するためのインターフェイスです。 ワークフローには 2 つのフェーズが含まれています。ユーザーは最初に Snapshot - Take を呼び出してソース オブジェクトのコピーを作成し、それをスナップショットとして格納し、Snapshot - Apply を呼び出してターゲット サブスクリプションにスナップショットを貼り付けます。 スナップショットは(Azure インスタンスごとに) 一元化された場所に格納されるため、クロス アカウントとリージョンに適用できます。<br /> スナップショットの取得は非同期操作です。 操作 ID は、応答ヘッダーの "Operation-Location" フィールドから取得して、OperationStatus - Get で使用して、スナップショットの作成の進行状況を追跡できます。 スナップショット ID は、OperationStatus - 操作の状態が "成功" のときに応答を取得するの "resourceLocation" フィールドに含まれます。<br/> Snapshot taking time は、ソース オブジェクト内の人物と顔のエントリの数によって異なります。 数秒で、または複数の顔を持つ 1,000,000 人の場合は最大数時間です。<br /> Snapshots は、スナップショット - Take によって作成されてから 48 時間後に自動的に期限切れになり、クリーンアップされます。 ユーザーは、有効期限の前にいつでもスナップショット - 削除を使用してスナップショットを削除できます。<br /> 特定のオブジェクトに対してスナップショットを取得しても、オブジェクトに対する他の操作はブロックされません。 すべての読み取り専用操作 (Get/List および Identify/FindSimilar/Verify) は、通常どおり実行できます。 ソース オブジェクトまたはその人物/顔の追加/更新/削除、トレーニングなど、すべての書き込み可能な操作ではブロックされませんが、書き込み可能な更新が実行中にスナップショットに反映されない可能性があるため、推奨されません。 スナップショットの取得が完了すると、すべての読み取り可能な操作と書き込み可能な操作が正常に機能します。 スナップショットには、ソース オブジェクトのトレーニング結果も含まれます。つまり、スナップショットが適用されるターゲット サブスクリプションでは、Identify/FindSimilar を呼び出す前にターゲット オブジェクトを再トレーニングする必要はありません。<Br/>
|
| UpdateAsync(ISnapshotOperations, Guid, IList<Guid>, String, CancellationToken) |
スナップショットの情報を更新します。 スナップショットを取得したソース サブスクリプションのみがスナップショットを更新できます。 |
適用対象
Azure SDK for .NET
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示