Person Group Operations - Create Person Group Person

Service:

Azure AI Services

API Version:

v1.1-preview.1

Create une nouvelle personne dans un groupe de personnes spécifié. Pour ajouter un visage à cette personne, appelez « Ajouter un visage de personne de groupe de personnes ».

Notes

• • Quota d’abonnement de niveau gratuit :
    • 1 000 personnes dans toutes les personnes Groupes.
  • Quota d’abonnement de niveau S0 :
    • 10 000 personnes par groupe de personnes.
    • 1 000 000 Groupes de personnes.
    • 100.000.000 personnes en tout Groupes.

POST {endpoint}/face/{apiVersion}/persongroups/{personGroupId}/persons

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
apiVersion	path	True	string	Version d'API
endpoint	path	True	string uri	Points de terminaison Cognitive Services pris en charge (protocole et nom d’hôte, par exemple : https://{nom-ressource}.cognitiveservices.azure.com).
personGroupId	path	True	string	ID du conteneur. Regex pattern: ^[a-z0-9-_]+$

Corps de la demande

Nom	Obligatoire	Type	Description
name	True	string	Nom défini par l’utilisateur, la longueur maximale est 128.
userData		string	Données facultatives définies par l’utilisateur. La longueur ne doit pas dépasser 16 000.

Réponses

Nom	Type	Description
200 OK	CreatePersonResult	Un appel réussi retourne un nouvel id de personne créé.
Other Status Codes	FaceErrorResponse	Réponse d’erreur inattendue. Headers x-ms-error-code: string

Sécurité

Ocp-Apim-Subscription-Key

Clé secrète de votre abonnement Azure AI Face.

Type: apiKey
In: header

AADToken

Flux OAuth2 Azure Active Directory

Type: oauth2
Flow: accessCode
Authorization URL: https://api.example.com/oauth2/authorize
Token URL: https://api.example.com/oauth2/token

Scopes

Nom	Description
https://cognitiveservices.azure.com/.default

Exemples

Create Person in PersonGroup

Sample Request

HTTP

POST {endpoint}/face/v1.1-preview.1/persongroups/your_person_group_id/persons

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

Sample Response

Status code:

200

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

Définitions

Nom	Description
CreatePersonResult	Réponse de la personne de création.
FaceError	Objet d’erreur. Pour plus d’informations sur les codes d’erreur et les messages retournés par le service Visage, reportez-vous au lien suivant : https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Réponse contenant les détails de l’erreur.

CreatePersonResult

Réponse de la personne de création.

Nom	Type	Description
personId	string	ID de personne de la personne.

FaceError

Objet d’erreur. Pour plus d’informations sur les codes d’erreur et les messages retournés par le service Visage, reportez-vous au lien suivant : https://aka.ms/face-error-codes-and-messages.

Nom	Type	Description
code	string	Un des codes d’erreur définis par le serveur.
message	string	Représentation lisible par l’homme de l’erreur.

FaceErrorResponse

Réponse contenant les détails de l’erreur.

Nom	Type	Description
error	FaceError	Objet d’erreur.