命名空间:microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。
异步新建 pullPrintPrinter 对象。
权限
为此 API 选择标记为最低特权的权限。 只有在应用需要它时,才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息,请参阅权限类型。 要了解有关这些权限的详细信息,请参阅 权限参考。
| 权限类型 | 最小特权权限 | 更高特权权限 |
|---|---|---|
| 委派(工作或学校帐户) | PullPrintPrinter.FullControl.All | 不可用。 |
| 委派(个人 Microsoft 帐户) | 不支持。 | 不支持。 |
| 应用程序 | 不支持。 | 不支持。 |
重要
对于使用工作或学校帐户的委派访问权限,登录用户必须在租户范围内分配到受支持的 Microsoft Entra 角色。 打印机管理员 是此操作支持的最低特权角色。
HTTP 请求
POST /print/pullPrintPrinters
请求标头
| 名称 | 说明 |
|---|---|
| Authorization | 持有者 {token}。 必填。 详细了解 身份验证和授权。 |
| Content-Type | application/json. 必需。 |
请求正文
在请求正文中,提供 pullPrintPrinter 对象的 JSON 表示形式。
创建 pullPrintPrinter 时,可以指定以下属性。
| 属性 | 类型 | 说明 |
|---|---|---|
| displayName | String | 拉式打印打印机的非空名称。 必填。 |
| includeAllPrinters | 布尔值 | 指示租户中的每个打印机是否自动成为此拉取打印打印机的成员。 可选。 默认值为 false。 时false,将特定打印机添加到打印机关系。 |
响应
如果成功,此方法将返回响应 202 Accepted 代码,但不返回响应正文。
Location响应标头包含 pullPrintPrinterCreateOperation 的 URL。 还支持旧 Operation-Location 标头,并包含相同的 URL。
Retry-After标头指定轮询前要等待的秒数。
使用操作 URL 中的 Get pullPrintPrinterCreateOperation API 检索操作 JSON 并监视其 状态。 轮询时观察 Retry-After 间隔,并在 status.state 为 succeeded 或 failed时停止。 创建成功后,使用操作的 pullPrintPrinter 关系 获取 创建的 pullPrintPrinter 对象。
示例
请求
以下示例显示了一个请求。
POST https://graph.microsoft.com/beta/print/pullPrintPrinters
Content-Type: application/json
{
"displayName": "Contoso Pull Print - Building 5",
"includeAllPrinters": false
}
响应
以下示例显示了相应的响应。
HTTP/1.1 202 Accepted
Location: https://graph.microsoft.com/beta/print/operations/f0d0f0f0-1234-5678-9abc-def012345678
Operation-Location: https://graph.microsoft.com/beta/print/operations/f0d0f0f0-1234-5678-9abc-def012345678
Retry-After: 5