Hämta begäran

Hämtar en eller flera angivna Microsoft Identity Manager (MIM) certifikathanteringsbegäranden (CM).

Anteckning

URL:erna i den här artikeln är relativa till det värdnamn som väljs under API-distributionen, till exempel https://api.contoso.com.

Förfrågan

Metod Begärans-URL
GET /CertificateManagement/api/v1.0/requests/{id}

URL-parametrar

Egenskap Beskrivning
id Valfritt. GUID för en begäran att hämta.

Frågeparametrar

Egenskap Beskrivning
targetuser Valfritt. Målanvändaren för begäran. Om inget mål anges returneras alla begäranden, oavsett målanvändare.

Obs! Endast värdet "current" stöds för närvarande.
status Valfritt. Anger status för begäran som ska hämtas. Möjliga statustyper är "Approved", "Canceled", "Completed", "Denied", "Executing", "Failed", "None" och "Pending".
Om ingen status anges returneras alla begäranden, oavsett status.

Begärandehuvuden

Vanliga begärandehuvuden finns i HTTP-begärande- och svarshuvuden i CM REST API-tjänstinformation.

Begärandetext

Inga.

Svarsåtgärder

I det här avsnittet beskrivs svaret.

Svarskoder

Kod Description
200 OK
204 Inget innehåll
403 Förbjudet
500 Internt fel

Svarshuvuden

Vanliga svarshuvuden finns i HTTP-begärande- och svarshuvuden i CM REST API-tjänstinformation.

Själva svaret

Vid lyckat resultat returnerar ett eller flera begärandeobjekt med följande egenskaper:

Name Beskrivning
Kommentar Kommentaren som är associerad med MIM CM-begäran.
Slutförd Den tid då MIM CM-begäran slutfördes.
DataCollection De datainsamlingsobjekt som är associerade med MIM CM-begäran.
DataCollectionFlags Alternativen för datainsamling för MIM CM-begäran.
Flaggor De alternativ som är associerade med MIM CM-begäran.
IsDataCollectionComplete Ett booleskt värde som anger om datainsamlingen har slutförts för MIM CM-begäran.
IsEnrollmentAgent Ett booleskt värde som anger om en registreringsagent krävs för att köra MIM CM-begäran.
IsSmartcard Ett booleskt värde som anger om MIM CM-begäran är en begäran om smartkort eller en programprofilsbegäran.
NewProfileUuid Identiteten för den nya programvaruprofilen som skapas av MIM CM-begäran.
NewSmartcardUuid Identiteten för det nya smartkortet som tilldelas av MIM CM-begäran.
OldProfileUuid Identiteten för den programvaruprofil som MIM CM-begäran skapades för.
OldSmartcardUuid Identiteten för smartkortet som MIM CM-begäran skapades för.
OriginatorUserUuid Identiteten för den användare som kom från MIM CM-begäran.
Prioritet PRIORITET FÖR MIM CM-begäran.
ProfileTemplateUuid Identiteten för profilmallen som MIM CM-begäran skapades för.
RequestType Typ av MIM CM-begäran.
SecurityDescriptor Säkerhetsbeskrivningen för MIM CM-begäran.
Status Status för MIM CM-begäran.
Skickad Den tid då MIM CM-begäran skickades.
TargetUserUuid Identiteten för målanvändaren för MIM CM-begäran.
Uuid Identifieraren för MIM CM-begäran.

Exempel

Det här avsnittet innehåller ett exempel för att hämta angivna MIM CM-begäranden.

Exempel: Begäran 1

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

Exempel: Svar 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
}

Exempel: Begäran 2

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

Exempel: Svar 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
}

Se även