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