Person Group Operations - Get Person Group Person

  • Başvuru
Hizmet:
Azure AI Services
API Sürümü:
v1.2-preview.1

Bir kişinin adını ve userData değerini ve kayıtlı kişi yüz tanıma özelliğini temsil eden kalıcı faceId değerlerini alın.

GET {endpoint}/face/{apiVersion}/persongroups/{personGroupId}/persons/{personId}

URI Parametreleri

Name İçinde Gerekli Tür Description
apiVersion
 path True

string

API Sürümü
endpoint
 path True

string

uri

Desteklenen Bilişsel Hizmetler uç noktaları (protokol ve konak adı, örneğin: https://{resource-name}.cognitiveservices.azure.com).
personGroupId
 path True

string

Kapsayıcının kimliği.

Normal ifade deseni: ^[a-z0-9-_]+$
personId
 path True

string

uuid

Kişinin kimliği.

Yanıtlar

Name Tür Description
200 OK

PersonGroupPerson

Başarılı bir çağrı kişinin bilgilerini döndürür.
Other Status Codes

FaceErrorResponse

Beklenmeyen bir hata yanıtı.

Üst Bilgiler

x-ms-error-code: string

Güvenlik

Ocp-Apim-Subscription-Key

Azure Yapay Zeka Yüz Tanıma aboneliğinizin gizli anahtarı.

Tür: apiKey
İçinde: header

AADToken

Azure Active Directory OAuth2 Akışı

Tür: oauth2
Akış: accessCode
Yetkilendirme URL’si: https://api.example.com/oauth2/authorize
Belirteç URL'si: https://api.example.com/oauth2/token

Kapsamlar

Name Description
https://cognitiveservices.azure.com/.default

Örnekler

Get Person from PersonGroup

Örnek isteği

GET {endpoint}/face/v1.2-preview.1/persongroups/your_person_group_id/persons/25985303-c537-4467-b41d-bdb45cd95ca1

Örnek yanıt

Durum kodu:
200 
{
  "personId": "25985303-c537-4467-b41d-bdb45cd95ca1",
  "name": "your_person_group_person_name",
  "userData": "your_user_data",
  "persistedFaceIds": [
    "43897a75-8d6f-42cf-885e-74832febb055"
  ]
}

Tanımlar

Name Description
FaceError

Hata nesnesi. Yüz Tanıma Hizmeti tarafından döndürülen hata kodları ve iletiler hakkında ayrıntılı bilgi için lütfen şu bağlantıya bakın: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse

Hata ayrıntılarını içeren bir yanıt.
PersonGroupPerson

Belirtilen kişi grubundaki kişi. Bu kişiye yüz eklemek için lütfen "Büyük Kişi Grubu Kişi Yüzü Ekle"yi arayın.

FaceError

Hata nesnesi. Yüz Tanıma Hizmeti tarafından döndürülen hata kodları ve iletiler hakkında ayrıntılı bilgi için lütfen şu bağlantıya bakın: https://aka.ms/face-error-codes-and-messages.

Name Tür Description
code

string

Sunucu tanımlı hata kodları kümesinden biri.
message

string

Hatanın insan tarafından okunabilir bir gösterimi.

FaceErrorResponse

Hata ayrıntılarını içeren bir yanıt.

Name Tür Description
error

FaceError

Hata nesnesi.

PersonGroupPerson

Belirtilen kişi grubundaki kişi. Bu kişiye yüz eklemek için lütfen "Büyük Kişi Grubu Kişi Yüzü Ekle"yi arayın.

Name Tür Description
name

string

Kullanıcı tanımlı ad, uzunluk üst sınırı 128'dir.
persistedFaceIds

string[]

Kişideki kayıtlı yüzlerin yüz kimlikleri.
personId

string

Kişinin kimliği.
userData

string

İsteğe bağlı kullanıcı tanımlı veriler. Uzunluk 16K'yi aşmamalıdır.