Udostępnij przez

Uzyskiwanie profilów kart inteligentnych

Pobiera listę profilów kart inteligentnych dla użytkownika. Lista zawiera możliwe operacje, które mogą być wykonywane przez bieżącego użytkownika. Następnie można zainicjować żądanie dla dowolnej z określonych operacji.

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/smartcards
/CertificateManagement/api/v1.0/smartcards/{smartcarduuid}

Parametry URL

Nieruchomość / Majątek Opis
smartcarduuid Opcjonalny. Identyfikator UUID karty inteligentnej oznaczony przez zarządzanie certyfikatami programu Microsoft Identity Manager (MIM). Wartość odpowiada polu "uuid" w obiekcie Microsoft.Clm.Shared.Smartcards.Smartcards .

Parametry zapytania

Nieruchomość / Majątek Opis
cardid Opcjonalny. Identyfikator UUID karty inteligentnej oznaczony przez program 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

Żaden.

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

W tej sekcji przedstawiono przykład pobierania profilów kart inteligentnych dla użytkownika.

Przykład: żądanie 1

GET /certificatemanagement/api/v1.0/smartcards?cardid=d1ef6869-5517-42a0-8f05-16ca1a0b834d HTTP/1.1

Przykład: odpowiedź 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"
}

Przykład: żądanie 2

GET /certificatemanagement/api/v1.0/smartcards/17cf063d-e337-4aa9-a822-346554ddd3c9 HTTP/1.1

Przykład: odpowiedź 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"
}

Zobacz też

  • Last updated on