Actualizar impresora

Espacio de nombres: microsoft.graph

Actualizar las propiedades de un objeto de impresora .

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

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.

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

Solicitud HTTP

PATCH /print/printers/{id}

Encabezados de solicitud

Cuerpo de la solicitud

Permisos delegados y carga útil de JSON

Si usa permisos delegados, en el cuerpo de la solicitud, proporcione los valores de los campos de impresora relevantes que deben actualizarse. Las propiedades existentes que no están incluidas 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 con permisos delegados.

Permisos de aplicación y carga útil de JSON

En el cuerpo de la solicitud, proporcione los valores de los campos de impresora relevantes que deben actualizarse. 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 con permisos de aplicación.

Permisos de aplicación y carga de IPP

Con permisos de aplicación, una impresora también se puede actualizar utilizando una carga útil del Protocolo de impresión en 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 de impresora con uno o más valores (incluidos los valores fuera de banda permitidos explícitamente) como se define en RFC8011 sección 5.2 Atributos de plantilla de trabajo ("atributos xxx-default", "xxx-supported" y "xxx-ready"), sección 5.4 Atributos de descripción de la impresora. Además, el cliente debe proporcionar las extensiones de atributo admitidas por la impresora. Los valores de cada atributo Printer suministrado 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 pasar atributos de operación en el cuerpo de la solicitud. El cuerpo de la solicitud solo debe contener los atributos de la impresora.

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

Respuesta

Permisos delegados y carga útil de JSON

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

Permisos de aplicación y carga útil de JSON

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

Permisos de aplicación y carga de IPP

Si utiliza permisos de aplicación, si se realiza 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
  }
}

// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Beta.Models;

var requestBody = new Printer
{
	Name = "PrinterName",
	Location = new PrinterLocation
	{
		Latitude = 1.1d,
		Longitude = 2.2d,
		AltitudeInMeters = 3,
	},
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Print.Printers["{printer-id}"].PatchAsync(requestBody);

// Code snippets are only available for the latest major version. Current major version is $v0.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
	  graphmodels "github.com/microsoftgraph/msgraph-beta-sdk-go/models"
	  //other-imports
)

requestBody := graphmodels.NewPrinter()
name := "PrinterName"
requestBody.SetName(&name) 
location := graphmodels.NewPrinterLocation()
latitude := float64(1.1)
location.SetLatitude(&latitude) 
longitude := float64(2.2)
location.SetLongitude(&longitude) 
altitudeInMeters := int32(3)
location.SetAltitudeInMeters(&altitudeInMeters) 
requestBody.SetLocation(location)

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
printers, err := graphClient.Print().Printers().ByPrinterId("printer-id").Patch(context.Background(), requestBody, nil)

// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

Printer printer = new Printer();
printer.setName("PrinterName");
PrinterLocation location = new PrinterLocation();
location.setLatitude(1.1d);
location.setLongitude(2.2d);
location.setAltitudeInMeters(3);
printer.setLocation(location);
Printer result = graphClient.print().printers().byPrinterId("{printer-id}").patch(printer);

const options = {
	authProvider,
};

const client = Client.init(options);

const printer = {
  name: 'PrinterName',
  location: {
    latitude: 1.1,
    longitude: 2.2,
    altitudeInMeters: 3
  }
};

await client.api('/print/printers/{id}')
	.version('beta')
	.update(printer);

<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Models\Printer;
use Microsoft\Graph\Beta\Generated\Models\PrinterLocation;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);

$requestBody = new Printer();
$requestBody->setName('PrinterName');
$location = new PrinterLocation();
$location->setLatitude(1.1);
$location->setLongitude(2.2);
$location->setAltitudeInMeters(3);
$requestBody->setLocation($location);

$result = $graphServiceClient->escapedPrint()->printers()->byPrinterId('printer-id')->patch($requestBody)->wait();

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.models.printer import Printer
from msgraph_beta.generated.models.printer_location import PrinterLocation
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = Printer(
	name = "PrinterName",
	location = PrinterLocation(
		latitude = 1.1,
		longitude = 2.2,
		altitude_in_meters = 3,
	),
)

result = await graph_client.print.printers.by_printer_id('printer-id').patch(request_body)

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"
  }
}