更新打印机

项目
07/18/2022

命名空间：microsoft.graph

重要

Microsoft Graph版本下的 /beta API 可能会发生更改。不支持在生产应用程序中使用这些 API。若要确定 API 是否在 v1.0 中可用，请使用版本选择器。

更新打印机对象的属性。

权限

要调用此 API，需要以下权限之一。要了解详细信息，包括如何选择权限的信息，请参阅权限。

除了以下权限之外，用户的租户还必须具有活动的通用打印订阅。登录的用户必须是打印机管理员。

仅允许注册打印机的应用使用应用程序权限更新打印机。

权限类型	权限（从最低特权到最高特权）
委派（工作或学校帐户）	Printer.ReadWrite.All、Printer.FullControl.All
委派（个人 Microsoft 帐户）	不支持。
应用程序	Printer.ReadWrite.All

注意： 目前，只有没有物理设备的打印机可以使用应用程序权限进行更新。

HTTP 请求

PATCH /print/printers/{id}

请求标头

名称	说明
Authorization	Bearer {token}。必需。
Content-type	`application/json` 使用委派权限时， `application/ipp` 或者 `application/json` 使用应用程序权限时。必需。

请求正文

委派的权限和 JSON 有效负载

如果使用委派权限，在请求正文中，提供应更新的相关打印机字段的值。请求正文中不包括的现有属性将保留其以前的值，或根据对其他属性值的更改重新计算。为了获得最佳性能，请勿加入尚未更改的现有值。

可以使用委派权限更新以下属性。

属性	类型	Description
defaults	printerDefaults	打印机的默认打印设置。
位置	printerLocation	打印机的物理和/或组织位置。
displayName	String	打印机的名称。

应用程序权限和 JSON 有效负载

在请求正文中，提供应更新的相关打印机字段的值。请求正文中不包括的现有属性将保留其以前的值，或根据对其他属性值的更改重新计算。为了获得最佳性能，请勿加入尚未更改的现有值。

可以使用应用程序权限更新以下属性。

属性	类型	Description
defaults	printerDefaults	打印机的默认打印设置。
capabilities	printerCapabilities	与此打印机共享关联的打印机的功能。
displayName	String	打印机的名称。
manufacturer	String	打印机的制造商。
model	String	打印机的模型名称。
状态	printerStatus	打印机的处理状态，包括任何错误。
isAcceptingJobs	布尔	打印机当前是否接受新的打印作业。

应用程序权限和 IPP 有效负载

使用应用程序权限，还可使用 Internet 打印协议和 IPP (更新) 负载。在这种情况下，请求正文包含表示 IPP 编码中的 Printer Attributes 组的二进制流。

客户端必须为一组 Printer 属性提供一个或多个值 (包括 RFC8011 第 5.2 节中定义的显式允许的带外值) 作业模板属性 ("xxx-default"、"xxx-supported"和"xxx-ready"属性) 、第 5.4 节打印机说明属性以及打印机支持的任何属性扩展。提供的 (每个 Printer) 的值将 (Printer) 的对应 Printer 属性的值。对于在 1setOf (可以有多个值) ，客户端提供的所有值将替换相应的 Printer 对象属性的所有值。

注意： 不要传递请求正文中的操作属性。请求正文应仅包含打印机属性。

注意： 对于使用特定平台的打印机，它应满足该平台的要求。例如，在 Windows 客户端上，打印机应根据一些功能规范指定被视为必需属性的所有属性。请注意，一些 SPECRIA 规范仅适用于 PAIDRIA 的付费成员。

响应

委派的权限和 JSON 有效负载

如果使用委派权限，如果成功，此方法在响应正文中返回响应 200 OK 代码和更新的 printer 对象。

应用程序权限和 JSON 有效负载

如果使用委派权限，如果成功，此方法在响应正文中返回响应 200 OK 代码和更新的 printer 对象。

应用程序权限和 IPP 有效负载

如果使用应用程序权限，如果成功，此方法将返回 204 No content 响应代码。它不会在响应正文中返回任何内容。

示例

请求

下面展示了示例请求。

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

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


GraphServiceClient graphClient = new GraphServiceClient( authProvider );

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

await graphClient.Print.Printers["{printer-id}"]
    .Request()
    .UpdateAsync(printer);

重要

Microsoft Graph SDK 默认使用 v1.0 版本的 API，并且不支持 beta 版本中提供的所有类型、属性和 API。有关使用 SDK 访问 beta API 的详细信息，请参阅将 Microsoft Graph SDK 与 beta API 配合使用。

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。


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);

重要

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。


MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];

NSString *MSGraphBaseURL = @"https://graph.microsoft.com/beta/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/print/printers/{id}"]]];
[urlRequest setHTTPMethod:@"PATCH"];
[urlRequest setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];

MSGraphPrinter *printer = [[MSGraphPrinter alloc] init];
[printer setName:@"PrinterName"];
MSGraphPrinterLocation *location = [[MSGraphPrinterLocation alloc] init];
[location setLatitude: 1.1];
[location setLongitude: 2.2];
[location setAltitudeInMeters: 3];
[printer setLocation:location];

NSError *error;
NSData *printerData = [printer getSerializedDataWithError:&error];
[urlRequest setHTTPBody:printerData];

MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest 
    completionHandler: ^(NSData *data, NSURLResponse *response, NSError *nserror) {

        //Request Completed

}];

[meDataTask execute];

重要

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。


GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();

Printer printer = new Printer();
printer.name = "PrinterName";
PrinterLocation location = new PrinterLocation();
location.latitude = 1.1d;
location.longitude = 2.2d;
location.altitudeInMeters = 3;
printer.location = location;

graphClient.print().printers("{id}")
    .buildRequest()
    .patch(printer);

重要

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。


//THE GO SDK IS IN PREVIEW. NON-PRODUCTION USE ONLY
graphClient := msgraphsdk.NewGraphServiceClient(requestAdapter)

requestBody := msgraphsdk.NewPrinter()
name := "PrinterName"
requestBody.SetName(&name)
location := msgraphsdk.NewPrinterLocation()
requestBody.SetLocation(location)
latitude := float64(1.1)
location.SetLatitude(&latitude)
longitude := float64(2.2)
location.SetLongitude(&longitude)
altitudeInMeters := int32(3)
location.SetAltitudeInMeters(&altitudeInMeters)
printerId := "printer-id"
graphClient.Print().PrintersById(&printerId).Patch(requestBody)

重要

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。


Import-Module Microsoft.Graph.Devices.CloudPrint

$params = @{
    Name = "PrinterName"
    Location = @{
        Latitude = 1.1
        Longitude = 2.2
        AltitudeInMeters = 3
    }
}

Update-MgPrintPrinter -PrinterId $printerId -BodyParameter $params

重要

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。

响应

下面展示了示例响应。

注意： 为了提高可读性，可能缩短了此处显示的响应对象。

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

更新打印机

权限

HTTP 请求

请求标头

请求正文

委派的权限和 JSON 有效负载

应用程序权限和 JSON 有效负载

应用程序权限和 IPP 有效负载

响应

委派的权限和 JSON 有效负载

应用程序权限和 JSON 有效负载

应用程序权限和 IPP 有效负载

示例

请求

响应

反馈