Large Person Group Person - Get

Layanan:

Azure AI Services

Versi API:

1.0

Ambil nama dan userData seseorang, dan faceIds yang bertahan yang mewakili fitur wajah orang terdaftar.

GET {Endpoint}/face/v1.0/largepersongroups/{largePersonGroupId}/persons/{personId}

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
Endpoint	path	True	string	Titik akhir Cognitive Services yang didukung (protokol dan nama host, misalnya: https://westus.api.cognitive.microsoft.com).
largePersonGroupId	path	True	string maxLength: 64 pattern: ^[a-z0-9-_]+$	Id mereferensikan grup orang besar tertentu.
personId	path	True	string (uuid)	Id mereferensikan orang tertentu.

Header Permintaan

Nama	Diperlukan	Jenis	Deskripsi
Ocp-Apim-Subscription-Key	True	string

Respons

Nama	Jenis	Deskripsi
200 OK	Person	Panggilan yang berhasil mengembalikan informasi orang tersebut.
Other Status Codes	APIError	Respons kesalahan.

Keamanan

Ocp-Apim-Subscription-Key

Jenis: apiKey
Dalam: header

Contoh

Get person example

Permintaan sampel

HTTP

GET {Endpoint}/face/v1.0/largepersongroups/abc/persons/25985303-c537-4467-b41d-bdb45cd95ca1

Respon sampel

Kode status:

200

{
  "personId": "25985303-c537-4467-b41d-bdb45cd95ca1",
  "persistedFaceIds": [
    "015839fb-fbd9-4f79-ace9-7675fc2f1dd9",
    "fce92aed-d578-4d2e-8114-068f8af4492e",
    "b64d5e15-8257-4af2-b20a-5a750f8940e7"
  ],
  "name": "person-name",
  "userData": "User-provided data attached to the person."
}

Definisi

Nama	Deskripsi
APIError	Informasi kesalahan yang dikembalikan oleh API
Error	Isi kesalahan.
Person	Objek orang.

APIError

Objek

Informasi kesalahan yang dikembalikan oleh API

Nama	Jenis	Deskripsi
error	Error	Isi kesalahan.

Error

Objek

Isi kesalahan.

Nama	Jenis	Deskripsi
code	string
message	string

Person

Objek

Objek orang.

Nama	Jenis	Deskripsi
name	string maxLength: 128	Nama yang ditentukan pengguna, panjang maksimum adalah 128.
persistedFaceIds	string[] (uuid)	PersistedFaceIds dari wajah terdaftar pada orang tersebut. PersistedFaceIds ini dikembalikan dari Orang - Tambahkan Wajah Orang, dan tidak akan kedaluwarsa.
personId	string (uuid)	PersonId dari daftar wajah target.
userData	string maxLength: 16384	Data yang ditentukan pengguna. Panjang tidak boleh melebihi 16KB.