Получение шаблонов профилей

Статья
09/14/2023

Возвращает список шаблонов профилей, для которых указанный пользователь может зарегистрировать. Этот метод возвращает ограниченное представление шаблона профиля. Возвращаемых данных о шаблонах профилей должно быть достаточно, чтобы запрашивающий пользователь мог решить, какие шаблоны профилей нужно зарегистрировать. Если рабочий процесс и разрешение не указаны, возвращаются все шаблоны профилей, видимые пользователю.

Примечание

URL-адреса в этой статье относятся к имени узла, выбранному во время развертывания API, например https://api.contoso.com.

Запрос

Метод	URL-адрес запроса
GET	/CertificateManagement/api/v1.0/profiletemplates? [targetuser]

Параметры URL-адреса

Параметр	Описание
targetuser	Необязательный элемент. Задает целевого пользователю, для которого нужно вернуть шаблон профиля. Если не указано, используется удостоверение текущего пользователя. Примечание. В настоящее время поддерживается только текущий пользователь.

Параметр

Описание

targetuser

Необязательный элемент. Задает целевого пользователю, для которого нужно вернуть шаблон профиля. Если не указано, используется удостоверение текущего пользователя.

Примечание. В настоящее время поддерживается только текущий пользователь.

Заголовки запросов

Общие заголовки запросов см. в разделе Заголовки HTTP-запросов и ответов в службе REST API CM.

Текст запроса

Нет.

Ответ

В этом разделе описывается ответ.

Коды ответов

Код	Описание
200	ОК
204	Нет содержимого
500	Внутренняя ошибка

Заголовки ответов

Общие заголовки ответов см. в разделе Заголовки HTTP-запросов и ответов в службе REST API CM.

Текст ответа

При успешном выполнении возвращает список объектов ProfileTemplateLimitedView со следующими свойствами:

Свойство	Тип	Описание
Название	строка	Отображаемое имя шаблона профиля.
Описание	строка	Описание шаблона профиля.
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
    }
]

Поделиться через