Richiesta GET
Ottiene una o più richieste di gestione certificati (CM) Microsoft Identity Manager (MIM) specificate.
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 |
|---|---|
| GET | /CertificateManagement/api/v1.0/requests/{id} |
Parametri URL
| Proprietà | Descrizione |
|---|---|
| id | Facoltativa. Il GUID di una richiesta di recupero. |
Parametri di query
| Proprietà | Descrizione |
|---|---|
| targetuser | Facoltativa. L'utente di destinazione della richiesta. Se non viene specificata alcuna destinazione, vengono restituite tutte le richieste, indipendentemente dall'utente di destinazione. Nota: attualmente è supportato solo il valore "current". |
| status | Facoltativa. Indica lo stato della richiesta da recuperare. I tipi di stato possibili sono "Approved", "Canceled", "Completed", "Denied", "Executing", "Failed", "None" e "Pending". Se non viene specificato alcuno stato, vengono restituite tutte le richieste, indipendentemente dallo stato. |
Intestazioni della richiesta
Per le intestazioni di richiesta comuni, vedere Intestazioni di richiesta e risposta HTTP nei dettagli del servizio API REST cm.
Testo della richiesta
Nessuno.
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 e risposta HTTP nei dettagli del servizio API REST cm.
Corpo della risposta
In caso di esito positivo, restituisce uno o più oggetti Richiesta con 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 ottenere le richieste CM MIM specificate.
Esempio: Richiesta 1
GET /certificatemanagement/api/v1.0/requests/a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099 HTTP/1.1
Esempio: Risposta 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
}
Esempio: Richiesta 2
GET /certificatemanagement/api/v1.0/requests/0c96d73f-967b-420e-854a-43ad2a1504bc HTTP/1.1
Esempio: Risposta 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
}