更新时间:2026-10-21 GMT+08:00
分享

使用API连接Ray联邦端点并提交作业

当您需要将数据处理能力集成到业务系统中,或通过代码自动化提交Ray作业和查询作业状态时,可以通过API连接Ray联邦端点并提交作业。API 提供标准RESTful接口,方便您通过代码调用。

前提条件

已创建RayCluster和Ray联邦端点且端点状态为“运行中”。具体操作,请参见创建Ray引擎端点。

涉及API

运行作业。

操作步骤

  1. 使用Postman等工具,调用API连接Ray联邦端点并提交作业。

    调用API的具体操作,请参见如何调用API。

    请求示例如下:

    POST /v2/workspaces/{workspace_id}/ray-jobs
    {
      "name": "xd-test-010-0906",
      "endpoint_name": "ray-federation-1hrr",
      "config": {
        "entrypoint": "python3 -c \"import ray,time; time.sleep(30); ray.init(); print(ray.cluster_resources())\""
        }
    }

    关键参数说明如表1所示,更多参数信息,请参见运行作业。

    表1 参数说明

    参数

    说明

    workspace_id

    输入工作空间ID。获取工作空间ID的具体操作,请参见管理工作空间。

    name

    输入作业名称。

    endpoint_name

    输入Ray联邦端点名称。获取端点名称的具体操作,请参见管理Ray引擎端点。

    entrypoint

    输入运行作业的主脚本。

  2. 查看返回响应信息,类似如下所示,表示已连接Ray联邦端点并成功提交作业。

    {
      "job_id" : "ac8111bf-3601-4905-8ddd-b41d3e63****"
    }

相关操作

相关文档