Namespace: microsoft.graph
Important
APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.
Represents a virtual printer to which users send print jobs for later release at any member printer.
Inherits from printerBase.
Methods
| Method | Return type | Description |
|---|---|---|
| List | pullPrintPrinter collection | Get a list of the pullPrintPrinter objects and their properties in the tenant. |
| Create | None | Create a new pullPrintPrinter object asynchronously. |
| Get | pullPrintPrinter | Read the properties and relationships of a pullPrintPrinter object. |
| Update | pullPrintPrinter | Update the properties of a pullPrintPrinter object. |
| Delete | None | Delete a pullPrintPrinter. |
| Add printer | None | Add an existing printer to the printers relationship of a pullPrintPrinter. |
| Remove printer | None | Remove a printer from the printers relationship of a pullPrintPrinter. This operation removes only the membership; it doesn't delete the printer or the pullPrintPrinter. |
| Restore factory defaults | None | Restore the default settings of a pullPrintPrinter to the values specified by the manufacturer. |
| Member suggestions | printer collection | Get a list of printer objects that are eligible candidates to become member printers of a pullPrintPrinter. |
Properties
| Property | Type | Description |
|---|---|---|
| capabilities | printerCapabilities | The capabilities of the pull print printer. Read-only. Inherited from printerBase. |
| defaults | printerDefaults | The default print settings of the pull print printer. Inherited from printerBase. |
| displayName | String | The name of the pull print printer. Set when you create the pull print printer; read-only after creation. Inherited from printerBase. |
| id | String | The identifier of the pull print printer. Read-only. Inherited from printerBase. |
| includeAllPrinters | Boolean | Indicates whether every printer in the tenant is automatically a member of this pull print printer. When true, the printers collection doesn't need to be managed explicitly. |
| isAcceptingJobs | Boolean | Specifies whether the pull print printer currently accepts new print jobs. Read-only. Inherited from printerBase. |
| location | printerLocation | The organizational location of the pull print printer. Inherited from printerBase. |
| manufacturer | String | The manufacturer of the pull print printer. Read-only. Inherited from printerBase. |
| model | String | The model name of the pull print printer. Read-only. Inherited from printerBase. |
| registeredDateTime | DateTimeOffset | The date and time when the pull print printer was registered. Read-only. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2024, is 2024-01-01T00:00:00Z. |
| status | printerStatus | The processing status of the pull print printer, including any errors. Read-only. Inherited from printerBase. |
Relationships
| Relationship | Type | Description |
|---|---|---|
| jobs | printJob collection | The list of jobs that are queued in the pull print printer. Inherited from printerBase. |
| printers | printer collection | The member printers at which print jobs sent to this pull print printer can be released. Use Add printer and Remove printer to manage explicit membership. |
| shares | printerShare collection | The printer shares that are associated with this pull print printer. |
JSON representation
The following JSON representation shows the resource type.
{
"@odata.type": "#microsoft.graph.pullPrintPrinter",
"id": "String (identifier)",
"displayName": "String",
"manufacturer": "String",
"model": "String",
"isAcceptingJobs": "Boolean",
"defaults": {
"@odata.type": "microsoft.graph.printerDefaults"
},
"location": {
"@odata.type": "microsoft.graph.printerLocation"
},
"capabilities": {
"@odata.type": "microsoft.graph.printerCapabilities"
},
"status": {
"@odata.type": "microsoft.graph.printerStatus"
},
"registeredDateTime": "String (timestamp)",
"includeAllPrinters": "Boolean"
}