Person Group Operations - Create Large Person Group Person
Create orang baru dalam Grup Orang Besar tertentu. Untuk menambahkan wajah ke orang ini, silakan panggil "Tambahkan Wajah Orang Grup Orang Besar".
Catatan
-
- Kuota langganan tingkat gratis:
- 1.000 orang di semua Grup Orang Besar.
- Kuota langganan tingkat S0:
- 1.000.000 orang per Kelompok Orang Besar.
- 1.000.000 orang besar Grup.
- 1.000.000.000 orang di semua Grup Orang Besar.
- Kuota langganan tingkat gratis:
POST {endpoint}/face/{apiVersion}/largepersongroups/{largePersonGroupId}/persons
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). |
large
|
path | True |
string |
ID kontainer. Regex pattern: |
Isi Permintaan
Nama | Diperlukan | Jenis | Deskripsi |
---|---|---|---|
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 |
---|---|---|
200 OK |
Panggilan yang berhasil mengembalikan personId baru yang dibuat. |
|
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
Create Person in LargePersonGroup
Sample Request
POST {endpoint}/face/v1.1-preview.1/largepersongroups/your_large_person_group_id/persons
{
"name": "your_large_person_group_person_name",
"userData": "your_user_data"
}
Sample Response
{
"personId": "25985303-c537-4467-b41d-bdb45cd95ca1"
}
Definisi
Nama | Deskripsi |
---|---|
Create |
Respons buat orang. |
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. |
CreatePersonResult
Respons buat orang.
Nama | Jenis | Deskripsi |
---|---|---|
personId |
string |
ID orang tersebut. |
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. |