查询指定作业下的特定信号的详细信息。
接口说明
请求说明
通过此 API,用户可以获取到指定 JobId 和 SignalId 对应的信号详情,包括信号的状态、发送范围等信息。请注意,返回的结果中不再包含每个 Pod 的原始结果结构,而是通过 Status, Reason, 和 Message 字段来表达信号处理的整体情况。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
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 |
| 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"
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。