Bagikan melalui

Memperbarui status kartu pintar

Memperbarui status kartu pintar.

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

URL Parameter

Pengaturan Deskripsi
reqid Dibutuhkan. Pengidentifikasi permintaan yang khusus untuk Manajemen Sertifikat (CM) Microsoft Identity Manager (MIM).
scid Dibutuhkan. Pengidentifikasi kartu pintar yang khusus untuk 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

Isi permintaan berisi properti berikut:

Harta benda Deskripsi
kedudukan Status untuk mengatur permintaan ke, seperti "Dihentikan."

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 memperbarui status kartu pintar.

Contoh: Permintaan

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

Contoh: Respons

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"
}

Lihat juga