共用方式為

取消、放棄或完成要求

  • 發行項

將MICROSOFT IDENTITY MANAGER (MIM) 憑證管理 (CM) 要求標示為已完成、取消或放棄。

注意

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

要求

方法 要求 URL
PUT /CertificateManagement/api/v1.0/requests/{id}

URL 參數

屬性 描述
id 必要。 要完成之要求的 GUID。

要求標頭

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

要求本文

要求本文包含下列屬性：

屬性 描述
status 設定給要求的狀態。 可能的值為 「Completed」、「Canceled」 或 「Abandoned」。

回應

本節描述回應。

回應碼

程式碼 描述
200 [確定]
204 沒有內容
403 禁止
500 內部錯誤

回應標頭

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

回應本文

成功時，會傳回 Microsoft.Clm.Shared.Requests.Request 物件。 物件描述已標示為已完成的 MIM CM 要求。 物件包含下列屬性：

名稱 描述
註解 與 MIM CM 要求相關聯的註解。
已完成 MIM CM 要求的完成時間。
DataCollection 與 MIM CM 要求相關聯的資料收集項目。
DataCollectionFlags MIM CM 要求的資料收集的選項。
Flags MIM CM 要求相關聯的選項。
IsDataCollectionComplete 布林值，指出是否已完成 MIM CM 要求的資料收集。
IsEnrollmentAgent 布林值，指出是否需要註冊代理程式來執行 MIM CM 要求。
IsSmartcard 布林值，指出如果 MIM CM 要求是智慧卡要求還是軟體設定檔要求。
NewProfileUuid MIM CM 要求所產生的新軟體設定檔身分。
NewSmartcardUuid MIM CM 要求所指派的新智慧卡身分。
OldProfileUuid 建立 MIM CM 要求的軟體設定檔身分。
OldSmartcardUuid 建立 MIM CM 要求的暫慧卡身分。
OriginatorUserUuid 產生 MIM CM 要求之使用者的身分識別。
優先順序 MIM CM 要求的優先順序。
ProfileTemplateUuid 建立 MIM CM 要求的設定檔範本的身分。
RequestType MIM CM 要求的類型。
SecurityDescriptor MIM CM 要求的安全性描述元。
狀態 MIM CM 要求的狀態。
已提交 已提交 MIM CM 要求的時間。
TargetUserUuid MIM CM 要求的目標使用者身分。
Uuid MIM CM 要求的識別碼。

範例

本節提供將要求標示為已完成的範例。

範例：要求

PUT /certificatemanagement/api/v1.0/requests/a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099 HTTP/1.1


{
    "status":"Completed"
}

範例：回應

HTTP/1.1 200 OK

{
    "Uuid":"a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099",
    "RequestType":1,
    "Status":8,
    "Flags":2,
    "DataCollection":[

    ],
    "DataCollectionFlags":32,
    "OriginatorUserUuid":"8f1590dc-d932-4b66-8e68-2e91c5880780",
    "TargetUserUuid":"8f1590dc-d932-4b66-8e68-2e91c5880780",
    "Submitted":"2015-07-07T23:36:21.93Z",
    "Completed":"2015-07-07T23:37:37.767Z",
    "NewProfileUuid":"b99ff38c-6653-471f-ae3c-325bb351a6bc",
    "OldProfileUuid":"00000000-0000-0000-0000-000000000000",
    "NewSmartcardUuid":"17cf063d-e337-4aa9-a822-346554ddd3c9",
    "OldSmartcardUuid":"00000000-0000-0000-0000-000000000000",
    "Priority":0,
    "Comment":"",
    "ProfileTemplateUuid":"a039b4d0-5ce8-4eff-8651-181c6576fda3",
    "SecurityDescriptor":"O:S-1-5-21-2127521184-1604012920-1887927527-14134865D:(D;;LC;;;S-1-5-21-2127521184-1604012920-1887927527-14995557)(A;;DCSW;;;S-1-5-21-2127521184-1604012920-1887927527-5094533)(A;;DCSW;;;S-1-5-21-2127521184-1604012920-1887927527-5094534)(A;;DCSW;;;S-1-5-21-2127521184-1604012920-1887927527-5219125)(A;;SWRC;;;S-1-5-21-2127521184-1604012920-1887927527-5094533)(A;;RC;;;WD)(A;;CCDCLCSWSDRC;;;S-1-5-21-2127521184-1604012920-1887927527-14134865)(A;;DCSW;;;S-1-5-21-2127521184-1604012920-1887927527-14995557)(A;;CCDCSW;;;S-1-5-21-2127521184-1604012920-1887927527-14995557)\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000",
    "IsSmartcard":true,
    "IsEnrollmentAgent":false,
    "IsDataCollectionComplete":false
}

另請參閱