Annullare, abbandonare o completare una richiesta
Contrassegnare una richiesta di gestione certificati (MIM) Microsoft Identity Manager (CM) come completata, annullata o abbandonata.
Nota
Gli URL di questo articolo sono relativi al nome host scelto durante la distribuzione api, ad esempio https://api.contoso.com
.
Richiesta
Metodo | URL richiesta |
---|---|
PUT | /CertificateManagement/api/v1.0/requests/{id} |
Parametri URL
Proprietà | Descrizione |
---|---|
id | Obbligatorio. Il GUID del completamento della richiesta. |
Intestazioni della richiesta
Per le intestazioni di richiesta comuni, vedere Intestazioni di richiesta HTTP e risposta nei dettagli del servizio API REST CM.
Testo della richiesta
Il corpo della richiesta contiene le proprietà seguenti:
Proprietà | Descrizione |
---|---|
status | Lo stato su cui impostare la richiesta. I valori possibili sono "Completato", "Annullata" o "Abbandonata". |
Risposta
Questa sezione descrive la risposta.
Codici di risposta
Codice | Descrizione |
---|---|
200 | OK |
204 | Nessun contenuto |
403 | Accesso negato |
500 | Errore interno |
Intestazioni di risposta
Per le intestazioni di risposta comuni, vedere Intestazioni di richiesta HTTP e risposta nei dettagli del servizio API REST CM.
Corpo della risposta
In caso di esito positivo, restituisce un oggetto Microsoft.Clm.Shared.Request.Request . L'oggetto descrive la richiesta CM MIM contrassegnata come completata. L'oggetto contiene le proprietà seguenti:
Nome | Descrizione |
---|---|
Comment | Il commento associato alla richiesta CM MIM. |
Completato | L’ora in cui è stata completata la richiesta CM MIM. |
DataCollection | Gli elementi di raccolta dati che sono associati alla richiesta CM MIM. |
DataCollectionFlags | Le opzioni per la raccolta di dati per la richiesta CM MIM. |
Flags | Le opzioni associate alla richiesta CM MIM. |
IsDataCollectionComplete | Valore booleano che indica se la raccolta dei dati è stata completata per la richiesta CM MIM. |
IsEnrollmentAgent | Valore booleano che indica se è necessario un agente di registrazione per eseguire la richiesta CM MIM. |
IsSmartcard | Valore booleano che indica se la richiesta CM MIMè una richiesta smart card o una richiesta di profilo software. |
NewProfileUuid | L'identità del nuovo profilo software che viene generato dalla richiesta CM MIM. |
NewSmartcardUuid | L'identità della nuova smart card che viene generata dalla richiesta CM MIM. |
OldProfileUuid | L'identità del profilo software per cui è stata creata la richiesta CM MIM. |
OldSmartcardUuid | L'identità della smart card per cui è stata creata la richiesta CM MIM. |
OriginatorUserUuid | Identità dell'utente che ha originato la richiesta CM MIM. |
Priorità | La priorità della richiesta CM MIM. |
ProfileTemplateUuid | L'identità del modello di profilo per cui è stata creata la richiesta CM MIM. |
RequestType | Il tipo della richiesta CM MIM. |
SecurityDescriptor | Descrittore di sicurezza per la richiesta CM MIM. |
Stato | Lo stato della richiesta CM MIM. |
Inviata | L’ora in cui è stata inviata la richiesta CM MIM. |
TargetUserUuid | L'identità dell'utente di destinazione per la richiesta CM MIM. |
Uuid | L’identificatore della richiesta CM MIM. |
Esempio
Questa sezione fornisce un esempio per contrassegnare una richiesta come completata.
Esempio: Richiesta
PUT /certificatemanagement/api/v1.0/requests/a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099 HTTP/1.1
{
"status":"Completed"
}
Esempio: Risposta
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
}