Обновление состояния смарт-карты

Статья
09/14/2023

Обновления состояние смарт-карты.

Примечание

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

Запрос

Метод	URL-адрес запроса
GET	/CertificateManagement/api/v1.0/requests/{reqid}/smartcards/{scid}

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

Параметр	Описание
reqid	Обязательный. Идентификатор запроса, относящееся к управлению сертификатами (CM) Microsoft Identity Manager (MIM).
scid	Обязательный. Идентификатор смарт-карты, относящееся к MIM CM. Значение соответствует полю "uuid" в объекте Microsoft.Clm.Shared.Smartcards.Smartcard .

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

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

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

Текст запроса содержит следующие свойства:

Свойство	Описание
status	Состояние для задания запроса, например "Устарело".

Ответ

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

Коды ответов

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

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

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

Текст ответа

В случае успешного выполнения возвращает JSON-сериализованный объект Microsoft.Clm.Shared.Smartcards.Smartcard объектов со следующими свойствами:

Имя	Описание
AssignedUserUuid	Идентификатор пользователя, которому назначена смарт-карта.
Atr	Строка ATR смарт-карты, которая в настоящее время инициализируется.
Комментировать	Комментарий, описывающий смарт-карту.
Флаги	Флажки, описывающие смарт-карту.
ПО промежуточного слоя	ПО промежуточного слоя смарт-карты.
ParentSmartcardUuid	Идентификатор старой смарт-карты, которую заменила эта смарт-карта.
PermanentSmartcardUuid	Идентификатор постоянной смарт-карты, связанной с этой смарт-картой.
PrimarySmartcardUuid	Идентификатор основной смарт-карты.
ProfileTemplateUuid	Идентификатор шаблона профиля, который содержит политики и параметры, управляющие смарт-картой.
ProfileTemplateVersion	Версия шаблона профиля во время создания профиля смарт-карты.
SerialNumber	Серийный номер смарт-карты.
Состояние	Состояние смарт-карты.
Uuid	Идентификатор профиля смарт-карты.

Пример

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

Пример. Запрос

PUT /certificatemanagement/api/v1.0/requests/b105403d-d021-41ea-9f11-be3d677d229e/smartcards/17cf063d-e337-4aa9-a822-346554ddd3c9 HTTP/1.1

Пример: Ответ

HTTP/1.1 200 OK

{
    "Uuid":"17cf063d-e337-4aa9-a822-346554ddd3c9",
    "Status":6,
    "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"
}

См. также раздел

Класс Microsoft.Clm.Shared.Smartcards.Smartcard

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