Kérelem lekérése
Lekér egy vagy több megadott Microsoft Identity Manager (MIM) tanúsítványkezelési (CM) kérést.
Megjegyzés
A cikkben szereplő URL-címek az API-telepítés során kiválasztott gazdagépnévhez (például https://api.contoso.com) kapcsolódnak.
Kérés
| Metódus | URL-cím kérése |
|---|---|
| GET | /CertificateManagement/api/v1.0/requests/{id} |
URL-paraméterek
| Tulajdonság | Leírás |
|---|---|
| id | Választható. A lekérni kívánt kérelem GUID azonosítója. |
Lekérdezési paraméterek
| Tulajdonság | Leírás |
|---|---|
| targetuser | Választható. A kérés célfelhasználója. Ha nincs megadva cél, a rendszer a célfelhasználótól függetlenül minden kérést visszaad. Megjegyzés: Jelenleg csak az "aktuális" érték támogatott. |
| status | Választható. A lekérni kívánt kérelem állapotát jelzi. A lehetséges állapottípusok a következők: "Jóváhagyva", "Megszakítva", "Befejezve", "Megtagadva", "Végrehajtás", "Sikertelen", "Nincs" és "Függőben". Ha nincs megadva állapot, a rendszer az állapottól függetlenül minden kérést visszaad. |
Kérésfejlécek
A gyakori kérésfejlécekért lásd: HTTP-kérés- és válaszfejlécek a CM REST API szolgáltatás részleteiben.
A kérés törzse
Nincsenek.
Reagálás
Ez a szakasz a választ ismerteti.
Válaszkódok
| Code | Description |
|---|---|
| 200 | OK |
| 204 | Nincs tartalom |
| 403 | Forbidden |
| 500 | Belső hiba |
Válaszfejlécek
A gyakori válaszfejlécekért lásd: HTTP-kérés- és válaszfejlécek a CM REST API szolgáltatás részleteiben.
Választörzs
Sikeres művelet esetén egy vagy több Kérelem objektumot ad vissza a következő tulajdonságokkal:
| Név | Leírás |
|---|---|
| Megjegyzés | A MIM CM-kéréshez társított megjegyzés. |
| Befejeződött | A MIM CM-kérés befejezésének időpontja. |
| DataCollection | A MIM CM-kérelemhez társított adatgyűjtési elemek. |
| DataCollectionFlags | A MIM CM-kérés adatgyűjtési lehetőségei. |
| Zászlók | A MIM CM-kérelemhez társított beállítások. |
| IsDataCollectionComplete | Logikai érték, amely azt jelzi, hogy az adatgyűjtés befejeződött-e a MIM CM-kéréshez. |
| IsEnrollmentAgent | Logikai érték, amely azt jelzi, hogy szükség van-e regisztrációs ügynökre a MIM CM-kérelem futtatásához. |
| IsSmartcard | Logikai érték, amely azt jelzi, hogy a MIM CM-kérés intelligenskártya-kérés vagy szoftverprofil-kérés-e. |
| NewProfileUuid | A MIM CM-kérés által létrehozott új szoftverprofil identitása. |
| NewSmartcardUuid | A MIM CM-kérés által hozzárendelt új intelligens kártya identitása. |
| OldProfileUuid | Annak a szoftverprofilnak az identitása, amelyhez a MIM CM-kérés létrejött. |
| OldSmartcardUuid | Annak az intelligens kártyának az identitása, amelyhez a MIM CM-kérés létre lett hozva. |
| OriginatorUserUuid | A MIM CM-kérést létrehozó felhasználó identitása. |
| Prioritás | A MIM CM-kérés prioritása. |
| ProfileTemplateUuid | Annak a profilsablonnak az identitása, amelyhez a MIM CM-kérést létrehozták. |
| RequestType | A MIM CM-kérelem típusa. |
| SecurityDescriptor | A MIM CM-kérés biztonsági leírója. |
| Állapot | A MIM CM-kérés állapota. |
| Elküldve | A MIM CM-kérés elküldési ideje. |
| TargetUserUuid | A MIM CM-kérés célfelhasználójának identitása. |
| Uuid | A MIM CM-kérelem azonosítója. |
Példa
Ez a szakasz egy példát mutat be a megadott MIM CM-kérések lekérésére.
Példa: 1. kérelem
GET /certificatemanagement/api/v1.0/requests/a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099 HTTP/1.1
Példa: 1. válasz
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
}
Példa: 2. kérelem
GET /certificatemanagement/api/v1.0/requests/0c96d73f-967b-420e-854a-43ad2a1504bc HTTP/1.1
Példa: 2. válasz
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
}