Récupérer les données de profil

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

Important

Le serveur définit le code confidentiel uniquement si la stratégie du modèle de profil indique qu’il doit être effectué. Dans le cas contraire, l’utilisateur doit fournir le code confidentiel.

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/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 dont les profils sont à retourner.

Paramètres de la requête

Paramètre Description
status Optionnel. Indique l’état des profils dont les données doivent être récupérées. Les types d’État possibles sont « actif », « approuvé », « annulé », « terminé », « refusé », « en cours d’exécution », « é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 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

Aucun.

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

Propriété Description
AssignedUserUuid Identificateur de l'utilisateur auquel est attribué le profil.
Commentaire Commentaire qui décrit le profil.
Indicateurs 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 qui peuvent être effectuées par l'utilisateur actuel sur le profil.
ProfileTemplateUuid Identificateur du modèle de profil contenant les stratégies et paramètres qui régissent le profil.
ProfileTemplateVersion Version du modèle de profil au moment de la création du profil.
État État du profil.
Uuid Identificateur du profil.

Exemple

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

Exemple : demande

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