Hämta smartkortsprofiler

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.

Anmärkning

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.

Begäran

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

URL-parametrar

Fastighet	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 s.Smartcard.

Frågeparametrar

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

Förfrågningsrubriker

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

begäranens innehåll

Ingen.

Svar

I det här avsnittet beskrivs svaret.

Svarskoder

Kod	Beskrivning
200	OK
204	Inget innehåll
403	Ej tillåtet
500	Internt fel

Svarshuvuden

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

Svarsdel

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

Namn	Beskrivning
AssignedUserUuid	Identifieraren för den användare som smartkortet har tilldelats.
Atr	Smartkortets atr-sträng (answer-to-reset) för kortet som för närvarande initieras.
Kommentar	Kommentaren som beskriver smartkortet.
Flaggor	Flaggorna som beskriver smartkortet.
Middleware	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 vid den tidpunkt då smartkortsprofilen skapades.
SerialNumber	Smartkortets serienummer.
Status	Smartkortets status.
Uuid	Smartkortprofilens identifierare.

Exempel

Det här avsnittet innehåller ett exempel för att hämta smartkortprofiler 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

• Klassen Microsoft.Clm.Shared.Smartcards.Smartcard