Udostępnij przez

Aktualizowanie stanu karty inteligentnej

Aktualizuje stan karty inteligentnej.

Uwaga

Adresy URL w tym artykule są powiązane z nazwą hosta wybraną podczas wdrażania interfejsu API, taką jak https://api.contoso.com.

Żądanie

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

Parametry URL

Parametr Opis
reqid To jest wymagane. Identyfikator żądania specyficzny dla zarządzania certyfikatami programu Microsoft Identity Manager (MIM).
scid To jest wymagane. Identyfikator karty inteligentnej specyficzny dla programu MIM CM. Wartość odpowiada polu "uuid" w obiekcie Microsoft.Clm.Shared.Smartcards.Smartcards .

Nagłówki zapytań

Aby uzyskać typowe nagłówki żądań, zobacz nagłówki żądań i odpowiedzi HTTP w szczegółach usługi interfejsu API REST CM.

Ciało żądania

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

Nieruchomość / Majątek Opis
stan Stan, na który ma być ustawione żądanie, na przykład "Wycofano".

Odpowiedź

W tej sekcji opisano odpowiedź.

Kody odpowiedzi

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

Nagłówki odpowiedzi

Aby uzyskać typowe nagłówki odpowiedzi, zobacz nagłówki żądań HTTP i odpowiedzi w szczegółach usługi API REST.

Ciało odpowiedzi

Po pomyślnym wykonaniu polecenia zwraca obiekt JSON-Serialized Microsoft.Clm.Shared.Smartcards.Smartcard z następującymi właściwościami:

Nazwa Opis
AssignedUserUuid Identyfikator użytkownika, któremu przypisano kartę inteligentną.
Atr Ciąg odpowiedzi na zresetowanie karty inteligentnej (ATR) dla aktualnie inicjowanej karty.
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órą zamieniła karta inteligentna.
PermanentSmartcardUuid Identyfikator stałej karty inteligentnej skojarzonej z kartą inteligentną.
PrimarySmartcardUuid Identyfikator podstawowej karty inteligentnej.
ProfileTemplateUuid Identyfikator szablonu profilu, który zawiera zasady i ustawienia, które zarządzają kartą inteligentną.
ProfileTemplateVersion Wersja szablonu profilu w momencie utworzenia profilu karty inteligentnej.
Numer seryjny Numer seryjny karty inteligentnej.
Status Stan karty inteligentnej.
Uuid Identyfikator profilu karty inteligentnej.

Przykład

Ta sekcja zawiera przykład aktualizacji 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ż

  • Last updated on