Person Group Operations - Get Person Group Person Face

Service:

Azure AI Services

API-versie:

v1.2-preview.1

Persoonlijke gezichtsinformatie ophalen. Het persistente gezicht van de persoon wordt opgegeven door de personGroupId, personId en persistentedFaceId.

GET {endpoint}/face/{apiVersion}/persongroups/{personGroupId}/persons/{personId}/persistedfaces/{persistedFaceId}

URI-parameters

Name	In	Vereist	Type	Description
apiVersion	path	True	string	API-versie
endpoint	path	True	string (uri)	Ondersteunde Cognitive Services-eindpunten (protocol en hostnaam, bijvoorbeeld: https://{resource-name}.cognitiveservices.azure.com).
persistedFaceId	path	True	string (uuid)	Face ID van het gezicht.
personGroupId	path	True	string minLength: 1 maxLength: 64 pattern: ^[a-z0-9-_]+$	Id van de container.
personId	path	True	string (uuid)	Id van de persoon.

Antwoorden

Name	Type	Description
200 OK	PersonGroupPersonFace	Een geslaagde aanroep retourneert de doelgegevens van het gezicht (persistentedFaceId en userData).
Other Status Codes	FaceErrorResponse	Een onverwachte foutreactie. Kopteksten x-ms-error-code: string

Beveiliging

Ocp-Apim-Subscription-Key

De geheime sleutel voor uw Azure AI Face-abonnement.

Type: apiKey
In: header

AADToken

De Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: accessCode
Autorisatie-URL: https://api.example.com/oauth2/authorize
Token-URL: https://api.example.com/oauth2/token

Bereiken

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

Voorbeelden

Get Face form PersonGroup Person

Voorbeeldaanvraag

HTTP

GET {endpoint}/face/v1.2-preview.1/persongroups/your_person_group_id/persons/25985303-c537-4467-b41d-bdb45cd95ca1/persistedfaces/43897a75-8d6f-42cf-885e-74832febb055

Voorbeeldrespons

Statuscode:

200

{
  "persistedFaceId": "43897a75-8d6f-42cf-885e-74832febb055",
  "userData": "your_user_data"
}

Definities

Name	Description
FaceError	Het foutobject. Raadpleeg de volgende koppeling voor uitgebreide informatie over foutcodes en berichten die worden geretourneerd door de Face-service: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Een antwoord met foutdetails.
PersonGroupPersonFace	Gezichtsresource voor persoonsgroep persoon.

FaceError

Object

Het foutobject. Raadpleeg de volgende koppeling voor uitgebreide informatie over foutcodes en berichten die worden geretourneerd door de Face-service: https://aka.ms/face-error-codes-and-messages.

Name	Type	Description
code	string	Een van een door de server gedefinieerde set foutcodes.
message	string	Een leesbare weergave van de fout.

FaceErrorResponse

Object

Een antwoord met foutdetails.

Name	Type	Description
error	FaceError	Het foutobject.

PersonGroupPersonFace

Object

Gezichtsresource voor persoonsgroep persoon.

Name	Type	Description
persistedFaceId	string (uuid)	Face ID van het gezicht.
userData	string maxLength: 1024	Door de gebruiker verstrekte gegevens die aan het gezicht zijn gekoppeld. De lengtelimiet is 1K.