Získání profilů čipových karet

Článek
09/14/2023

Získá seznam profilů čipových karet pro uživatele. Seznam obsahuje možné operace, které může provést aktuální uživatel. Pak je možné zahájit požadavek pro libovolnou ze zadaných operací.

Poznámka

Adresy URL v tomto článku jsou relativní vzhledem k názvu hostitele zvolenému při nasazování rozhraní API, například https://api.contoso.com.

Žádost

Metoda	Adresa URL požadavku
GET	/CertificateManagement/api/v1.0/smartcards /CertificateManagement/api/v1.0/smartcards/{smartcarduuid}

Parametry adresy URL

Vlastnost	Popis
smartcarduuid	Nepovinný parametr. Identifikátor UUID čipové karty, který označuje Microsoft Identity Manager (MIM) Certificate Management (CM). Hodnota odpovídá poli "uuid" v objektu Microsoft.Clm.Shared.Smartcards.Smartcard .

Parametry dotazů

Vlastnost	Popis
cardid	Nepovinný parametr. Identifikátor UUID čipové karty označený mim CM. Hodnota odpovídá poli "uuid" v objektu Microsoft.Clm.Shared.Smartcards.Smartcard .

Hlavičky požadavku

Informace o běžných hlavičkách požadavků najdete v tématu Hlavičky požadavků HTTP a odpovědí v podrobnostech o službě ROZHRANÍ REST API CM.

Text požadavku

Žádné

Odpověď

Tato část popisuje odpověď.

Kódy odpovědí

Kód	Description
200	OK
204	Žádný obsah
403	Forbidden
500	Vnitřní chyba

Hlavičky odpovědi

Informace o běžných hlavičkách odpovědí najdete v tématu Http request and response headers (Hlavičky požadavků HTTP a odpovědí ) v podrobnostech služby CM REST API.

Text odpovědi

V případě úspěchu vrátí JSON-Serialized objektu Microsoft.Clm.Shared.Smartcards.Smartcards s následujícími vlastnostmi:

Název	Description
AssignedUserUuid	Identifikátor uživatele, kterému je čipová karta přiřazena.
Atr	Řetězec ATR (answer-to-reset) čipové karty pro kartu, která se právě inicializuje.
Komentář	Komentář, který popisuje čipovou kartu.
Příznaky	Příznaky, které popisují čipovou kartu.
Middleware	Middleware pro čipovou kartu.
ParentSmartcardUuid	Identifikátor staré čipové karty, kterou čipová karta nahradila.
PermanentSmartcardUuid	Identifikátor trvalé čipové karty, která je přidružena k čipové kartě.
PrimarySmartcardUuid	Identifikátor primární čipové karty.
ProfileTemplateUuid	Identifikátor šablony profilu, který obsahuje zásady a nastavení, kterými se řídí čipová karta.
ProfileTemplateVersion	Verze šablony profilu v době vytvoření profilu čipové karty
SerialNumber	Sériové číslo čipové karty.
Stav	Stav čipové karty.
Uuid	Identifikátor profilu čipové karty.

Příklad

Tato část obsahuje příklad, jak získat profily čipových karet pro uživatele.

Příklad: Žádost 1

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

Příklad: Odpověď 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"
}

Příklad: Žádost 2

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

Příklad: Odpověď 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"
}

Viz také

Microsoft.Clm.Shared.Smartcards.Smartcard – třída

Sdílet prostřednictvím