Person Group Operations - Create Person Group Person

Service:

Azure AI Services

API Version:

v1.1-preview.1

Create orang baru dalam Grup Orang tertentu. Untuk menambahkan wajah ke orang ini, silakan hubungi "Tambahkan Wajah Orang Grup".

Catatan

• • Kuota langganan tingkat gratis:
    • 1.000 orang di semua orang Grup.
  • Kuota langganan tingkat S0:
    • 10.000 orang per Grup Orang.
    • 1.000.000 Orang Grup.
    • 100.000.000 orang di semua orang Grup.

POST {endpoint}/face/{apiVersion}/persongroups/{personGroupId}/persons

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).
personGroupId	path	True	string	ID kontainer. Regex pattern: ^[a-z0-9-_]+$

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	CreatePersonResult	Panggilan yang berhasil mengembalikan personId baru yang dibuat.
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

Create Person in PersonGroup

Sample Request

HTTP

POST {endpoint}/face/v1.1-preview.1/persongroups/your_person_group_id/persons

{
  "name": "your_person_group_person_name",
  "userData": "your_user_data"
}

Sample Response

Status code:

200

{
  "personId": "25985303-c537-4467-b41d-bdb45cd95ca1"
}

Definisi

Nama	Deskripsi
CreatePersonResult	Respons buat 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.
FaceErrorResponse	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	FaceError	Objek kesalahan.