建立請求

建立Microsoft Identity Manager （MIM） 憑證管理 （CM） 要求。

備註

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

請求

方法 請求 URL
郵件 /CertificateManagement/api/v1.0/requests

URL 參數

沒有。

請求標頭

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

請求主體

要求本文包含下列屬性：

財產 說明
profiletemplateuuid 必須的。 使用者正在建立要求的配置檔範本 GUID。
datacollection 必須的。 名稱/值組的集合，表示要由註冊者提供的數據。 必須提供的必要數據集合可以從配置檔範本的工作流程原則擷取。 可以指定空集合。
目標 選擇性。 要為其建立要求的目標使用者 GUID。 如果未指定，則目標會預設為目前使用者。
型別 必須的。 正在建立的要求類型。 可用的要求類型包括 “Enroll”、“Duplicate”、“OfflineUnblock”、“OnlineUpdate”、“Renew”、“Recover”、“RecoverOnBehalf”、“Reinstate”、“Retire”、“Revoke”、“TemporaryCards” 和 “Unblock”。

附註：並非所有配置檔範本都支援所有要求類型。 例如，您無法在軟體設定檔範本上指定解除封鎖作業。
留言 必須的。 用戶可輸入的任何批注。 工作流程原則會定義是否需要批注屬性。 可以指定空字串。
優先權 選擇性。 要求的優先順序。 如果未指定，則會使用配置檔範本設定所決定的預設要求優先順序。

回應

本節描述回應。

回應碼

Code 說明
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"
}

另請參閱

  • Last updated on