Partager via

Mettre à jour l’état de la carte à puce

Met à jour l’état d’une carte à puce.

Remarque

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
OBTENIR /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.Smartcard.

En-têtes de requête

Pour connaître les en-têtes de requête courants, consultez les en-têtes de requête et de réponse HTTP dans détails du service d’API REST CM.

Corps de la requête

Le corps de la requête contient les propriétés suivantes :

Propriété Description
statut État sur lequel définir la demande, par exemple « Supprimé ».

Réponse

Cette section décrit la réponse.

Codes de réponse

Code Description
200 D’ACCORD
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 les en-têtes de requête et de réponse HTTP dans détails du service d’API REST CM.

Corps de la réponse

En cas de réussite, retourne un objet JSON-Serialized Microsoft.Clm.Shared.Smartcards.Smartcard avec les propriétés suivantes :

Nom Description
AssignedUserUuid Identificateur de l’utilisateur auquel la carte à puce est affectée.
Atr Chaîne de réponse à réinitialiser (ATR) de carte à puce pour la carte en cours d’initialisation.
Commentaire Commentaire décrivant la carte à puce.
Flags Indicateurs qui décrivent la carte à puce.
Intergiciel Intergiciel pour la carte à puce.
ParentSmartcardUuid Identificateur de l’ancienne carte à puce que la carte à puce a remplacée.
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 qui contient les stratégies et les paramètres qui régissent la carte à puce.
ProfileTemplateVersion Version du modèle de profil au moment où le profil de carte à puce a été créé.
Numéro de série Numéro de série de la carte à puce.
Statut État de la carte à puce.
Uuid Identificateur du profil de carte à puce.

Exemple :

Cette section fournit un exemple pour mettre à jour 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"
}

Voir aussi

  • Last updated on