Skapa begäranCreate Request

Skapa en MIM CM-begäran.Create a MIM CM request.

Obs: URL: er som visas i det här avsnittet är i förhållande till värdnamnet valt under distributionen av API, till exempel: https://api.contoso.com.Note: URLs shown in this topic are relative to the hostname chosen during API deployment; for example: https://api.contoso.com.

BegäranRequest

MetodMethod URL-begäranRequest URL
POSTPOST /CertificateManagement/API/v1.0/Requests/CertificateManagement/api/v1.0/requests

URL-parametrarURL Parameters

ingetnone

Huvuden för begäranRequest Headers

Vanliga begärandehuvuden finns HTTP-begäran och svarshuvuden i CM REST API-tjänsteinformation.For common request headers, see HTTP Request and Response Headers in CM REST API Service Details.

BegärandetextenRequest Body

Begärandetexten innehåller följande egenskaper.The request body contains the following properties.

EgenskapProperty BeskrivningDescription
profiletemplateuuidprofiletemplateuuid Obligatoriskt.Required. GUID för profilmallen som användaren skapar denna begäran.The GUID of the profile template that the user is creating the request for.
datacollectiondatacollection Obligatoriskt.Required. En uppsättning namn / värde-par som representerar de data som ska tillhandahållas av denna registrerare.A collection of name-value pairs representing the data that is to be provided by the enrollee. Insamling av nödvändiga data som måste anges kan hämtas från av Profilmall arbetsflöde principen.The collection of necessary data that must be provided can be retrieved from the profile template’s workflow policy. En tom samling kan anges.An empty collection can be specified.
måltarget Valfritt.Optional. GUID för målanvändaren som begäran kommer att skapas för.The GUID of the target user that the request is to be created for. Om inget annat anges, detta är som standard till den aktuella användaren.If not specified, this defaults to the current user.
typtype Obligatoriskt.Required. Typ av begäran som håller på att skapas.The type of request that is being created. Om tillgängliga begärandetyper är: ”registrera”, ”kopia”, ”OfflineUnblock”, ”OnlineUpdate”, ”förnya”, ”återställa”, ”RecoverOnBehalf”, ”återställa”, ”ta bort”, ”återkalla”, ”TemporaryCards” och ”avblockera”.Available request types are : "Enroll", "Duplicate", "OfflineUnblock", "OnlineUpdate", "Renew", "Recover", "RecoverOnBehalf", "Reinstate", "Retire", "Revoke", "TemporaryCards", and "Unblock".
Obs: stöds inte alla typer av begäran på alla profilmallar för.Note: Not all types of request are supported on all profile templates. Du kan till exempel ange en avblockera åtgärd på en Profilmall för programvara.For example, you can't specify an unblock operation on a software profile template.
kommentarcomment Obligatoriskt.Required. Eventuella kommentarer som kan anges av användaren.Any comments that may be entered by the user. Principen för arbetsflöde definierar om detta är nödvändigt.The workflow policy will define whether this is necessary. En tom sträng kan anges.An empty string can be specified.
Prioritetpriority Valfritt.Optional. Prioritet för begäran.The priority of the request. Om inget anges används begäran standardprioritet utifrån mallen profilinställningarna.If not specified, the default request priority, as determined by the profile template settings, will be used.

SvarResponse

SvarskoderResponse Codes

KodCode BeskrivningDescription
201201 SkapadCreated
403403 Tillåts inteForbidden
500500 Internt felInternal Error

SvarsrubrikerResponse Headers

Vanliga svarshuvuden finns HTTP-begäran och svarshuvuden i CM REST API-tjänsteinformation.For common response headers, see HTTP Request and Response Headers in CM REST API Service Details.

SvarstextenResponse Body

Returnerar URI: N för den nyligen skapade begäranden på åtgärden lyckades.On success, returns the URI for the newly created request.

ExempelExample

Begäran 1Request 1

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

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

Svar 1Response 1

HTTP/1.1 201 Created

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

Förfrågan 2Request 2

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

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

Svar 2Response 2

HTTP/1.1 201 Created

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

Begäran 3Request 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 ävenSee Also