Obtenir des modèles de profil

Article
09/14/2023

Obtient la liste des modèles de profil pour lesquels l’utilisateur spécifié peut s’inscrire. Cette méthode retourne une vue limitée du modèle de profil. Les données de modèles de profil retournées doivent être suffisantes pour permettre à l'utilisateur demandeur de choisir le modèle de profil, le cas échéant, pour lequel il doit s'inscrire. Si aucun workflow et aucune autorisation ne sont spécifiés, tous les modèles de profil visibles par l’utilisateur sont retournés.

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/profiletemplates ? [targetuser]

Paramètres d’URL

Paramètre	Description
targetuser	facultatif. Spécifie l'utilisateur cible pour lequel retourner les modèles de profil. Si elle n’est pas spécifiée, l’identité de l’utilisateur actuel est utilisée. Remarque: actuellement, seul l'utilisateur actif est pris en charge.

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

Aucun.

response

Cette section décrit la réponse.

Codes de réponse

Code	Description
200	OK
204	Aucun contenu
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 une liste d’objets ProfileTemplateLimitedView avec les propriétés suivantes :

Propriété	Type	Description
Nom	string	Nom complet du modèle de profil.
Description	string	Description du modèle de profil.
Uuid	Guid	Identificateur du modèle de profil.
IsSmartcardProfileTemplate	bool	Indique si le modèle est un modèle de profil de carte à puce.
IsVirtualSmartcardProfileTemplate	bool	Indique si le modèle de profil nécessite une carte à puce virtuelle.

Exemple

Cette section fournit un exemple permettant d’obtenir la liste des modèles de profil pour l’utilisateur spécifié.

Exemple : requête

GET /certificatemanagement/api/v1.0/profiletemplates HTTP/1.1

Exemple : Réponse

HTTP/1.1 200 OK

[
    {
        "Name":"FIM CM Sample Profile Template",
        "Description":"Description of the template goes here",
        "Uuid":"12bd5120-86a2-4ee1-8d05-131066871578",
        "IsSmartcardProfileTemplate":false,
        "IsVirtualSmartcardProfileTemplate":false
    },
    {
        "Name":"FIM CM Sample Smart Card Logon Profile Template",
        "Description":"Description of the template goes here",
        "Uuid":"2b7044cf-aa96-4911-b886-177947e9271b",
        "IsSmartcardProfileTemplate":true,
        "IsVirtualSmartcardProfileTemplate":false
    }
]

Partager via