Avbryta, avbryta eller slutföra en begäran

Artikel
09/14/2023

Markera en Microsoft Identity Manager (MIM) certifikathanteringsbegäran (CM) som slutförd, avbruten eller övergiven.

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
PUT	/CertificateManagement/api/v1.0/requests/{id}

URL-parametrar

Egenskap	Beskrivning
id	Krävs. GUID för begäran att slutföra.

Begärandehuvuden

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

Begärandetext

Begärandetexten innehåller följande egenskaper:

Egenskap	Beskrivning
status	Status som begäran ska anges till. Möjliga värden är "Slutförd", "Avbruten" eller "Övergiven".

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 Microsoft.Clm.Shared.Requests.Request-objekt . Objektet beskriver MIM CM-begäran som har markerats som slutförd. Objektet innehåller 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 markera en begäran som slutförd.

Exempel: Begäran

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


{
    "status":"Completed"
}

Exempel: Svar

HTTP/1.1 200 OK

{
    "Uuid":"a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099",
    "RequestType":1,
    "Status":8,
    "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":"2015-07-07T23:37:37.767Z",
    "NewProfileUuid":"b99ff38c-6653-471f-ae3c-325bb351a6bc",
    "OldProfileUuid":"00000000-0000-0000-0000-000000000000",
    "NewSmartcardUuid":"17cf063d-e337-4aa9-a822-346554ddd3c9",
    "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
}

Dela via