Créer printTaskTrigger

Espace de noms: microsoft.graph

Créez un déclencheur de tâche sur l’imprimante spécifiée. Actuellement, un seul déclencheur de tâche peut être spécifié par imprimante, mais cette limite peut être supprimée à l’avenir.

Remarque : L’appId utilisé pour générer un jeton d’accès pour la création d’un déclencheur de tâche doit être le même que celui utilisé pour créer la définition de tâche correspondante.

Autorisations

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Outre les autorisations suivantes, le client de l’utilisateur doit avoir un abonnement d’impression universelle actif. L’utilisateur doit être un administrateur d’imprimantes.

Type d’autorisation Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire) Printer.ReadWrite.All, Printer.FullControl.All
Déléguée (compte Microsoft personnel) Non prise en charge.
Application Non prise en charge.

Requête HTTP

POST /print/printers/{printerId}/taskTriggers

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire.
Content-Type application/json. Obligatoire.

Corps de la demande

Dans le corps de la demande, fournissons une représentation JSON d’un objet printTaskTrigger . Fournissez une référence à un printTaskDefinition en utilisant le @odata.bind format, comme illustré dans l’exemple suivant.

Réponse

Si elle réussit, cette méthode renvoie un 201 Created code de réponse et un printTaskTrigger dans le corps de la réponse.

Exemples

Demande

POST https://graph.microsoft.com/v1.0/print/printers/{printerId}/taskTriggers
Content-Type: application/json

{
  "event": "jobStarted",
  "definition@odata.bind": "https://graph.microsoft.com/v1.0/print/taskDefinitions/{taskDefinitionId}"
}

Réponse

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

HTTP/1.1 201 Created
Content-Type: application/json

{
  "@odata.context": "https://graph.print.microsoft.com/v1.0/$metadata#Collection(Microsoft.Graph.PrintTaskTrigger)",
  "id": "b6a843ca-e60e-4e20-a222-a58d85eead6d",
  "event": "jobStarted"
}