Partager via

Créer une demande

Créez une demande MIM (Microsoft Identity Manager) Certificate Management (CM).

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

Paramètres d’URL

Aucun.

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

Le corps de la requête contient les propriétés suivantes :

Propriété Description
profiletemplateuuid Obligatoire. GUID du modèle de profil pour lequel l’utilisateur crée la demande.
datacollection Obligatoire. Collection de paires nom-valeur représentant les données à fournir par le bénéficiaire. La collecte des données nécessaires qui doivent être fournies peut être récupérée à partir de la stratégie de flux de travail du modèle de profil. Une collection vide peut être spécifiée.
cible Optionnel. GUID de l’utilisateur cible pour lequel la demande doit être créée. S’il n’est pas spécifié, la cible est définie par défaut sur l’utilisateur actuel.
type Obligatoire. Type de requête en cours de création. Les types de requêtes disponibles incluent « Inscrire », « Dupliquer », « OfflineUnblock », « OnlineUpdate », « Renouveler », « Récupérer », « RecoverOnBehalf », « Rétablir », « Retirer », « Révoquer », « Révoquer », « Temporaires » et « Débloquer ».

Remarque: tous les types de demandes 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. Tous les commentaires qui peuvent ê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.
priorité Optionnel. Priorité de la requête. 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.

Réponse

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 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 l’URI de la demande nouvellement créée.

Exemple :

Cette section fournit un exemple de création de demandes d’inscription et de déblocage.

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

  • Last updated on