上一主题: 管理器模式下一主题: 详细的 API 文档


操作模式

操作模式负责处理不适合“创建读取更新删除”(CRUD) 管理器模式的操作。 这些操作包括从更改资源状态到使资源执行诸如重置电源密码等操作。

通过对以 operations/<operation name> 结尾的 URL 执行 POST 操作并使用可选有效负载来实施操作模式。 在以下示例中,启动名为 govt_sales 的网格:

POST grids/govt_sales/operations/start

对于 RESTful 的情况,操作模式可创建通过操作名称标识的新资源。

操作模式可以并且常常与管理模式和管理器模式结合使用。 受管收集上的操作应遵循管理模式。 但是,受管实例上的操作应遵循管理器模式。

下一节中的表格介绍了(以常规方式)URI 结构、HTTP 方法的使用、有效负载以及 BFC 客户端与 API 应用交互方式的返回结构。

目标示例

操作如下:

BFC/admin/<resource_type>s/operations/<operation_name>、 
BFC/<resource_type>s/operations/<operation_name>、 
BFC/admin/<resource_type>/<resource_id>/operations/<operation_name>

GET

调用不包含有效负载的操作。 使用这种方式调用的操作不得产生副作用。

返回值:操作的结果。

POST

与 GET 相同,但是会产生副作用。

有效负载:变量-由操作定义。

返回值:操作的结果。