Akıllı kart profilleri alma

Bir kullanıcının akıllı kart profillerinin listesini alır. Liste, geçerli kullanıcı tarafından gerçekleştirilebilecek olası işlemleri içerir. Daha sonra belirtilen işlemlerden herhangi biri için bir istek başlatılabilir.

Uyarı

Bu makaledeki URL'ler, api dağıtımı sırasında seçilen ana bilgisayar adıyla (https://api.contoso.comgibi) ilgilidir.

İstek

Yöntem İstek URL’si
AL/GETİR /CertificateManagement/api/v1.0/smartcards
/CertificateManagement/api/v1.0/smartcards/{smartcarduuid}

URL parametreleri

Mülkiyet Açıklama
smartcarduuid Opsiyonel. Microsoft Identity Manager (MIM) Sertifika Yönetimi (CM) tarafından belirtilen akıllı kart UUID değeri. Değer, Microsoft.Clm.Shared.Smartcards.Smartcard nesnesindeki "uuid" alanına karşılık gelir.

Sorgu parametreleri

Mülkiyet Açıklama
cardid Opsiyonel. MIM CM tarafından belirtilen akıllı kart UUID değeri. Değer, Microsoft.Clm.Shared.Smartcards.Smartcard nesnesindeki "uuid" alanına karşılık gelir.

İstek başlıkları

Yaygın istek üst bilgileri için bkz. CM REST API hizmeti ayrıntılarıhttp isteği ve yanıt üst bilgileri .

İstek içeriği

Yok.

Yanıt

Bu bölümde yanıt açıklanmaktadır.

Yanıt kodları

Kod Açıklama
200 Tamam
204 İçerik yok
403 Yasak
beş yüz İç Hata

Yanıt üst bilgileri

Yaygın yanıt üst bilgileri için bkz. CM REST API hizmeti ayrıntılarıhttp isteği ve yanıt üst bilgileri .

Yanıtın içeriği

Başarılı olduğunda, aşağıdaki özelliklere sahip bir JSON-Serialized Microsoft.Clm.Shared.Smartcards.Smartcard nesnesi döndürür:

İsim Açıklama
AssignedUserUuid Akıllı kartın atandığı kullanıcının tanımlayıcısı.
Atr Şu anda başlatılmakta olan kart için akıllı kart sıfırlama yanıtı (ATR) dizesi.
Yorum Akıllı kartı açıklayan açıklama.
Bayrak Akıllı kartı tanımlayan bayraklar.
Ara yazılım Akıllı kart için ara yazılım.
ParentSmartcardUuid Akıllı kartın değiştirdiği eski akıllı kartın tanımlayıcısı.
PermanentSmartcardUuid Akıllı kartla ilişkili kalıcı akıllı kartın tanımlayıcısı.
PrimarySmartcardUuid Birincil akıllı kartın tanımlayıcısı.
ProfileTemplateUuid Akıllı kartı yöneten ilkeleri ve ayarları içeren profil şablonunun tanımlayıcısı.
ProfileTemplateVersion Akıllı kart profilinin oluşturulduğu sırada profil şablonunun sürümü.
SerialNumber Akıllı kartın seri numarası.
Durum Akıllı kartın durumu.
Uuid Akıllı kart profilinin tanımlayıcısı.

Örnek

Bu bölümde, bir kullanıcı için akıllı kart profilleri almak için bir örnek sağlanır.

Örnek: İstek 1

GET /certificatemanagement/api/v1.0/smartcards?cardid=d1ef6869-5517-42a0-8f05-16ca1a0b834d HTTP/1.1

Örnek: Yanıt 1

HTTP/1.1 200 OK

{
    "Uuid":"438d1b30-f3b4-4bed-85fa-285e08605ba7",
    "Status":3,
    "Flags":1,
    "ParentSmartcardUuid":"00000000-0000-0000-0000-000000000000",
    "PrimarySmartcardUuid":"00000000-0000-0000-0000-000000000000",
    "PermanentSmartcardUuid":"00000000-0000-0000-0000-000000000000",
    "AssignedUserUuid":"8f1590dc-d932-4b66-8e68-2e91c5880780",
    "ProfileTemplateUuid":"a039b4d0-5ce8-4eff-8651-181c6576fda3",
    "ProfileTemplateVersion":46,
    "Comment":"",
    "SerialNumber":"{d1ef6869-5517-42a0-8f05-16ca1a0b834d}",
    "Middleware":"MSBaseCSP",
    "Atr":"3b8d0180fba000000397425446590301c8"
}

Örnek: İstek 2

GET /certificatemanagement/api/v1.0/smartcards/17cf063d-e337-4aa9-a822-346554ddd3c9 HTTP/1.1

Örnek: Yanıt 2

HTTP/1.1 200 OK

{
    "Uuid":"17cf063d-e337-4aa9-a822-346554ddd3c9",
    "Status":2,
    "Flags":1,
    "ParentSmartcardUuid":"00000000-0000-0000-0000-000000000000",
    "PrimarySmartcardUuid":"00000000-0000-0000-0000-000000000000",
    "PermanentSmartcardUuid":"00000000-0000-0000-0000-000000000000",
    "AssignedUserUuid":"8f1590dc-d932-4b66-8e68-2e91c5880780",
    "ProfileTemplateUuid":"a039b4d0-5ce8-4eff-8651-181c6576fda3",
    "ProfileTemplateVersion":46,
    "Comment":"",
    "SerialNumber":"{bc88f13f-83ba-4037-8262-46eba1291c6e}",
    "Middleware":"MSBaseCSP",
    "Atr":"3b8d0180fba000000397425446590301c8"
}

Ayrıca bkz.