Person Directory Operations - Create Dynamic Person Group

Service:

Azure AI Services

Version d'API:

v1.2-preview.1

Crée un groupe de personnes dynamiques avec dynamicPersonGroupId, name et userData fourni par l’utilisateur.
Un groupe de personnes dynamiques est un conteneur qui fait référence au répertoire de personnes « Créer une personne ». Après la création, utilisez l’annuaire de personnes « Mettre à jour le groupe de personnes dynamiques » pour ajouter/supprimer des personnes à/à partir du groupe de personnes dynamiques.

Le groupe de personnes dynamiques et les données utilisateur sont stockés sur le serveur jusqu’à ce que l’annuaire de personnes « Supprimer le groupe de personnes dynamiques » soit appelé. Utilisez « Identifier à partir d’un groupe de personnes dynamiques » avec le paramètre dynamicPersonGroupId pour identifier les personnes.

Aucune image ne sera stockée. Seules les fonctionnalités de visage extraites de la personne et userData sont stockées sur le serveur jusqu’à ce que l’annuaire de personnes « Supprimer la personne » ou « Supprimer le visage de la personne » soit appelé.

'recognitionModel' n’a pas besoin d’être spécifié avec des groupes de personnes dynamiques. Les groupes de personnes dynamiques sont des références à l’annuaire de personnes « Créer une personne » et fonctionnent donc avec la plupart des « recognitionModels ». Les faceId fournis pendant « Identifier » déterminent le « recognitionModel » utilisé.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
apiVersion	path	True	string	Version de l’API
dynamicPersonGroupId	path	True	string	ID du groupe de personnes dynamiques. Modèle d’expression régulière: ^[a-z0-9-_]+$
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).

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 définies par l’utilisateur facultatives. La longueur ne doit pas dépasser 16 Ko.

Réponses

Nom	Type	Description
200 OK		La demande a réussi.
Other Status Codes	FaceErrorResponse	Réponse d’erreur inattendue. En-têtes x-ms-error-code: string

Sécurité

Ocp-Apim-Subscription-Key

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

Type: apiKey
Dans: header

AADToken

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: accessCode
URL d’autorisation: https://api.example.com/oauth2/authorize
URL du jeton: https://api.example.com/oauth2/token

Étendues

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

Exemples

Create DynamicPersonGroup

Exemple de requête

HTTP

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

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

Exemple de réponse

Code d’état:

200

Définitions

Nom	Description
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.

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 ensemble de 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.