Anforderung erstellen

Artikel
09/14/2023

Erstellen Sie eine MICROSOFT IDENTITY MANAGER-Anforderung (MIM) Certificate Management (CM).

Hinweis

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

Anforderung

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

URL-Parameter

Keine.

Anforderungsheader

Informationen zu gängigen Anforderungsheadern finden Sie unter HTTP-Anforderungs- und Antwortheader in CM-REST-API-Dienstdetails.

Anforderungstext

Der Anforderungstext enthält die folgenden Eigenschaften:

Eigenschaft	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 vom Registrierenden bereitzustellenden Daten darstellen. Die Sammlung der erforderlichen Daten, die bereitgestellt werden müssen, können über die Workflowrichtlinie der Profilvorlage abgerufen werden. Eine leere Sammlung kann angegeben werden.
target	Optional. Die GUID des Zielbenutzers, für den die Anforderung erstellt werden soll. Wenn nicht angegeben, wird standardmäßig der aktuelle Benutzer als Ziel verwendet.
Typ	Erforderlich. Der Typ der zu erstellenden Anforderung. Zu den verfügbaren Anforderungstypen gehören "Enroll", "Duplicate", "OfflineUnblock", "OnlineUpdate", "Renew", "Recover", "RecoverOnBehalf", "Reinstate", "Retire", "Revoke", "TemporaryCards" und "Unblock". Hinweis: Nicht alle Anforderungstypen werden für alle Profilvorlagen unterstützt. Beispielsweise können Sie den Vorgang Blockierung aufheben nicht für eine Softwareprofilvorlage angeben.
comment	Erforderlich. Beliebige Kommentare, die vom Benutzer eingegeben werden können. Die Workflowrichtlinie definiert, ob die Comment-Eigenschaft erforderlich ist. Eine leere Zeichenfolge kann angegeben werden.
priority	Optional. Die Priorität der Anforderung. Wenn nicht angegeben, wird die Standardanforderungspriorität verwendet, die durch die Profilvorlageneinstellungen bestimmt wird.

Antwort

In diesem Abschnitt wird die Antwort beschrieben.

Antwortcodes

Code	BESCHREIBUNG
201	Erstellt
403	Verboten
500	Interner Fehler

Antwortheader

Informationen zu allgemeinen Antwortheadern finden Sie unter HTTP-Anforderungs- und Antwortheader in CM REST API-Dienstdetails.

Antworttext

Bei Erfolg wird der URI für die neu erstellte Anforderung zurückgegeben.

Beispiel

Dieser Abschnitt enthält ein Beispiel zum Erstellen von Registrierungs- und Entsperrungsanforderungen.

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