Veritas NetBackup™ 版本说明

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

• 在主服务器上

  API 存储在主服务器上的 YAML 文件中：

  https://<master_server>/api-docs/index.html

  API 以 Swagger 格式记录。此格式支持通过实际调用 API 查看代码和测试功能。您必须具有访问主服务器和 API 的适当安全权限才能使用 Swagger API。

  小心:

  Veritas 建议您仅在开发环境中测试 API。由于您可以从 Swagger 文件进行实际的 API 调用，因此不应在生产环境中测试 API。

• 在 SORT 上

  SORT 上也提供了 NetBackup API 文档：

  主页 > 知识库 > 文档 > 产品版本 > 8.3

  在“API 参考”下进行查看。“入门”文档提供了有关使用 NetBackup API 的背景信息。还提供了 API YAML 文件供您参考，但是这些文件不能发挥作用。无法从 SORT 上的文档测试 API。

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

• 访问控制：可用于访问 NetBackup 基于角色的访问控制配置。

• 资产服务：可用于访问 NetBackup 资产信息。

• 云存储桶：创建和列出 MSDP 存储服务器的云存储桶。

• 云文件与文件夹恢复：恢复云虚拟机中的单个文件和文件夹。

• 云恢复目标：列出可以将云资产恢复到的目标。

• 凭据管理：管理 NetBackup 使用的凭据。

• 数据分类：列出系统中定义的数据分类。

• 磁盘卷：更新磁盘卷。

• 磁盘卷复制目标：提供配置磁盘卷复制目标的功能。

• 事件日志：帮助深入了解 NetBackup 环境中的活动和问题。还允许使用事件日志消息和通知 API 自定义简易集成的通知。

• 主机：列出其证书等待续订的主机。

• 身份提供程序：使用 SAML 管理单点登录身份验证的身份提供程序配置。

• 密钥管理服务：提供对密钥管理服务配置的访问。

• 介质服务器：列出介质服务器。

• NetBackup 证书颁发机构：提供对 NetBackup 证书颁发机构配置的访问。

• 策略：创建现有策略的副本，并列出与策略关联的唯一客户端。

• 恢复点服务：查询基于工作负载备份的数据的信息。

• 安全域：使用 Veritas NetBackup Authentication Service (AT) 管理 AD/LDAP 域。

• 快照管理服务器：提供对快照管理服务器配置的访问。

• SQL Server 即时访问：提供对 SQL Server 备份的即时访问功能。

• SQL Server 还原：从单个恢复点或完整链还原 SQL Server。

• SSO 登录：使用单点登录 (SSO) 身份验证方法登录 NetBackup Web UI。

• 信任版本：基于 NetBackup 证书颁发机构迁移，列出信任版本。

• 可信主服务器：提供对可信主服务器配置的访问。

• 通用共享：管理 MSDP 存储服务器上的通用共享存储。

以下 API 已在 NetBackup 8.3 中弃用。

• 资产数据库：资产数据库 API 已被资产服务 API 取代。

• 基于角色的访问控制：/rbac 子上下文中的 API 已被 /access-control 子上下文中的 API 取代。使用 /rbac 子上下文中定义的 API 创建的任何 RBAC 配置数据现在都是只读的。此数据保持可用，以便使用在 /access-control 子上下文中找到的新 API 来创建类似的访问控制。

以下 API 已在 NetBackup 8.3 中进行版本控制。如果指定了正确的版本，则仍支持这些 API 的先前版本。

• GET /admin/jobs

  PolicyType 枚举已更新为 UPPERCASE_WITH_UNDERSCORES。

• GET /admin/jobs/{jobId}

  PolicyType 枚举已更新为 UPPERCASE_WITH_UNDERSCORES。

• POST /config/{workloadType}/access-hosts

  错误代码和响应已更改为 500“无法找到客户端主机名”，而不是在提供无效访问主机且无法验证时显示常规异常。

• GET /config/policies

  现在返回的信息不仅只是每个策略的名称，如果在没有分页参数的情况下调用，还会显示默认分页信息。

• POST /recovery/workloads/{workload}/scenarios/{scenarioType}/pre-recovery-check

  在恢复前检查中产生了 404。如果请求中提供了无效的 vmserver，则会返回此错误。

• GET /security/auditlogs

  现在支持分页、过滤和排序。现在，此 API 返回审核详细信息对象。

• GET /security/auditlogs/{auditId}

  现在，此 API 返回审核详细信息对象。

• GET /security/cacert

  现在返回最新的信任版本，以及需要在 NetBackup 主机的信任存储区中添加或删除的证书颁发机构的列表。

• GET /security/logindetails

  现在支持分页、过滤和排序。现在，此 API 返回审核登录详细信息对象。

• GET /security/logindetails/{auditId}

  现在，此 API 返回审核登录详细信息对象。

• GET /storage/disk-pools

  不再返回与云磁盘池大小相关的属性。将过滤器参数从不区分大小写更改为区分大小写。

• POST /storage/disk-pools

  不再接受 kmsKeyPassphrase（以前对于云磁盘池是必需的）。

• POST /storage/storage-servers

  从输入中删除了 KMS 属性。

• POST /storage/storage-servers/{storageServerId}/disk-volumes

  现在支持为 MSDP 存储服务器创建云磁盘卷。

• GET /storage/storage-units

  不再返回与云存储单元大小相关的属性。

• GET /storage/storage-units/{storageUnitName}

  不再返回与云存储单元大小相关的属性。

• PATCH /storage/storage-units/{storageUnitName}

  不再返回与云存储单元大小相关的属性。

• GET /storage/storage-units/{storageUnitName}/replication-relationships

  更新了响应中的资源类型。