SnapshotOperations class
Classe che rappresenta uno SnapshotOperations.
Costruttori
| Snapshot |
Creare snapshotOperations. |
Metodi
| apply(string, string, Service |
|
| apply(string, string, Snapshot |
Inviare un'operazione per applicare uno snapshot alla sottoscrizione corrente. Per ogni snapshot, solo le sottoscrizioni incluse in applyScope of Snapshot - Take possono applicarle.
|
| apply(string, string, Snapshot |
|
| delete |
Eliminare uno snapshot esistente in base allo snapshotId. Verranno eliminati anche tutti i dati e le informazioni dell'oggetto nello snapshot. Solo la sottoscrizione di origine che ha creato lo snapshot può eliminare lo snapshot. Se l'utente non elimina uno snapshot con questa API, lo snapshot verrà comunque eliminato automaticamente in 48 ore dopo la creazione. |
| delete |
|
| delete |
|
| get(string, Request |
Recuperare informazioni su uno snapshot. Lo snapshot è accessibile solo alla sottoscrizione di origine che lo ha usato e alle sottoscrizioni di destinazione incluse in applyScope in Snapshot - Take. |
| get(string, Request |
|
| get(string, Service |
|
| get |
Recuperare lo stato di un'operazione di acquisizione/applicazione dello snapshot. |
| get |
|
| get |
|
| list(Service |
|
| list(Snapshot |
Elencare tutti gli snapshot accessibili con informazioni correlate, inclusi gli snapshot acquisiti dall'utente o gli snapshot da applicare all'utente (l'ID sottoscrizione è stato incluso in applyScope in Snapshot - Take). |
| list(Snapshot |
|
| take(Snapshot |
|
| take(Snapshot |
Inviare un'operazione per creare uno snapshot dell'elenco dei visi, un elenco di visi di grandi dimensioni, un gruppo di persone o un gruppo di persone di grandi dimensioni, con tipo di snapshot specificato dall'utente, ID oggetto di origine, ambito di applicazione e dati utente facoltativi.
|
| take(Snapshot |
|
| update(string, Service |
|
| update(string, Snapshot |
Aggiornare le informazioni di uno snapshot. Solo la sottoscrizione di origine che ha eseguito lo snapshot può aggiornare lo snapshot. |
| update(string, Snapshot |
Dettagli costruttore
SnapshotOperations(FaceClientContext)
Creare snapshotOperations.
new SnapshotOperations(client: FaceClientContext)Parametri
- client
- FaceClientContext
Riferimento al client del servizio.
Dettagli metodo
apply(string, string, ServiceCallback<void>)
function apply(snapshotId: string, objectId: string, callback: ServiceCallback<void>)Parametri
- snapshotId
-
string
ID che fa riferimento a uno snapshot specifico.
- objectId
-
string
ID oggetto di destinazione specificato dall'utente da creare dallo snapshot.
- callback
-
ServiceCallback<void>
Callback
apply(string, string, SnapshotApplyOptionalParams)
Inviare un'operazione per applicare uno snapshot alla sottoscrizione corrente. Per ogni snapshot, solo le sottoscrizioni incluse in applyScope of Snapshot - Take possono applicarle.
Le interfacce snapshot consentono agli utenti di eseguire il backup e ripristinare i dati dei visi da una sottoscrizione viso a un'altra, all'interno della stessa area o tra aree. Il flusso di lavoro contiene due fasi, l'utente chiama prima Snapshot: crea una copia dell'oggetto di origine e la archivia come snapshot, quindi chiama Snapshot - Applica per incollare lo snapshot alla sottoscrizione di destinazione. Gli snapshot vengono archiviati in una posizione centralizzata (per ogni istanza di Azure), in modo che possano essere applicati tra account e aree.
L'applicazione dello snapshot è un'operazione asincrona. Un ID operazione può essere ottenuto dal campo "Operation-Location" nell'intestazione della risposta, da usare in OperationStatus - Ottenere per tenere traccia dello stato di avanzamento dell'applicazione dello snapshot. L'ID oggetto di destinazione verrà incluso nel campo "resourceLocation" in OperationStatus - Ottieni risposta quando lo stato dell'operazione è "riuscito".
Il tempo di applicazione dello snapshot dipende dal numero di voci di persona e viso nell'oggetto snapshot.
Potrebbe essere in secondi o fino a 1 ora per 1.000.000 persone con più visi.
Gli snapshot verranno automaticamente scaduti e puliti in 48 ore dopo la creazione da snapshot
- Prendere. La sottoscrizione di destinazione è quindi necessaria per applicare lo snapshot in 48 ore dalla creazione.
L'applicazione di uno snapshot non blocca altre operazioni sull'oggetto di destinazione, ma non è consigliabile perché non è possibile garantire la correttezza durante l'applicazione dello snapshot. Al termine dell'applicazione dello snapshot, tutte le operazioni verso l'oggetto di destinazione possono funzionare normalmente. Lo snapshot include anche i risultati del training dell'oggetto di origine, ovvero la sottoscrizione di destinazione a cui lo snapshot applicato non richiede di ripetere il training dell'oggetto di destinazione prima di chiamare Identify/FindSimilar.
Uno snapshot può essere applicato più volte in parallelo, mentre attualmente è supportata solo la modalità di applicazione CreateNew, il che significa che l'operazione di applicazione avrà esito negativo se la sottoscrizione di destinazione contiene già un oggetto dello stesso tipo e usa lo stesso objectId. Gli utenti possono specificare "objectId" nel corpo della richiesta per evitare tali conflitti.
- Quota di sottoscrizione a livello gratuito: 100 applicano operazioni al mese.
- Quota di sottoscrizione a livello S0: 100 operazioni vengono applicate al giorno.
function apply(snapshotId: string, objectId: string, options?: SnapshotApplyOptionalParams): Promise<SnapshotApplyResponse>Parametri
- snapshotId
-
string
ID che fa riferimento a uno snapshot specifico.
- objectId
-
string
ID oggetto di destinazione specificato dall'utente da creare dallo snapshot.
- options
- SnapshotApplyOptionalParams
Parametri facoltativi
Restituisce
Promise<SnapshotApplyResponse>
Promise<Models.SnapshotApplyResponse>
apply(string, string, SnapshotApplyOptionalParams, ServiceCallback<void>)
function apply(snapshotId: string, objectId: string, options: SnapshotApplyOptionalParams, callback: ServiceCallback<void>)Parametri
- snapshotId
-
string
ID che fa riferimento a uno snapshot specifico.
- objectId
-
string
ID oggetto di destinazione specificato dall'utente da creare dallo snapshot.
- options
- SnapshotApplyOptionalParams
Parametri facoltativi
- callback
-
ServiceCallback<void>
Callback
deleteMethod(string, RequestOptionsBase)
Eliminare uno snapshot esistente in base allo snapshotId. Verranno eliminati anche tutti i dati e le informazioni dell'oggetto nello snapshot. Solo la sottoscrizione di origine che ha creato lo snapshot può eliminare lo snapshot. Se l'utente non elimina uno snapshot con questa API, lo snapshot verrà comunque eliminato automaticamente in 48 ore dopo la creazione.
function deleteMethod(snapshotId: string, options?: RequestOptionsBase): Promise<RestResponse>Parametri
- snapshotId
-
string
ID che fa riferimento a uno snapshot specifico.
- options
- RequestOptionsBase
Parametri facoltativi
Restituisce
Promise<RestResponse>
Promise<msRest.RestResponse>
deleteMethod(string, RequestOptionsBase, ServiceCallback<void>)
function deleteMethod(snapshotId: string, options: RequestOptionsBase, callback: ServiceCallback<void>)Parametri
- snapshotId
-
string
ID che fa riferimento a uno snapshot specifico.
- options
- RequestOptionsBase
Parametri facoltativi
- callback
-
ServiceCallback<void>
Callback
deleteMethod(string, ServiceCallback<void>)
function deleteMethod(snapshotId: string, callback: ServiceCallback<void>)Parametri
- snapshotId
-
string
ID che fa riferimento a uno snapshot specifico.
- callback
-
ServiceCallback<void>
Callback
get(string, RequestOptionsBase)
Recuperare informazioni su uno snapshot. Lo snapshot è accessibile solo alla sottoscrizione di origine che lo ha usato e alle sottoscrizioni di destinazione incluse in applyScope in Snapshot - Take.
function get(snapshotId: string, options?: RequestOptionsBase): Promise<SnapshotGetResponse>Parametri
- snapshotId
-
string
ID che fa riferimento a uno snapshot specifico.
- options
- RequestOptionsBase
Parametri facoltativi
Restituisce
Promise<SnapshotGetResponse>
Promise<Models.SnapshotGetResponse>
get(string, RequestOptionsBase, ServiceCallback<Snapshot>)
function get(snapshotId: string, options: RequestOptionsBase, callback: ServiceCallback<Snapshot>)Parametri
- snapshotId
-
string
ID che fa riferimento a uno snapshot specifico.
- options
- RequestOptionsBase
Parametri facoltativi
- callback
Callback
get(string, ServiceCallback<Snapshot>)
function get(snapshotId: string, callback: ServiceCallback<Snapshot>)Parametri
- snapshotId
-
string
ID che fa riferimento a uno snapshot specifico.
- callback
Callback
getOperationStatus(string, RequestOptionsBase)
Recuperare lo stato di un'operazione di acquisizione/applicazione dello snapshot.
function getOperationStatus(operationId: string, options?: RequestOptionsBase): Promise<SnapshotGetOperationStatusResponse>Parametri
- operationId
-
string
ID che fa riferimento a una particolare operazione di acquisizione/applicazione dello snapshot.
- options
- RequestOptionsBase
Parametri facoltativi
Restituisce
Promise<SnapshotGetOperationStatusResponse>
Promise<Models.SnapshotGetOperationStatusResponse>
getOperationStatus(string, RequestOptionsBase, ServiceCallback<OperationStatus>)
function getOperationStatus(operationId: string, options: RequestOptionsBase, callback: ServiceCallback<OperationStatus>)Parametri
- operationId
-
string
ID che fa riferimento a una particolare operazione di acquisizione/applicazione dello snapshot.
- options
- RequestOptionsBase
Parametri facoltativi
- callback
Callback
getOperationStatus(string, ServiceCallback<OperationStatus>)
function getOperationStatus(operationId: string, callback: ServiceCallback<OperationStatus>)Parametri
- operationId
-
string
ID che fa riferimento a una particolare operazione di acquisizione/applicazione dello snapshot.
- callback
Callback
list(ServiceCallback<Snapshot[]>)
function list(callback: ServiceCallback<Snapshot[]>)Parametri
- callback
Callback
list(SnapshotListOptionalParams)
Elencare tutti gli snapshot accessibili con informazioni correlate, inclusi gli snapshot acquisiti dall'utente o gli snapshot da applicare all'utente (l'ID sottoscrizione è stato incluso in applyScope in Snapshot - Take).
function list(options?: SnapshotListOptionalParams): Promise<SnapshotListResponse>Parametri
- options
- SnapshotListOptionalParams
Parametri facoltativi
Restituisce
Promise<SnapshotListResponse>
Promise<Models.SnapshotListResponse>
list(SnapshotListOptionalParams, ServiceCallback<Snapshot[]>)
function list(options: SnapshotListOptionalParams, callback: ServiceCallback<Snapshot[]>)Parametri
- options
- SnapshotListOptionalParams
Parametri facoltativi
- callback
Callback
take(SnapshotObjectType, string, string[], ServiceCallback<void>)
function take(type: SnapshotObjectType, objectId: string, applyScope: string[], callback: ServiceCallback<void>)Parametri
- type
- SnapshotObjectType
Tipo specificato dall'utente per l'oggetto di origine da cui eseguire lo snapshot. Attualmente sono supportati FaceList, PersonGroup, LargeFaceList e LargePersonGroup. I valori possibili includono: 'FaceList', 'LargeFaceList', 'LargePersonGroup', 'PersonGroup'
- objectId
-
string
ID oggetto di origine specificato dall'utente da cui creare uno snapshot.
- applyScope
-
string[]
Matrice specificata dall'utente degli ID sottoscrizione viso di destinazione per lo snapshot. Per ogni snapshot, solo le sottoscrizioni incluse in applyScope of Snapshot - Take possono applicarle.
- callback
-
ServiceCallback<void>
Callback
take(SnapshotObjectType, string, string[], SnapshotTakeOptionalParams)
Inviare un'operazione per creare uno snapshot dell'elenco dei visi, un elenco di visi di grandi dimensioni, un gruppo di persone o un gruppo di persone di grandi dimensioni, con tipo di snapshot specificato dall'utente, ID oggetto di origine, ambito di applicazione e dati utente facoltativi.
Le interfacce snapshot consentono agli utenti di eseguire il backup e ripristinare i dati dei visi da una sottoscrizione viso a un'altra, all'interno della stessa area o tra aree. Il flusso di lavoro contiene due fasi, l'utente chiama prima Snapshot: crea una copia dell'oggetto di origine e la archivia come snapshot, quindi chiama Snapshot - Applica per incollare lo snapshot alla sottoscrizione di destinazione. Gli snapshot vengono archiviati in una posizione centralizzata (per ogni istanza di Azure), in modo che possano essere applicati tra account e aree.
La creazione di snapshot è un'operazione asincrona. Un ID operazione può essere ottenuto dal campo "Operation-Location" nell'intestazione della risposta, da usare in OperationStatus - Ottenere per tenere traccia dello stato di avanzamento della creazione dello snapshot. L'ID snapshot verrà incluso nel campo "resourceLocation" in OperationStatus - Ottenere risposta quando lo stato dell'operazione è "riuscito".
La creazione di snapshot dipende dal numero di voci di persona e viso nell'oggetto di origine. Potrebbe essere in secondi o fino a diverse ore per 1.000.000 persone con più visi.
Gli snapshot verranno automaticamente scaduti e puliti in 48 ore dopo la creazione da snapshot
- Prendere. L'utente può eliminare lo snapshot usando Snapshot - Elimina da solo in qualsiasi momento prima della scadenza.
La creazione di snapshot per un determinato oggetto non blocca altre operazioni sull'oggetto. Tutte le operazioni di sola lettura (Get/List e Identify/FindSimilar/Verify) possono essere eseguite come di consueto. Per tutte le operazioni scrivibili, tra cui Add/Update/Delete, l'oggetto di origine o le relative persone/visi e Train, non vengono bloccati ma non consigliati perché gli aggiornamenti scrivibili potrebbero non essere riflessi sullo snapshot durante l'acquisizione. Al termine dell'acquisizione di snapshot, tutte le operazioni leggibili e scrivibili possono funzionare normalmente. Lo snapshot include anche i risultati del training dell'oggetto di origine, il che significa che la sottoscrizione di destinazione applicata allo snapshot a non richiede di ripetere il training dell'oggetto di destinazione prima di chiamare Identify/FindSimilar.
- Quota di sottoscrizione a livello gratuito: 100 operazioni al mese.
- Quota di sottoscrizione a livello S0: 100 operazioni al giorno.
function take(type: SnapshotObjectType, objectId: string, applyScope: string[], options?: SnapshotTakeOptionalParams): Promise<SnapshotTakeResponse>Parametri
- type
- SnapshotObjectType
Tipo specificato dall'utente per l'oggetto di origine da cui eseguire lo snapshot. Attualmente sono supportati FaceList, PersonGroup, LargeFaceList e LargePersonGroup. I valori possibili includono: 'FaceList', 'LargeFaceList', 'LargePersonGroup', 'PersonGroup'
- objectId
-
string
ID oggetto di origine specificato dall'utente da cui eseguire lo snapshot.
- applyScope
-
string[]
Matrice specificata dall'utente degli ID sottoscrizione Viso di destinazione per lo snapshot. Per ogni snapshot, solo le sottoscrizioni incluse nell'oggetto applyScope of Snapshot - Take possono applicarle.
- options
- SnapshotTakeOptionalParams
Parametri facoltativi
Restituisce
Promise<SnapshotTakeResponse>
Promise<Models.SnapshotTakeResponse>
take(SnapshotObjectType, string, string[], SnapshotTakeOptionalParams, ServiceCallback<void>)
function take(type: SnapshotObjectType, objectId: string, applyScope: string[], options: SnapshotTakeOptionalParams, callback: ServiceCallback<void>)Parametri
- type
- SnapshotObjectType
Tipo specificato dall'utente per l'oggetto di origine da cui eseguire lo snapshot. Attualmente Sono supportati FaceList, PersonGroup, LargeFaceList e LargePersonGroup. I valori possibili includono: 'FaceList', 'LargeFaceList', 'LargePersonGroup', 'PersonGroup'
- objectId
-
string
ID oggetto di origine specificato dall'utente da cui eseguire lo snapshot.
- applyScope
-
string[]
Matrice specificata dall'utente degli ID sottoscrizione Viso di destinazione per lo snapshot. Per ogni snapshot, solo le sottoscrizioni incluse nell'oggetto applyScope of Snapshot - Take possono applicarle.
- options
- SnapshotTakeOptionalParams
Parametri facoltativi
- callback
-
ServiceCallback<void>
Callback
update(string, ServiceCallback<void>)
function update(snapshotId: string, callback: ServiceCallback<void>)Parametri
- snapshotId
-
string
ID che fa riferimento a uno snapshot specifico.
- callback
-
ServiceCallback<void>
Callback
update(string, SnapshotUpdateOptionalParams)
Aggiornare le informazioni di uno snapshot. Solo la sottoscrizione di origine che ha eseguito lo snapshot può aggiornare lo snapshot.
function update(snapshotId: string, options?: SnapshotUpdateOptionalParams): Promise<RestResponse>Parametri
- snapshotId
-
string
ID che fa riferimento a uno snapshot specifico.
- options
- SnapshotUpdateOptionalParams
Parametri facoltativi
Restituisce
Promise<RestResponse>
Promise<msRest.RestResponse>
update(string, SnapshotUpdateOptionalParams, ServiceCallback<void>)
function update(snapshotId: string, options: SnapshotUpdateOptionalParams, callback: ServiceCallback<void>)Parametri
- snapshotId
-
string
ID che fa riferimento a uno snapshot specifico.
- options
- SnapshotUpdateOptionalParams
Parametri facoltativi
- callback
-
ServiceCallback<void>
Callback