Enumerar printJobsList printJobs

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. Para determinar si una API está disponible en v 1.0, use el selector de versiones .To determine whether an API is available in v1.0, use the Version selector.

Recupere una lista de trabajos de impresión asociados con la impresora.Retrieve a list of print jobs associated with the printer.

PermisosPermissions

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.

Para usar el servicio de impresión universal, el inquilino del usuario o de la aplicación debe tener una suscripción de impresión universal activa, un permiso que conceda acceso a la impresora y uno de los permisos que aparecen en la siguiente tabla.To use the Universal Print service, the user or app's tenant must have an active Universal Print subscription, a permission that grants Get printer access, and one of the permissions listed in the following table. El usuario que ha iniciado sesión debe ser un administrador de la impresora.The signed in user must be a Printer Administrator.

Para leer los trabajos de impresión de otro usuario, el usuario que ha iniciado sesión tiene que ser un administrador de impresión y tener el permiso PrintJob. ReadBasic. All, PrintJob. Read. All, PrintJob. ReadWriteBasic. All o PrintJob. ReadWrite. All.To read print jobs from another user, the signed in user needs to be a print administrator and have the PrintJob.ReadBasic.All, PrintJob.Read.All, PrintJob.ReadWriteBasic.All, or PrintJob.ReadWrite.All permission.

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) PrintJob. ReadBasic, PrintJob. Read, PrintJob. ReadBasic. All, PrintJob. Read. All, PrintJob. ReadWriteBasic, PrintJob. ReadWrite, PrintJob. ReadWriteBasic. All, PrintJob. ReadWrite. AllPrintJob.ReadBasic, PrintJob.Read, PrintJob.ReadBasic.All, PrintJob.Read.All, PrintJob.ReadWriteBasic, PrintJob.ReadWrite, PrintJob.ReadWriteBasic.All, PrintJob.ReadWrite.All
Delegado (cuenta personal de Microsoft)Delegated (personal Microsoft account) No se admite.Not Supported.
AplicaciónApplication PrintJob. ReadBasic. All, PrintJob. Read. All, PrintJob. ReadWriteBasic. All, PrintJob. ReadWrite. AllPrintJob.ReadBasic.All, PrintJob.Read.All, PrintJob.ReadWriteBasic.All, PrintJob.ReadWrite.All

Solicitud HTTPHTTP request

GET /print/printers/{id}/jobs

Parámetros de consulta opcionalesOptional query parameters

Este método admite los Parámetros de consulta de OData a modo de ayuda para personalizar la respuesta.This method supports some of the OData query parameters to help customize the response. Para obtener información general, vea Parámetros de consulta OData.For general information, see OData query parameters.

  • De forma predeterminada, se omite la propiedad Documents de la respuesta.The documents property is omitted from the response by default. Para devolver también una lista de printDocuments para cada trabajo de impresión, use $expand=documents .To also return a list of printDocuments for each print job, use $expand=documents.
  • Este método permite filtrar los trabajos de impresión por parte del usuario que los creó.This method supports filtering print jobs by the user who created them. Use $filter=createdBy/userPrincipalName eq '{upn}' , donde {UPN} es el nombre principal de usuario del usuario asociado.Use $filter=createdBy/userPrincipalName eq '{upn}', where {upn} is the user principal name of the associated user.

ExceptionsExceptions

Algunos operadores no son compatibles: $count , $search , $filter .Some operators are not supported: $count, $search, $filter.

Encabezados de solicitudRequest headers

NombreName DescripciónDescription
AuthorizationAuthorization {token} de portador. Obligatorio.Bearer {token}. Required.

Cuerpo de la solicitudRequest body

No proporcione un cuerpo de solicitud para este método.Do not supply a request body for this method.

RespuestaResponse

Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y la colección de objetos printJob en el cuerpo de la respuesta.If successful, this method returns a 200 OK response code and collection of printJob objects in the response body.

EjemploExample

SolicitudRequest

Aquí tiene un ejemplo de la solicitud.The following is an example of the request.

GET https://graph.microsoft.com/beta/print/printers/{id}/jobs

RespuestaResponse

Aquí tiene un ejemplo de la respuesta.The following is an example of the response.

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad. Se devolverán todas las propiedades de una llamada real.Note: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.

HTTP/1.1 200 OK
Content-type: application/json
Content-length: 461

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#print/printers('c05f3726-0d4b-4aa1-8fe9-2eb981bb26fb')/jobs",
  "value": [
    {
      "id": "5182",
      "createdDateTime": "2020-02-04T00:00:00.0000000Z",
      "createdBy": {},
      "status": {
        "processingState": "completed",
        "processingStateDescription": "The print job has completed successfully and no further processing will take place."
      }
    }
  ]
}