Person Directory Operations - Create Dynamic Person Group With Person
Membuat Grup Orang Dinamis baru dengan dynamicPersonGroupId, nama, dan userData yang disediakan pengguna tertentu.
Grup Orang Dinamis adalah kontainer yang mereferensikan Direktori Orang "Create Orang". Setelah pembuatan, gunakan Direktori Orang "Perbarui Grup Orang Dinamis" untuk menambahkan/menghapus orang ke/dari Grup Orang Dinamis.
Grup Orang Dinamis dan data pengguna akan disimpan di server hingga Direktori Orang "Hapus Grup Orang Dinamis" dipanggil. Gunakan "Identifikasi Dari Grup Orang Dinamis" dengan parameter dynamicPersonGroupId untuk mengidentifikasi terhadap orang.
Tidak ada gambar yang akan disimpan. Hanya fitur wajah orang yang diekstrak dan userData yang akan disimpan di server hingga Direktori Orang "Hapus Orang" atau "Hapus Wajah Orang" dipanggil.
'recognitionModel' tidak perlu ditentukan dengan Grup Orang Dinamis. Dynamic Person Grup adalah referensi ke Direktori Orang "orang Create" dan oleh karena itu bekerja dengan sebagian besar 'recognitionModels'. FaceId yang disediakan selama "Identifikasi" menentukan 'recognitionModel' yang digunakan.
PUT {endpoint}/face/{apiVersion}/dynamicpersongroups/{dynamicPersonGroupId}
Parameter URI
Nama | Dalam | Diperlukan | Jenis | Deskripsi |
---|---|---|---|---|
api
|
path | True |
string |
Versi API |
dynamic
|
path | True |
string |
ID grup orang dinamis. Pola regex: |
endpoint
|
path | True |
string uri |
Titik akhir Cognitive Services yang didukung (protokol dan nama host, misalnya: https://{resource-name}.cognitiveservices.azure.com). |
Isi Permintaan
Nama | Diperlukan | Jenis | Deskripsi |
---|---|---|---|
addPersonIds | True |
string[] |
Array personId yang dibuat oleh Person Directory "Create Person" untuk ditambahkan. |
name | True |
string |
Nama yang ditentukan pengguna, panjang maksimum adalah 128. |
userData |
string |
Data opsional yang ditentukan pengguna. Panjang tidak boleh melebihi 16K. |
Respons
Nama | Jenis | Deskripsi |
---|---|---|
202 Accepted |
Panggilan yang berhasil mengembalikan isi respons kosong. Layanan telah menerima permintaan dan akan segera mulai diproses. Klien dapat mengkueri status operasi dan hasil menggunakan URL yang ditentukan di header respons 'Lokasi Operasi'. URL kedaluwarsa dalam 48 jam. URL memberikan status kapan Direktori Orang "Dapatkan Referensi Grup Orang Dinamis" akan mengembalikan perubahan yang dibuat dalam permintaan ini. Header operation-Location: string |
|
Other Status Codes |
Respons kesalahan yang tidak terduga. Header x-ms-error-code: string |
Keamanan
Ocp-Apim-Subscription-Key
Kunci rahasia untuk langganan Azure AI Face Anda.
Jenis:
apiKey
Dalam:
header
AADToken
Alur OAuth2 Azure Active Directory
Jenis:
oauth2
Alur:
accessCode
URL Otorisasi:
https://api.example.com/oauth2/authorize
URL token:
https://api.example.com/oauth2/token
Cakupan
Nama | Deskripsi |
---|---|
https://cognitiveservices.azure.com/.default |
Contoh
Create DynamicPersonGroup
Permintaan sampel
PUT {endpoint}/face/v1.1-preview.1/dynamicpersongroups/your_dynamic_person_group_id
{
"name": "your_dynamic_person_group_name",
"userData": "your_user_data",
"addPersonIds": [
"85c0c630-c9c9-40f8-8a4e-f9ae4f926ea5"
]
}
Respon sampel
operation-Location: https://contoso.com/operationstatus
Definisi
Nama | Deskripsi |
---|---|
Face |
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. |
Face |
Respons yang berisi detail kesalahan. |
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 |
Objek kesalahan. |