要求をキャンセル、破棄、または完了する

  • [アーティクル]

Microsoft Identity Manager (MIM) 証明書管理 (CM) 要求を完了、取り消し、または破棄済みとしてマークします。

注意

この記事の URL は、API のデプロイ中に選択されたホスト名 (など https://api.contoso.com) に対して相対的です。

Request

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

URL パラメーター

プロパティ 説明
id 必須。 完了する要求の GUID。

要求ヘッダー

一般的な要求ヘッダーについては、「CM REST API サービスの詳細」の HTTP 要求ヘッダーと応答ヘッダーに関するページを参照してください。

要求本文

要求本文には、次のプロパティが含まれています。

プロパティ 説明
status 要求に設定する状態。 指定できる値は、"Completed"、"Canceled"、または "Abandoned" です。

Response

このセクションでは、応答について説明します。

応答コード

コード 説明
200 OK
204 コンテンツなし
403 Forbidden
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 要求によって生成される新しいソフトウェア プロファイルの ID。
NewSmartcardUuid MIM CM 要求によって割り当てられる新しいスマート カードの ID。
OldProfileUuid MIM CM 要求が作成されたソフトウェア プロファイルの ID。
OldSmartcardUuid MIM CM 要求が作成されたスマート カードの ID。
OriginatorUserUuid MIM CM 要求を送信したユーザーの ID。
Priority MIM CM 要求の優先度。
ProfileTemplateUuid MIM CM 要求が作成されたプロファイル テンプレートの ID。
RequestType MIM CM 要求の種類。
SecurityDescriptor MIM CM 要求のセキュリティ記述子。
Status MIM CM 要求の状態。
送信 MIM CM 要求が送信された時刻。
TargetUserUuid MIM CM 要求の対象ユーザーの ID。
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
}

関連項目