建立要求

建立 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。 如果未指定,則目標會預設為目前的使用者。
類型 必要。 正在建立的要求類型。 可用的要求類型包括「註冊」、「重複」、「OfflineUnblock」、「OnlineUpdate」、「續約」、「復原」、「RecoverOnBehalf」、「恢復」、「淘汰」、「撤銷」、「TemporaryCards」和「解除封鎖」。

注意:並非所有的要求類型都支援所有的設定檔範本。 例如,您無法在軟體設定檔範本上指定解除封鎖作業。
comment 必要。 使用者可能輸入的任何註解。 工作流程原則會定義是否需要 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"
}

另請參閱