Delen via

Aanvraag maken

Maak een AANVRAAG voor Microsoft Identity Manager (MIM) Certificate Management (CM).

Notitie

De URL's in dit artikel zijn relatief ten opzichte van de hostnaam die tijdens de API-implementatie is gekozen, zoals https://api.contoso.com.

Aanvraag

Methode Aanvraag-URL
BERICHT /CertificateManagement/api/v1.0/requests

URL-parameters

Geen.

Headers aanvragen

Zie HTTP-aanvraag- en antwoordheaders in CM REST API-servicedetailsvoor algemene aanvraagheaders.

Inhoud van het verzoek

De hoofdtekst van de aanvraag bevat de volgende eigenschappen:

Vastgoed Beschrijving
profiletemplateuuid Verplicht. De GUID van de profielsjabloon waarvoor de gebruiker de aanvraag maakt.
gegevensverzameling Verplicht. Een verzameling naam-waardeparen die de gegevens vertegenwoordigen die door de ingeschreven persoon moeten worden verstrekt. De verzameling benodigde gegevens die moeten worden opgegeven, kan worden opgehaald uit het werkstroombeleid van de profielsjabloon. Er kan een lege verzameling worden opgegeven.
doel Facultatief. De GUID van de doelgebruiker waarvoor de aanvraag moet worden gemaakt. Als dit niet is opgegeven, wordt het doel standaard ingesteld op de huidige gebruiker.
soort Verplicht. Het type aanvraag dat wordt gemaakt. Beschikbare aanvraagtypen zijn onder andere 'Enroll', 'Duplicate', 'OfflineUnblock', 'OnlineUpdate', 'Renew', 'RecoverOnBehalf', 'Reinstate', 'Retire', 'Revoke', 'TemporaryCards' en 'Unblock'.

Opmerking: niet alle aanvraagtypen worden ondersteund op alle profielsjablonen. U kunt bijvoorbeeld de blokkeringsbewerking niet opgeven voor een softwareprofielsjabloon.
reactie Verplicht. Opmerkingen die door de gebruiker kunnen worden ingevoerd. Het werkstroombeleid bepaalt of de opmerkingseigenschap nodig is. Er kan een lege tekenreeks worden opgegeven.
voorrang Facultatief. De prioriteit van de aanvraag. Als dit niet is opgegeven, wordt de standaardaanvraagprioriteit, zoals bepaald door de profielsjablooninstellingen, gebruikt.

Reactie

In deze sectie wordt het antwoord beschreven.

Antwoordcodes

Code Beschrijving
201 Gemaakt
403 Verboden
500 Interne fout

Antwoordheaders

Zie HTTP-aanvraag- en antwoordheaders in CM REST API-servicedetailsvoor algemene antwoordheaders.

Antwoordlichaam

Retourneert bij succes de URI voor de zojuist gemaakte aanvraag.

Voorbeeld

In deze sectie vindt u een voorbeeld voor het maken van registratie- en deblokkeringsaanvragen.

Voorbeeld: Aanvraag 1

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

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

Voorbeeld: Antwoord 1

HTTP/1.1 201 Created

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

Voorbeeld: Aanvraag 2

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

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

Voorbeeld: Antwoord 2

HTTP/1.1 201 Created

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

Voorbeeld: Aanvraag 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"
}

Zie ook

  • Last updated on