Mettre à jour l’état de la carte à puce
Met à jour l’état d’une carte à puce.
Notes
Les URL de cet article sont relatives au nom d’hôte qui est choisi pendant le déploiement de l’API, par exemple https://api.contoso.com .
Requête
| Méthode | URL de demande |
|---|---|
| GET | /CertificateManagement/api/v1.0/requests/{reqid}/smartcards/{scid} |
Paramètres d’URL
| Paramètre | Description |
|---|---|
| reqid | Obligatoire. identificateur de demande spécifique à Microsoft Identity Manager (MIM) la gestion des certificats (CM). |
| scid | Obligatoire. identificateur de carte à puce qui est spécifique à MIM CM. La valeur correspond au champ « UUID » de l’objet Microsoft. CLM. Shared. SmartCards. SmartCard. |
En-têtes de requête
Pour les en-têtes de requête courants, consultez en-têtes de requête et de réponse http dans Détails du service de l' API REST cm.
Corps de la demande
Le corps de la demande contient les propriétés suivantes :
| Propriété | Description |
|---|---|
| status | État à affecter à la demande, par exemple « retirée ». |
response
Cette section décrit la réponse.
Codes de réponse
| Code | Description |
|---|---|
| 200 | OK |
| 204 | Aucun contenu |
| 403 | Interdit |
| 500 | Erreur interne |
En-têtes de réponse
Pour les en-têtes de réponse courants, consultez en-têtes de requête et de réponse http dans Détails du service de l' API REST cm.
Response body
En cas de réussite, retourne un objet JSON sérialisé Microsoft.Clm.Shared.Smartcards.Smartcard avec les propriétés suivantes :
| Nom | Description |
|---|---|
| AssignedUserUuid | Identificateur de l'utilisateur auquel est affectée la carte à puce. |
| Atr | Chaîne ATR (Answer-To-Reset) de carte à puce pour la carte en cours d'initialisation. |
| Commentaire | Commentaire qui décrit la carte à puce. |
| Indicateurs | Indicateurs qui décrivent la carte à puce. |
| Middleware | Intergiciel (middleware) de la carte à puce. |
| ParentSmartcardUuid | Identificateur de l'ancienne carte à puce remplacée par la nouvelle. |
| PermanentSmartcardUuid | Identificateur de la carte à puce permanente associée à la carte à puce. |
| PrimarySmartcardUuid | Identificateur de la carte à puce principale. |
| ProfileTemplateUuid | Identificateur du modèle de profil contenant les stratégies et paramètres qui régissent la carte à puce. |
| ProfileTemplateVersion | Version du modèle de profil au moment de la création de la carte à puce. |
| SerialNumber | Numéro de série de la carte à puce. |
| Statut | État de la carte à puce. |
| Uuid | Identificateur du profil de la carte à puce. |
Exemple
Cette section fournit un exemple de mise à jour de l’état d’une carte à puce.
Exemple : demande
PUT /certificatemanagement/api/v1.0/requests/b105403d-d021-41ea-9f11-be3d677d229e/smartcards/17cf063d-e337-4aa9-a822-346554ddd3c9 HTTP/1.1
Exemple : réponse
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"
}