# 管理计算实例和规格

管理工作区中的计算规格和计算实例，包括创建、配置、运行状态检查及生命周期操作。规格定义可选配置，实例负责实际运行；本页不处理工作流任务本身。

## 前提条件

- 准备目标工作区的访问条件；通用规则见[调用前准备](../../api-call-basics.md)。
- 管理计算规格前，先确认当前身份是否具有相应管理权限。
- 更新、暂停、恢复、重试或删除实例前，先从实例列表或详情取得目标实例 ID 和当前状态。

## 调用顺序

1. 查询计算规格管理权限，再列出当前可见规格；需要新增或调整规格时，创建或更新规格，并确认其启用状态。
2. 创建或更新计算实例前，查询可选 Worker 镜像，并根据需要准备计算规格或实例配置。
3. 创建实例后，查询实例详情确认配置、容量和生命周期状态；需要观察运行情况时，查询 Worker 运行时和实例指标。
4. 仅在详情显示 `ACTIVE` 时暂停实例；已暂停实例需要恢复，处于 `ERROR` 的实例需要重试操作。每次生命周期操作后重新查询详情确认状态。
5. 删除前先检查活动任务和工作流绑定；确认检查结果后再删除实例。历史资源所有权接管仅在受控修复场景中使用。

## API 操作

### 管理计算规格

| 要完成的事 | API 操作 | 何时使用 |
| --- | --- | --- |
| 查询计算规格管理权限 | [查看规格管理权限](../../../../reference/api/ai-studio/resource-center/compute-resource-specs/get-compute-resource-spec-management-permission.md) | 创建、更新或启用、停用规格前确认当前身份权限时使用。 |
| 列出计算规格 | [查看规格列表](../../../../reference/api/ai-studio/resource-center/compute-resource-specs/list-compute-resource-specs.md) | 选择现有规格或确认规格变更结果时使用。 |
| 创建计算规格 | [创建规格](../../../../reference/api/ai-studio/resource-center/compute-resource-specs/create-compute-resource-spec.md) | 当前工作区需要新的计算规格时使用。 |
| 更新计算规格 | [更新规格](../../../../reference/api/ai-studio/resource-center/compute-resource-specs/update-compute-resource-spec.md) | 修改已有规格定义时使用。 |
| 启用或禁用计算规格 | [启用或停用规格](../../../../reference/api/ai-studio/resource-center/compute-resource-specs/set-compute-resource-spec-enabled.md) | 改变指定规格的启用状态时使用。 |

### 创建和观察计算实例

| 要完成的事 | API 操作 | 何时使用 |
| --- | --- | --- |
| 列出计算实例 | [查看计算实例列表](../../../../reference/api/ai-studio/resource-center/compute-resources/list-compute-resources.md) | 选择已有实例、取得实例 ID 或确认创建和删除结果时使用。 |
| 列出 Worker 镜像 | [查看可用 Worker 镜像](../../../../reference/api/ai-studio/resource-center/compute-resources/list-worker-images.md) | 创建或更新实例前选择可用 Worker 镜像时使用。 |
| 创建计算实例 | [创建计算实例](../../../../reference/api/ai-studio/resource-center/compute-resources/create-compute-resource.md) | 已准备实例配置，需要在当前工作区创建实例时使用。 |
| 更新计算实例 | [更新计算实例](../../../../reference/api/ai-studio/resource-center/compute-resources/update-compute-resource.md) | 修改实例可更新配置时使用。 |
| 查询计算实例详情 | [查看计算实例详情](../../../../reference/api/ai-studio/resource-center/compute-resources/get-compute-resource.md) | 确认实例的配置、容量和生命周期状态时使用。 |
| 查询 Worker 运行时 | [查看 Worker 运行状态](../../../../reference/api/ai-studio/resource-center/compute-resources/get-worker-runtime.md) | 需要按 Worker 类型查看运行时副本状态时使用。 |
| 查询计算实例指标 | [查询计算实例指标](../../../../reference/api/ai-studio/resource-center/compute-resources/get-compute-resource-metrics.md) | 读取实例用量指标时使用。 |

### 管理实例生命周期

| 要完成的事 | API 操作 | 何时使用 |
| --- | --- | --- |
| 暂停计算实例 | [暂停计算实例](../../../../reference/api/ai-studio/resource-center/compute-resources/suspend-compute-resource.md) | 详情确认实例为 `ACTIVE`，需要停止其 Worker 时使用。 |
| 恢复计算实例 | [恢复计算实例](../../../../reference/api/ai-studio/resource-center/compute-resources/resume-compute-resource.md) | 已暂停实例需要恢复到可用状态时使用。 |
| 重试计算实例操作 | [重试计算实例](../../../../reference/api/ai-studio/resource-center/compute-resources/retry-compute-resource.md) | 详情确认实例处于 `ERROR` 时使用。 |
| 删除前检查计算实例 | [删除前检查](../../../../reference/api/ai-studio/resource-center/compute-resources/preflight-delete.md) | 删除前检查活动任务和工作流绑定时使用。 |
| 删除计算实例 | [删除计算实例](../../../../reference/api/ai-studio/resource-center/compute-resources/delete-compute-resource.md) | 已完成删除前检查并确认目标实例不再需要时使用。 |
| 接管历史计算资源所有权 | [接管历史计算资源所有权](../../../../reference/api/ai-studio/resource-center/compute-resources/adopt-legacy-compute-resource-ownership.md) | 仅在受控修复历史计算资源所有权时使用。 |

## 结果确认

规格创建、更新或启用状态变更后，通过[查看规格列表](../../../../reference/api/ai-studio/resource-center/compute-resource-specs/list-compute-resource-specs.md)确认。实例创建、更新、暂停、恢复或重试后，查询[查看计算实例详情](../../../../reference/api/ai-studio/resource-center/compute-resources/get-compute-resource.md)确认当前状态；删除后通过实例列表确认目标不再出现。

## 限制和注意事项

- 创建、更新或启用、停用计算规格前，应先确认计算规格管理权限。
- 暂停操作只适用于 `ACTIVE` 实例；恢复已暂停实例和重试 `ERROR` 实例成功后，实例都会回到 `IDLE`，不会立即部署 Worker。
- Serverless 实例更新后不会立即部署 Worker，Worker 由后续工作负载需求激活。
- 删除前检查会返回需要处理的活动任务和工作流绑定；未确认这些影响前不要删除。
- 历史计算资源所有权接管属于受控修复操作，要求相应管理权限。

## 下一步

- [管理工作区](workspaces.md)
- [数据发布与订阅](data-publications-subscriptions.md)