Membuat permintaan

Buat permintaan Manajemen Sertifikat (CM) Microsoft Identity Manager (MIM).

Nota

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

Permohonan

Metode URL Permintaan
PENGUMUMAN /CertificateManagement/api/v1.0/requests

URL Parameter

Tidak ada.

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
profiletemplateuuid Dibutuhkan. GUID templat profil tempat pengguna membuat permintaan.
datacollection Dibutuhkan. Kumpulan pasangan nama-nilai yang mewakili data yang akan disediakan oleh penerima pendaftaran. Pengumpulan data yang diperlukan yang harus disediakan dapat diambil dari kebijakan alur kerja templat profil. Koleksi kosong dapat ditentukan.
sasaran Fakultatif. GUID pengguna target tempat permintaan akan dibuat. Jika tidak ditentukan, target default ke pengguna saat ini.
jenis Dibutuhkan. Jenis permintaan yang sedang dibuat. Jenis permintaan yang tersedia termasuk "Daftar," "Duplikat," "OfflineUnblock," "OnlineUpdate," "Renew," "Recover," "RecoverOnBehalf," "Reinstate," "Retire," "Revoke," "TemporaryCards," dan "Unblock."

Catatan: Tidak semua jenis permintaan didukung pada semua templat profil. Misalnya, Anda tidak dapat menentukan operasi Buka blokir pada templat profil perangkat lunak.
komentar Dibutuhkan. Komentar apa pun yang mungkin dimasukkan oleh pengguna. Kebijakan alur kerja menentukan apakah properti komentar diperlukan. String kosong dapat ditentukan.
Prioritas Fakultatif. Prioritas permintaan. Jika tidak ditentukan, prioritas permintaan default, seperti yang ditentukan oleh pengaturan templat profil, digunakan.

Tanggapan

Bagian ini menjelaskan responsnya.

Kode respons

Kode Deskripsi
201 Dibuat
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 URI untuk permintaan yang baru dibuat.

Contoh

Bagian ini menyediakan contoh untuk membuat permintaan pendaftaran dan membuka blokir.

Contoh: Permintaan 1

POST /CertificateManagement/api/v1.0/requests HTTP/1.1

{
    "datacollection":"[]",
    "type":"Enroll",
    "profiletemplateuuid":"a039b4d0-5ce8-4eff-8651-181c6576fda3",
    "comment":""
}

Contoh: Respons 1

HTTP/1.1 201 Created

"api/v1.0/requests/a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099"

Contoh: Permintaan 2

POST /CertificateManagement/api/v1.0/requests HTTP/1.1

{  
    "datacollection":"[]",
    "type":"Unblock",
    "smartcard":"17cf063d-e337-4aa9-a822-346554ddd3c9",
    "comment":""
}

Contoh: Respons 2

HTTP/1.1 201 Created

"api/v1.0/requests/0c96d73f-967b-420e-854a-43ad2a1504bc"

Contoh: Permintaan 3

POST /CertificateManagement/api/v1.0/requests HTTP/1.1

{
    "profiletemplateuuid" : "97CD65FA-AF4B-4587-9309-0DD6BFD8B4E1",
    "datacollection":
    [
        {"name" : "pavle"},
        {"city" : "seattle"}
    ],
    "target" : "97CC3493-F556-4C9B-9D8B-982434201527",
    "type" : "Enroll",
    "comment" : "LALALALA",
    "priority" :  "4"
}

Lihat juga

  • Last updated on