Get 要求

証明書管理 (CM) Microsoft Identity Manager (MIM) 要求を 1 つ以上取得します。

注意

この記事の URL は、API のデプロイ中に選択されたホスト名 (例: ) を基準にしています https://api.contoso.com

Request

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

URL パラメーター

プロパティ 説明
id 任意。 取得する要求の GUID。

クエリ パラメーター

プロパティ 説明
targetuser 任意。 要求の対象ユーザー。 ターゲットが指定されていない場合、ターゲット ユーザーに関係なく、すべての要求が返されます。

: 現在サポートされているのは、値 "current" のみです。
status 任意。 取得する要求の状態を示します。 可能な状態の種類は、"Approved"、"Canceled"、"Completed"、"Denied"、"Executing"、"Failed"、"None"、"Pending" です。
状態が指定されていない場合は、状態に関係なく、すべての要求が返されます。

要求ヘッダー

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

要求本文

[なし] :

Response

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

応答コード

コード 説明
200 OK
204 コンテンツはありません
403 Forbidden
500 内部エラー

応答ヘッダー

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

応答本文

成功した場合、 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 CM 要求を送信したユーザー MIM ID。
Priority MIM CM 要求の優先度。
ProfileTemplateUuid MIM CM 要求が作成されたプロファイル テンプレートの ID。
RequestType MIM CM 要求の種類。
SecurityDescriptor MIM CM 要求のセキュリティ記述子。
状態 MIM CM 要求の状態。
送信 MIM CM 要求が送信された時刻。
TargetUserUuid MIM CM 要求の対象ユーザーの ID。
Uuid MIM CM 要求の識別子。

このセクションでは、指定した CM 要求を取得するMIMを示します。

例: 要求 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
}

関連項目