# 使用算子和算子 API 服务

查询可用算子，创建和维护自定义算子，并将算子发布、启用、停用或调用为 API 服务。本页不处理工作流作业；需要运行工作流时，请参阅[运行、恢复和重试工作流作业](workflow-jobs-recovery.md)。

## 前提条件

准备可访问目标工作区的凭据。有关服务地址、认证和通用请求格式，请参阅[调用前准备](../../api-call-basics.md)。

维护自定义算子或算子 API 服务前，先从相应列表或详情中取得目标标识。

## 调用顺序

1. 查询算子列表和详情，确认可用算子及其当前信息。
2. 需要自定义处理逻辑时创建自定义算子；查询代码和详情，并在调整后试运行。
3. 确认自定义算子可用后，发布算子 API 服务；通过服务配置确认目标服务。
4. 启用服务后调用；需要暂时停止服务时停用，恢复使用时再启用。
5. 不再需要自定义算子时，先确认影响后删除。

## API 操作

### 浏览算子

| 要完成的事 | API 操作 | 何时使用 |
| --- | --- | --- |
| 查询算子列表 | [查看工作流算子列表](../../../../reference/api/ai-studio/data-processing/operator-catalog/list-operators.md) | 查找可用算子时使用。 |
| 查询算子详情 | [查看工作流算子详情](../../../../reference/api/ai-studio/data-processing/operator-catalog/get-operator.md) | 已选择算子后查看其信息时使用。 |

### 管理自定义算子

| 要完成的事 | API 操作 | 何时使用 |
| --- | --- | --- |
| 查询自定义算子列表 | [查看自定义算子列表](../../../../reference/api/ai-studio/data-processing/custom-operators/list-custom-operators.md) | 查找自定义算子或取得目标标识时使用。 |
| 创建自定义算子 | [创建自定义算子](../../../../reference/api/ai-studio/data-processing/custom-operators/create-custom-operator.md) | 需要新增自定义处理逻辑时使用。 |
| 查询自定义算子详情 | [查看自定义算子详情](../../../../reference/api/ai-studio/data-processing/custom-operators/get-custom-operator.md) | 确认单个自定义算子当前信息时使用。 |
| 查询自定义算子代码 | [查看自定义算子代码](../../../../reference/api/ai-studio/data-processing/custom-operators/get-custom-operator-code.md) | 需要查看自定义算子代码时使用。 |
| 更新自定义算子 | [更新自定义算子](../../../../reference/api/ai-studio/data-processing/custom-operators/update-custom-operator.md) | 需要调整已有自定义算子时使用。 |
| 试运行自定义算子 | [试运行自定义算子](../../../../reference/api/ai-studio/data-processing/custom-operators/test-custom-operator.md) | 发布或使用前验证自定义算子时使用。 |
| 启用自定义算子 | [启用自定义算子](../../../../reference/api/ai-studio/data-processing/custom-operators/enable-custom-operator.md) | 需要启用已停用的自定义算子时使用。 |
| 停用自定义算子 | [停用自定义算子](../../../../reference/api/ai-studio/data-processing/custom-operators/disable-custom-operator.md) | 需要暂时停止使用自定义算子时使用。 |
| 删除自定义算子 | [删除自定义算子](../../../../reference/api/ai-studio/data-processing/custom-operators/delete-custom-operator.md) | 确认不再需要该自定义算子后使用。 |

### 发布和调用 API 服务

| 要完成的事 | API 操作 | 何时使用 |
| --- | --- | --- |
| 发布算子 API 服务 | [发布算子 API 服务](../../../../reference/api/ai-studio/data-processing/operator-api-services/publish-operator-api-service.md) | 需要将算子作为 API 服务提供时使用。 |
| 查看算子 API 服务配置 | [查看算子 API 服务配置](../../../../reference/api/ai-studio/data-processing/operator-api-services/get-operator-api-service.md) | 发布后确认服务配置时使用。 |
| 启用算子 API 服务 | [启用算子 API 服务](../../../../reference/api/ai-studio/data-processing/operator-api-services/enable-operator-api-service.md) | 需要启用已停用服务时使用。 |
| 停用算子 API 服务 | [停用算子 API 服务](../../../../reference/api/ai-studio/data-processing/operator-api-services/disable-operator-api-service.md) | 需要暂时停止服务时使用。 |
| 调用算子 API 服务 | [调用算子 API 服务](../../../../reference/api/ai-studio/data-processing/operator-api-services/invoke-operator-api-service.md) | 服务已发布并可用时调用。 |

## 结果确认

创建、更新、启用或停用自定义算子后，使用[查看自定义算子详情](../../../../reference/api/ai-studio/data-processing/custom-operators/get-custom-operator.md)确认当前信息；发布、启用或停用服务后，使用[查看算子 API 服务配置](../../../../reference/api/ai-studio/data-processing/operator-api-services/get-operator-api-service.md)确认服务配置。

## 限制和注意事项

- 发布、启用和调用是不同操作；调用前先确认服务配置和可用状态。
- 删除或停用自定义算子、停用 API 服务前，先确认不会影响依赖它的调用。

## 下一步

- [运行、恢复和重试工作流作业](workflow-jobs-recovery.md)