Person Directory Operations - Create Dynamic Person Group

Servizio:

Azure AI Services

Versione API:

v1.2-preview.1

Crea un nuovo gruppo di persone dinamiche con dynamicPersonGroupId, nome e utente specificato dall'utenteData.
Un gruppo di persone dinamiche è un contenitore che fa riferimento alla directory person "Create Person". Dopo la creazione, usare la directory delle persone "Aggiorna gruppo di persone dinamiche" per aggiungere/rimuovere persone da/verso il gruppo di persone dinamiche.

I dati dinamici di Person Group e utente verranno archiviati nel server finché non viene chiamato "Delete Dynamic Person Group" (Elimina gruppo di persone dinamiche). Usare "Identify From Dynamic Person Group" con il parametro dynamicPersonGroupId per identificare le persone.

Nessuna immagine verrà archiviata. Solo le caratteristiche del viso estratte e userData verranno archiviate nel server fino a quando non viene chiamato "Delete Person" o "Delete Person Face".

'recognitionModel' non deve essere specificato con i gruppi di persone dinamici. I gruppi di persone dinamici sono riferimenti alla directory delle persone "Crea persona" e quindi funzionano con la maggior parte di tutti i "recognitionModel". Il faceId specificato durante "Identificare" determina il "recognitionModel" usato.

PUT {endpoint}/face/{apiVersion}/dynamicpersongroups/{dynamicPersonGroupId}

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
apiVersion	path	True	string	Versione API
dynamicPersonGroupId	path	True	string	ID del gruppo di persone dinamiche. Criterio di espressione regolare: ^[a-z0-9-_]+$
endpoint	path	True	string uri	Endpoint di Servizi cognitivi supportati (protocollo e nome host, ad esempio: https://{nome-risorsa}.cognitiveservices.azure.com).

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
name	True	string	Il nome definito dall'utente, la lunghezza massima è 128.
userData		string	Dati facoltativi definiti dall'utente. La lunghezza non deve superare 16.000.

Risposte

Nome	Tipo	Descrizione
200 OK		La richiesta ha avuto esito positivo.
Other Status Codes	FaceErrorResponse	Risposta di errore imprevista. Intestazioni x-ms-error-code: string

Sicurezza

Ocp-Apim-Subscription-Key

Chiave privata per la sottoscrizione di Viso di Intelligenza artificiale di Azure.

Tipo: apiKey
In: header

AADToken

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: accessCode
URL di autorizzazione: https://api.example.com/oauth2/authorize
URL token: https://api.example.com/oauth2/token

Ambiti

Nome	Descrizione
https://cognitiveservices.azure.com/.default

Esempio

Create DynamicPersonGroup

Esempio di richiesta

HTTP

PUT {endpoint}/face/v1.2-preview.1/dynamicpersongroups/your_dynamic_person_group_id

{
  "name": "your_dynamic_person_group_name",
  "userData": "your_user_data"
}

Risposta di esempio

Codice di stato:

200

Definizioni

Nome	Descrizione
FaceError	Oggetto error. Per informazioni dettagliate sui codici di errore e i messaggi restituiti dal servizio Viso, vedere il collegamento seguente: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Risposta contenente i dettagli dell'errore.

FaceError

Oggetto error. Per informazioni dettagliate sui codici di errore e i messaggi restituiti dal servizio Viso, vedere il collegamento seguente: https://aka.ms/face-error-codes-and-messages.

Nome	Tipo	Descrizione
code	string	Uno di un set definito dal server di codici di errore.
message	string	Rappresentazione leggibile dell'errore.

FaceErrorResponse

Risposta contenente i dettagli dell'errore.

Nome	Tipo	Descrizione
error	FaceError	Oggetto error.