Partager via

Requête GET

Obtient une ou plusieurs demandes de gestion des certificats Microsoft Identity Manager (MIM) spécifiées.

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/requests/{id}

Paramètres d’URL

Propriété Description
id Optionnel. GUID d’une requête à récupérer.

Paramètres de requête

Propriété Description
targetuser Optionnel. Utilisateur cible de la requête. Si aucune cible n’est spécifiée, toutes les requêtes, quel que soit l’utilisateur cible, sont retournées.

Remarque: seule la valeur « actuelle » est actuellement prise en charge.
statut Optionnel. 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 l’état retourné.

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 un ou plusieurs objets Request avec les propriétés suivantes :

Nom Description
Commentaire Commentaire associé à la requête CM MIM.
Terminé Heure à laquelle la demande MIM CM a été terminée.
DataCollection Éléments de collecte de données associés à la requête CM MIM.
DataCollectionFlags Options de collecte de données pour la requête MIM CM.
Flags Options associées à la requête CM MIM.
IsDataCollectionComplete Valeur booléenne qui indique si la collecte de données a été effectuée pour la requête CM MIM.
IsEnrollmentAgent Valeur booléenne qui indique si un agent d’inscription est requis pour exécuter la requête CM MIM.
IsSmartcard Valeur booléenne qui indique si la demande MIM CM est une demande de carte à puce ou une demande 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 requête 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 MIM CM.
Priorité Priorité de la requête CM MIM.
ProfileTemplateUuid Identité du modèle de profil pour lequel la requête CM MIM a été créée.
RequestType Type de la requête CM MIM.
SecurityDescriptor Descripteur de sécurité pour la requête MIM CM.
Statut État de la requête MIM CM.
Envoyé Heure à laquelle la demande MIM CM a été envoyée.
TargetUserUuid Identité de l’utilisateur cible pour la requête CM MIM.
Uuid Identificateur de la requête MIM CM.

Exemple :

Cette section fournit un exemple pour obtenir les requêtes MIM CM spécifiées.

Exemple : Demande 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 : Demande 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
}

Voir aussi

  • Last updated on