Obtenir des données de profil
Obtient la liste des 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 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 de modèle de profil indique que cela 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 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 requête
| Paramètre | Description |
|---|---|
| status | facultatif. Indique l’état des profils pour lesquels récupérer des données. Les types d’état possibles sont « Actif », « Approuvé », « Annulé », « Terminé », « Refusé », « 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 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 |
| 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 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. |
| Statut | État du profil. |
| Uuid | Identificateur du profil. |
Exemple
Cette section fournit un exemple permettant d’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"
]
}
]