impresora: crear

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Cree (registre) una impresora con el servicio Universal Print. Se trata de una operación de larga duración y, como tal, devuelve un printerCreateOperation que puede usarse para realizar un seguimiento y comprobar el registro de la impresora.

Esta API está disponible en las siguientes implementaciones en la nube nacional.

Servicio global Administración pública de EE. UU. Gobierno de EE. UU. L5 (DOD) China operado por 21Vianet
✅ ✅ ✅ ❌

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) Printer.Create Printer.FullControl.All, Printer.ReadWrite.All
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación No admitida. No admitida.

Solicitud HTTP

POST /print/printers/create

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre autenticación y autorización.
Tipo de contenido application/json. Obligatorio.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione un objeto JSON con las siguientes propiedades.

Parámetro Tipo Descripción ¿Necesario?
displayName Cadena El nombre para mostrar que se asignará a la impresora. Sí
manufacturer Cadena El fabricante de la impresora. Sí
model Cadena El modelo de la impresora. Sí
physicalDeviceId Cadena UUID del dispositivo físico de la impresora. Obligatorio si la hasPhysicalDevice propiedad es verdadera. No
hasPhysicalDevice Booleano True si la impresora tiene un dispositivo de salida físico; de lo contrario, false. Si se omite, el valor predeterminado es true. No
certificateSigningRequest printCertificateSigningRequest La solicitud de firma de certificado (RSC) X.509 para el certificado creado y usado por la impresora para identificarse. Sí
identificador de conector Cadena Id. del conector que actúa como proxy de la impresora. No

Respuesta

Si se realiza correctamente, este método devuelve un 202 Accepted código de respuesta y un vínculo a la printerCreateOperation asociada en el Operation-Location encabezado.

Hacer una solicitud GET a la URL vinculada puede usarse para obtener el estado de un registro de impresora en curso. Una vez que el registro de la impresora se haya completado correctamente, una solicitud GET a la dirección URL vinculada contendrá el objeto de impresora creado y el certificado registrado.

Ejemplo

Solicitud

En el ejemplo siguiente se muestra la solicitud.

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
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

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