Condividi tramite

Annullare, abbandonare o completare una richiesta

  • Articolo

Contrassegnare una richiesta di gestione certificati (CM) di Microsoft Identity Manager (MIM) come completata, annullata o abbandonata.

Nota

Gli URL in questo articolo sono relativi al nome host scelto durante la distribuzione dell'API, ad esempio https://api.contoso.com.

Richiesta

Metodo URL richiesta
INSERIRE /CertificateManagement/api/v1.0/requests/{id}

Parametri URL

Proprietà Descrizione
id Obbligatorio. GUID della richiesta da completare.

Header di richiesta

Per le intestazioni di richiesta comuni, vedere intestazioni di richiesta e risposta HTTP nei dettagli del servizio API REST cm .

Testo della richiesta

Il corpo della richiesta contiene le proprietà seguenti:

Proprietà Descrizione
stato Stato su cui impostare la richiesta. I valori possibili sono "Completed", "Canceled" o "Abandoned".

Risposta

Questa sezione descrive la risposta.

Codici di risposta

Codice Descrizione
200 Va bene
204 Nessun contenuto
403 Vietato
500 Errore interno

Intestazioni di risposta

Per le intestazioni di risposta comuni, vedere intestazioni di richiesta e risposta HTTP nei dettagli del servizio API REST cm .

Corpo della risposta

In caso di esito positivo, restituisce un oggetto Microsoft.Clm.Shared.Requests.Request. L'oggetto descrive la richiesta CM MIM contrassegnata come completata. L'oggetto contiene le proprietà seguenti:

Nome Descrizione
Commento Commento associato alla richiesta CM MIM.
Finito Ora in cui la richiesta CM MIM è stata completata.
DataCollection Elementi della raccolta dati associati alla richiesta CM MIM.
DataCollectionFlags Opzioni per la raccolta dati per la richiesta CM MIM.
Bandiere Opzioni associate alla richiesta CM MIM.
IsDataCollectionComplete Valore booleano che indica se la raccolta 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 di smart card o una richiesta di profilo software.
NewProfileUuid Identità del nuovo profilo software prodotto dalla richiesta CM MIM.
NewSmartcardUuid Identità della nuova smart card assegnata dalla richiesta CM MIM.
OldProfileUuid Identità del profilo software per cui è stata creata la richiesta CM MIM.
OldSmartcardUuid Identità della smart card per cui è stata creata la richiesta CM MIM.
OriginatorUserUuid Identità dell'utente che ha originato la richiesta CM MIM.
Priorità Priorità della richiesta CM MIM.
ProfileTemplateUuid Identità del modello di profilo per cui è stata creata la richiesta CM MIM.
RequestType Tipo della richiesta CM MIM.
Descrittore di Sicurezza Descrittore di sicurezza per la richiesta CM MIM.
Stato Stato della richiesta CM MIM.
Inviato Ora in cui è stata inviata la richiesta CM MIM.
TargetUserUuid Identità dell'utente di destinazione per la richiesta CM MIM.
Uuid Identificatore della richiesta CM MIM.

Esempio

In questa sezione viene fornito 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
}

Vedere anche