跳到主要内容
联系支持

这篇文章是给谁看的?

Incydr专业，企业，地平线和政府F2
Incydr基础，高级，和政府F1

的Code42控制台中找到您的产品计划帐户菜单．

老师,不。

Incydr Professional, Enterprise, Horizon和Gov F2，没有。

Incydr基础，高级和Gov F1，是的。

首页
开始
发布说明
常见问题
api
系统状态
Code42支持

使用Code42 API查看设备备份状态

  1. 最后一次更新
  2. 另存为PDF

这篇文章是给谁看的?

Incydr专业，企业，地平线和政府F2
Incydr基础，高级，和政府F1

的Code42控制台中找到您的产品计划帐户菜单．

老师,不。

Incydr Professional, Enterprise, Horizon和Gov F2，没有。

Incydr基础，高级和Gov F1，是的。

概述

的Code42 APIDeviceBackupReportresource有效地检索您在Code42环境中解决常见问题和回答有关用户和设备的常见问题所需的数据。DeviceBackupReport类的单独调用提供集中式报告和更好的性能用户，电脑,目的地资源。

Code42开发者门户
看到Code42开发者门户获取更多API文档和资源。门户提供:

尽可能多地使用Code42开发者门户来满足您的API需求。门户中的api是Incydr用户与Code42集成的首选方式。如果您使用的Code42 api没有出现在Code42开发者门户上，联系我们的技术支持工程师以获得与Code42集成的最佳方式的指导。

DeviceBackupReport资源的功能

DeviceBackupReport提供关于Code42环境中的用户和设备的信息，例如:

  • 备份状态
  • 磁盘使用情况
  • 冷藏状态
  • 连接状态和警报
  • 组织以及目的地详细信息
  • 用户信息
  • 操作系统类型
  • 网络信息

注意事项

的DeviceBackupReport资源无法修改Code42环境，它能提供的结果是受用户角色限制．

请至少指定一个查询参数
在非常大的Code42环境(100,000+设备)中，发送请求到DeviceBackupReport资源而不指定至少一个参数值对会给Code42云带来异常沉重的负载，并可能导致明显的性能延迟。尽可能指定查询参数和值。

在开始之前

在你尝试使用之前DeviceBackupReport，熟悉基本知识。

使用细节

使用Code42 API文档查看器要了解以下几个方面DeviceBackupReport：

  • 查询参数
  • 输出值
  • 示例使用

部分字符串匹配和灵活的搜索

您可以使用部分字符串匹配来搜索用户、组织、设备、目的地和操作系统。针对每个实体的多个源字段执行搜索。例如，您可以根据用户的姓氏、用户名、电子邮件或名称搜索用户userExtRef字段。

有关灵活搜索使用哪些字段的完整说明，请参见DeviceBackupReportCode42 API文档查看器中的条目。

输出格式

DeviceBackupReport提供了JSON-格式的输出，但您也可以获取输出CSV使用查询参数格式化= csv导出．

  • 导出为CSV格式时返回所有记录。
  • 以CSV格式导出时不使用分页，即使pgSize指定查询参数。
  • CSV格式是理想的DeviceBackupReport资源不提供所需的排序、分组或筛选。只需在电子表格中打开CSV文件，并应用所需的排序和分组选项。

排序和分页

在使用srtKey查询参数时，分页仅限于第一页。

示例用例

下面的例子展示了如何使用DeviceBackupReport来管理Code42环境。

用例1:备份状态报告

此备份状态报告标识了哪些设备长时间没有备份。

示例请求

此请求显示活动设备的设备备份状态，按它们最后连接到Code42云的时间排序:

复制! 
https://console.us.code42.com/api/DeviceBackupReport?srtKey=lastConnectedDate&active=true

解读结果

系统默认的排序方向为升序，所以排在前面的设备是长时间没有连接的设备。的backupCompletePercentage数据可以帮助您识别设备上的数据是否已经部分或全部备份成功。

使用这些信息，您可以调查长时间未连接的用户设备。一些可能的原因:

  • 用户正在休假或休假。
  • 远程用户的路由器或防火墙阻止连接。
  • 设备上已禁用Code42服务。
  • 用户卸载Code42应用程序。

用例2:磁盘使用率

该磁盘使用情况报告标识了消耗最多存储空间的用户。

示例请求

这个请求显示了按其存档大小排序的设备:

复制! 
https://console.us.code42.com/api/DeviceBackupReport?srtKey=archiveBytes&srtDir=desc

解读结果

具有最大存档的设备首先列出，突出显示了在Code42环境中占用最多磁盘空间的用户和设备。然后可以检查文件除外，版本的设置，及其他设备备份设置对于这些用户。

选择请求

或者，您可能希望根据选择用于备份的文件和文件夹的总大小对输出进行排序，而不是根据Code42环境存储的归档文件的大小:

复制! 
https://console.us.code42.com/api/DeviceBackupReport?srtKey=selectedBytes&srtDir=desc

用例3:设备迁移计划

DeviceBackupReport可以识别组织中特定操作系统上的设备，以及需要将多少数据迁移到替换设备上。

示例请求

这个请求显示了名为“Accounting”的组织中的所有Mac设备:

复制! 
https://console.us.code42.com/api/DeviceBackupReport?os=mac&org=Accounting&active=true&srtKey=selectedBytes&srtDir=desc

将此示例请求中的操作系统类型和组织名称替换为适合您的Code42环境的值。

解读结果

档案最多的Mac设备被列在前面，突出了可能需要更长的迁移时间。

用例4:清除冷库以释放空间

定位档案，可以从冷库中清洗，DeviceBackupReport显示冷存储中具有存档的所有设备，以及设备上次连接的日期。

清除档案
这只是一个例子。在从冷存储中清除任何存档之前，请确认不再需要这些存档。根据公司的数据保留政策，档案可能需要betway88help保留一段规定的时间。

示例请求

下面的请求生成一个CSV文件，其中包含所有设备的备份信息:

复制! 
https://console.us.code42.com/api/DeviceBackupReport?export=csv

解读结果

在本例中，数据可通过web浏览器下载。下载文件后，在电子表格中打开该文件，并根据输出值对结果进行排序coldStorage．的coldStorage输出值为布尔数据类型。

  • 真正的表示设备的存档处于冷存储中。
  • 假表示设备的存档不在冷存储中。

该报告包含Code42环境中所有设备的列表。通过过滤结果，只显示冷藏库中有存档的设备，并根据最近连接的日期对过滤后的列表进行排序，管理员可以确认不再需要存档，并确定是否需要存档清理档案腾出空间。

用例5:使用自定义元数据字段进行搜索

DeviceBackupReport还搜索引用字段，用以储存用户的描述资料(userExtRef)、设备(computerExtRef．deviceExtRef)和机构(orgExtRef）.

示例请求

用户查询参数灵活搜索用户名，电子邮件，userExtRef或姓。下面的请求为用户查找基于的所有设备userExtRef，例如存储在reference字段中的雇员ID号:

复制! 
https://console.us.code42.com/api/DeviceBackupReport?user=1001

betway365安全性和权限

只读的报告

的DeviceBackupReport资源不能更改Code42环境，因此使用它比提供相同数据的其他资源更安全。

角色和权限

的DeviceBackupReport资源可以由Code42环境中的任何用户使用，但它所能提供的结果受到分配给用户的权限的限制角色．例如:

  • 没有额外权限的标准桌面用户可以在自己的设备上获取信息，但不能在其他人的设备上获取信息。
  • 组织管理员可以获取他所管理的组织的所有设备的信息，但不能获取其他组织中的设备的信息。
  • 系统管理员可以获得Code42环境中任何用户的信息。