Akıllı kart durumunu güncelleştirme

2025-04-08

Akıllı kartın durumunu güncelleştirir.

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/requests/{reqid}/smartcards/{scid}

URL parametreleri

Parametre	Açıklama
reqid	Gerekli. Microsoft Identity Manager (MIM) Sertifika Yönetimi'ne (CM) özgü istek tanımlayıcısı.
scid	Gerekli. MIM CM'ye özgü akıllı kart tanımlayıcısı. 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

İstek gövdesi aşağıdaki özellikleri içerir:

Mülkiyet	Açıklama
durum	İsteğin ayarlanacağı durum, örneğin "Kullanımdan kaldırıldı."

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, akıllı kartın durumunu güncelleştirmek için bir örnek sağlanır.

Örnek: İstek

PUT /certificatemanagement/api/v1.0/requests/b105403d-d021-41ea-9f11-be3d677d229e/smartcards/17cf063d-e337-4aa9-a822-346554ddd3c9 HTTP/1.1

Örnek: Yanıt

HTTP/1.1 200 OK

{
    "Uuid":"17cf063d-e337-4aa9-a822-346554ddd3c9",
    "Status":6,
    "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.

Microsoft.Clm.Shared.Smartcards.Smartcard sınıfı