Créer une demande

Article
09/14/2023

Créez une demande de gestion des certificats (CM) Microsoft Identity Manager (MIM).

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
POST	/CertificateManagement/api/v1.0/requests

Paramètres d’URL

Aucun.

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

Le corps de la demande contient les propriétés suivantes :

Propriété	Description
profiletemplateuuid	Obligatoire. GUID du modèle de profil pour lequel l'utilisateur est en train de créer la requête.
datacollection	Obligatoire. Collection de paires nom-valeur représentant les données qui doivent être fournies par le candidat à l'inscription. La collection des données nécessaires à fournir peut être récupérée à partir de la stratégie de workflow du modèle de profil. Une collection vide peut être spécifiée.
target	facultatif. GUID de l'utilisateur cible pour lequel la requête doit être créée. Si elle n’est pas spécifiée, la cible est définie par défaut sur l’utilisateur actuel.
type	Obligatoire. Type de demande en cours de création. Les types de requêtes disponibles incluent « Inscrire », « Dupliquer », « OfflineUnblock », « OnlineUpdate », « Renouveler », « Récupérer », « Récupérer », « Rétablir », « Retirer », « Retirer », « Révoquer », « TemporaryCards » et « Débloquer ». Remarque : tous les types de requêtes ne sont pas pris en charge sur tous les modèles de profil. Par exemple, vous ne pouvez pas spécifier l’opération Débloquer sur un modèle de profil logiciel.
comment	Obligatoire. Commentaires pouvant être entrés par l'utilisateur. La stratégie de flux de travail définit si la propriété de commentaire est nécessaire. Une chaîne vide peut être spécifiée.
priority	facultatif. Priorité de la demande. Si elle n’est pas spécifiée, la priorité de requête par défaut, telle que déterminée par les paramètres du modèle de profil, est utilisée.

response

Cette section décrit la réponse.

Codes de réponse

Code	Description
201	Date de création
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 l'URI de la demande récemment créée.

Exemple

Cette section fournit un exemple pour créer des demandes d’inscription et de déblocage.

Exemple : Requête 1

POST /CertificateManagement/api/v1.0/requests HTTP/1.1

{
    "datacollection":"[]",
    "type":"Enroll",
    "profiletemplateuuid":"a039b4d0-5ce8-4eff-8651-181c6576fda3",
    "comment":""
}

Exemple : Réponse 1

HTTP/1.1 201 Created

"api/v1.0/requests/a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099"

Exemple : Requête 2

POST /CertificateManagement/api/v1.0/requests HTTP/1.1

{  
    "datacollection":"[]",
    "type":"Unblock",
    "smartcard":"17cf063d-e337-4aa9-a822-346554ddd3c9",
    "comment":""
}

Exemple : Réponse 2

HTTP/1.1 201 Created

"api/v1.0/requests/0c96d73f-967b-420e-854a-43ad2a1504bc"

Exemple : Requête 3

POST /CertificateManagement/api/v1.0/requests HTTP/1.1

{
    "profiletemplateuuid" : "97CD65FA-AF4B-4587-9309-0DD6BFD8B4E1",
    "datacollection":
    [
        {"name" : "pavle"},
        {"city" : "seattle"}
    ],
    "target" : "97CC3493-F556-4C9B-9D8B-982434201527",
    "type" : "Enroll",
    "comment" : "LALALALA",
    "priority" :  "4"
}

Partager via