Mettre à jour l’état de la carte à puce
Mises à jour l’état d’une carte à puce.
Notes
Les URL de cet article sont relatives au nom d’hôte 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) Certificate Management (CM). |
| scid | Obligatoire. Identificateur de carte à puce spécifique à MIM CM. La valeur correspond au champ « uuid » dans l’objet Microsoft.Clm.Shared.Smartcards.Smartcards. |
En-têtes de requête
Pour connaître les en-têtes de requête courants, consultez En-têtes de requête et de réponse HTTP dans les détails du service d’API REST CM.
Corps de la demande
Le corps de la demande contient les propriétés suivantes :
| Propriété | Description |
|---|---|
| status | État sur lequel définir la demande, par exemple « Retiré ». |
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 connaître les en-têtes de réponse courants, consultez Requêtes HTTP et en-têtes de réponse dans les détails du service d’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 : requête
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"
}