# 星图子账号数据权限管理

本文介绍主账号如何为子账号配置数据权限，控制子账号在星图各功能页面中可以查看和操作的数据范围。

已具备项目权限的子账号，默认仍可查看项目下全部 API Key 及其关联数据，无需重新授权。仅在需要限制子账号的数据范围，或需要使用"共享 API Key"功能时，按本文配置。

# 适用范围

星图的数据权限以 API Key 为粒度，作用于以下三个页面：

| **页面** | **受数据权限控制的内容**                          |
|----------|---------------------------------------------------|
| 密钥管理 | API Key 列表、API Key 详情、共享关系                |
| 模型日志 | 各 API Key 产生的调用日志、日志分析任务            |
| 模型监控 | 各 API Key 产生的调用量、Token、时延、缓存等监控指标 |

每个页面的数据权限由各自的接口单独控制。本文提供的策略模板已包含三个页面的全部接口，直接使用模板时，子账号在密钥管理中能看到哪些 API Key，模型日志、模型监控就展示这些 API Key 产生的数据。

如需自定义策略，请按《“全部”与“我的”数据权限接口对照表》为每个页面分别配置接口，并保持各页面的数据范围一致。

>  页面能否进入由**页面访问权限（链接）** 控制，与本数据权限分别配置、共同生效。子账号需要同时具备页面的访问权限和数据权限，才能查看对应数据。

# 数据权限说明

### "全部"与"我的"

密钥管理页面按数据范围分为"全部"和"我的"两个视图：

- **全部**：当前项目下的全部 API Key。
- **我的**：当前项目下，当前账号创建的 API Key，及其他账号共享给当前账号的 API Key。

![image](https://cdnv2-cache.udelivrs.com/2026/11/97897a015ade887aa1a31bcd38451866_1794986966832.png)

主账号可按下表为子账号配置数据权限：

| **配置目标**                     | **密钥管理可见范围**  | **可执行操作**                                                     |
|----------------------------------|-----------------------|--------------------------------------------------------------------|
| 管理项目下全部 API Key           | "全部"和"我的"        | 创建、编辑、删除项目内任意 API Key，共享并管理共享关系                |
| 仅管理本人创建及被共享的 API Key | 仅"我的"，不展示"全部" | 本人创建的 API Key 可创建、编辑、删除、共享；被共享的 API Key 仅可查看 |

### API Key 共享

- API Key 可共享给**同一项目内**的子账号。
- 被共享者可查看该 API Key 及其在模型日志、模型监控、消费中心产生的数据，不可编辑、删除或再次共享。
-  存量 API Key 统一归属主账号，创建人显示为“root”，主账号可将存量 Key 共享给子账号，使其可见（API key不明文显示）。新版本上线后新增的 API Key 将记录实际创建人。

![image](https://cdnv2-cache.udelivrs.com/2026/11/6d55cb73b9611c1e6eb408a93024b527_1794986968004.png)

![image](https://cdnv2-cache.udelivrs.com/2026/11/6e5794a1ebeb83b92436d6e2117da3b0_1794986965866.png)

# 操作指南

各场景的接口含义详见 **《"全部"与"我的"数据权限接口对照表》（链接）**。


## 通用步骤：创建共享对象查询策略（全局级）

以下三个场景中， 若需使用"共享 API Key"功能，都必须先创建该策略。共享弹窗需要列出同项目子账号，依赖 `iam:ListUsers` 等接口；**缺少该策略时，共享弹窗无法列出可选择的子账号。**

1. 进入 **访问控制 > 策略管理**，点击 **创建自定义策略**。
2. 策略名称填写 `Astraflow-APIKey-ShareUserList`，策略描述填写"共享 API Key 时可选择同项目子账号"。
3. 策略级别选择 **全局级**，编辑方式选择 **脚本编辑**，粘贴以下脚本并保存。

```plain
{
  "Version": "1",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "label:ListLabelsByResourceIds"
      ],
      "Resource": [
        "*"
      ],
      "Condition": {}
    },
    {
      "Effect": "Allow",
      "Action": [
        "iam:ListUsers",
        "iam:ListEntitiesForProject"
      ],
      "Resource": [
        "*"
      ],
      "Condition": {}
    }
  ]
}
```
 
> **全局策略影响范围**： Astraflow 与 UCloud 共用账号及访问控制体系。全局级策略在整个 UCloud 主账号范围内生效，不区分项目；其中 `iam:ListUsers` 、`label:ListLabelsByResourceIds`  等接口授权，可能同时适用于其他调用相同接口的 UCloud 产品。授权前请确认影响范围，仅向确有共享需求的子账号授予。该策略本身不授予查看其他子账号 API Key 的权限。

## 场景A：仅授予 API Key 共享权限

### 创建项目级策略

1. 在星图控制台右上角账号菜单中，点击 **账号与权限管理**。

![image](https://cdnv2-cache.udelivrs.com/2026/11/fd8c60929e7248073f0a2e4db61d7615_1794986967654.png)

2. 进入 **访问控制 > 策略管理**，点击 **创建自定义策略**。

![image](https://cdnv2-cache.udelivrs.com/2026/11/14a2f1287e088cdc6e1aae9055ba8e59_1794986967205.png)

3. 填写策略名称与描述。建议命名及描述如下： Astraflow-APIKey-ShareProjectKey，策略描述： 子账号可将当前项目 API Key 共享给同项目子账号
4. 策略级别选择 **项目级**，编辑方式选择 **脚本编辑**，粘贴以下脚本并保存。

```plain
{
  "Version": "1",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "uai_modelverse:AddUMInferAPIKeyShareUsersProject",
        "uai_modelverse:DeleteUMInferAPIKeyShareUsersProject",
        "uai_modelverse:ListUMInferAPIKeyShareUsersProject"
      ],
      "Resource": [
        "*"
      ],
      "Condition": {}
    }
  ]
}
```
 
### 绑定子账号

1. 进入 **访问控制 > 用户管理**，在目标子账号的操作列点击 **添加权限**。
2. 同时选择 `Astraflow-APIKey-ShareProjectKey` 与 `Astraflow-APIKey-ShareUserList`。
3. 为项目级策略选择 **指定项目** 后保存。

## 场景 B：子账号管理项目下全部 API Key

**适用场景**：子账号需要管理项目内所有 API Key，并查看全部 API Key 在模型日志、模型监控产生的数据。

### 权限效果

配置完成后，子账号在目标项目中：

- 密钥管理页面展示"全部"和"我的"两个视图。
- 可查看项目下全部 API Key，可创建、批量创建、编辑、批量更新、删除项目内任意 API Key。
- 可将 API Key 共享给同项目子账号，也可管理共享关系。
- 模型日志、模型监控展示项目下全部 API Key 产生的数据。

### 配置步骤

#### （一）创建项目级策略

1. 在星图控制台右上角账号菜单中，点击 **账号与权限管理**。
2. 进入 **访问控制 > 策略管理，**点击 **创建自定义策略**。
3. 填写策略名称与描述。建议命名及描述如下： Astraflow-`APIKey-ProjectFullAccess`，策略描述：子账号可管理项目下全部 API Key
4. 策略级别选择 **项目级，**编辑方式选择 **脚本编辑**。
5. 粘贴脚本后保存。

```plain
{
  "Version": "1",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "uai_modelverse:AddUMInferAPIKeyShareUsers",
        "uai_modelverse:AddUMInferAPIKeyShareUsersProject",
        "uai_modelverse:BatchCreateUMInferAPIKey",
        "uai_modelverse:BatchUpdateUMInferAPIKey",
        "uai_modelverse:BatchUpdateUMInferUserAPIKey",
        "uai_modelverse:CancelLogAnalysisJob",
        "uai_modelverse:CancelUMInferExportTask",
        "uai_modelverse:CancelUMInferUserExportTask",
        "uai_modelverse:CancelUserLogAnalysisJob",
        "uai_modelverse:CheckLogAnalysisLogCount",
        "uai_modelverse:CheckUMInferAPIKeyQuotaAlertContact",
        "uai_modelverse:CheckUserLogAnalysisLogCount",
        "uai_modelverse:CreateLogAnalysisJob",
        "uai_modelverse:CreateUMInferAPIKey",
        "uai_modelverse:CreateUserLogAnalysisJob",
        "uai_modelverse:DeleteUMInferAPIKey",
        "uai_modelverse:DeleteUMInferAPIKeyShareUsers",
        "uai_modelverse:DeleteUMInferAPIKeyShareUsersProject",
        "uai_modelverse:DownloadUMInferExportTask",
        "uai_modelverse:DownloadUMInferUserExportTask",
        "uai_modelverse:GetLogAnalysisJob",
        "uai_modelverse:GetLogAnalysisReport",
        "uai_modelverse:GetUMInferAPIKeyPlaintext",
        "uai_modelverse:GetUMInferLog",
        "uai_modelverse:GetUMInferLogPermissionStatus",
        "uai_modelverse:GetUMInferPlaintext",
        "uai_modelverse:GetUMInferRequestLogDetail",
        "uai_modelverse:GetUMInferUserLog",
        "uai_modelverse:GetUMInferUserRequestLogDetail",
        "uai_modelverse:GetUMMonitorBasicMetrics",
        "uai_modelverse:GetUMMonitorCacheMetrics",
        "uai_modelverse:GetUMMonitorLatencyMetrics",
        "uai_modelverse:GetUMMonitorModelMetrics",
        "uai_modelverse:GetUMMonitorThroughputMetrics",
        "uai_modelverse:GetUMMonitorTokenMetrics",
        "uai_modelverse:GetUMMonitorUserBasicMetrics",
        "uai_modelverse:GetUMMonitorUserCacheMetrics",
        "uai_modelverse:GetUMMonitorUserLatencyMetrics",
        "uai_modelverse:GetUMMonitorUserModelMetrics",
        "uai_modelverse:GetUMMonitorUserThroughputMetrics",
        "uai_modelverse:GetUMMonitorUserTokenMetrics",
        "uai_modelverse:GetUserLogAnalysisJob",
        "uai_modelverse:GetUserLogAnalysisReport",
        "uai_modelverse:ListLogAnalysisJobs",
        "uai_modelverse:ListUMInferAPIKey",
        "uai_modelverse:ListUMInferAPIKeyShareUsers",
        "uai_modelverse:ListUMInferAPIKeyShareUsersProject",
        "uai_modelverse:ListUMInferAPIKeyTags",
        "uai_modelverse:ListUMInferAPIKeyV2",
        "uai_modelverse:ListUMInferExportTasks",
        "uai_modelverse:ListUMInferExportUserTasks",
        "uai_modelverse:ListUMInferRequestLogModels",
        "uai_modelverse:ListUMInferRequestLogs",
        "uai_modelverse:ListUMInferUserRequestLogModels",
        "uai_modelverse:ListUMInferUserRequestLogs",
        "uai_modelverse:ListUMInferUserShareAPIKey",
        "uai_modelverse:ListUserLogAnalysisJobs",
        "uai_modelverse:RemoveUMInferApikeys",
        "uai_modelverse:RemoveUMInferUserAPIKeys",
        "uai_modelverse:RestartLogAnalysisJob",
        "uai_modelverse:RestartUMInferExportTask",
        "uai_modelverse:RestartUMInferUserExportTask",
        "uai_modelverse:RestartUserLogAnalysisJob",
        "uai_modelverse:SendUMInferAPIKeyQuotaAlertVerifyCode",
        "uai_modelverse:UpdateUMInferAPIKey",
        "uai_modelverse:UpdateUMInferExportTaskTime",
        "uai_modelverse:UpdateUMInferUserExportTaskTime"
      ],
      "Resource": [
        "*"
      ],
      "Condition": {}
    }
  ]
}
```
 
###  为子账号绑定策略

1. 进入 **访问控制 > 用户管理**，在目标子账号的操作列点击 **添加权限**。
2. 同时选择已创建的项目级策略Astraflow`-APIKey-ProjectFullAccess`；如需使用共享功能，再选择 Astraflow`-APIKey-ShareUserList`。
3. 为项目级策略选择**指定项目**并保存。仅在确认需要覆盖现有及未来全部项目时，才选择“全部项目”。

>  注意： 本策略只覆盖密钥管理、模型日志、模型监控三个页面的数据权限。如需赋予子账号其他星图功能权限，需另行配置对应策略。

## 场景 C：子账号仅管理本人创建及被共享的 API Key

**适用场景**：子账号只应看到自己创建的 API Key 以及其他账号共享给它的 API Key，不应看到项目下其他 API Key 及其数据。

### 权限效果

配置完成后，子账号在目标项目中：

- 密钥管理页面仅展示"我的"视图，不展示"全部"。
- 列表包含本人创建的 API Key 和被共享给本人的 API Key。
- 对本人创建的 API Key：可查看、创建、编辑、删除、共享。
- 对被共享的 API Key：可查看及其在模型日志、模型监控、消费中心产生的数据；不可编辑、删除或再次共享。
- 模型日志、模型监控仅展示本人创建及被共享的 API Key 产生的数据。
- 不可查看项目内未共享给自己的其他 API Key 及其数据。

### 创建项目级策略

1. 在星图控制台右上角账号菜单中，点击 **账号与权限管理**。
2. 进入 **访问控制 > 策略管理，**点击 **创建自定义策略**。
3. 填写策略名称与描述，建议命名及描述如下： Astraflow`-APIKey-OwnAndShared`，策略描述：子账号仅可管理本人创建及被共享的 API Key
4. 策略级别选择 **项目级，**编辑方式选择 **脚本编辑**。
5. 粘贴脚本并保存

```plain
{
  "Version": "1",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "uai_modelverse:CreateUMInferAPIKey",
        "uai_modelverse:BatchCreateUMInferAPIKey",
        "uai_modelverse:SendUMInferAPIKeyQuotaAlertVerifyCode",
        "uai_modelverse:AddUMInferAPIKeyShareUsers",
        "uai_modelverse:RemoveUMInferUserAPIKeys",
        "uai_modelverse:DeleteUMInferAPIKeyShareUsers",
        "uai_modelverse:BatchUpdateUMInferUserAPIKey",
        "uai_modelverse:CheckUMInferAPIKeyQuotaAlertContact",
        "uai_modelverse:ListUMInferAPIKeyTags",
        "uai_modelverse:GetUMInferAPIKeyPlaintext",
        "uai_modelverse:GetUMInferPlaintext",
        "uai_modelverse:ListUMInferUserShareAPIKey",
        "uai_modelverse:ListUMInferAPIKeyShareUsers",
        "uai_modelverse:GetUMInferLogPermissionStatus",
        "uai_modelverse:ListUMInferUserRequestLogs",
        "uai_modelverse:GetUMInferUserRequestLogDetail",
        "uai_modelverse:ListUMInferUserRequestLogModels",
        "uai_modelverse:GetUMInferUserLog",
        "uai_modelverse:ListUMInferExportUserTasks",
        "uai_modelverse:DownloadUMInferUserExportTask",
        "uai_modelverse:CreateUserLogAnalysisJob",
        "uai_modelverse:CheckUserLogAnalysisLogCount",
        "uai_modelverse:GetUserLogAnalysisJob",
        "uai_modelverse:ListUserLogAnalysisJobs",
        "uai_modelverse:CancelUserLogAnalysisJob",
        "uai_modelverse:RestartUserLogAnalysisJob",
        "uai_modelverse:GetUserLogAnalysisReport",
        "uai_modelverse:GetUMMonitorUserBasicMetrics",
        "uai_modelverse:GetUMMonitorUserTokenMetrics",
        "uai_modelverse:GetUMMonitorUserThroughputMetrics",
        "uai_modelverse:GetUMMonitorUserLatencyMetrics",
        "uai_modelverse:GetUMMonitorUserCacheMetrics",
        "uai_modelverse:GetUMMonitorUserModelMetrics",
        "uai_modelverse:CancelUMInferUserExportTask",
        "uai_modelverse:RestartUMInferUserExportTask",
        "uai_modelverse:UpdateUMInferUserExportTaskTime"

      ],
      "Resource": [
        "*"
      ],
      "Condition": {}
    },    
    {
      "Effect": "Deny",
      "Action": [
        "uai_modelverse:AddUMInferAPIKeyShareUsersProject",
        "uai_modelverse:RemoveUMInferApikeys",
        "uai_modelverse:DeleteUMInferAPIKey",
        "uai_modelverse:DeleteUMInferAPIKeyShareUsersProject",
        "uai_modelverse:BatchUpdateUMInferAPIKey",
        "uai_modelverse:UpdateUMInferAPIKey",
        "uai_modelverse:ListUMInferAPIKeyShareUsersProject",
        "uai_modelverse:ListUMInferAPIKeyV2",
        "uai_modelverse:ListUMInferAPIKey",
        "uai_modelverse:ListUMInferRequestLogs",
        "uai_modelverse:GetUMInferRequestLogDetail",
        "uai_modelverse:ListUMInferRequestLogModels",
        "uai_modelverse:GetUMInferLog",
        "uai_modelverse:ListUMInferExportTasks",
        "uai_modelverse:DownloadUMInferExportTask",
        "uai_modelverse:CreateLogAnalysisJob",
        "uai_modelverse:CheckLogAnalysisLogCount",
        "uai_modelverse:GetLogAnalysisJob",
        "uai_modelverse:ListLogAnalysisJobs",
        "uai_modelverse:CancelLogAnalysisJob",
        "uai_modelverse:RestartLogAnalysisJob",
        "uai_modelverse:GetLogAnalysisReport",
        "uai_modelverse:GetUMMonitorBasicMetrics",
        "uai_modelverse:GetUMMonitorTokenMetrics",
        "uai_modelverse:GetUMMonitorThroughputMetrics",
        "uai_modelverse:GetUMMonitorLatencyMetrics",
        "uai_modelverse:GetUMMonitorCacheMetrics",
        "uai_modelverse:GetUMMonitorModelMetrics",
        "uai_modelverse:CancelUMInferExportTask",
        "uai_modelverse:RestartUMInferExportTask",
        "uai_modelverse:UpdateUMInferExportTaskTime"
      ],
      "Resource": [
        "*"
      ],
      "Condition": {}
    }
  ]
}
```
 
### 为子账号绑定策略

1. 进入 **访问控制 > 用户管理**，在目标子账号的操作列点击 **添加权限**。
2. 同时选择已创建的项目级策略 Astraflow`-APIKey-OwnAndShared`；如需使用共享功能，再选择 Astraflow`-APIKey-ShareUserList`。
3. 为项目级策略选择**指定项目**并保存。仅在确认需要覆盖现有及未来全部项目时，才选择“全部项目”。

 注意： 本策略只覆盖密钥管理、模型日志、模型监控三个页面的数据权限。如需赋予子账号其他星图功能权限，需另行配置对应策略。

# 常见问题

1. 配置后子账号仍提示“暂无访问权限”？

优先检查该子账号是否已具备对应页面的访问权限（菜单权限）。数据权限控制查看哪些数据，页面访问权限控制能否进入页面，两者都具备才能正常使用。

2. 配置场景 C 后仍能看到“全部”页签？

请检查该子账号是否还绑定了其他包含项目全量查询权限的策略。如有，请先调整原有授权，或将本策略与其冲突的策略解绑。

3. 子账号为什么看不到别人共享给自己的 Key？

请依次检查：

- 共享方是否已将该 Key 共享给该子账号。
- 双方是否在**同一项目**内。
- 被共享者是否已配置项目级策略 `ModelVerse-APIKey-OwnAndShared`。
- 被共享者是否具备对应页面菜单权限。

4. 模型日志、模型监控、消费中心是否需要单独配置数据权限？

取决于配置方式：

- **直接使用本文模板**：无需单独配置。场景二、场景三的模板已包含模型日志、模型监控、消费中心的相关接口。
- **自定义策略**：需要单独配置。每个页面的“全部”与“我的”数据由不同接口控制，未授权的页面将无法查看数据。请参照《“全部”与“我的”数据权限接口对照表》逐一添加。

 自定义时，建议各页面使用相同的数据范围。例如，密钥管理仅授权“我的”接口，而模型日志授权了“全部”接口，子账号就能在模型日志中看到项目下全部 API Key 的调用数据。

5. 全局级策略是否会让子账号看到其他子账号的 Key？

不会。该全局策略用于开放选择子账号所需的接口；API Key 数据仍由项目级策略与共享关系共同决定

5. 是否需要为被共享者单独配置策略？

需要。被共享者至少要能进入密钥管理页面，并配置项目级策略，才能在“我的”中稳定查看被共享 Key 及其关联数据。
