Pobieranie żądania
Pobiera co najmniej jedno określone żądanie zarządzania certyfikatami Microsoft Identity Manager (MIM).
Uwaga
Adresy URL w tym artykule są powiązane z nazwą hosta wybraną podczas wdrażania interfejsu API, taką jak https://api.contoso.com.
Żądanie
| Metoda | Adres URL żądania |
|---|---|
| GET | /CertificateManagement/api/v1.0/requests/{id} |
Parametry URL
| Właściwość | Opis |
|---|---|
| identyfikator | Opcjonalny. Identyfikator GUID żądania do pobrania. |
Parametry zapytania
| Właściwość | Opis |
|---|---|
| targetuser | Opcjonalny. Docelowy użytkownik żądania. Jeśli żaden element docelowy nie zostanie określony, wszystkie żądania, niezależnie od użytkownika docelowego zostaną zwrócone. Uwaga: obecnie obsługiwana jest tylko wartość "current". |
| status | Opcjonalny. Wskazuje stan żądania do pobrania. Możliwe typy stanów to "Approved", "Canceled", "Completed", "Denied", "Executing", "Failed", "None" i "Pending". Jeśli nie określono stanu, wszystkie żądania, niezależnie od stanu są zwracane. |
Nagłówki żądań
Aby zapoznać się z typowymi nagłówkami żądań, zobacz Nagłówki żądań HTTP i odpowiedzi w szczegółach usługi interfejsu API REST zarządzania konfiguracją.
Treść żądania
Brak.
Reakcja
W tej sekcji opisano odpowiedź.
Kody odpowiedzi
| Kod | Opis |
|---|---|
| 200 | OK |
| 204 | Brak zawartości |
| 403 | Forbidden |
| 500 | Błąd wewnętrzny |
Nagłówki odpowiedzi
Typowe nagłówki odpowiedzi można znaleźć w temacie Http request and response headers in CM REST API details (Nagłówki żądań HTTP i odpowiedzi w szczegółach usługi interfejsu API REST zarządzania konfiguracją).
Treść odpowiedzi
Po powodzeniu zwraca co najmniej jeden obiekt Request z następującymi właściwościami:
| Nazwa | Opis |
|---|---|
| Komentarz | Komentarz skojarzony z żądaniem cm programu MIM. |
| Ukończone | Czas ukończenia żądania cm programu MIM. |
| DataCollection | Elementy zbierania danych skojarzone z żądaniem zarządzania programem MIM. |
| DataCollectionFlags | Opcje zbierania danych dla żądania cm programu MIM. |
| Flagi | Opcje skojarzone z żądaniem zarządzania programem MIM. |
| IsDataCollectionComplete | Wartość logiczna wskazująca, czy zbieranie danych zostało ukończone dla żądania cm programu MIM. |
| IsEnrollmentAgent | Wartość logiczna wskazująca, czy do uruchomienia żądania cm programu MIM jest wymagany agent rejestracji. |
| IsSmartcard | Wartość logiczna wskazująca, czy żądanie cm programu MIM jest żądaniem karty inteligentnej, czy żądaniem profilu oprogramowania. |
| NewProfileUuid | Tożsamość nowego profilu oprogramowania, który jest generowany przez żądanie cm programu MIM. |
| NewSmartcardUuid | Tożsamość nowej karty inteligentnej przypisanej przez żądanie cm programu MIM. |
| OldProfileUuid | Tożsamość profilu oprogramowania, dla którego utworzono żądanie cm programu MIM. |
| OldSmartcardUuid | Tożsamość karty inteligentnej, dla której utworzono żądanie cm programu MIM. |
| OriginatorUserUuid | Tożsamość użytkownika, który utworzył żądanie cm programu MIM. |
| Priorytet | Priorytet żądania cm programu MIM. |
| ProfileTemplateUuid | Tożsamość szablonu profilu, dla którego utworzono żądanie cm programu MIM. |
| RequestType | Typ żądania cm programu MIM. |
| SecurityDescriptor | Deskryptor zabezpieczeń dla żądania programu MIM CM. |
| Stan | Stan żądania cm programu MIM. |
| Przesłane | Czas przesłania żądania cm programu MIM. |
| TargetUserUuid | Tożsamość użytkownika docelowego dla żądania cm programu MIM. |
| Identyfikator UUID | Identyfikator żądania cm programu MIM. |
Przykład
W tej sekcji przedstawiono przykład pobierania określonych żądań zarządzania zarządzanego przez program MIM.
Przykład: żądanie 1
GET /certificatemanagement/api/v1.0/requests/a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099 HTTP/1.1
Przykład: Odpowiedź 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
}
Przykład: Żądanie 2
GET /certificatemanagement/api/v1.0/requests/0c96d73f-967b-420e-854a-43ad2a1504bc HTTP/1.1
Przykład: odpowiedź 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
}