Bagikan melalui

Dapatkan permintaan

Mendapatkan satu atau beberapa permintaan Manajemen Sertifikat (CM) Microsoft Identity Manager (MIM) 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/requests/{id}

URL Parameter

Harta benda Deskripsi
id Fakultatif. GUID permintaan untuk diambil.

Parameter permintaan

Harta benda Deskripsi
targetuser Fakultatif. Pengguna target permintaan. Jika tidak ada target yang ditentukan, semua permintaan, terlepas dari pengguna target yang dikembalikan.

Catatan: Hanya nilai "saat ini" yang saat ini didukung.
kedudukan Fakultatif. Menunjukkan status permintaan yang akan diambil. Jenis status yang mungkin adalah "Disetujui," "Dibatalkan," "Selesai," "Ditolak," "Mengeksekusi," "Gagal," "Tidak Ada," dan "Tertunda."
Jika tidak ada status yang ditentukan, semua permintaan, terlepas dari status yang dikembalikan.

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 satu atau beberapa objek Permintaan dengan properti berikut:

Nama Deskripsi
Komentar Komentar yang terkait dengan permintaan MIM CM.
Selesai Waktu permintaan MIM CM selesai.
DataCollection Item pengumpulan data yang terkait dengan permintaan MIM CM.
DataCollectionFlags Opsi untuk pengumpulan data untuk permintaan MIM CM.
Bendera Opsi yang terkait dengan permintaan MIM CM.
IsDataCollectionComplete Nilai Boolean yang menunjukkan apakah pengumpulan data telah selesai untuk permintaan MIM CM.
IsEnrollmentAgent Nilai Boolean yang menunjukkan apakah agen pendaftaran diperlukan untuk menjalankan permintaan MIM CM.
IsSmartcard Nilai Boolean yang menunjukkan apakah permintaan MIM CM adalah permintaan kartu pintar atau permintaan profil perangkat lunak.
NewProfileUuid Identitas profil perangkat lunak baru yang diproduksi oleh permintaan MIM CM.
NewSmartcardUuid Identitas kartu pintar baru yang ditetapkan oleh permintaan MIM CM.
OldProfileUuid Identitas profil perangkat lunak tempat permintaan MIM CM dibuat.
OldSmartcardUuid Identitas kartu pintar tempat permintaan MIM CM dibuat.
OriginatorUserUuid Identitas pengguna yang berasal dari permintaan MIM CM.
Prioritas Prioritas permintaan MIM CM.
ProfileTemplateUuid Identitas templat profil tempat permintaan MIM CM dibuat.
RequestType Jenis permintaan MIM CM.
Deskriptor Keamanan Pendeskripsi keamanan untuk permintaan MIM CM.
Kedudukan Status permintaan MIM CM.
Diajukan Waktu permintaan MIM CM dikirimkan.
TargetUserUuid Identitas pengguna target untuk permintaan MIM CM.
Uuid Pengidentifikasi untuk permintaan MIM CM.

Contoh

Bagian ini menyediakan contoh untuk mendapatkan permintaan MIM CM yang ditentukan.

Contoh: Permintaan 1

GET /certificatemanagement/api/v1.0/requests/a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099 HTTP/1.1

Contoh: Respons 1

HTTP/1.1 200 OK

{
    "Uuid":"a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099",
    "RequestType":1,
    "Status":3,
    "Flags":2,
    "DataCollection":[

    ],
    "DataCollectionFlags":32,
    "OriginatorUserUuid":"8f1590dc-d932-4b66-8e68-2e91c5880780",
    "TargetUserUuid":"8f1590dc-d932-4b66-8e68-2e91c5880780",
    "Submitted":"2015-07-07T23:36:21.93Z",
    "Completed":"0001-01-01T00:00:00",
    "NewProfileUuid":"00000000-0000-0000-0000-000000000000",
    "OldProfileUuid":"00000000-0000-0000-0000-000000000000",
    "NewSmartcardUuid":"00000000-0000-0000-0000-000000000000",
    "OldSmartcardUuid":"00000000-0000-0000-0000-000000000000",
    "Priority":0,
    "Comment":"",
    "ProfileTemplateUuid":"a039b4d0-5ce8-4eff-8651-181c6576fda3",
    "SecurityDescriptor":"O:S-1-5-21-2127521184-1604012920-1887927527-14134865D:(D;;LC;;;S-1-5-21-2127521184-1604012920-1887927527-14995557)(A;;DCSW;;;S-1-5-21-2127521184-1604012920-1887927527-5094533)(A;;DCSW;;;S-1-5-21-2127521184-1604012920-1887927527-5094534)(A;;DCSW;;;S-1-5-21-2127521184-1604012920-1887927527-5219125)(A;;SWRC;;;S-1-5-21-2127521184-1604012920-1887927527-5094533)(A;;RC;;;WD)(A;;CCDCLCSWSDRC;;;S-1-5-21-2127521184-1604012920-1887927527-14134865)(A;;DCSW;;;S-1-5-21-2127521184-1604012920-1887927527-14995557)(A;;CCDCSW;;;S-1-5-21-2127521184-1604012920-1887927527-14995557)\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000",
    "IsSmartcard":true,
    "IsEnrollmentAgent":false,
    "IsDataCollectionComplete":false
}

Contoh: Permintaan 2

GET /certificatemanagement/api/v1.0/requests/0c96d73f-967b-420e-854a-43ad2a1504bc HTTP/1.1

Contoh: Respons 2

HTTP/1.1 200 OK

{
    "Uuid":"0c96d73f-967b-420e-854a-43ad2a1504bc",
    "RequestType":5,
    "Status":3,
    "Flags":2,
    "DataCollection":[
        {
            "Name":"Sample Data Item",
            "Value":null
        }
    ],
    "DataCollectionFlags":32,
    "OriginatorUserUuid":"8f1590dc-d932-4b66-8e68-2e91c5880780",
    "TargetUserUuid":"8f1590dc-d932-4b66-8e68-2e91c5880780",
    "Submitted":"2015-07-07T23:40:33.133Z",
    "Completed":"0001-01-01T00:00:00",
    "NewProfileUuid":"b99ff38c-6653-471f-ae3c-325bb351a6bc",
    "OldProfileUuid":"b99ff38c-6653-471f-ae3c-325bb351a6bc",
    "NewSmartcardUuid":"17cf063d-e337-4aa9-a822-346554ddd3c9",
    "OldSmartcardUuid":"17cf063d-e337-4aa9-a822-346554ddd3c9",
    "Priority":0,
    "Comment":"",
    "ProfileTemplateUuid":"a039b4d0-5ce8-4eff-8651-181c6576fda3",
    "SecurityDescriptor":"O:S-1-5-21-2127521184-1604012920-1887927527-14134865D:(D;;LC;;;S-1-5-21-2127521184-1604012920-1887927527-14995557)(A;;SWRC;;;S-1-5-21-2127521184-1604012920-1887927527-5094533)(A;;RC;;;WD)(A;;CCDCLCSWSDRC;;;S-1-5-21-2127521184-1604012920-1887927527-14134865)(A;;DCSW;;;S-1-5-21-2127521184-1604012920-1887927527-14995557)(A;;CCDCSW;;;S-1-5-21-2127521184-1604012920-1887927527-14995557)\u0000\u0000\u0000\u0000\u0000\u0000",
    "IsSmartcard":true,
    "IsEnrollmentAgent":false,
    "IsDataCollectionComplete":false
}

Lihat juga

  • Last updated on