Aktualisieren des Smartcardstatus
Aktualisiert den Status einer Smartcard.
Hinweis
Die URLs in diesem Artikel beziehen sich auf den Hostnamen, der während der API-Bereitstellung ausgewählt wird, z. B. https://api.contoso.com.
Anfrage
| Methode | Anforderungs-URL |
|---|---|
| ERHALTEN/Bekommen | /CertificateManagement/api/v1.0/requests/{reqid}/smartcards/{scid} |
URL-Parameter
| Parameter | BESCHREIBUNG |
|---|---|
| reqid | Erforderlich. Der Anforderungsbezeichner, der für die Microsoft Identity Manager (MIM)-Zertifikatverwaltung (CM) spezifisch ist. |
| scid | Erforderlich. Der Smartcardbezeichner, der für MIM CM spezifisch ist. Der Wert entspricht dem Feld "uuid" im Microsoft.Clm.Shared.Smartcards.Smartcards.Smartcard-Objekt. |
Anforderungsheader
Allgemeine Anforderungsheader finden Sie unter HTTP-Anforderungs- und Antwortheader in CM-REST-API-Dienstdetails.
Anfragekörper
Der Anforderungstext enthält die folgenden Eigenschaften:
| Eigentum | 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 | OKAY |
| 204 | Kein Inhalt |
| 403 | Verboten |
| 500 | Interner Fehler |
Antwortheader
Allgemeine Antwortheader finden Sie unter HTTP-Anforderungs- und Antwortheader in CM REST API-Dienstdetails.
Antwortkörper
Gibt bei Erfolg ein JSON-Serialized Microsoft.Clm.Shared.Smartcards.Smartcards.Smartcard- -Objekt mit den folgenden Eigenschaften zurück:
| Name | BESCHREIBUNG |
|---|---|
| AssignedUserUuid | Der Bezeichner des Benutzers, dem die Smartcard zugewiesen ist. |
| Atr | Die Smartcard answer-to-reset (ATR)-Zeichenfolge für die Karte, die derzeit initialisiert wird. |
| Kommentar | Der Kommentar, der die Smartcard beschreibt. |
| Flaggen | Die Kennzeichnungen, die die Smartcard beschreiben. |
| Middleware | Die Middleware für die Smartcard. |
| ParentSmartcardUuid | Der Bezeichner der alten Smartcard, die die Smartcard ersetzt hat. |
| PermanentSmartcardUuid | Der Bezeichner der dauerhaften Smartcard, die der Smartcard zugeordnet ist. |
| PrimarySmartcardUuid | Der Bezeichner der primären Smartcard. |
| ProfileTemplateUuid | Der Bezeichner der Profilvorlage, die die Richtlinien und Einstellungen enthält, die die Smartcard steuern. |
| ProfileTemplateVersion | Die Version der Profilvorlage zum Zeitpunkt der Erstellung des Smartcardprofils. |
| Seriennummer | Die Seriennummer der Smartcard. |
| Status | Der Status der Smartcard. |
| Uuid | Der Bezeichner des Smartcardprofils. |
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"
}