Uppdatera smartkortstatus

Uppdaterar statusen för ett smartkort.

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/requests/{reqid}/smartcards/{scid}

URL-parametrar

Parameter	Beskrivning
reqid	Obligatoriskt. Den begärandeidentifierare som är specifik för Microsoft Identity Manager (MIM) Certificate Management (CM).
scid	Obligatoriskt. Smartkortsidentifieraren som är specifik för 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

Begärandetexten innehåller följande egenskaper:

Fastighet	Beskrivning
tillstånd	Statusen som begäran ska anges till, till exempel "Pensionerad".

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 på hur du uppdaterar statusen för ett smartkort.

Exempel: begäran

PUT /certificatemanagement/api/v1.0/requests/b105403d-d021-41ea-9f11-be3d677d229e/smartcards/17cf063d-e337-4aa9-a822-346554ddd3c9 HTTP/1.1

Exempel: svar

HTTP/1.1 200 OK

{
    "Uuid":"17cf063d-e337-4aa9-a822-346554ddd3c9",
    "Status":6,
    "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