建立要求

發行項
09/14/2023

建立MICROSOFT IDENTITY MANAGER (MIM) 憑證管理 (CM) 要求。

注意

本文中的 URL 相對於 API 部署期間所選擇的主機名稱，例如 https://api.contoso.com 。

要求

方法	要求 URL
POST	/CertificateManagement/api/v1.0/requests

URL 參數

無。

要求標頭

如需常見的要求標頭，請參閱CM REST API 服務詳細資料中的HTTP 要求和回應標頭。

要求本文

要求本文包含下列屬性：

屬性	描述
profiletemplateuuid	必要。使用者正在建立要求的設定檔範本的 GUID。
datacollection	必要。表示註冊者所提供之資料的名稱-值組的集合。可以從設定檔範本的工作流程原則中，擷取必須提供的必要資料集合。您可以指定空集合。
目標	選擇性。為其建立要求的目標使用者的 GUID。如果未指定，則目標預設為目前使用者。
類型	必要。正在建立的要求類型。可用的要求類型包括「Enroll」、「Duplicate」、「OfflineUnblock」、「OnlineUpdate」、「Renew」、「Recovery」、「RecoveryOnBehalf」、「Reinstate」、「Retire」、「Revoke」、「TemporaryCards」和「Unblock」。注意：並非所有要求類型都支援所有設定檔範本。例如，您無法在軟體設定檔範本上指定解除封鎖作業。
comment	必要。使用者可能輸入的任何註解。工作流程原則會定義是否需要批註屬性。您可以指定空字串。
priority	選擇性。要求的優先順序。如果未指定，則會使用設定檔範本設定所決定的預設要求優先順序。

回應

本節描述回應。

回應碼

程式碼	描述
201	建立時間
403	禁止
500	內部錯誤

回應標頭

如需常見的回應標頭，請參閱CM REST API 服務詳細資料中的HTTP 要求和回應標頭。

回應本文

成功時會傳回新建要求的 URI。

範例

本節提供建立註冊和解除封鎖要求的範例。

範例：要求 1

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

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

範例：回應 1

HTTP/1.1 201 Created

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

範例：要求 2

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

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

範例：回應 2

HTTP/1.1 201 Created

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

範例：要求 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"
}