Hämta Data för smartkortGet Smartcard Data

Hämtar en lista med profiler smartkort med en lista över möjliga åtgärder som kan utföras av den aktuella användaren.Gets a list of a user’s smartcard profiles with a list of possible operations that can be performed by the current user. Sedan kan du initiera en begäran för någon av de angivna åtgärderna.A request can then be initiated for any of the specified operations.

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/SmartCards/CertificateManagement/api/v1.0/smartcards
/ CertificateManagement/api/v1.0/smartcards/{smartcarduuid}/CertificateManagement/api/v1.0/smartcards/{smartcarduuid}

URL-parametrarURL Parameters

EgenskapProperty BeskrivningDescription
smartcarduuidsmartcarduuid Valfritt.Optional. Smartkort UUID med MIM CM.The smartcard UUID as denoted by MIM CM. Detta är det ”uuid” i den Microsoft.Clm.Shared.Smartcards.Smartcard objekt.This is the “uuid” field in the Microsoft.Clm.Shared.Smartcards.Smartcard object.

FrågeparametrarQuery Parameters

EgenskapProperty BeskrivningDescription
av CardIdcardid Valfritt.Optional. Smartkort UUID med MIM CM.The smartcard UUID as denoted by MIM CM. Detta är det ”uuid” i den Microsoft.Clm.Shared.Smartcards.Smartcard objekt.This is the “uuid” field 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

ingetnone

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äran 1Request 1

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

Svar 1Response 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"
}

Förfrågan 2Request 2

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

Svar 2Response 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 ävenSee Also

-Microsoft.Clm.Shared.Smartcards.Smartcard-klass-Microsoft.Clm.Shared.Smartcards.Smartcard Class