Person Group Operations - Get Person Group Person
Ambil nama dan userData seseorang, dan faceIds yang bertahan yang mewakili fitur wajah orang terdaftar.
GET {endpoint}/face/{apiVersion}/persongroups/{personGroupId}/persons/{personId}
Parameter URI
Nama | Dalam | Diperlukan | Jenis | Deskripsi |
---|---|---|---|---|
api
|
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). |
person
|
path | True |
string |
ID kontainer. Regex pattern: |
person
|
path | True |
string uuid |
ID orang tersebut. |
Respons
Nama | Jenis | Deskripsi |
---|---|---|
200 OK |
Panggilan yang berhasil mengembalikan informasi orang tersebut. |
|
Other Status Codes |
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 Person from PersonGroup
Sample Request
GET {endpoint}/face/v1.1-preview.1/persongroups/your_person_group_id/persons/25985303-c537-4467-b41d-bdb45cd95ca1
Sample Response
{
"personId": "25985303-c537-4467-b41d-bdb45cd95ca1",
"name": "your_person_group_person_name",
"userData": "your_user_data",
"persistedFaceIds": [
"43897a75-8d6f-42cf-885e-74832febb055"
]
}
Definisi
Nama | Deskripsi |
---|---|
Face |
Objek kesalahan. Untuk detail komprehensif tentang kode kesalahan dan pesan yang dikembalikan oleh Layanan Wajah, silakan lihat tautan berikut: https://aka.ms/face-error-codes-and-messages. |
Face |
Respons yang berisi detail kesalahan. |
Person |
Orang dalam grup orang tertentu. Untuk menambahkan wajah ke orang ini, hubungi "Tambahkan Wajah Orang Grup Orang Besar". |
FaceError
Objek kesalahan. Untuk detail komprehensif tentang kode kesalahan dan pesan yang dikembalikan oleh Layanan Wajah, 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 |
Objek kesalahan. |
PersonGroupPerson
Orang dalam grup orang tertentu. Untuk menambahkan wajah ke orang ini, hubungi "Tambahkan Wajah Orang Grup Orang Besar".
Nama | Jenis | Deskripsi |
---|---|---|
name |
string |
Nama yang ditentukan pengguna, panjang maksimum adalah 128. |
persistedFaceIds |
string[] |
Id wajah wajah terdaftar pada orang tersebut. |
personId |
string |
ID orang tersebut. |
userData |
string |
Data yang ditentukan pengguna opsional. Panjang tidak boleh melebihi 16K. |