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

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

Poznámka:

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

Žádost

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

Parametry adresy URL

Vlastnictví Popis
smartcarduuid Volitelný. Identifikátor UUID čipové karty označený správou certifikátů Microsoft Identity Manageru (MIM). Hodnota odpovídá poli "uuid" v Microsoft.Clm.Shared.Smartcards.Smartcard objektu.

Parametry dotazu

Vlastnictví Popis
cardid Volitelný. UUID čipové karty, jak označuje MIM CM. Hodnota odpovídá poli "uuid" v Microsoft.Clm.Shared.Smartcards.Smartcard objektu.

Hlavičky žádosti

Běžné hlavičky požadavků najdete v tématu hlavičky požadavku HTTP a odpovědi v podrobnostech služby rozhraní REST API CM.

Obsah požadavku

Žádné.

Odpověď

Tato část popisuje odpověď.

Kódy odpovědí

Code Popis
200 OK
204 Žádný obsah
403 Zakázáno
500 Vnitřní chyba

Hlavičky odpovědi

Běžné hlavičky odpovědí najdete v tématu hlavičky požadavku HTTP a odpovědi v podrobnostech služby rozhraní REST API CM.

Obsah odpovědi

Při úspěchu vrátí objekt JSON-Serialized Microsoft.Clm.Shared.Smartcards.Smartcards.Smartcard s následujícími vlastnostmi:

Název Popis
AssignedUserUuid Identifikátor uživatele, kterému je čipová karta přiřazena.
Atr Řetězec odpovědi na resetování čipové karty (ATR) pro kartu, která se právě inicializuje.
Komentář Komentář, který popisuje čipovou kartu.
Vlajky 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žená k čipové kartě.
PrimarySmartcardUuid Identifikátor primární čipové karty.
ProfileTemplateUuid Identifikátor šablony profilu, která obsahuje zásady a nastavení, která řídí čipovou kartu.
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 získání profilů č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é

  • Last updated on