# 使用API连接Ray联邦端点并提交作业
当您需要将数据处理能力集成到业务系统中，或通过代码自动化提交Ray作业和查询作业状态时，可以通过API连接Ray联邦端点并提交作业。API 提供标准RESTful接口，方便您通过代码调用。
#### 前提条件
已创建RayCluster和Ray联邦端点且端点状态为"运行中"。具体操作，请参见[创建Ray引擎端点](https://support.huaweicloud.com/usermanual-aidatalake/aidatalake_01_0073.html)。
#### 涉及API
[运行作业](https://support.huaweicloud.com/api-aidatalake/RunRayJob.html)。
#### 操作步骤
1. 使用Postman等工具，调用API连接Ray联邦端点并提交作业。 
   调用API的具体操作，请参见[如何调用API](https://support.huaweicloud.com/api-aidatalake/aidatalake_02_0003.html)。
   请求示例如下：
   ```
   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]所示，更多参数信息，请参见[运行作业](https://support.huaweicloud.com/api-aidatalake/RunRayJob.html)。
    表1参数说明 
   | 参数            | 说明                                                                                                                   |
   |:---|:---|
   | workspace_id   | 输入工作空间ID。获取工作空间ID的具体操作，请参见[管理工作空间](https://support.huaweicloud.com/usermanual-aidatalake/aidatalake_01_0038.html)。    |
   | name         | 输入作业名称。                                                                                                               |
   | endpoint_name | 输入Ray联邦端点名称。获取端点名称的具体操作，请参见[管理Ray引擎端点](https://support.huaweicloud.com/usermanual-aidatalake/aidatalake_01_0074.html)。 |
   | entrypoint    | 输入运行作业的主脚本。                                                                                                            |
      
   
   
2. 查看返回响应信息，类似如下所示，表示已连接Ray联邦端点并成功提交作业。 
   ```
   {
     "job_id" : "ac8111bf-3601-4905-8ddd-b41d3e63****"
   }
   ```
   
   
 
#### 相关操作
- 运行作业后，您可以通过API查询作业列表信息。具体操作，请参见[查询Ray作业列表 - ListRayJobs](https://support.huaweicloud.com/api-aidatalake/ListRayJobs.html)。
- 运行作业后，您可以通过API查询作业的详情信息。具体操作，请参见[查询作业详情 - ShowRayJob](https://support.huaweicloud.com/api-aidatalake/ShowRayJob.html)。
- 运行作业后，您可以通过API取消作业运行。具体操作，请参见[取消作业运行 - CancelRayJob](https://support.huaweicloud.com/api-aidatalake/CancelRayJob.html)。