1 つ以上の指定された Microsoft Identity Manager (MIM) 証明書管理 (CM) 要求を取得します。
注
この記事の URL は、https://api.contoso.comなど、API のデプロイ時に選択されたホスト名を基準にしています。
依頼
| メソッド | 要求 URL |
|---|---|
| 取得する | /CertificateManagement/api/v1.0/requests/{id} |
URL パラメーター
| プロパティ | 説明 |
|---|---|
| 識別子 | 随意。 取得する要求の GUID。 |
クエリ パラメーター
| プロパティ | 説明 |
|---|---|
| targetuser | 随意。 要求のターゲット ユーザー。 ターゲットが指定されていない場合は、ターゲット ユーザーに関係なく、すべての要求が返されます。 注: 現在サポートされているのは値 "current" のみです。 |
| ステータス | 随意。 取得する要求の状態を示します。 使用可能な状態の種類は、"承認済み"、"キャンセル済み"、"完了"、"拒否"、"実行中"、"失敗"、"なし"、"保留中" です。 状態が指定されていない場合は、状態に関係なくすべての要求が返されます。 |
要求ヘッダー
一般的な要求ヘッダーについては、CM REST API サービスの詳細に HTTP 要求ヘッダーと応答ヘッダー を参照してください。
リクエストの本文
なし。
応答
このセクションでは、応答について説明します。
応答コード
| コード | 説明 |
|---|---|
| 200 | わかりました |
| 204 | コンテンツなし |
| 403 | 禁じられた |
| 500 | 内部エラー |
応答ヘッダー
一般的な応答ヘッダーについては、CM REST API サービスの詳細に HTTP 要求ヘッダーと応答ヘッダーの に関するページを参照してください。
応答内容
成功した場合は、次のプロパティを持つ 1 つ以上の Request オブジェクトを返します。
| 名前 | 説明 |
|---|---|
| コメント | 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 要求の識別子。 |
例
このセクションでは、指定した MIM CM 要求を取得する例を示します。
例: 要求 1
GET /certificatemanagement/api/v1.0/requests/a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099 HTTP/1.1
例: 応答 1
HTTP/1.1 200 OK
{
"Uuid":"a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099",
"RequestType":1,
"Status":3,
"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":"0001-01-01T00:00:00",
"NewProfileUuid":"00000000-0000-0000-0000-000000000000",
"OldProfileUuid":"00000000-0000-0000-0000-000000000000",
"NewSmartcardUuid":"00000000-0000-0000-0000-000000000000",
"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
}
例: 要求 2
GET /certificatemanagement/api/v1.0/requests/0c96d73f-967b-420e-854a-43ad2a1504bc HTTP/1.1
例: 応答 2
HTTP/1.1 200 OK
{
"Uuid":"0c96d73f-967b-420e-854a-43ad2a1504bc",
"RequestType":5,
"Status":3,
"Flags":2,
"DataCollection":[
{
"Name":"Sample Data Item",
"Value":null
}
],
"DataCollectionFlags":32,
"OriginatorUserUuid":"8f1590dc-d932-4b66-8e68-2e91c5880780",
"TargetUserUuid":"8f1590dc-d932-4b66-8e68-2e91c5880780",
"Submitted":"2015-07-07T23:40:33.133Z",
"Completed":"0001-01-01T00:00:00",
"NewProfileUuid":"b99ff38c-6653-471f-ae3c-325bb351a6bc",
"OldProfileUuid":"b99ff38c-6653-471f-ae3c-325bb351a6bc",
"NewSmartcardUuid":"17cf063d-e337-4aa9-a822-346554ddd3c9",
"OldSmartcardUuid":"17cf063d-e337-4aa9-a822-346554ddd3c9",
"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;;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",
"IsSmartcard":true,
"IsEnrollmentAgent":false,
"IsDataCollectionComplete":false
}