次の方法で共有

Get 要求

  • [アーティクル]

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

注意

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

Request

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

URL パラメーター

プロパティ 説明
id 省略可能。 取得する要求の GUID。

クエリ パラメーター

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

注: 現在サポートされているのは、値 "current" のみです。
status 省略可能。 取得する要求の状態を示します。 使用可能な状態の種類は、"承認済み"、"キャンセル済み"、"完了"、"拒否"、"実行中"、"失敗"、"なし"、"保留中" です。
状態が指定されていない場合は、状態に関係なく、すべての要求が返されます。

要求ヘッダー

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

要求本文

なし。

Response

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

応答コード

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

応答ヘッダー

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

応答本文

成功した場合、 1 つまたは複数の Request オブジェクトと次のプロパティが返されます。

名前 説明
解説 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 要求の識別子。

例

このセクションでは、指定した 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
}

関連項目