Compartir a través de


Actualizar impresora

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.

Actualice las propiedades de un objeto de impresora .

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global Gobierno de EE. UU. L4 Us Government L5 (DOD) China operada por 21Vianet

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores 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.ReadWrite.All Printer.FullControl.All
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación Printer.ReadWrite.All No disponible.

Nota: En este momento, solo las impresoras que no tienen dispositivos físicos se pueden actualizar mediante permisos de aplicación.

Solicitud HTTP

PATCH /print/printers/{id}

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.
Tipo de contenido application/json cuando se usan permisos application/ipp delegados o application/json cuando se usan permisos de aplicación. Obligatorio.

Cuerpo de la solicitud

Permisos delegados y carga de JSON

Si usa permisos delegados, en el cuerpo de la solicitud, proporcione los valores de los campos de impresora pertinentes que se deben actualizar. Las propiedades existentes que no se incluyen en el cuerpo de la solicitud mantienen sus valores anteriores o se recalculan en función de los cambios realizados en otros valores de propiedad. Para obtener el mejor rendimiento, no incluya valores existentes que no hayan cambiado.

Las siguientes propiedades se pueden actualizar mediante permisos delegados.

Propiedad Tipo Descripción
defaults printerDefaults La configuración de impresión predeterminada de la impresora.
ubicación printerLocation Ubicación física o organizativa de la impresora.
displayName Cadena Nombre de la impresora.

Permisos de aplicación y carga de JSON

En el cuerpo de la solicitud, proporcione los valores de los campos de impresora pertinentes que se deben actualizar. Las propiedades existentes que no se incluyen en el cuerpo de la solicitud mantienen sus valores anteriores o se recalculan en función de los cambios realizados en otros valores de propiedad. Para obtener el mejor rendimiento, no incluya valores existentes que no hayan cambiado.

Las siguientes propiedades se pueden actualizar mediante permisos de aplicación.

Propiedad Tipo Descripción
defaults printerDefaults La configuración de impresión predeterminada de la impresora.
capabilities printerCapabilities Capacidades de la impresora asociada a este recurso compartido de impresora.
displayName Cadena Nombre de la impresora.
manufacturer Cadena Fabricante de la impresora.
model Cadena Nombre del modelo de la impresora.
status printerStatus Estado de procesamiento de la impresora, incluidos los errores.
isAcceptingJobs Booleano Si la impresora está aceptando nuevos trabajos de impresión.

Permisos de aplicación y carga de IPP

Con permisos de aplicación, una impresora también se puede actualizar mediante una carga de Protocolo de impresión por Internet (IPP). En este caso, el cuerpo de la solicitud contiene una secuencia binaria que representa el grupo Atributos de impresora en la codificación IPP.

El cliente DEBE proporcionar un conjunto de atributos Printer con uno o varios valores (incluidos los valores fuera de banda permitidos explícitamente) tal como se define en RFC8011 sección 5.2 Atributos de plantilla de trabajo ("xxx-default", "xxx-supported" y "xxx-ready"), Atributos de descripción de impresora de la sección 5.4 . Además, el cliente debe proporcionar cualquier extensión de atributo compatible con printer. Los valores de cada atributo Printer proporcionado reemplazan los valores del atributo Printer correspondiente en el objeto Printer de destino. Para los atributos que pueden tener varios valores (1setOf), todos los valores proporcionados por el cliente reemplazan todos los valores del atributo de objeto Printer correspondiente.

Nota: No pase atributos de operación en el cuerpo de la solicitud. El cuerpo de la solicitud solo debe contener atributos de impresora.

Nota: Para que las impresoras funcionen con una plataforma determinada, debe cumplir los requisitos de esa plataforma. Por ejemplo, en el cliente de Windows, se espera que la impresora especifique todos los atributos que se consideran obligatorios según las especificaciones de MOPRIA . Tenga en cuenta que las especificaciones MOPRIA solo están disponibles para los miembros de pago de MOPRIA.

Respuesta

Permisos delegados y carga de JSON

Si usa permisos delegados, si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y un objeto de impresora actualizado en el cuerpo de la respuesta.

Permisos de aplicación y carga de JSON

Si usa permisos delegados, si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y un objeto de impresora actualizado en el cuerpo de la respuesta.

Permisos de aplicación y carga de IPP

Si usa permisos de aplicación, si se ejecuta correctamente, este método devuelve 204 No content código de respuesta. No devuelve nada en el cuerpo de la respuesta.

Ejemplo

Solicitud

En el ejemplo siguiente se muestra la solicitud.

PATCH https://graph.microsoft.com/beta/print/printers/{id}
Content-type: application/json

{
  "name": "PrinterName",
  "location": {
    "latitude": 1.1,
    "longitude": 2.2,
    "altitudeInMeters": 3
  }
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

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

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#print/printers/$entity",
  "id": "016b5565-3bbf-4067-b9ff-4d68167eb1a6",
  "displayName": "PrinterName",
  "manufacturer": "PrinterManufacturer",
  "model": "PrinterModel",
  "isShared": true,
  "registeredDateTime": "2020-02-04T00:00:00.0000000Z",
  "isAcceptingJobs": true,
  "status": {
    "state": "idle",
    "details": [],
    "description": ""
  },
  "defaults": {
    "copiesPerJob":1,
    "contentType": "application/oxps",
    "finishings": ["none"],
    "mediaType": "stationery"
  },
  "location": {
    "latitude": 1.1,
    "longitude": 2.2,
    "altitudeInMeters": 3,
    "streetAddress": "One Microsoft Way",
    "subUnit": [
        "Main Plaza",
        "Unit 400"
    ],
    "city": "Redmond",
    "postalCode": "98052",
    "countryOrRegion": "USA",
    "site": "Puget Sound",
    "building": "Studio E",
    "floor": "1",
    "floorDescription": "First Floor",
    "roomName": "1234",
    "roomDescription": "First floor copy room",
    "organization": [
        "C+AI",
        "Microsoft Graph"
    ],
    "subdivision": [
        "King County",
        "Red West"
    ],
    "stateOrProvince": "Washington"
  }
}