Person Group Operations - Get Person Group Person Face

Service:

Azure AI Services

API Version:

v1.1-preview.1

Ambil informasi wajah orang. Wajah orang yang bertahan ditentukan oleh personGroupId, personId, dan persistedFaceId-nya.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
apiVersion	path	True	string	Versi API
endpoint	path	True	string uri	Titik akhir Cognitive Services yang didukung (protokol dan nama host, misalnya: https://{resource-name}.cognitiveservices.azure.com).
persistedFaceId	path	True	string uuid	ID wajah wajah.
personGroupId	path	True	string	ID kontainer. Regex pattern: ^[a-z0-9-_]+$
personId	path	True	string uuid	ID orang tersebut.

Respons

Nama	Jenis	Deskripsi
200 OK	PersonGroupPersonFace	Panggilan yang berhasil mengembalikan informasi wajah persisten target (persistedFaceId dan userData).
Other Status Codes	FaceErrorResponse	Respons kesalahan yang tidak terduga. Headers x-ms-error-code: string

Keamanan

Ocp-Apim-Subscription-Key

Kunci rahasia untuk langganan Azure AI Face Anda.

Type: apiKey
In: header

AADToken

Alur OAuth2 Azure Active Directory

Type: oauth2
Flow: accessCode
Authorization URL: https://api.example.com/oauth2/authorize
Token URL: https://api.example.com/oauth2/token

Scopes

Nama	Deskripsi
https://cognitiveservices.azure.com/.default

Contoh

Get Face form PersonGroup Person

Sample Request

HTTP

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

Sample Response

Status code:

200

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

Definisi

Nama	Deskripsi
FaceError	Objek kesalahan. Untuk detail komprehensif tentang kode kesalahan dan pesan yang dikembalikan oleh Face Service, silakan lihat tautan berikut: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Respons yang berisi detail kesalahan.
PersonGroupPersonFace	Sumber daya wajah untuk orang grup orang.

FaceError

Objek kesalahan. Untuk detail komprehensif tentang kode kesalahan dan pesan yang dikembalikan oleh Face Service, silakan lihat tautan berikut: https://aka.ms/face-error-codes-and-messages.

Nama	Jenis	Deskripsi
code	string	Salah satu set kode kesalahan yang ditentukan server.
message	string	Representasi kesalahan yang dapat dibaca manusia.

FaceErrorResponse

Respons yang berisi detail kesalahan.

Nama	Jenis	Deskripsi
error	FaceError	Objek kesalahan.

PersonGroupPersonFace

Sumber daya wajah untuk orang grup orang.

Nama	Jenis	Deskripsi
persistedFaceId	string	ID wajah wajah.
userData	string	Data yang disediakan pengguna yang dilampirkan ke wajah. Batas panjangnya adalah 1K.