# 查询运行策略详情

```{raw} html
<div class="mo-api-page-show-toc" aria-hidden="true"></div>
```

读取一个运行策略配置的范围、准入条件、预算、重试和数据策略。

```text
GET https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/runtime-policy-profiles/{policy_id}
```

## 调用前准备

先[查询运行策略列表](list-runtime-policy-profiles.md)取得策略 ID。准备有目标工作区访问权限的个人访问令牌和目标工作区 ID。

## 请求示例

示例中的凭据和资源标识需替换为当前调用者的实际值。

```bash
curl "https://api.moi.matrixorigin.cn/v5/workspaces/$WORKSPACE_ID/runtime-policy-profiles/$POLICY_ID" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID"
```

<span id="请求参数"></span>

## 路径参数

| 参数 | 类型 | 是否必填 | 说明 |
| --- | --- | --- | --- |
| `workspace_id` | string | 是 | 当前工作区 ID。 |
| `policy_id` | string | 是 | 运行策略 ID。 |

## 成功响应

请求成功时返回 HTTP 200，响应如下。

```json
{
  "code": 0,
  "data": {
    "id": "policy_01",
    "workspace_id": "ws_01",
    "name": "默认运行限制",
    "status": "active",
    "scope_type": "workspace",
    "admission": {},
    "budgets": {
      "max_steps": 20
    },
    "retry": {},
    "version": 1,
    "created_at": "2026-08-21T07:00:00Z",
    "updated_at": "2026-08-21T07:00:00Z"
  }
}
```

响应字段如下。

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `data.id` | string | 运行策略 ID。 |
| `data.workspace_id` | string | 所属工作区 ID。 |
| `data.name` | string | 策略名称和说明；说明仅在有值时返回。 |
| `data.description` | string | 策略名称和说明；说明仅在有值时返回。 无值时可省略。 |
| `data.status` | string | 策略状态、作用域类型和引用；取值：`draft`、`active`、`disabled`、`archived`。 |
| `data.scope_type` | string | 策略状态、作用域类型和引用；取值：`workspace`、`role`、`agent`、`provider_profile`。 |
| `data.scope_ref` | string | 策略状态、作用域类型和引用。 无值时可省略。 |
| `data.admission` | object | 准入、预算和重试配置；仅在有值时返回。 无值时可省略。 |
| `data.budgets` | object | 准入、预算和重试配置；仅在有值时返回。 无值时可省略。 |
| `data.retry` | object | 准入、预算和重试配置；仅在有值时返回。 无值时可省略。 |
| `data.data_policy` | object | 数据、产物和提供商约束；仅在有值时返回。 无值时可省略。 |
| `data.artifact_policy` | object | 数据、产物和提供商约束；仅在有值时返回。 无值时可省略。 |
| `data.provider_constraints` | object | 数据、产物和提供商约束；仅在有值时返回。 无值时可省略。 |
| `data.version` | integer | 策略版本。 |
| `data.labels` | object | 附加标签、注解和元数据；仅在有值时返回。 无值时可省略。 |
| `data.annotations` | object | 附加标签、注解和元数据；仅在有值时返回。 无值时可省略。 |
| `data.metadata` | object | 附加标签、注解和元数据；仅在有值时返回。 无值时可省略。 |
| `data.created_by` | string | 创建者。 无值时可省略。 |
| `data.updated_by` | string | 最近更新者。 无值时可省略。 |
| `data.created_at` | string | 创建和更新时间；RFC 3339 时间。 |
| `data.updated_at` | string | 创建和更新时间；RFC 3339 时间。 |

## 错误响应

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} 响应示例

```json
{
  "code": 3,
  "message": "运行策略不存在"
}
```

:::::
:::::{tab-item} 字段说明

::::{tab-set}
:::{tab-item} 通用字段

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `code` | integer | 错误代码。 |
| `message` | string | 面向调用者的错误信息。 |

:::
::::

:::::
::::::
:::::::

## 后续操作

使用[更新运行策略](update-runtime-policy-profile.md)修改可变字段。