搜索 <book_title>...

Veritas NetBackup™ 版本说明

Last Published: 2021-07-28

Product(s): NetBackup (9.1)

NetBackup 9.1 中包含的 RESTful API

NetBackup 9.1 包括更新和新增的 RESTful 应用程序编程接口 (API)。这些 API 提供了一个基于 Web 服务的界面，可用于在您的环境中配置和管理 NetBackup。

可以在以下位置找到 NetBackup API 相关文档：

在主服务器上
API 存储在主服务器上的 YAML 文件中：
https://<primary_server>/api-docs/index.html
API 以 Swagger 格式记录。此格式支持通过实际调用 API 查看代码和测试功能。您必须具有访问主服务器和 API 的适当安全权限才能使用 Swagger API。
小心:
Veritas 建议您仅在开发环境中测试 API。由于您可以从 Swagger 文件进行实际的 API 调用，因此不应在生产环境中测试 API。
在 SORT 上
SORT 上也提供了 NetBackup API 文档：
主页 > 知识库 > 文档 > 产品版本 > 9.1
在“API 参考”下进行查看。“入门”文档提供了有关使用 NetBackup API 的背景信息。还提供了 API YAML 文件供您参考，但是这些文件不能发挥作用。无法从 SORT 上的文档测试 API。

关于作业的访问控制

已增加多个当前版本的作业 API，基于工作负载资产的访问控制更加细化。仍可以对作业的访问进行全局配置，以使用“|MANAGE|JOBS|”命名空间向所有作业授予操作。现在，对作业的访问可以限制在特定工作负载范围内，甚至是已针对其运行作业的特定资产范围内。对备份和还原作业的对象级别访问是根据创建了作业的资产的访问控制 ID（命名空间）强制执行的。

以前，更改作业状态的权限由单个更新操作控制。增加了特定于作业的其他操作，使管理员能够独立授予暂停、重新启动、继续和取消作业。

作业 API 的早期版本包含“基于启动器”访问控制概念，即无论管理员授予哪种操作，启动备份作业的用户都具有该作业的完全权限。在此版本中，删除了基于启动器的访问，取而代之的是基于资产的对象级访问控制。

新 API

NetBackup 9.1 包括以下新增 API 和增强的 API：

无代理主机：管理无代理主机。
iSCSI 设置：管理 AHV 工作负载的全局 iSCSI 设置。
策略：支持 VMware 策略类型和新快照配置验证。
SAML 证书：管理基于单点登录的身份验证的 SAML 证书。
SLP：更新并检查存储生命周期策略 (SLP) 冲突。
SLP 设置：管理全局存储生命周期策略 (SLP) 设置。
SLP 时段：管理存储生命周期策略 (SLP) 时段。
快照管理服务器扩展：管理向 CloudPoint 服务器注册的扩展。
快照提供程序 - Azure 域：检索有关已配置的 Azure 域的信息。
恢复
- 云：云资产恢复的恢复前检查。
- Nutanix AHV：完全 AHV VM 恢复。使用 NetBackup 客户端和无代理进行单个文件和文件夹恢复。
- Oracle：完整 Oracle 数据库恢复。
- 物理：从物理系统进行粒度文件和文件夹恢复。
- VMware：即时同步 VM 恢复。
用户证书登录：允许使用 X.509 证书进行客户端证书身份验证。
GET /catalog/image-contents
现有 API 已得到增强，可以支持请求标头“X-NetBackup-All-Copies”。此标头为布尔值，指示它应返回日期范围内每个路径的所有备份，而不是仅返回最新备份。

受版本控制的 API

作业

已从 V6.0 的作业详细信息响应中删除以下属性：

initiatorId

已将以下属性添加到 V6.0 的作业详细信息响应中：

属性	类型
dteMode	字符串
dedupSpaceRatio	浮点
compressionSpaceRatio	浮点
workloadDisplayName	字符串

对作业 API 的其他更改包括：

GET:/admin/jobs
已为列表作业 API 实现基于光标的新分页策略。
RBAC 强制已扩展，进而包括基于工作负载资产的对象级强制。
已引入一个新操作 |OPERATIONS|MANAGE|JOBS|VIEW|，用于授予对基于资产的作业的查看权限。这样，管理员便可独立于运行了作业的资产委派对作业的访问权限。
已删除基于启动器的强制。对象级别的强制支持已使基于启动器的强制变得冗余。
```
GET:/admin/jobs/{jobId}
GET:/admin/jobs/{jobId}/progress-logs
GET:/admin/jobs/{jobId}/try-logs
GET:/admin/jobs/{jobId}/try-logs/{attempt}
GET:/admin/jobs/{jobId}/file-lists
```
RBAC 强制已扩展，进而包括基于工作负载资产的对象级强制。
已引入一个新操作 |OPERATIONS|MANAGE|JOBS|VIEW|，用于区分查看作业以及运行了作业的资产的能力。
已删除基于启动器的强制。对象级别的强制支持已使基于启动器的强制变得冗余。
```
GET:/admin/jobs/{jobId}/cancel
GET:/admin/jobs/{jobId}/suspend
GET:/admin/jobs/{jobId}/resume
GET:/admin/jobs/{jobId}/restart
```
RBAC 强制已扩展，进而包括基于工作负载资产的对象级强制。
现在，可以在 API 级别和对象级别单独授予取消、暂停、继续和重新启动作业的能力。
已删除基于启动器的强制。对象级别的强制支持已使基于启动器的强制变得冗余。