Dela via

Uppdatera smartkortstatus

  • Artikel

Uppdateringar status för ett smartkort.

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

URL-parametrar

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

Begärandetexten innehåller följande egenskaper:

Egenskap Beskrivning
status Status som begäran ska anges till, till exempel "Tillbakadragen".

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 returneras 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 AtR-strängen (answer-to-reset) för det kort som håller på att 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 smartkortet 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 smartkortprofilen skapades.
Serienummer 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