为备份响应添加 user_id 属性¶

https://blueprints.launchpad.net/cinder/+spec/add-user-id-attribute-to-backup-response

此蓝图建议在带有详细信息的备份列表和显示备份详细信息 API 的响应体中添加 user_id 属性。

问题描述¶

目前，backups 表中存在一个 user_id 字段。这些字段对于管理员管理备份文件非常有用，但未在响应体中返回。因此，很难管理项目下的资源。如果一个项目下有多个用户，就无法区分备份文件属于哪个用户。

用例¶

在大型环境中，系统中创建了大量的备份资源，我们只能看到备份文件所属的项目，但无法知道备份属于哪个用户。

管理员希望能够识别创建备份的用户。

提议的变更¶

此规范建议在带有详细信息的备份列表和显示备份详细信息 API 的响应体中添加 user_id 属性。

添加一个新的微版本 API，以在带有详细信息的备份列表和显示备份详细信息 API 的响应体中添加 user_id 属性

列出带有详细信息的备份 GET /v3/{project_id}/backups/detail
显示备份详细信息 GET /v3/{project_id}/backups/{backup_id}

备选方案¶

管理员/用户可以从上下文中获取 user_id 作为日志打印，但很难轻松找到它，尤其是在用户想要查找非常旧的备份文件时。

REST API 影响¶

在 Cinder API 中添加一个新的微版本。

列出带有详细信息的备份

GET /v3/{project_id}/backups/detail
Response BODY:
{
    "backups": [{
        ...
        "user_id": "515ba0dd59f84f25a6a084a45d8d93b2"
    }]
}

显示备份详细信息

GET /v3/{project_id}/backups/{backup_id}
Response BODY:
{
    "backups": [{
        ...
        "user_id": "515ba0dd59f84f25a6a084a45d8d93b2"
    }]
}

调用此方法会显示卷备份的 user_id。它旨在供管理员使用，用于显示备份文件所属的用户，并由 BACKUP_ATTRIBUTES_POLICY 控制。

数据模型影响¶

无

安全影响¶

无

通知影响¶

无

其他最终用户影响¶

无

性能影响¶

无

其他部署者影响¶

无

开发人员影响¶

无

实现¶

负责人¶

主要负责人: Brin Zhang <zhangbailin@inspur.com>

工作项¶

添加一个新的微版本。
为带有详细信息的备份列表和显示备份详细信息 API 的响应体添加 user_id。
添加相关的单元测试。
更新相关的带有详细信息的备份列表和显示详细信息 api 文档。

依赖项¶

无

测试¶

应实现单元测试、tempest 和其他相关测试

文档影响¶

无

参考资料¶

无

为备份响应添加 user_id 属性