Partager via

Obtenir des données de profil

Obtient une liste de profils de certificat logiciel pour un utilisateur. La liste inclut les opérations possibles qui peuvent être effectuées par l’utilisateur actuel. Une demande peut ensuite être lancée pour l’une des opérations spécifiées.

Important

Le serveur définit le code confidentiel uniquement si la stratégie de modèle de profil indique qu’elle doit être effectuée. Sinon, l’utilisateur doit fournir le code confidentiel.

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/profiles
/CertificateManagement/api/v1.0/profiles/{id}
/CertificateManagement/api/v1.0/requests/{requestid}/profiles

Paramètres d’URL

Paramètre Description
id Identificateur (GUID) du profil à retourner.
requestId Identificateur de la demande pour laquelle retourner les profils.

Paramètres de requête

Paramètre Description
statut Optionnel. Indique l’état des profils pour lesquels récupérer des données. Les types d’état possibles sont « Actif », « Approuvé », « Annulé », « Terminé », « Refusé », « Échec », « Échec », « Aucun » et « En attente ».
Si aucun état n’est spécifié, tous les profils, quel que soit l’état sont retournés.

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

Aucun.

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 une liste d’objets microsoft.Clm.Shared.Profiles.Profile avec les propriétés suivantes :

Propriété Description
AssignedUserUuid Identificateur de l’utilisateur auquel le profil est affecté.
Commentaire Commentaire décrivant le profil.
Flags Indicateurs qui décrivent le profil.
ParentProfileUuid Identificateur de l’ancien profil que le profil a remplacé.
PrimaryProfileUuid Identificateur du profil principal.
ProfileOperations Liste des opérations possibles qui peuvent être effectuées par l’utilisateur actuel sur le profil.
ProfileTemplateUuid Identificateur du modèle de profil qui contient les stratégies et les paramètres qui régissent le profil.
ProfileTemplateVersion Version du modèle de profil au moment de la création du profil.
Statut État du profil.
Uuid Identificateur du profil.

Exemple :

Cette section fournit un exemple pour obtenir les données de profil d’un utilisateur.

Exemple : requête

GET /certificatemanagement/api/v1.0/profiles?status=Active HTTP/1.1

Exemple : réponse

HTTP/1.1 200 OK

[
    {
        "Uuid":"c0dd5c7d-ec35-4346-baca-3ad711e9722f",
        "Status":2,
        "Flags":1,
        "ParentProfileUuid":"1c9e2606-fea2-4048-a6ac-b014e54c22df",
        "PrimaryProfileUuid":"00000000-0000-0000-0000-000000000000",
        "AssignedUserUuid":"0378a33b-8650-4713-a727-efd233903643",
        "ProfileTemplateUuid":"8f31803f-8afc-49bb-911d-402ec264b589",
        "ProfileTemplateVersion":8,
        "Comment":"",
        "ProfileOperations":[
            "renew",
            "disable",
            "recover"
        ]
    },
    {
        "Uuid":"5ad77b40-aa42-4533-9396-c9c59fd021a8",
        "Status":2,
        "Flags":1,
        "ParentProfileUuid":"00000000-0000-0000-0000-000000000000",
        "PrimaryProfileUuid":"00000000-0000-0000-0000-000000000000",
        "AssignedUserUuid":"0378a33b-8650-4713-a727-efd233903643",
        "ProfileTemplateUuid":"8f31803f-8afc-49bb-911d-402ec264b589",
        "ProfileTemplateVersion":8,
        "Comment":"",
        "ProfileOperations":[
            "renew",
            "disable",
            "recover"
        ]
    },
    {
        "Uuid":"ff342953-c444-4dc7-b144-f5515d6460c6",
        "Status":2,
        "Flags":1,
        "ParentProfileUuid":"00000000-0000-0000-0000-000000000000",
        "PrimaryProfileUuid":"00000000-0000-0000-0000-000000000000",
        "AssignedUserUuid":"0378a33b-8650-4713-a727-efd233903643",
        "ProfileTemplateUuid":"1e3a31fe-699b-4a6b-945c-18b83c985bc1",
        "ProfileTemplateVersion":9,
        "Comment":"",
        "ProfileOperations":[
            "renew",
            "disable"
        ]
    }
]

Voir aussi

  • Last updated on