SnapshotOperations class
Classe che rappresenta uno SnapshotOperations.
Costruttori
| Snapshot |
Creare uno 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 all'id snapshot. 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 l'ha impiegato 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, un ID oggetto di origine, applicare l'ambito e i dati utente facoltativi.
|
| take(Snapshot |
|
| update(string, Service |
|
| update(string, Snapshot |
Aggiornare le informazioni di uno snapshot. Solo la sottoscrizione di origine che ha creato lo snapshot può aggiornare lo snapshot. |
| update(string, Snapshot |
Dettagli costruttore
SnapshotOperations(FaceClientContext)
Creare uno 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 del viso da una sottoscrizione viso a un'altra, all'interno della stessa area o in più aree. Il flusso di lavoro contiene due fasi, ovvero 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 nella sottoscrizione di destinazione. Gli snapshot vengono archiviati in una posizione centralizzata (per 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 - Get per tenere traccia dello stato di applicazione dello snapshot. L'ID oggetto di destinazione verrà incluso nel campo "resourceLocation" in OperationStatus - Ottenere la risposta quando lo stato dell'operazione è "completato".
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ù volti.
Gli snapshot verranno automaticamente scaduti e puliti in 48 ore dopo la creazione da snapshot
- Prendere. Pertanto, la sottoscrizione di destinazione è necessaria per applicare lo snapshot in 48 ore dalla creazione.
L'applicazione di uno snapshot non bloccherà 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 deve eseguire nuovamente 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 operazioni vengono applicate 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
Valori restituiti
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 all'id snapshot. 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
Valori restituiti
Promise<RestResponse>
Prometti<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 l'ha impiegato 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
Valori restituiti
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
Valori restituiti
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
Valori restituiti
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 creare uno 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, un ID oggetto di origine, applicare l'ambito e i dati utente facoltativi.
Le interfacce snapshot consentono agli utenti di eseguire il backup e ripristinare i dati del viso da una sottoscrizione viso a un'altra, all'interno della stessa area o in più aree. Il flusso di lavoro contiene due fasi, ovvero 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 nella sottoscrizione di destinazione. Gli snapshot vengono archiviati in una posizione centralizzata (per 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 - Get per tenere traccia dello stato di avanzamento della creazione dello snapshot. L'ID snapshot verrà incluso nel campo "resourceLocation" in OperationStatus - Ottenere la risposta quando lo stato dell'operazione è "completato".
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ù volti.
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.
L'acquisizione di snapshot per un determinato oggetto non bloccherà 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, inclusi 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 includerà anche i risultati del training dell'oggetto di origine, ovvero la sottoscrizione di destinazione a cui lo snapshot applicato non richiede il nuovo 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 creare uno 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.
- options
- SnapshotTakeOptionalParams
Parametri facoltativi
Valori restituiti
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 creare uno 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.
- 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 creato 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
Valori restituiti
Promise<RestResponse>
Prometti<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