Aktualizowanie stanu karty inteligentnej

Aktualizuje stan karty inteligentnej.

Uwaga

Adresy URL w tym artykule są względne względem nazwy hosta wybranej podczas wdrażania interfejsu API, takiej jak https://api.contoso.com .

Żądanie

Metoda Adres URL żądania
GET /CertificateManagement/api/v1.0/requests/{reqid}/smartcards/{scid}

Parametry URL

Parametr Opis
reqid Wymagane. Identyfikator żądania specyficzny dla zarządzania certyfikatami Microsoft Identity Manager (MIM) (CM).
Scid Wymagane. Identyfikator karty inteligentnej, który jest specyficzny dla MIM zarządzania MIM zarządzania. Wartość odpowiada polu "uuid" w obiekcie Microsoft.Clm.Shared.Smartcards.Smartcard.

Nagłówki żądań

Aby uzyskać typowe nagłówki żądań, zobacz Http request and response headers (Nagłówki żądań i odpowiedzi HTTP) w tesłudze.

Treść żądania

Treść żądania zawiera następujące właściwości:

Właściwość Opis
status Stan, na który ma być ustawione żądanie, na przykład "Wycofane".

Reakcja

W tej sekcji opisano odpowiedź.

Kody odpowiedzi

Kod Opis
200 OK
204 Brak zawartości
403 Forbidden
500 Błąd wewnętrzny

Nagłówki odpowiedzi

Aby uzyskać typowe nagłówki odpowiedzi, zobacz Http request and response headers (Nagłówki żądań i odpowiedzi HTTP) w tesłudze.

Treść odpowiedzi

W przypadku powodzenia zwraca JSON-Serialized Microsoft.Clm.Shared.Smartcards.Smartcard z następującymi właściwościami:

Nazwa Opis
AssignedUserUuid Identyfikator użytkownika, do którego przypisano kartę inteligentną.
Atr Ciąg odpowiedzi na zresetowanie karty inteligentnej (ATR) dla karty, która jest aktualnie zainicjowana.
Komentarz Komentarz opisujący kartę inteligentną.
Flagi Flagi opisujące kartę inteligentną.
Oprogramowanie pośredniczące Oprogramowanie pośredniczące dla karty inteligentnej.
ParentSmartcardUuid Identyfikator starej karty inteligentnej, która została zastąpiona przez kartę inteligentną.
PermanentSmartcardUuid Identyfikator trwałej karty inteligentnej skojarzonej z kartą inteligentną.
PrimarySmartcardUuid Identyfikator podstawowej karty inteligentnej.
ProfileTemplateUuid Identyfikator szablonu profilu, który zawiera zasady i ustawienia, które określają karty inteligentnej.
ProfileTemplateVersion Wersja szablonu profilu w momencie utworzenia profilu karty inteligentnej.
SerialNumber Numer seryjny karty inteligentnej.
Stan Stan karty inteligentnej.
Identyfikator UUID Identyfikator profilu karty inteligentnej.

Przykład

Ta sekcja zawiera przykład aktualizowania stanu karty inteligentnej.

Przykład: Żądanie

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

Przykład: Odpowiedź

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"
}

Zobacz też