GetSignal - 获取信号详情

更新时间:
复制 MD 格式

查询指定作业下的特定信号的详细信息。

接口说明

请求说明

通过此 API,用户可以获取到指定 JobIdSignalId 对应的信号详情,包括信号的状态、发送范围等信息。请注意,返回的结果中不再包含每个 Pod 的原始结果结构,而是通过 Status, Reason, 和 Message 字段来表达信号处理的整体情况。

调试

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

调试

授权信息

当前API暂无授权信息透出。

请求语法

GET /api/v1/jobs/{JobId}/signals/{SignalId} HTTP/1.1

路径参数

名称

类型

必填

描述

示例值

JobId

string

作业 Id

dlc**********

SignalId

string

信号 Id

oper**********

请求参数

名称

类型

必填

描述

示例值

Token

string

用于鉴权的临时令牌。

eyXXXX-XXXX.XXXXX

返回参数

名称

类型

描述

示例值

object

Schema of Response

RequestId

string

请求 ID。

473469C7-AA6F-4DC5-B3DB-xxxxxxx

SignalId

string

信号 Id

dlc***********

JobId

string

作业 Id

oper***********

Signal

string

信号

SIGUSR1

Status

string

信号状态

Succeeded

GmtCreated

string

创建时间。

2026-03-18T10:02:04+08:00

GmtModified

string

修改时间。

2026-03-18T10:02:04+08:00

Scope

string

发送范围

pods

Roles

array

角色对象列表。

string

角色信息。

worker

PodNames

array

Pod 名称列表

string

Pod 名称

dlc*******-worker-0

Reason

string

状态原因码, 如 Completed / SignalFailed / StoppedByJobEnded

Completed

Message

string

状态说明, 包含每个 Pod 的汇总(投递成功数、失败/pending 的 Pod 名等)

signal delivered to 1 pods

示例

正常返回示例

JSON格式

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-xxxxxxx",
  "SignalId": "dlc***********",
  "JobId": "oper***********",
  "Signal": "SIGUSR1",
  "Status": "Succeeded",
  "GmtCreated": "2026-03-18T10:02:04+08:00",
  "GmtModified": "2026-03-18T10:02:04+08:00",
  "Scope": "pods",
  "Roles": [
    "worker"
  ],
  "PodNames": [
    "dlc*******-worker-0"
  ],
  "Reason": "Completed",
  "Message": "signal delivered to 1 pods"
}

错误码

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

变更历史

更多信息,参考变更详情