Hämta smartkortsprofiler

Artikel
09/14/2023

Hämtar en lista över smartkortsprofiler för en användare. Listan innehåller de möjliga åtgärder som kan utföras av den aktuella användaren. En begäran kan sedan initieras för någon av de angivna åtgärderna.

Anteckning

URL:erna i den här artikeln är relativa till det värdnamn som väljs under API-distributionen, till exempel https://api.contoso.com.

Förfrågan

Metod	Begärans-URL
GET	/CertificateManagement/api/v1.0/smartcards /CertificateManagement/api/v1.0/smartcards/{smartcarduuid}

URL-parametrar

Egenskap	Beskrivning
smartcarduuid	Valfritt. Smartkortets UUID som anges av Microsoft Identity Manager (MIM) Certificate Management (CM). Värdet motsvarar fältet "uuid" i objektet Microsoft.Clm.Shared.Smartcards.Smartcard .

Frågeparametrar

Egenskap	Beskrivning
cardid	Valfritt. Smartkortets UUID som anges av MIM CM. Värdet motsvarar fältet "uuid" i objektet Microsoft.Clm.Shared.Smartcards.Smartcard .

Begärandehuvuden

Vanliga begärandehuvuden finns i HTTP-begärande- och svarshuvuden i CM REST API-tjänstinformation.

Begärandetext

Inga.

Svarsåtgärder

I det här avsnittet beskrivs svaret.

Svarskoder

Kod	Description
200	OK
204	Inget innehåll
403	Förbjudet
500	Internt fel

Svarshuvuden

Vanliga svarshuvuden finns i HTTP-begärande- och svarshuvuden i CM REST API-tjänstinformation.

Själva svaret

Vid lyckat resultat returnerar ett JSON-Serialized Microsoft.Clm.Shared.Smartcards.Smartcard-objekt med följande egenskaper:

Name	Beskrivning
AssignedUserUuid	Identifieraren för den användare som smartkortet har tilldelats.
Atr	Smartkortssträngen answer-to-reset (ATR) för kortet som för närvarande initieras.
Kommentar	Kommentaren som beskriver smartkortet.
Flaggor	Flaggorna som beskriver smartkortet.
Mellanprogram	Mellanprogrammet för smartkortet.
ParentSmartcardUuid	Identifieraren för det gamla smartkortet som smartkortet har ersatt.
PermanentSmartcardUuid	Identifieraren för det permanenta smartkort som är associerat med smartkortet.
PrimarySmartcardUuid	Identifieraren för det primära smartkortet.
ProfileTemplateUuid	Identifieraren för profilmallen som innehåller de principer och inställningar som styr smartkortet.
ProfileTemplateVersion	Versionen av profilmallen när smartkortsprofilen skapades.
Serienummer	Smartkortets serienummer.
Status	Smartkortets status.
Uuid	Smartkortprofilens identifierare.

Exempel

Det här avsnittet innehåller ett exempel för att hämta smartkortsprofiler för en användare.

Exempel: Begäran 1

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

Exempel: Svar 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"
}

Exempel: Begäran 2

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

Exempel: Svar 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"
}

Se även

Microsoft.Clm.Shared.Smartcards.Smartcard-klass

Dela via