Person Group Operations - Create Large Person Group Person

Servizio:

Azure AI Services

Versione API:

v1.2-preview.1

Creare una nuova persona in un gruppo di persone large specificato. Per aggiungere il viso a questa persona, chiama "Add Large Person Group Person Face".

Nota

• • Quota di sottoscrizione a livello gratuito:
    • 1.000 persone in tutti i gruppi di persone di grandi dimensioni.
  • Quota di sottoscrizione a livello S0:
    • 1.000.000 persone per gruppo di persone di grandi dimensioni.
    • 1.000.000 gruppi di persone di grandi dimensioni.
    • 1.000.000.000 persone in tutti i gruppi di persone di grandi dimensioni.

POST {endpoint}/face/{apiVersion}/largepersongroups/{largePersonGroupId}/persons

Parametri dell'URI

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

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	CreatePersonResult	Una chiamata con esito positivo restituisce un nuovo personId creato.
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 Person in LargePersonGroup

Esempio di richiesta

HTTP

POST {endpoint}/face/v1.2-preview.1/largepersongroups/your_large_person_group_id/persons

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

Risposta di esempio

Codice di stato:

200

{
  "personId": "25985303-c537-4467-b41d-bdb45cd95ca1"
}

Definizioni

Nome	Descrizione
CreatePersonResult	Risposta della persona di creazione.
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.

CreatePersonResult

Risposta della persona di creazione.

Nome	Tipo	Descrizione
personId	string	ID persona della persona.

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.