Person Group Operations - Get Person Group

Service:

Azure AI Services

Version d'API:

v1.2-preview.1

Récupérer le nom du groupe de personnes, userData et recognitionModel. Pour obtenir des informations sur les personnes sous ce groupe de personnes, utilisez « Obtenir des personnes de groupe de personnes ».

GET {endpoint}/face/{apiVersion}/persongroups/{personGroupId}

Avec des paramètres facultatifs:

GET {endpoint}/face/{apiVersion}/persongroups/{personGroupId}?returnRecognitionModel={returnRecognitionModel}

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
apiVersion	path	True	string	Version de l’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. Modèle d’expression régulière: ^[a-z0-9-_]+$
returnRecognitionModel	query		boolean	Retournez « recognitionModel » ou non. La valeur par défaut est false.

Réponses

Nom	Type	Description
200 OK	PersonGroup	Un appel réussi retourne les informations du groupe de personnes.
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

Get PersonGroup

Exemple de requête

HTTP

GET {endpoint}/face/v1.2-preview.1/persongroups/your_person_group_id?returnRecognitionModel=True

Exemple de réponse

Code d’état:

200

{
  "name": "your_person_group_name",
  "userData": "your_user_data",
  "recognitionModel": "recognition_01",
  "personGroupId": "your_person_group_id"
}

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.
PersonGroup	Conteneur des données de personne chargées, y compris la fonctionnalité de reconnaissance faciale, et jusqu’à 10 000 personnes. Pour gérer un problème d’identification des visages à grande échelle, envisagez d’utiliser un groupe de personnes volumineux.
RecognitionModel	Modèle de reconnaissance pour le visage.

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.

PersonGroup

Conteneur des données de personne chargées, y compris la fonctionnalité de reconnaissance faciale, et jusqu’à 10 000 personnes. Pour gérer un problème d’identification des visages à grande échelle, envisagez d’utiliser un groupe de personnes volumineux.

Nom	Type	Description
name	string	Nom défini par l’utilisateur, la longueur maximale est 128.
personGroupId	string	ID du conteneur.
recognitionModel	RecognitionModel	Nom du modèle de reconnaissance. Le modèle de reconnaissance est utilisé lorsque les fonctionnalités du visage sont extraites et associées à des visages détectés.
userData	string	Données définies par l’utilisateur facultatives. La longueur ne doit pas dépasser 16 Ko.

RecognitionModel

Modèle de reconnaissance pour le visage.

Nom	Type	Description
recognition_01	string	Modèle de reconnaissance par défaut pour « Détecter ». Tous ces faceIds créés avant mars 2019 sont liés à ce modèle de reconnaissance.
recognition_02	string	Modèle de reconnaissance publié en mars 2019.
recognition_03	string	Modèle de reconnaissance publié en mai 2020.
recognition_04	string	Modèle de reconnaissance publié en février 2021. Il est recommandé d’utiliser ce modèle de reconnaissance pour une meilleure précision de reconnaissance.