Aktualisieren des Smartcardstatus
Aktualisierungen den Status einer Smartcard.
Hinweis
Die URLs in diesem Artikel sind relativ zum Hostnamen, der während der API-Bereitstellung ausgewählt wird, z. B https://api.contoso.com. .
Anforderung
| Methode | Anforderungs-URL |
|---|---|
| GET | /CertificateManagement/api/v1.0/requests/{reqid}/smartcards/{scid} |
URL-Parameter
| Parameter | BESCHREIBUNG |
|---|---|
| reqid | Erforderlich. Der Anforderungsbezeichner, der für Microsoft Identity Manager Zertifikatverwaltung (MIM) spezifisch ist. |
| scid | Erforderlich. Der Smartcardbezeichner, der für MIM CM spezifisch ist. Der Wert entspricht dem Feld "uuid" im Microsoft.Clm.Shared.Smartcards.Smartcard-Objekt . |
Anforderungsheader
Allgemeine Anforderungsheader finden Sie unter HTTP-Anforderungs- und Antwortheader in CM REST API-Dienstdetails.
Anforderungstext
Der Anforderungstext enthält die folgenden Eigenschaften:
| Eigenschaft | BESCHREIBUNG |
|---|---|
| status | Der Status, auf den die Anforderung festgelegt werden soll, z. B. "Eingestellt". |
Antwort
In diesem Abschnitt wird die Antwort beschrieben.
Antwortcodes
| Code | BESCHREIBUNG |
|---|---|
| 200 | OK |
| 204 | Kein Inhalt |
| 403 | Verboten |
| 500 | Interner Fehler |
Antwortheader
Informationen zu allgemeinen Antwortheadern finden Sie unter HTTP-Anforderungs- und Antwortheader in CM REST API-Dienstdetails.
Antworttext
Bei Erfolg wird ein JSON-serialisiertes Microsoft.Clm.Shared.Smartcards.Smartcard-Objekt mit den folgenden Eigenschaften zurückgegeben:
| Name | BESCHREIBUNG |
|---|---|
| AssignedUserUuid | Der Bezeichner des Benutzers, dem die Smartcard zugewiesen ist. |
| Atr | Die ATR-Zeichenfolge (Antwort zum Zurücksetzen) der Smartcard für die Karte, die derzeit initialisiert wird. |
| Comment | Der Kommentar, der die Smartcard beschreibt. |
| Flags | Die Flags, die die Smartcard beschreiben. |
| Middleware | Die Middleware für die Smartcard. |
| ParentSmartcardUuid | Der Bezeichner der alten Smartcard, die von der Smartcard ersetzt wurde. |
| PermanentSmartcardUuid | Der Bezeichner für die permanente Smartcard, der mit der Smartcard zugewiesen wird. |
| PrimarySmartcardUuid | Der Bezeichner der primären Smartcard. |
| ProfileTemplateUuid | Der Bezeichner der Profilvorlage, die die Richtlinien und Einstellungen enthält, die die Smartcard bestimmen. |
| ProfileTemplateVersion | Die Version der Profilvorlage zum Zeitpunkt der Erstellung der Smartcard. |
| SerialNumber | Die Seriennummer der Smartcard. |
| Status | Der Status der Smartcard. |
| Uuid | Der Bezeichner für das Profil der Smartcard. |
Beispiel
Dieser Abschnitt enthält ein Beispiel zum Aktualisieren des Status einer Smartcard.
Beispiel: Anforderung
PUT /certificatemanagement/api/v1.0/requests/b105403d-d021-41ea-9f11-be3d677d229e/smartcards/17cf063d-e337-4aa9-a822-346554ddd3c9 HTTP/1.1
Beispiel: Antwort
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"
}