Large Person Group Person - Get

Service:

Azure AI Services

API-versie:

1.0

Haal de naam en userData van een persoon op en de persistente faceIds die de functie voor het gezicht van de geregistreerde persoon vertegenwoordigen.

GET {Endpoint}/face/v1.0/largepersongroups/{largePersonGroupId}/persons/{personId}

URI-parameters

Name	In	Vereist	Type	Description
Endpoint	path	True	string	Ondersteunde Cognitive Services-eindpunten (protocol en hostnaam, bijvoorbeeld: https://westus.api.cognitive.microsoft.com).
largePersonGroupId	path	True	string maxLength: 64 pattern: ^[a-z0-9-_]+$	Id die verwijst naar een bepaalde groep met grote personen.
personId	path	True	string (uuid)	Id die verwijst naar een bepaalde persoon.

Aanvraagkoptekst

Name	Vereist	Type	Description
Ocp-Apim-Subscription-Key	True	string

Antwoorden

Name	Type	Description
200 OK	Person	Een geslaagde oproep retourneert de gegevens van de persoon.
Other Status Codes	APIError	Foutreactie.

Beveiliging

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Voorbeelden

Get person example

Voorbeeldaanvraag

HTTP

GET {Endpoint}/face/v1.0/largepersongroups/abc/persons/25985303-c537-4467-b41d-bdb45cd95ca1

Voorbeeldrespons

Statuscode:

200

{
  "personId": "25985303-c537-4467-b41d-bdb45cd95ca1",
  "persistedFaceIds": [
    "015839fb-fbd9-4f79-ace9-7675fc2f1dd9",
    "fce92aed-d578-4d2e-8114-068f8af4492e",
    "b64d5e15-8257-4af2-b20a-5a750f8940e7"
  ],
  "name": "person-name",
  "userData": "User-provided data attached to the person."
}

Definities

Name	Description
APIError	Foutinformatie geretourneerd door de API
Error	Hoofdtekst van de fout.
Person	Persoonsobject.

APIError

Object

Foutinformatie geretourneerd door de API

Name	Type	Description
error	Error	Hoofdtekst van de fout.

Error

Object

Hoofdtekst van de fout.

Name	Type	Description
code	string
message	string

Person

Object

Persoonsobject.

Name	Type	Description
name	string maxLength: 128	Door de gebruiker gedefinieerde naam, de maximale lengte is 128.
persistedFaceIds	string[] (uuid)	PersistentedFaceIds van geregistreerde gezichten in de persoon. Deze persistenteFaceIds worden geretourneerd door Persoon- Een persoonsgezicht toevoegen en verlopen niet.
personId	string (uuid)	PersonId van de lijst met doel facets.
userData	string maxLength: 16384	Door de gebruiker opgegeven gegevens. De lengte mag niet groter zijn dan 16 kB.