Creare una richiesta

Articolo
09/14/2023

Creare una richiesta di gestione certificati (CM) Microsoft Identity Manager (MIM).

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
POST	/CertificateManagement/api/v1.0/requests

Parametri URL

Nessuno.

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

Il corpo della richiesta contiene le proprietà seguenti:

Proprietà	Descrizione
profiletemplateuuid	Obbligatorio. Il GUID del modello di profilo per cui l’utente crea la richiesta.
datacollection	Obbligatorio. Una raccolta di coppie nome-valore che rappresenta i dati che devono essere forniti dall'iscritto. La raccolta di dati necessari che devono essere forniti può essere recuperata dal criterio di flusso di lavoro del modello di profilo. È possibile specificare una raccolta vuota.
target	Facoltativa. Il GUID dell'utente di destinazione per cui deve essere creata la richiesta. Se non specificato, per impostazione predefinita la destinazione è l'utente corrente.
tipo	Obbligatorio. Il tipo di richiesta che viene creato. I tipi di richiesta disponibili includono "Enroll", "Duplicate", "OfflineUnblock", "OnlineUpdate", "Renew", "Recover", "RecoverOnBehalf", "Reinstate", "Retire", "Revoke", "TemporaryCards" e "Unblock". Nota: non tutti i tipi di richiesta sono supportati in tutti i modelli di profilo. Ad esempio, non è possibile specificare l'operazione di sblocco in un modello di profilo software.
comment	Obbligatorio. Eventuali commenti che possono essere immessi dall'utente. I criteri del flusso di lavoro definiscono se la proprietà di commento è necessaria. È possibile specificare una stringa vuota.
priority	Facoltativa. La priorità della richiesta. Se non specificato, viene usata la priorità di richiesta predefinita, come determinato dalle impostazioni del modello di profilo.

Risposta

Questa sezione descrive la risposta.

Codici di risposta

Codice	Descrizione
201	Data di creazione
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 l'URI per la richiesta appena creata.

Esempio

Questa sezione fornisce un esempio per creare richieste di registrazione e sblocco.

Esempio: Richiesta 1

POST /CertificateManagement/api/v1.0/requests HTTP/1.1

{
    "datacollection":"[]",
    "type":"Enroll",
    "profiletemplateuuid":"a039b4d0-5ce8-4eff-8651-181c6576fda3",
    "comment":""
}

Esempio: Risposta 1

HTTP/1.1 201 Created

"api/v1.0/requests/a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099"

Esempio: Richiesta 2

POST /CertificateManagement/api/v1.0/requests HTTP/1.1

{  
    "datacollection":"[]",
    "type":"Unblock",
    "smartcard":"17cf063d-e337-4aa9-a822-346554ddd3c9",
    "comment":""
}

Esempio: Risposta 2

HTTP/1.1 201 Created

"api/v1.0/requests/0c96d73f-967b-420e-854a-43ad2a1504bc"

Esempio: Richiesta 3

POST /CertificateManagement/api/v1.0/requests HTTP/1.1

{
    "profiletemplateuuid" : "97CD65FA-AF4B-4587-9309-0DD6BFD8B4E1",
    "datacollection":
    [
        {"name" : "pavle"},
        {"city" : "seattle"}
    ],
    "target" : "97CC3493-F556-4C9B-9D8B-982434201527",
    "type" : "Enroll",
    "comment" : "LALALALA",
    "priority" :  "4"
}

Condividi tramite