Anforderung erstellen

Artikel
03/22/2025

Erstellen Sie eine MICROSOFT Identity Manager (MIM)-Zertifikatverwaltungsanforderung (CM).

Hinweis

Die URLs in diesem Artikel beziehen sich auf den Hostnamen, der während der API-Bereitstellung ausgewählt wird, z. B. https://api.contoso.com.

Anfrage

Methode	Anforderungs-URL
SENDEN	/CertificateManagement/api/v1.0/requests

URL-Parameter

Keiner.

Anforderungsheader

Allgemeine Anforderungsheader finden Sie unter HTTP-Anforderungs- und Antwortheader in CM-REST-API-Dienstdetails.

Anfragekörper

Der Anforderungstext enthält die folgenden Eigenschaften:

Eigentum	BESCHREIBUNG
profiletemplateuuid	Erforderlich. Die GUID der Profilvorlage, für die der Benutzer die Anforderung erstellt.
Datacollection	Erforderlich. Eine Sammlung von Name-Wert-Paaren, die die Daten darstellen, die vom Registrierten bereitgestellt werden sollen. Die Sammlung der erforderlichen Daten, die bereitgestellt werden müssen, kann aus der Workflowrichtlinie der Profilvorlage abgerufen werden. Eine leere Auflistung kann angegeben werden.
Ziel	Wahlfrei. Die GUID des Zielbenutzers, für den die Anforderung erstellt werden soll. Wenn nicht angegeben, wird das Ziel standardmäßig für den aktuellen Benutzer festgelegt.
type	Erforderlich. Der Typ der Anforderung, die erstellt wird. Zu den verfügbaren Anforderungstypen gehören "Registrieren", "Duplizieren", "OfflineUnblock", "OnlineUpdate", "Verlängern", "Wiederherstellen", "RecoverOnBehalf", "Reinstate", "Retire", "Revoke", "TemporaryCards" und "Unblock". Hinweis: Nicht alle Anforderungstypen werden für alle Profilvorlagen unterstützt. Beispielsweise können Sie den Entsperrungsvorgang für eine Softwareprofilvorlage nicht angeben.
Kommentar	Erforderlich. Alle Kommentare, die vom Benutzer eingegeben werden können. Die Workflowrichtlinie definiert, ob die Kommentareigenschaft erforderlich ist. Eine leere Zeichenfolge kann angegeben werden.
Priorität	Wahlfrei. Die Priorität der Anforderung. Wenn nicht angegeben, wird die Standardanforderungspriorität verwendet, wie sie durch die Profilvorlageneinstellungen bestimmt wird.

Antwort

In diesem Abschnitt wird die Antwort beschrieben.

Antwortcodes

Code	BESCHREIBUNG
201	Erstellt
403	Verboten
500	Interner Fehler

Antwortheader

Allgemeine Antwortheader finden Sie unter HTTP-Anforderungs- und Antwortheader in CM REST API-Dienstdetails.

Antwortkörper

Gibt bei Erfolg den URI für die neu erstellte Anforderung zurück.

Beispiel

Dieser Abschnitt enthält ein Beispiel zum Erstellen von Registrieren und Aufheben der Blockierung von Anforderungen.

Beispiel: Anforderung 1

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

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

Beispiel: Antwort 1

HTTP/1.1 201 Created

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

Beispiel: Anforderung 2

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

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

Beispiel: Antwort 2

HTTP/1.1 201 Created

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

Beispiel: Anforderung 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"
}

Freigeben über