Získat žádost

Článek
09/14/2023

Získá jeden nebo více zadaných požadavků Microsoft Identity Manager (MIM) Certificate Management (CM).

Poznámka

Adresy URL v tomto článku jsou relativní vzhledem k názvu hostitele zvolenému při nasazování rozhraní API, například https://api.contoso.com.

Žádost

Metoda	Adresa URL požadavku
GET	/CertificateManagement/api/v1.0/requests/{id}

Parametry adresy URL

Vlastnost	Popis
id	Nepovinný parametr. Identifikátor GUID požadavku, který se má načíst.

Parametry dotazů

Vlastnost	Popis
targetuser	Nepovinný parametr. Cílový uživatel požadavku. Pokud není zadán žádný cíl, vrátí se všechny požadavky bez ohledu na cílového uživatele. Poznámka: Aktuálně je podporována pouze hodnota "current".
status	Nepovinný parametr. Označuje stav požadavku, který se má načíst. Možné typy stavů jsou "Schváleno", "Zrušeno", "Dokončeno", "Odepřeno", "Provádění", "Neúspěšné", "Žádné" a "Čeká na vyřízení". Pokud není zadán žádný stav, vrátí se všechny požadavky bez ohledu na stav.

Hlavičky požadavku

Informace o běžných hlavičkách požadavků najdete v tématu Hlavičky požadavků HTTP a odpovědí v podrobnostech o službě ROZHRANÍ REST API CM.

Text požadavku

Žádné

Odpověď

Tato část popisuje odpověď.

Kódy odpovědí

Kód	Description
200	OK
204	Žádný obsah
403	Forbidden
500	Vnitřní chyba

Hlavičky odpovědi

Informace o běžných hlavičkách odpovědí najdete v tématu Http request and response headers (Hlavičky požadavků HTTP a odpovědí ) v podrobnostech služby CM REST API.

Text odpovědi

V případě úspěchu vrátí jeden nebo více objektů Request s následujícími vlastnostmi:

Název	Description
Komentář	Komentář přidružený k požadavku MIM CM.
Dokončeno	Čas dokončení požadavku MIM CM.
DataCollection	Položky shromažďování dat, které jsou přidruženy k požadavku MIM CM.
DataCollectionFlags	Možnosti shromažďování dat pro požadavek MIM CM.
Příznaky	Možnosti přidružené k požadavku MIM CM.
IsDataCollectionComplete	Logická hodnota, která označuje, jestli bylo dokončeno shromažďování dat pro požadavek MIM CM.
IsEnrollmentAgent	Logická hodnota, která označuje, jestli se ke spuštění požadavku MIM CM vyžaduje agent registrace.
IsSmartcard	Logická hodnota, která označuje, jestli je žádost MIM CM žádost o čipovou kartu nebo žádost o profil softwaru.
NovýProfileUuid	Identita nového softwarového profilu vytvořeného požadavkem MIM CM.
NewSmartcardUuid	Identita nové čipové karty, která je přiřazena požadavkem MIM CM.
OldProfileUuid	Identita softwarového profilu, pro který byl vytvořen požadavek MIM CM.
OldSmartcardUuid	Identita čipové karty, pro kterou byl vytvořen požadavek MIM CM.
PůvodceUserUuid	Identita uživatele, který žádost MIM CM odeslal.
Priorita	Priorita požadavku MIM CM.
ProfileTemplateUuid	Identita šablony profilu, pro kterou byl vytvořen požadavek MIM CM.
Requesttype	Typ požadavku MIM CM.
Popisovač SecurityDescriptor	Popisovač zabezpečení pro požadavek MIM CM.
Stav	Stav požadavku MIM CM.
Odesláno	Čas odeslání požadavku MIM CM.
TargetUserUuid	Identita cílového uživatele pro požadavek MIM CM.
Uuid	Identifikátor požadavku MIM CM.

Příklad

Tato část obsahuje příklad získání zadaných požadavků MIM CM.

Příklad: Žádost 1

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

Příklad: Odpověď 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
}

Příklad: Žádost 2

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

Příklad: Odpověď 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
}

Sdílet prostřednictvím