Uppdatera Status för smartkortUpdate Smartcard Status

Uppdaterar statusen för ett smartkort.Updates the status of a smartcard.

Obs: URL: er som visas i det här avsnittet är i förhållande till värdnamnet valt under distributionen av API, till exempel: https://api.contoso.com.Note: URLs shown in this topic are relative to the hostname chosen during API deployment; for example: https://api.contoso.com.

BegäranRequest

MetodMethod URL-begäranRequest URL
GETGET / CertificateManagement/api/v1.0/requests/{reqid}/smartcards/{scid}/CertificateManagement/api/v1.0/requests/{reqid}/smartcards/{scid}

URL-parametrarURL Parameters

ParameterParameter BeskrivningDescription
reqidreqid Obligatoriskt.Required. Begärande-ID (MIM CM-specifik).The Request identifier (MIM CM specific).
scidscid Obligatoriskt.Required. Smartkort identifierare (MIM CM-specifik).The smartcard identifier (MIM CM specific). Det här är ”uuid”-egenskap i den Microsoft.Clm.Shared.Smartcards.Smartcard objekt.This is the "uuid" property in the Microsoft.Clm.Shared.Smartcards.Smartcard object.

Huvuden för begäranRequest Headers

Vanliga begärandehuvuden finns HTTP-begäran och svarshuvuden i CM REST API-tjänsteinformation.For common request headers, see HTTP Request and Response Headers in CM REST API Service Details.

BegärandetextenRequest Body

Begärandetexten innehåller följande egenskaper.The request body contains the following properties.

EgenskapProperty BeskrivningDescription
statusstatus Status till begäran.The status to set the request to. Till exempel inaktiverad ””.For example, "Retired".

SvarResponse

SvarskoderResponse Codes

KodCode BeskrivningDescription
200200 OKOK
204204 Inget innehållNo content
403403 Tillåts inteForbidden
500500 Internt felInternal Error

SvarsrubrikerResponse Headers

Vanliga svarshuvuden finns HTTP-begäran och svarshuvuden i CM REST API-tjänsteinformation.For common response headers, see HTTP Request and Response Headers in CM REST API Service Details.

SvarstextenResponse Body

Returnerar lyckades, en JSON-serialiserad Microsoft.Clm.Shared.Smartcards.Smartcard objekt med följande egenskaper:On success, returns a JSON-Serialized Microsoft.Clm.Shared.Smartcards.Smartcard object with the following properties:

NamnName BeskrivningDescription
AssignedUserUuidAssignedUserUuid Identifierare för den användare som tilldelats smartkortet.The identifier of the user to whom the smart card is assigned.
ATRAtr Smartkort svar till återställning (ATR) strängen för kortet som för närvarande på att initieras.The smart card answer-to-reset (ATR) string for the card that is currently being initialized.
KommentarComment Kommentar som beskriver smartkortet.The comment that describes the smart card.
FlaggorFlags Flaggor som beskriver smartkortet.The flags that describe the smart card.
MellanprogramMiddleware Mellanprogram för smartkortet.The middleware for the smart card.
ParentSmartcardUuidParentSmartcardUuid Identifierare för det gamla smartkort som smartkortet har ersatt.The identifier of the old smart card that the smart card has replaced.
PermanentSmartcardUuidPermanentSmartcardUuid Identifierare för permanenta smartkortet som associeras med smartkortet.The identifier of the permanent smart card that is associated with the smart card.
PrimarySmartcardUuidPrimarySmartcardUuid Identifierare för primära smartkortet.The identifier of the primary smart card.
ProfileTemplateUuidProfileTemplateUuid Identifierare av Profilmall som innehåller de principer och inställningar som styr smartkortet.The identifier of the profile template that contains the policies and settings that govern the smart card.
ProfileTemplateVersionProfileTemplateVersion Versionen av Profilmall vid den tidpunkt då smartkort profilen har skapats.The version of the profile template at the time that the smart card profile was created.
SerienummerSerialNumber Serienumret för det smartkortet.The smart card's serial number.
StatusStatus Status för smartkortet.The status of the smart card.
UUIDUuid Identifierare för smartkort-profilen.The smart card profile's identifier.

ExempelExample

BegäranRequest

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

SvarResponse

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 ävenSee Also