Dela via

Skapa begäran

Skapa en begäran från Microsoft Identity Manager (MIM) Certificate Management (CM).

Anmärkning

URL:erna i den här artikeln är relativa till det värdnamn som väljs under API-distributionen, till exempel https://api.contoso.com.

Begäran

Metod Begärans-URL
Posten /CertificateManagement/api/v1.0/requests

URL-parametrar

Ingen.

Förfrågningsrubriker

Vanliga begärandehuvuden finns i HTTP-begärande- och svarshuvuden i CM REST API-tjänstinformation.

begäranens innehåll

Begärandetexten innehåller följande egenskaper:

Fastighet Beskrivning
profiletemplateuuid Obligatoriskt. GUID för profilmallen som användaren skapar begäran för.
datainsamling Obligatoriskt. En samling namn/värde-par som representerar de data som ska tillhandahållas av den registrerade. Insamlingen av nödvändiga data som måste anges kan hämtas från profilmallens arbetsflödesprincip. En tom samling kan anges.
mål Valfritt. GUID för målanvändaren som begäran ska skapas för. Om det inte anges är målet standard för den aktuella användaren.
typ Obligatoriskt. Den typ av begäran som skapas. Tillgängliga begärandetyper inkluderar "Registrera", "Duplicera", "OfflineUnblock", "OnlineUpdate", "Förnya", "Återställ", "RecoverOnBehalf", "Återställ", "Dra tillbaka", "Återkalla", "TemporaryCards" och "Avblockera".

Obs: Alla begärandetyper stöds inte för alla profilmallar. Du kan till exempel inte ange avblockeringsåtgärden för en mall för programvaruprofiler.
kommentar Obligatoriskt. Eventuella kommentarer som kan anges av användaren. Arbetsflödesprincipen definierar om kommentarsegenskapen är nödvändig. Du kan ange en tom sträng.
prioritet Valfritt. Prioriteten för begäran. Om den inte anges används standardprioriteten för begäran, enligt inställningarna för profilmallen.

Svar

I det här avsnittet beskrivs svaret.

Svarskoder

Kod Beskrivning
201 Skapad
403 Ej tillåtet
500 Internt fel

Svarshuvuden

Vanliga svarshuvuden finns i HTTP-begärande- och svarshuvuden i CM REST API-tjänstinformation.

Svarsdel

Vid lyckat resultat returnerar URI:n för den nyligen skapade begäran.

Exempel

Det här avsnittet innehåller ett exempel för att skapa begäranden om registrering och avblockering.

Exempel: Begäran 1

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

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

Exempel: Svar 1

HTTP/1.1 201 Created

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

Exempel: Begäran 2

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

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

Exempel: Svar 2

HTTP/1.1 201 Created

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

Exempel: Begäran 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"
}

Se även

  • Last updated on