共用方式為

建立請求

建立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”。

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

回應

本節描述回應。

回應碼

程式碼 說明
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