DescribePeripheralDrivers - 查询外设驱动列表

多个筛选条件同时传入时，返回同时满足这些条件的驱动。不传筛选条件时，查询无影官方与当前账号的驱动。使用 PageSize 和 PageNumber 分页；保持筛选条件和 PageSize 不变，逐页增加 PageNumber，返回空列表时停止。示例值用于说明格式，请替换为实际值。

请求示例

以下 JSON 展示逻辑请求参数。公共签名参数由 SDK 或签名组件生成。

查询官方打印机驱动

查询指定品牌下包含关键词的官方打印机驱动，返回第 1 页，每页最多 20 条。

{
  "Action": "DescribePeripheralDrivers",
  "Version": "2020-09-30",
  "OwnerType": "WUYING",
  "Brand": "hp",
  "DeviceType": "printer",
  "Filter": "LaserJet",
  "PageSize": 20,
  "PageNumber": 1
}

按驱动 ID 批量查询

{
  "Action": "DescribePeripheralDrivers",
  "Version": "2020-09-30",
  "DriverIds": [
    "11111111-2222-4333-8444-555555555555",
    "66666666-7777-4888-8999-000000000000"
  ],
  "PageSize": 20,
  "PageNumber": 1
}

直接构造请求参数时，DriverIds 按序号展开：

DriverIds.1=11111111-2222-4333-8444-555555555555
DriverIds.2=66666666-7777-4888-8999-000000000000

使用 SDK 时传入字符串数组，由 SDK 完成编码。

响应示例

以下响应为格式示例，图标 URL 为示意地址。保留字段 MaxResults 和 NextToken 未提供有效值，示例中省略。

查询成功

{
  "RequestId": "00000000-1111-4222-8333-444444444444",
  "Count": 1,
  "DriverInfos": [
    {
      "Id": "11111111-2222-4333-8444-555555555555",
      "Icon": "https://example.com/icons/printer.png",
      "Name": "HP Universal Printing PCL 6",
      "Brand": "hp",
      "DeviceType": "printer",
      "OsType": "Windows",
      "CreateTime": "2026-09-01T10:30:00+08:00",
      "Source": "Wuying",
      "OwnerType": "WUYING"
    }
  ]
}

无匹配结果

{
  "RequestId": "00000000-1111-4222-8333-444444444444",
  "Count": 0,
  "DriverInfos": []
}