全部产品
Search
文档中心

开源大数据平台E-MapReduce:ListRayJob - 列出Ray Job信息。

更新时间:Oct 10, 2026

列出Ray Job信息。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:

    • 对于必选的资源类型,用前面加 * 表示。

    • 对于不支持资源级授权的操作,用全部资源表示。

  • 条件关键字:是指云产品自身定义的条件关键字。

  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

emr-serverless-spark:ListRayJob

none

*全部资源

*

无 无

请求语法

GET /api/v1/workspaces/{workspaceId}/rayJob HTTP/1.1

路径参数

名称

类型

必填

描述

示例值

workspaceId

string

否

工作空间 ID。

w-d2d82aa09155

请求参数

名称

类型

必填

描述

示例值

pageSize

integer

否

返回结果的分页数。默认值:20。

20

pageNum

integer

否

页码,默认值:1。

1

submissionId

string

否

Ray Job 的提交 id。

rj-xxxxxxxxxxx

name

string

否

Ray Job 的名称(精确搜索)。

myrayjob

submitTime

object

否

提交时间范围。

startTime

integer

否

提交时间起始,unix 毫秒级别时间戳。

1780017822000

endTime

integer

否

提交时间截止,unix 毫秒级别时间戳。

1780018822000

taskBizId

string

否

数据开发任务 ID。

TSK-db8b870d901e443ba0aebba40c923e02

返回参数

名称

类型

描述

示例值

object

Schema of Response

requestId

string

请求 ID。

DD6B1B2A-5837-5237-ABE4-FF0C8944

totalCount

integer

总数量。

200

rayJobs

array<object>

Ray Job 列表。

object

Ray Job 结构体。

submissionId

string

Ray Job 的 id。

rj-uiulpgow9xljimm1

name

string

Ray Job 的名称。

testRayJob

status

string

任务状态

  • Submitted 已提交。

  • Pending:集群创建中。

  • Running:任务运行中。

  • Succeeded:任务已成功。

  • Failed:任务已失败。

  • Cancelling:取消中。

  • Cancelled:已取消。

  • Timeout:超时取消。

枚举值:

  • Submitted :

    已提交

  • Succeeded :

    成功

  • Failed :

    失败

  • Timeout :

    超时

  • Running :

    运行中

  • Cancelled :

    已取消

  • Cancelling :

    取消中

  • Pending :

    等待中

Running

resourceQueue

string

Ray 引擎版本。

err-1.2.0 (Ray 2.55.1, Python 3.12)

submitTime

integer

任务提交时间。采用 Unix 时间戳,单位为毫秒。

1776945399000

startTime

integer

任务启动时间。采用 Unix 时间戳,单位为毫秒。

1776945499000

endTime

integer

任务结束时间。采用 Unix 时间戳,单位为毫秒。

1776945509000

duration

integer

任务执行时间,单位秒。

3564

creatorName

string

创建者昵称。

Alice

dashboardUrl

string

Ray 集群 Dashboard 链接,Ray 集群状态为 Running 时为 Runtime UI,状态为 Deleted 后为 History UI,仅 err-1.2.0 及以上版本支持 History UI。

https://emr-ray-gateway.aliyuncs.com?token=xxxxxxxxx

cuHours

number

任务运行周期内所消耗的 CU 数量(该值为预估值,最终以账单为准)。

120

clusterState

string

对应的 Ray 集群的状态。

  • Deleted:已删除。

  • Submitted:已提交未开始创建。

  • Pending:创建中。

  • Running:运行中。

枚举值:

  • Submitted :

    已提交

  • Running :

    运行中

  • Deleted :

    已删除

  • Pending :

    等待中

Running

示例

正常返回示例

JSON格式

{
  "requestId": "DD6B1B2A-5837-5237-ABE4-FF0C8944",
  "totalCount": 200,
  "rayJobs": [
    {
      "submissionId": "rj-uiulpgow9xljimm1",
      "name": "testRayJob",
      "status": "Running",
      "resourceQueue": "err-1.2.0 (Ray 2.55.1, Python 3.12)",
      "submitTime": 1776945399000,
      "startTime": 1776945499000,
      "endTime": 1776945509000,
      "duration": 3564,
      "creatorName": "Alice",
      "dashboardUrl": "https://emr-ray-gateway.aliyuncs.com?token=xxxxxxxxx",
      "cuHours": 120,
      "clusterState": "Running"
    }
  ]
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情。