Получение данных профиля
Возвращает список профилей сертификатов программного обеспечения для пользователя. Список включает возможные операции, которые может выполнять текущий пользователь. Запрос можно инициировать для любой из указанных операций.
Важно!
Сервер задает ПИН-код, только если политика шаблона профиля указывает, что это необходимо сделать. В противном случае пользователь должен указать ПИН-код.
Примечание
URL-адреса в этой статье относятся к имени узла, выбранному во время развертывания API, например https://api.contoso.com.
Запрос
| Метод | URL-адрес запроса |
|---|---|
| GET | /CertificateManagement/api/v1.0/profiles /CertificateManagement/api/v1.0/profiles/{id} /CertificateManagement/api/v1.0/requests/{requestid}/profiles |
Параметры URL-адреса
| Параметр | Описание |
|---|---|
| идентификатор | Идентификатор (GUID) возвращаемого профиля. |
| requestId | Идентификатор запроса, для которого возвращаются профили. |
Параметры запроса
| Параметр | Описание |
|---|---|
| status | Необязательный элемент. Указывает состояние профилей, для которых требуется извлечь данные. Возможные типы состояний: "Активно", "Утверждено", "Отменено", "Завершено", "Отказано", "Выполнение", "Сбой", "Нет" и "Ожидание". Если состояние не указано, возвращаются все профили, независимо от состояния. |
Заголовки запросов
Общие заголовки запросов см. в разделе Заголовки HTTP-запросов и ответов в службе REST API CM.
Текст запроса
Нет.
Ответ
В этом разделе описывается ответ.
Коды ответов
| Код | Описание |
|---|---|
| 200 | ОК |
| 204 | Нет содержимого |
| 403 | Запрещено |
| 500 | Внутренняя ошибка |
Заголовки ответов
Общие заголовки ответов см. в разделе Заголовки HTTP-запросов и ответов в службе REST API CM.
Текст ответа
В случае успешного выполнения возвращает список JSON-сериализованных объектов Microsoft.Clm.Shared.Profiles.Profile со следующими свойствами:
| Свойство | Описание |
|---|---|
| AssignedUserUuid | Идентификатор пользователя, которому назначен профиль. |
| Комментировать | Комментарий, описывающий профиль. |
| Флаги | Флажки, описывающие профиль. |
| ParentProfileUuid | Идентификатор старого профиля, который заменил этот профиль. |
| PrimaryProfileUuid | Идентификатор основного профиля. |
| ProfileOperations | Список возможных операций, которые может выполнять текущий пользователь в этом профиле. |
| ProfileTemplateUuid | Идентификатор шаблона профиля, который содержит политики и параметры, управляющие профилем. |
| ProfileTemplateVersion | Версия шаблона профиля во время создания профиля. |
| Состояние | Состояние профиля. |
| Uuid | Идентификатор профиля. |
Пример
В этом разделе приведен пример получения данных профиля для пользователя.
Пример. Запрос
GET /certificatemanagement/api/v1.0/profiles?status=Active HTTP/1.1
Пример: Ответ
HTTP/1.1 200 OK
[
{
"Uuid":"c0dd5c7d-ec35-4346-baca-3ad711e9722f",
"Status":2,
"Flags":1,
"ParentProfileUuid":"1c9e2606-fea2-4048-a6ac-b014e54c22df",
"PrimaryProfileUuid":"00000000-0000-0000-0000-000000000000",
"AssignedUserUuid":"0378a33b-8650-4713-a727-efd233903643",
"ProfileTemplateUuid":"8f31803f-8afc-49bb-911d-402ec264b589",
"ProfileTemplateVersion":8,
"Comment":"",
"ProfileOperations":[
"renew",
"disable",
"recover"
]
},
{
"Uuid":"5ad77b40-aa42-4533-9396-c9c59fd021a8",
"Status":2,
"Flags":1,
"ParentProfileUuid":"00000000-0000-0000-0000-000000000000",
"PrimaryProfileUuid":"00000000-0000-0000-0000-000000000000",
"AssignedUserUuid":"0378a33b-8650-4713-a727-efd233903643",
"ProfileTemplateUuid":"8f31803f-8afc-49bb-911d-402ec264b589",
"ProfileTemplateVersion":8,
"Comment":"",
"ProfileOperations":[
"renew",
"disable",
"recover"
]
},
{
"Uuid":"ff342953-c444-4dc7-b144-f5515d6460c6",
"Status":2,
"Flags":1,
"ParentProfileUuid":"00000000-0000-0000-0000-000000000000",
"PrimaryProfileUuid":"00000000-0000-0000-0000-000000000000",
"AssignedUserUuid":"0378a33b-8650-4713-a727-efd233903643",
"ProfileTemplateUuid":"1e3a31fe-699b-4a6b-945c-18b83c985bc1",
"ProfileTemplateVersion":9,
"Comment":"",
"ProfileOperations":[
"renew",
"disable"
]
}
]