Créer une demande
créez une demande de gestion des certificats Microsoft Identity Manager (MIM).
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 |
|---|---|
| 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 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 | Optionnel. GUID de l'utilisateur cible pour lequel la requête doit être créée. S’il n’est pas spécifié, la cible par défaut est l’utilisateur actuel. |
| type | Obligatoire. Type de demande en cours de création. Les types de demandes disponibles incluent « ENROLL », « duplicate », « OfflineUnblock », « OnlineUpdate », « Renew », « Recover », « RecoverOnBehalf », « Reverse », « disretraite », « Revoke », « TemporaryCards » et « Unblock ». Remarque: tous les types de demande ne sont pas pris en charge sur tous les modèles de profil. Par exemple, vous ne pouvez pas spécifier l’opération de déblocage sur un modèle de profil logiciel. |
| comment | Obligatoire. Commentaires pouvant être entrés par l'utilisateur. La stratégie de workflow définit si la propriété Comment est nécessaire. Une chaîne vide peut être spécifiée. |
| priority | Optionnel. Priorité de la demande. S’il n’est pas spécifié, la priorité de demande par défaut, telle que déterminée par les paramètres de 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 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 : demande 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 : demande 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"
}
Voir aussi
- Méthode Microsoft. CLM. provision. RequestOperations. Initiateenroll,
- Méthode Microsoft. CLM. provision. RequestOperations. Initiateofflineunblock,
- Méthode Microsoft. CLM. provision. RequestOperations. Initiaterecover,
- Méthode Microsoft. CLM. provision. RequestOperations. Initiateretire,
- Méthode Microsoft. CLM. provision. RequestOperations. Initiateunblock,