impresora: crearprinter: create

Espacio de nombres: microsoft.graphNamespace: microsoft.graph

Importante

Las API de la /beta versión de Microsoft Graph están sujetas a cambios.APIs under the /beta version in Microsoft Graph are subject to change. No se admite el uso de estas API en aplicaciones de producción.Use of these APIs in production applications is not supported.

Cree (registre) una impresora con el servicio de impresión universal.Create (register) a printer with the Universal Print service. Se trata de una operación de ejecución prolongada y, como tal, devuelve una printerCreateOperation que se puede usar para realizar un seguimiento y comprobar el registro de la impresora.This is a long-running operation and as such, it returns a printerCreateOperation that can be used to track and verify the registration of the printer.

PermissionsPermissions

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Además de los siguientes permisos, el inquilino del usuario debe tener una suscripción de impresión universal activa.In addition to the following permissions, the user's tenant must have an active Universal Print subscription. El usuario que ha iniciado sesión debe ser un administrador de la impresora.The signed in user must be a Printer Administrator.

Tipo de permisoPermission type Permisos (de menos a más privilegiados)Permissions (from least to most privileged)
Delegado (cuenta profesional o educativa)Delegated (work or school account) Printer. Create, Printer. ReadWrite. All, Printer. FullControl. AllPrinter.Create, Printer.ReadWrite.All, Printer.FullControl.All
Delegado (cuenta personal de Microsoft)Delegated (personal Microsoft account) No se admite.Not Supported.
AplicaciónApplication No admitida.Not supported.

Solicitud HTTPHTTP request

POST /print/printers/create

Encabezados de solicitudRequest headers

NombreName DescripciónDescription
AuthorizationAuthorization {token} de portador. Obligatorio.Bearer {token}. Required.
Tipo de contenidoContent-type application/json. Obligatorio.application/json. Required.

Cuerpo de la solicitudRequest body

En el cuerpo de la solicitud, proporcione un objeto JSON con las siguientes propiedades.In the request body, provide a JSON object with the following properties.

ParámetroParameter TipoType DescripciónDescription ¿Necesario?Required?
displayNamedisplayName CadenaString El nombre para mostrar que se va a asignar a la impresora.The display name to assign to the printer. Yes
manufacturermanufacturer CadenaString El fabricante de la impresora.The manufacturer of the printer. Yes
modelmodel CadenaString Modelo de la impresora.The model of the printer. Yes
physicalDeviceIdphysicalDeviceId CadenaString El UUID de dispositivo físico de la impresora.The physical device UUID of the printer. Obligatorio si la hasPhysicalDevice propiedad es true.Required if the hasPhysicalDevice property is true. NoNo
hasPhysicalDevicehasPhysicalDevice BooleanoBoolean True si la impresora tiene un dispositivo de salida físico; de lo contrario, false.True if the printer has physical output device, false otherwise. Si se omite, el valor predeterminado es true.If omitted, the default value is true. NoNo
certificateSigningRequestcertificateSigningRequest printCertificateSigningRequestprintCertificateSigningRequest La solicitud de firma de certificado X. 509 (CSR) para el certificado creado y usado por la impresora para identificarse.The X.509 Certificate Signing Request (CSR) for the certificate created and used by the printer to identify itself. Yes
connectorIdconnectorId CadenaString Identificador del conector que actúa como proxy para la impresora.Id of Connector acting as proxy to the printer. NoNo

RespuestaResponse

Si se ejecuta correctamente, este método devuelve un 202 Accepted código de respuesta y un vínculo al printerCreateOperation asociado en el Operation-Location encabezado.If successful, this method returns a 202 Accepted response code and a link to the associated printerCreateOperation in the Operation-Location header.

La creación de una solicitud GET a la dirección URL vinculada puede usarse para obtener el estado de un registro de la impresora en curso.Making a GET request to the linked URL can be used to get the status of an ongoing printer registration. Una vez que el registro de la impresora se haya completado correctamente, una solicitud GET a la dirección URL vinculada contendrá el objeto Printer creado y el certificado registrado.Once printer registration has completed successfully, a GET request to the linked URL will contain the created printer object and registered certificate.

EjemploExample

SolicitudRequest

Aquí tiene un ejemplo de la solicitud.The following is an example of the request. Para obtener ayuda para crear la solicitud de firma de certificado necesaria (CSR), vea el ejemplo de código generación del CSR.For help creating the required Certificate Signing Request (CSR), see the CSR generation code sample.

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

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

RespuestaResponse

Este es un ejemplo de la respuesta.The following is an example of the response.

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