Mendapatkan profil kartu pintar

Mendapatkan daftar profil kartu pintar untuk pengguna. Daftar ini mencakup kemungkinan operasi yang dapat dilakukan oleh pengguna saat ini. Permintaan kemudian dapat dimulai untuk salah satu operasi yang ditentukan.

Nota

URL dalam artikel ini relatif terhadap nama host yang dipilih selama penyebaran API, seperti https://api.contoso.com.

Permohonan

Metode URL Permintaan
DAPATKAN /CertificateManagement/api/v1.0/smartcards
/CertificateManagement/api/v1.0/smartcards/{smartcarduuid}

URL Parameter

Harta benda Deskripsi
smartcarduuid Fakultatif. UUID kartu pintar sebagaimana ditunjukkan oleh Manajemen Sertifikat (CM) Microsoft Identity Manager (MIM). Nilai sesuai dengan bidang "uuid" di objek Microsoft.Clm.Shared.Smartcards.Smartcard.

Parameter permintaan

Harta benda Deskripsi
cardid Fakultatif. UUID kartu pintar seperti yang ditunjukkan oleh MIM CM. Nilai sesuai dengan bidang "uuid" di objek Microsoft.Clm.Shared.Smartcards.Smartcard.

Tajuk permintaan

Untuk header permintaan umum, lihat permintaan HTTP dan header respons di detail layanan CM REST API.

Isi dari permintaan

Tidak ada.

Tanggapan

Bagian ini menjelaskan responsnya.

Kode respons

Kode Deskripsi
200 OK
204 Tidak ada konten
403 Dilarang
500 Kesalahan Internal

Header respons

Untuk header respons umum, lihat header permintaan dan respons HTTP di detail layanan CM REST API.

Badan respons

Setelah berhasil, mengembalikan objek JSON-Serialized Microsoft.Clm.Shared.Smartcards.Smartcard dengan properti berikut:

Nama Deskripsi
AssignedUserUuid Pengidentifikasi pengguna yang diberi kartu pintar.
Atr String answer-to-reset (ATR) kartu pintar untuk kartu yang saat ini sedang diinisialisasi.
Komentar Komentar yang menjelaskan kartu pintar.
Bendera Bendera yang menjelaskan kartu pintar.
Middleware Middleware untuk kartu pintar.
ParentSmartcardUuid Pengidentifikasi kartu pintar lama yang telah diganti oleh kartu pintar.
PermanentSmartcardUuid Pengidentifikasi kartu pintar permanen yang terkait dengan kartu pintar.
PrimarySmartcardUuid Pengidentifikasi kartu pintar utama.
ProfileTemplateUuid Pengidentifikasi templat profil yang berisi kebijakan dan pengaturan yang mengatur kartu pintar.
ProfileTemplateVersion Versi templat profil pada saat profil kartu pintar dibuat.
SerialNumber Nomor seri kartu pintar.
Kedudukan Status kartu pintar.
Uuid Pengidentifikasi profil kartu pintar.

Contoh

Bagian ini memberikan contoh untuk mendapatkan profil kartu pintar untuk pengguna.

Contoh: Permintaan 1

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

Contoh: Respons 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"
}

Contoh: Permintaan 2

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

Contoh: Respons 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"
}

Lihat juga

  • Last updated on