Condividi tramite


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
}

Vedi anche