Получение профилей смарт-карт
Возвращает список профилей смарт-карт для пользователя. Список включает возможные операции, которые может выполнять текущий пользователь. Запрос можно инициировать для любой из указанных операций.
Примечание
URL-адреса в этой статье относятся к имени узла, выбранному во время развертывания API, например https://api.contoso.com
.
Запрос
Метод | URL-адрес запроса |
---|---|
GET | /CertificateManagement/api/v1.0/smartcards /CertificateManagement/api/v1.0/smartcards/{smartcarduuid} |
Параметры URL-адреса
Свойство | Описание |
---|---|
smartcarduuid | Необязательный элемент. UUID смарт-карты, обозначаемый Microsoft Identity Manager (MIM) Certificate Management (CM). Значение соответствует полю "uuid" в объекте Microsoft.Clm.Shared.Smartcards.Smartcards. |
Параметры запроса
Свойство | Описание |
---|---|
cardid | Необязательный элемент. UUID смарт-карты, обозначаемый MIM CM. Значение соответствует полю "uuid" в объекте Microsoft.Clm.Shared.Smartcards.Smartcards. |
Заголовки запросов
Общие заголовки запросов см. в разделе Заголовки HTTP-запросов и ответов в службе REST API CM.
Текст запроса
Нет.
Ответ
В этом разделе описывается ответ.
Коды ответов
Код | Описание |
---|---|
200 | ОК |
204 | Нет содержимого |
403 | Запрещено |
500 | Внутренняя ошибка |
Заголовки ответов
Общие заголовки ответов см. в разделе Заголовки HTTP-запросов и ответов в службе REST API CM.
Текст ответа
В случае успешного выполнения возвращает JSON-сериализованный объект Microsoft.Clm.Shared.Smartcards.Smartcard объектов со следующими свойствами:
Имя | Описание |
---|---|
AssignedUserUuid | Идентификатор пользователя, которому назначена смарт-карта. |
Atr | Строка ATR смарт-карты, которая в настоящее время инициализируется. |
Комментировать | Комментарий, описывающий смарт-карту. |
Флаги | Флажки, описывающие смарт-карту. |
ПО промежуточного слоя | ПО промежуточного слоя смарт-карты. |
ParentSmartcardUuid | Идентификатор старой смарт-карты, которую заменила эта смарт-карта. |
PermanentSmartcardUuid | Идентификатор постоянной смарт-карты, связанной с этой смарт-картой. |
PrimarySmartcardUuid | Идентификатор основной смарт-карты. |
ProfileTemplateUuid | Идентификатор шаблона профиля, который содержит политики и параметры, управляющие смарт-картой. |
ProfileTemplateVersion | Версия шаблона профиля во время создания профиля смарт-карты. |
SerialNumber | Серийный номер смарт-карты. |
Состояние | Состояние смарт-карты. |
Uuid | Идентификатор профиля смарт-карты. |
Пример
В этом разделе приведен пример получения профилей смарт-карт для пользователя.
Пример. Запрос 1
GET /certificatemanagement/api/v1.0/smartcards?cardid=d1ef6869-5517-42a0-8f05-16ca1a0b834d HTTP/1.1
Пример. Ответ 1
HTTP/1.1 200 OK
{
"Uuid":"438d1b30-f3b4-4bed-85fa-285e08605ba7",
"Status":3,
"Flags":1,
"ParentSmartcardUuid":"00000000-0000-0000-0000-000000000000",
"PrimarySmartcardUuid":"00000000-0000-0000-0000-000000000000",
"PermanentSmartcardUuid":"00000000-0000-0000-0000-000000000000",
"AssignedUserUuid":"8f1590dc-d932-4b66-8e68-2e91c5880780",
"ProfileTemplateUuid":"a039b4d0-5ce8-4eff-8651-181c6576fda3",
"ProfileTemplateVersion":46,
"Comment":"",
"SerialNumber":"{d1ef6869-5517-42a0-8f05-16ca1a0b834d}",
"Middleware":"MSBaseCSP",
"Atr":"3b8d0180fba000000397425446590301c8"
}
Пример. Запрос 2
GET /certificatemanagement/api/v1.0/smartcards/17cf063d-e337-4aa9-a822-346554ddd3c9 HTTP/1.1
Пример. Ответ 2
HTTP/1.1 200 OK
{
"Uuid":"17cf063d-e337-4aa9-a822-346554ddd3c9",
"Status":2,
"Flags":1,
"ParentSmartcardUuid":"00000000-0000-0000-0000-000000000000",
"PrimarySmartcardUuid":"00000000-0000-0000-0000-000000000000",
"PermanentSmartcardUuid":"00000000-0000-0000-0000-000000000000",
"AssignedUserUuid":"8f1590dc-d932-4b66-8e68-2e91c5880780",
"ProfileTemplateUuid":"a039b4d0-5ce8-4eff-8651-181c6576fda3",
"ProfileTemplateVersion":46,
"Comment":"",
"SerialNumber":"{bc88f13f-83ba-4037-8262-46eba1291c6e}",
"Middleware":"MSBaseCSP",
"Atr":"3b8d0180fba000000397425446590301c8"
}