打印机:创建

命名空间:microsoft.graph

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。

使用通用打印服务创建 (注册) 打印机。 这是一个长时间运行的操作,因此,它返回可用于跟踪和验证打印机注册的 printerCreateOperation 。

API 可用性

此 API 可用于以下国家级云部署。

全局服务 美国政府 L4 美国政府 L5 (DOD) 由世纪互联运营的中国
✅ ✅ ✅ ❌

权限

为此 API 选择标记为最低特权的权限。 只有在应用需要它时,才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息,请参阅权限类型。 要了解有关这些权限的详细信息,请参阅 权限参考。

权限类型 最低特权权限 更高特权权限
委派(工作或学校帐户) Printer.Create Printer.FullControl.All、Printer.ReadWrite.All
委派(个人 Microsoft 帐户) 不支持。 不支持。
应用程序 不支持。 不支持。

HTTP 请求

POST /print/printers/create

请求标头

名称 说明
Authorization 持有者 {token}。 必填。 详细了解 身份验证和授权。
Content-type application/json. 必需。

请求正文

在请求正文中,提供具有以下属性的 JSON 对象。

参数 类型 说明
displayName String 必填。 要分配给打印机的显示名称。
manufacturer String 必填。 打印机的制造商。
model String 必填。 打印机的型号。
physicalDeviceId String 可选。 打印机的物理设备 UUID。 如果属性为 true,则 hasPhysicalDevice 为必需。
hasPhysicalDevice 布尔值 可选。 如果打印机具有物理输出设备,则为 true,否则为 false。 如果省略,则默认值为 true。
certificateSigningRequest printCertificateSigningRequest 必填。 X.509 证书签名请求 (CSR) 打印机创建并用于标识自身的证书。
connectorId String 可选。 充当打印机代理的连接器的 ID。

响应

如果成功,此方法将在标头中Operation-Location返回202 Accepted响应代码和指向关联 printerCreateOperation 的链接。

对链接的 URL 发出 GET 请求可用于获取正在进行的打印机注册的状态。 成功完成打印机注册后,对链接 URL 的 GET 请求将包含创建的打印机对象和注册证书。

示例

请求

以下示例显示了一个请求。

POST https://graph.microsoft.com/beta/print/printers/create
Content-type: application/json

{
  "displayName": "Test Printer",
  "manufacturer": "Test Printer Manufacturer",
  "model": "Test Printer Model",
  "physicalDeviceId": null,
  "hasPhysicalDevice": false,
  "certificateSigningRequest": { 
    "content": "{content}",
    "transportKey": "{sampleTransportKey}"
  },
  "connectorId": null
}

响应

以下示例显示了相应的响应。

HTTP/1.1 202 Accepted
Operation-Location: https://graph.microsoft.com/beta/print/operations/f221760a-52e8-4c11-b8c5-5dfaef3a49db
Retry-After: 5