Microsoft Identity Manager (MIM) 証明書管理 (CM) 要求を完了、キャンセル、または破棄済みとしてマークします。
注
この記事の URL は、https://api.contoso.comなど、API のデプロイ時に選択されたホスト名を基準にしています。
依頼
| メソッド | 要求 URL |
|---|---|
| 配置する | /CertificateManagement/api/v1.0/requests/{id} |
URL パラメーター
| プロパティ | 説明 |
|---|---|
| 識別子 | 必須。 完了する要求の GUID。 |
要求ヘッダー
一般的な要求ヘッダーについては、CM REST API サービスの詳細に HTTP 要求ヘッダーと応答ヘッダー を参照してください。
リクエストの本文
要求本文には、次のプロパティが含まれています。
| プロパティ | 説明 |
|---|---|
| ステータス | 要求を設定する状態。 指定できる値は、"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 要求のデータ収集のオプション。 |
| フラグ | 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。 |
| 優先順位 | MIM CM 要求の優先順位。 |
| ProfileTemplateUuid | MIM CM 要求が作成されたプロファイル テンプレートの ID。 |
| リクエストタイプ | MIM CM 要求の種類。 |
| SecurityDescriptor | MIM CM 要求のセキュリティ記述子。 |
| ステータス | 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
}