Udostępnij przez

Żądanie GET

Pobiera co najmniej jedno określone żądanie zarządzania certyfikatami (CM) programu 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

Nieruchomość / Majątek Opis
id Opcjonalny. Identyfikator GUID żądania do pobrania.

Parametry zapytania

Nieruchomość / Majątek 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".
stan Opcjonalny. Wskazuje stan żądania do pobrania. Możliwe typy stanów to "Zatwierdzone", "Anulowane", "Ukończono", "Odrzucone", "Wykonywanie", "Niepowodzenie", "Brak" i "Oczekujące".
Jeśli nie określono żadnego stanu, wszystkie żądania, niezależnie od stanu są zwracane.

Nagłówki zapytań

Aby uzyskać typowe nagłówki żądań, zobacz nagłówki żądań i odpowiedzi HTTP w szczegółach usługi interfejsu API REST CM.

Ciało żądania

Żaden.

Odpowiedź

W tej sekcji opisano odpowiedź.

Kody odpowiedzi

Kod Opis
200 OK
204 Brak zawartości
403 Zakazany
500 Błąd wewnętrzny

Nagłówki odpowiedzi

Aby uzyskać typowe nagłówki odpowiedzi, zobacz nagłówki żądań HTTP i odpowiedzi w szczegółach usługi API REST.

Ciało odpowiedzi

Po powodzeniu zwraca co najmniej jeden obiekt żądania z następującymi właściwościami:

Nazwa Opis
Komentarz Komentarz skojarzony z żądaniem zarządzania programem MIM.
Zakończone Czas ukończenia żądania zarządzania programem MIM.
DataCollection Elementy zbierania danych skojarzone z żądaniem cm programu 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 zarządzania programem MIM.
IsEnrollmentAgent Wartość logiczna wskazująca, czy agent rejestracji jest wymagany do uruchomienia żądania zarządzania programem MIM.
IsSmartcard Wartość logiczna wskazująca, czy żądanie cm programu MIM jest żądaniem karty inteligentnej lub żą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 zarządzania programem 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 zarządzania programem MIM.
ProfileTemplateUuid Tożsamość szablonu profilu, dla którego utworzono żądanie cm programu MIM.
Typ żądania Typ żądania cm programu MIM.
Deskryptor zabezpieczeń Deskryptor zabezpieczeń żądania zarządzania programem MIM.
Status Stan żądania cm programu MIM.
Przesłano Czas przesłania żądania cm programu MIM.
TargetUserUuid Tożsamość użytkownika docelowego dla żądania cm programu MIM.
Uuid Identyfikator żądania cm programu MIM.

Przykład

W tej sekcji przedstawiono przykład pobierania określonych żądań cm programu 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
}

Zobacz też

  • Last updated on