Partager via

Person Directory Operations - Get Dynamic Person Group Persons

  • Référence
Service:
Azure AI Services
Version d'API:
v1.2-preview.1

Répertorier toutes les personnes dans le groupe de personnes dynamiques spécifié.
Les personnes sont stockées dans l’ordre alphabétique de personId créé dans l’annuaire de personnes « Créer une personne ».

    • Le paramètre « start » (chaîne, facultatif) spécifie une valeur d’ID à partir de laquelle les entrées retournées auront des ID plus volumineux en fonction de la comparaison de chaînes. La définition de « start » sur une valeur vide indique que les entrées doivent être retournées à partir du premier élément.
    • Le paramètre « top » (int, facultatif) détermine le nombre maximal d’entrées à retourner, avec une limite allant jusqu’à 1 000 entrées par appel. Pour récupérer des entrées supplémentaires au-delà de cette limite, spécifiez « start » avec l’id de personne de la dernière entrée retournée dans l’appel actuel.

Pourboire

  • Par exemple, il existe au total 5 éléments avec leurs ID : « itemId1 », ..., « itemId5 ».
    • « start=&top= » retourne tous les 5 éléments.
    • « start=&top=2 » retourne « itemId1 », « itemId2 ».
    • « start=itemId2&top=3 » retourne « itemId3 », « itemId4 », « itemId5 ».
GET {endpoint}/face/{apiVersion}/dynamicpersongroups/{dynamicPersonGroupId}/persons
Avec des paramètres facultatifs: 
GET {endpoint}/face/{apiVersion}/dynamicpersongroups/{dynamicPersonGroupId}/persons?start={start}&top={top}

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).
start
 query

string

Répertorier les ressources supérieures au « start ». Il ne contient pas plus de 64 caractères. La valeur par défaut est vide.
top
 query

integer

int32

Nombre d’éléments à répertorier, compris dans [1, 1000]. La valeur par défaut est 1 000.

Réponses

Nom Type Description
200 OK

ListPersonResult

Un appel réussi retourne un tableau d’informations de personne dans l’annuaire 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 DynamicPersonGroup Persons

Exemple de requête

GET {endpoint}/face/v1.2-preview.1/dynamicpersongroups/your_dynamic_person_group_id/persons?start=00000000-0000-0000-0000-000000000000&top=20

Exemple de réponse

Code d’état:
200 
{
  "personIds": [
    "1d44651f-fadb-41f5-8918-c30609964489",
    "c1d3b745-2548-4abf-b057-a386c9bd52f1"
  ]
}

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.
ListPersonResult

Réponse de la personne de groupe de personnes dynamiques de liste.

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.

ListPersonResult

Réponse de la personne de groupe de personnes dynamiques de liste.

Nom Type Description
personIds

string[]

Tableau d’ID de personne PersonDirectory.