ListJobExecutors - 查询作业Executor信息_弹性高性能计算(E-HPC)-阿里云帮助中心

查询作业Executor信息。

接口说明

查询作业 Executor 信息。

调试

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

调试

授权信息

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

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
ehpc:ListJobExecutors	list	全部资源 ``	无	无

请求参数

名称	类型	必填	描述	示例值
JobId	string	否	作业 ID。	job-xxx
TaskName	string	否	作业名称。	task0
PageSize	integer	否	每页显示条数。	10
PageNumber	integer	否	分页查询的页码。	1

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	请求 ID。	896D338C-E4F4-41EC-A154-D605E5DE****
JobId	string	作业 ID。	job-xxxx
TaskName	string	作业名称。	task0
PageSize	integer	每页条数。	10
PageNumber	integer	当前页码。	1
TotalCount	string	列表条目总数。	50
Executors	array<object>	Executor 列表。
Executor	object	Executor 属性。
ExecutorId	string	Executor ID。格式为 JobId-TaskName-ArrayIndex。	job-xxxx-Task0-1
ArrayIndex	integer	Executor 索引号。	0
IpAddress	array	节点 IP 地址列表。
IpAddress	string	节点 IP 地址。	192.168.10.11
ExternalIpAddress	array	节点公网 IP 地址列表。
EipAddress	string	节点公网 IP 地址。	116.62.100.6
HostName	array	节点主机名数组。
HostName	string	主机名。	host0
CreateTime	string	创建时间。	2024-02-20 10:04:10
StartTime	string	开始时间。	2024-02-20 10:04:13
EndTime	string	结束时间。	2024-02-20 10:04:18
Status	string	Executor 状态。可能值： Pending：排队中 Initing：初始化中 Succeed：运行成功 Failed：运行失败 Running：运行中 Unknown：状态未知 Exception：调度异常 Retrying：重试中 Expired：运行超时 Deleted：删除完成	Running
StatusReason	string	状态原因描述。	Creating executor
Tags	array<object>	Executor 标签列表。
Tag	object	Executor 标签列表。
TagKey	string	Executor 标签键。	TestKey
TagValue	string	Executor 标签值。	TestValue
ExecutorStatus	object	Executor 状态统计。
Pending	integer	排队状态的 Executor 数量。	1
Initing	integer	初始化状态的 Executor 数量。	1
Running	integer	运行中状态的 Executor 数量。	1
Succeeded	integer	运行成功状态的 Executor 数量。	1
Failed	integer	运行失败状态的 Executor 数量。	1
Deleted	integer	删除状态的 Executor 数量。	1
Exception	integer	异常状态的 Executor 数量。	1

示例

正常返回示例

JSON格式

{
  "RequestId": "896D338C-E4F4-41EC-A154-D605E5DE****",
  "JobId": "job-xxxx",
  "TaskName": "task0",
  "PageSize": 10,
  "PageNumber": 1,
  "TotalCount": 50,
  "Executors": [
    {
      "ExecutorId": "job-xxxx-Task0-1\n",
      "ArrayIndex": 0,
      "IpAddress": [
        "192.168.10.11"
      ],
      "ExternalIpAddress": [
        "116.62.100.6"
      ],
      "HostName": [
        "host0"
      ],
      "CreateTime": "2024-02-20 10:04:10",
      "StartTime": "2024-02-20 10:04:13",
      "EndTime": "2024-02-20 10:04:18",
      "Status": "Running",
      "StatusReason": "Creating executor",
      "Tags": [
        {
          "TagKey": "TestKey\n",
          "TagValue": "TestValue"
        }
      ],
      "ExpirationTime": "",
      "BlockDuration": 0,
      "Preemptible": true
    }
  ],
  "ExecutorStatus": {
    "Pending": 1,
    "Initing": 1,
    "Running": 1,
    "Succeeded": 1,
    "Failed": 1,
    "Deleted": 1,
    "Exception": 1,
    "Suspended": 0,
    "Restarting": 0
  }
}

错误码

HTTP status code	错误码	错误信息	描述
400	InvalidParams	The specified parameter %s is invalid.	无效的参数：%s
400	JobNotFound	The specified job id is not found.	未找到作业ID
406	DbError	A database error occurred.	数据库错误
503	ServiceUnavailable	The request has failed due to a temporary failure of the server.	请求失败，服务暂时不可用

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

变更历史

变更时间	变更内容概要	操作
2025-01-02	OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更	查看变更详情
2024-12-30	OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更	查看变更详情
2024-11-11	OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更	查看变更详情
2024-09-18	OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更	查看变更详情
2024-08-14	OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更	查看变更详情