Dela via

Person Group Operations - Get Person Group Person Face

  • Referens
Tjänst:
Azure AI Services
API-version:
v1.2-preview.1

Hämta ansiktsinformation för person. Det beständiga personansiktet anges av dess personGroupId, personId och persistedFaceId.

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

URI-parametrar

Name I Obligatorisk Typ Description
apiVersion
 path True

string

API-version
endpoint
 path True

string (uri)

Cognitive Services-slutpunkter som stöds (protokoll och värdnamn, till exempel: https://{resource-name}.cognitiveservices.azure.com).
persistedFaceId
 path True

string (uuid)

Ansikts-ID för ansiktet.
personGroupId
 path True

string

minLength: 1
maxLength: 64
pattern: ^[a-z0-9-_]+$

ID för containern.
personId
 path True

string (uuid)

Personens ID.

Svar

Name Typ Description
200 OK

PersonGroupPersonFace

Ett lyckat anrop returnerar information om det bevarade ansiktet (persistedFaceId och userData).
Other Status Codes

FaceErrorResponse

Ett oväntat felsvar.

Sidhuvuden

x-ms-error-code: string

Säkerhet

Ocp-Apim-Subscription-Key

Den hemliga nyckeln för din Azure AI Face-prenumeration.

Typ: apiKey
I: header

AADToken

The Azure Active Directory OAuth2 Flow

Typ: oauth2
Flow: accessCode
Auktoriseringswebbadress: https://api.example.com/oauth2/authorize
Token-webbadress: https://api.example.com/oauth2/token

Omfattningar

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

Exempel

Get Face form PersonGroup Person

Exempelbegäran

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

Exempelsvar

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

Definitioner

Name Description
FaceError

Felobjektet. Mer information om felkoder och meddelanden som returneras av ansiktstjänsten finns i följande länk: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse

Ett svar som innehåller felinformation.
PersonGroupPersonFace

Ansiktsresurs för persongruppsperson.

FaceError

Objekt

Felobjektet. Mer information om felkoder och meddelanden som returneras av ansiktstjänsten finns i följande länk: https://aka.ms/face-error-codes-and-messages.

Name Typ Description
code

string

En av en serverdefinierad uppsättning felkoder.
message

string

En mänsklig läsbar representation av felet.

FaceErrorResponse

Objekt

Ett svar som innehåller felinformation.

Name Typ Description
error

FaceError

Felobjektet.

PersonGroupPersonFace

Objekt

Ansiktsresurs för persongruppsperson.

Name Typ Description
persistedFaceId

string (uuid)

Ansikts-ID för ansiktet.
userData

string

maxLength: 1024

Användarangivna data som är kopplade till ansiktet. Längdgränsen är 1 000.