Create printTaskDefinition
Article
03/02/2023
7 contributors
Feedback
In this article
Namespace: microsoft.graph
Create a new task definition.
For details about how to use this API to add pull printing support to Universal Print, see Extending Universal Print to support pull printing .
Permissions
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions .
In addition to the following permissions, the user's tenant must have an active Universal Print subscription.
Permission type
Permissions (from least to most privileged)
Delegated (work or school account)
Not supported.
Delegated (personal Microsoft account)
Not Supported.
Application
PrintTaskDefinition.ReadWrite.All
HTTP request
POST /print/taskDefinitions
Name
Description
Authorization
Bearer {token}. Required.
Content-Type
application/json. Required.
Request body
In the request body, supply a JSON representation of printTaskDefinition object.
The id and createdBy.appId properties of the printTaskDefinition object are set automatically upon resource creation.
Response
If successful, this method returns a 201 Created
response code and a printTaskDefinition object in the response body.
Examples
Request
POST https://graph.microsoft.com/v1.0/print/taskDefinitions
Content-Type: application/json
{
"displayName": "Test TaskDefinitionName",
"createdBy": {
"displayName": "Requesting App Display Name"
}
}
// Code snippets are only available for the latest version. Current version is 5.x
var graphClient = new GraphServiceClient(requestAdapter);
var requestBody = new PrintTaskDefinition
{
DisplayName = "Test TaskDefinitionName",
CreatedBy = new AppIdentity
{
DisplayName = "Requesting App Display Name",
},
};
var result = await graphClient.Print.TaskDefinitions.PostAsync(requestBody);
For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation .
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models"
//other-imports
)
graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)
requestBody := graphmodels.NewPrintTaskDefinition()
displayName := "Test TaskDefinitionName"
requestBody.SetDisplayName(&displayName)
createdBy := graphmodels.NewAppIdentity()
displayName := "Requesting App Display Name"
createdBy.SetDisplayName(&displayName)
requestBody.SetCreatedBy(createdBy)
result, err := graphClient.Print().TaskDefinitions().Post(context.Background(), requestBody, nil)
For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation .
GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();
PrintTaskDefinition printTaskDefinition = new PrintTaskDefinition();
printTaskDefinition.displayName = "Test TaskDefinitionName";
AppIdentity createdBy = new AppIdentity();
createdBy.displayName = "Requesting App Display Name";
printTaskDefinition.createdBy = createdBy;
graphClient.print().taskDefinitions()
.buildRequest()
.post(printTaskDefinition);
For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation .
const options = {
authProvider,
};
const client = Client.init(options);
const printTaskDefinition = {
displayName: 'Test TaskDefinitionName',
createdBy: {
displayName: 'Requesting App Display Name'
}
};
await client.api('/print/taskDefinitions')
.post(printTaskDefinition);
For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation .
<?php
// THIS SNIPPET IS A PREVIEW FOR THE KIOTA BASED SDK. NON-PRODUCTION USE ONLY
$graphServiceClient = new GraphServiceClient($requestAdapter);
$requestBody = new PrintTaskDefinition();
$requestBody->setDisplayName('Test TaskDefinitionName');
$createdBy = new AppIdentity();
$createdBy->setDisplayName('Requesting App Display Name');
$requestBody->setCreatedBy($createdBy);
$result = $graphServiceClient->print()->taskDefinitions()->post($requestBody);
For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation .
Import-Module Microsoft.Graph.Devices.CloudPrint
$params = @{
displayName = "Test TaskDefinitionName"
createdBy = @{
displayName = "Requesting App Display Name"
}
}
New-MgPrintTaskDefinition -BodyParameter $params
For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation .
Response
Note: The response object shown here might be shortened for readability.
HTTP/1.1 201 Created
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#print/taskDefinitions/$entity",
"id": "fab143fd-ee61-4358-8558-2c7dee953982",
"displayName": "Test TaskDefinitionName",
"createdBy": {
"appId": "815f204f-c791-4ee6-9098-614ecdb003f6",
"displayName": "Requesting App Display Name"
}
}