Requête GET
Obtient une ou plusieurs requêtes de gestion des certificats (CM) Microsoft Identity Manager (MIM) spécifiées.
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/requests/{id} |
Paramètres d’URL
| Propriété | Description |
|---|---|
| id | facultatif. GUID d'une requête à extraire. |
Paramètres de requête
| Propriété | Description |
|---|---|
| targetuser | facultatif. Utilisateur cible de la demande. Si aucune cible n’est spécifiée, toutes les demandes, quel que soit l’utilisateur cible, sont retournées. Remarque : Seule la valeur « current » est actuellement prise en charge. |
| status | facultatif. Indique l'état de la demande à récupérer. Les types d’état possibles sont « Approuvé », « Annulé », « Terminé », « Refusé », « Exécution », « Échec », « Aucun » et « En attente ». Si aucun état n’est spécifié, toutes les demandes, quel que soit leur état, sont retournées. |
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 les 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 les détails du service DE L’API REST CM.
Response body
En cas de réussite, retourne un ou plusieurs objets Request avec les propriétés suivantes :
| Nom | Description |
|---|---|
| Commentaire | Commentaire associé à la demande MIM CM. |
| Effectué | Heure à laquelle la demande MIM CM s'est terminée. |
| DataCollection | Éléments de collection de données associés à la demande MIM CM. |
| DataCollectionFlags | Options pour la collection de données pour la demande MIM CM. |
| Indicateurs | Options associées à la demande MIM CM. |
| IsDataCollectionComplete | Valeur booléenne qui indique si la collection de données a été effectuée pour la demande MIM CM. |
| IsEnrollmentAgent | Valeur booléenne qui indique si un agent d'inscription est nécessaire pour exécuter la demande MIM CM. |
| IsSmartcard | Valeur booléenne qui indique si la demande MIM CM est une demande de carte à puce ou de profil logiciel. |
| NewProfileUuid | Identité du nouveau profil logiciel généré par la demande MIM CM. |
| NewSmartcardUuid | Identité de la nouvelle carte à puce affectée par la demande MIM CM. |
| OldProfileUuid | Identité du profil logiciel pour lequel la demande MIM CM a été créée. |
| OldSmartcardUuid | Identité de la carte à puce pour laquelle la demande MIM CM a été créée. |
| OriginatorUserUuid | Identité de l’utilisateur à l’origine de la requête CM MIM. |
| Priorité | Priorité de la demande MIM CM. |
| ProfileTemplateUuid | Identité du modèle de profil pour lequel la demande MIM CM a été créée. |
| RequestType | Type de la demande MIM CM. |
| SecurityDescriptor | Descripteur de sécurité de la demande MIM CM. |
| Statut | État de la demande MIM CM. |
| Envoyée | Heure à laquelle la demande MIM CM a été soumise. |
| TargetUserUuid | Identité de l'utilisateur cible pour la demande MIM CM. |
| Uuid | Identificateur de la demande MIM CM. |
Exemple
Cette section fournit un exemple pour obtenir les requêtes CM MIM spécifiées.
Exemple : Requête 1
GET /certificatemanagement/api/v1.0/requests/a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099 HTTP/1.1
Exemple : Réponse 1
HTTP/1.1 200 OK
{
"Uuid":"a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099",
"RequestType":1,
"Status":3,
"Flags":2,
"DataCollection":[
],
"DataCollectionFlags":32,
"OriginatorUserUuid":"8f1590dc-d932-4b66-8e68-2e91c5880780",
"TargetUserUuid":"8f1590dc-d932-4b66-8e68-2e91c5880780",
"Submitted":"2015-07-07T23:36:21.93Z",
"Completed":"0001-01-01T00:00:00",
"NewProfileUuid":"00000000-0000-0000-0000-000000000000",
"OldProfileUuid":"00000000-0000-0000-0000-000000000000",
"NewSmartcardUuid":"00000000-0000-0000-0000-000000000000",
"OldSmartcardUuid":"00000000-0000-0000-0000-000000000000",
"Priority":0,
"Comment":"",
"ProfileTemplateUuid":"a039b4d0-5ce8-4eff-8651-181c6576fda3",
"SecurityDescriptor":"O:S-1-5-21-2127521184-1604012920-1887927527-14134865D:(D;;LC;;;S-1-5-21-2127521184-1604012920-1887927527-14995557)(A;;DCSW;;;S-1-5-21-2127521184-1604012920-1887927527-5094533)(A;;DCSW;;;S-1-5-21-2127521184-1604012920-1887927527-5094534)(A;;DCSW;;;S-1-5-21-2127521184-1604012920-1887927527-5219125)(A;;SWRC;;;S-1-5-21-2127521184-1604012920-1887927527-5094533)(A;;RC;;;WD)(A;;CCDCLCSWSDRC;;;S-1-5-21-2127521184-1604012920-1887927527-14134865)(A;;DCSW;;;S-1-5-21-2127521184-1604012920-1887927527-14995557)(A;;CCDCSW;;;S-1-5-21-2127521184-1604012920-1887927527-14995557)\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000",
"IsSmartcard":true,
"IsEnrollmentAgent":false,
"IsDataCollectionComplete":false
}
Exemple : Requête 2
GET /certificatemanagement/api/v1.0/requests/0c96d73f-967b-420e-854a-43ad2a1504bc HTTP/1.1
Exemple : Réponse 2
HTTP/1.1 200 OK
{
"Uuid":"0c96d73f-967b-420e-854a-43ad2a1504bc",
"RequestType":5,
"Status":3,
"Flags":2,
"DataCollection":[
{
"Name":"Sample Data Item",
"Value":null
}
],
"DataCollectionFlags":32,
"OriginatorUserUuid":"8f1590dc-d932-4b66-8e68-2e91c5880780",
"TargetUserUuid":"8f1590dc-d932-4b66-8e68-2e91c5880780",
"Submitted":"2015-07-07T23:40:33.133Z",
"Completed":"0001-01-01T00:00:00",
"NewProfileUuid":"b99ff38c-6653-471f-ae3c-325bb351a6bc",
"OldProfileUuid":"b99ff38c-6653-471f-ae3c-325bb351a6bc",
"NewSmartcardUuid":"17cf063d-e337-4aa9-a822-346554ddd3c9",
"OldSmartcardUuid":"17cf063d-e337-4aa9-a822-346554ddd3c9",
"Priority":0,
"Comment":"",
"ProfileTemplateUuid":"a039b4d0-5ce8-4eff-8651-181c6576fda3",
"SecurityDescriptor":"O:S-1-5-21-2127521184-1604012920-1887927527-14134865D:(D;;LC;;;S-1-5-21-2127521184-1604012920-1887927527-14995557)(A;;SWRC;;;S-1-5-21-2127521184-1604012920-1887927527-5094533)(A;;RC;;;WD)(A;;CCDCLCSWSDRC;;;S-1-5-21-2127521184-1604012920-1887927527-14134865)(A;;DCSW;;;S-1-5-21-2127521184-1604012920-1887927527-14995557)(A;;CCDCSW;;;S-1-5-21-2127521184-1604012920-1887927527-14995557)\u0000\u0000\u0000\u0000\u0000\u0000",
"IsSmartcard":true,
"IsEnrollmentAgent":false,
"IsDataCollectionComplete":false
}