プロファイル テンプレートを取得する

指定したユーザーが登録できるプロファイル テンプレートの一覧を取得します。 このメソッドは、プロファイル テンプレートの制限付きビューを返します。 要求したユーザーは、返されるプロファイル テンプレート データを使用して、登録する必要があるプロファイル テンプレート (ある場合) を決定できます。 ワークフローとアクセス許可が指定されていない場合は、ユーザーに表示されるすべてのプロファイル テンプレートが返されます。

注意

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

Request

Method	要求 URL
GET	/CertificateManagement/api/v1.0/profiletemplates?[targetuser]

URL パラメーター

パラメーター	説明
targetuser	省略可能。 プロファイル テンプレートを返す対象ユーザーを指定します。 指定しない場合は、現在のユーザーの ID が使用されます。 注意:現時点では、現在のユーザーのみがサポートされています。

要求ヘッダー

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

要求本文

なし。

Response

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

応答コード

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

応答ヘッダー

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

応答本文

成功した場合、次のプロパティを持つ ProfileTemplateLimitedView オブジェクトの一覧を返します。

プロパティ	種類	説明
名前	string	プロファイル テンプレートの表示名。
説明	string	プロファイル テンプレートの説明。
Uuid	Guid	プロファイル テンプレートの識別子。
IsSmartcardProfileTemplate	[bool]	テンプレートがスマート カード プロファイル テンプレートかどうかを示します。
IsVirtualSmartcardProfileTemplate	[bool]	プロファイル テンプレートに仮想スマート カードが必要かどうかを示します。

例

このセクションでは、指定したユーザーのプロファイル テンプレートの一覧を取得する例を示します。

例: 要求

GET /certificatemanagement/api/v1.0/profiletemplates HTTP/1.1

例: 応答

HTTP/1.1 200 OK

[
    {
        "Name":"FIM CM Sample Profile Template",
        "Description":"Description of the template goes here",
        "Uuid":"12bd5120-86a2-4ee1-8d05-131066871578",
        "IsSmartcardProfileTemplate":false,
        "IsVirtualSmartcardProfileTemplate":false
    },
    {
        "Name":"FIM CM Sample Smart Card Logon Profile Template",
        "Description":"Description of the template goes here",
        "Uuid":"2b7044cf-aa96-4911-b886-177947e9271b",
        "IsSmartcardProfileTemplate":true,
        "IsVirtualSmartcardProfileTemplate":false
    }
]