如何删除Vault

删除 Vault 的操作指南

要删除一个 Vault（备份仓库），您需要调用 DeleteVault 接口。以下是详细的请求参数、接口定义以及响应结果的说明。

请求参数

在调用 DeleteVault 接口时，您需要提供以下参数：

注意：
- vaultId 是唯一标识一个 Vault 的关键参数，必须正确填写。 - 如果您不确定 Vault 的 ID，可以通过相关查询接口（如 ListVaults）获取。

接口定义

同步方法

/**
 * 删除 Vault 同步方法
 * @param deleteVaultRequest 删除 Vault 请求对象
 * @return OASResult 响应结果
 * @throws OASClientException 客户端异常
 * @throws OASServerException 服务端异常
 */
public OASResult deleteVault(DeleteVaultRequest deleteVaultRequest)
    throws OASClientException, OASServerException;

异步方法

/**
 * 删除 Vault 异步接口
 * @param deleteVaultRequest 删除 Vault 请求对象
 * @param handler 异步请求处理器
 * @return ListenableFuture 异步任务结果
 * @throws OASClientException 客户端异常
 * @throws OASServerException 服务端异常
 */
public ListenableFuture deleteVaultAsync(
    DeleteVaultRequest deleteVaultRequest, AsyncHandler handler)
    throws OASClientException, OASServerException;

说明： - 同步方法适用于需要立即获取结果的场景。 - 异步方法适用于对性能要求较高的场景，允许您通过回调处理结果。

响应结果

调用 DeleteVault 接口后，返回的结果遵循 OASResult 结构。以下是主要字段的说明：

正常返回示例：

{
  "Code": "200",
  "Message": "successful",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "Success": true
}

错误处理： - 如果返回的 Code 不为 200，则表示操作失败，您需要根据 Message 提供的信息进行排查。 - 您可以参考官方文档中的错误码列表以获取更多详细信息。

授权信息

在使用 DeleteVault 接口前，确保您的 RAM 用户或角色已具备相应的权限。以下是授权信息的说明：

重要提示： - 访问级别为 delete，表示该操作会永久删除指定的 Vault，请谨慎操作。 - 确保调用者具备 hbr:DeleteVault 的权限，否则请求将被拒绝。

注意事项

1. 数据不可恢复：删除 Vault 后，其内的所有备份数据将被永久清除，请务必确认不再需要这些数据后再执行操作。
2. 权限校验：调用此接口前，请确保已正确配置 RAM 权限，并验证调用者的身份。
3. 幂等性：如果需要保证请求的幂等性，可以在请求中添加 Token 参数（可选）。

通过以上步骤，您可以安全且高效地删除指定的 Vault。如有其他疑问，请参考相关文档或联系技术支持团队。