Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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"
}