# SAP BTP 作业调度服务 ## 目录 * 概述 * 何时使用此技能 * 快速决策树 * 核心概念 * 服务限制 * 快速参考表 * 时间表格式 * Cron 格式（7 个字段） * 安排生命周期状态 * 作业的 HTTP 方法 * 最佳实践 * 调度优化 * 异步作业 * 一次性时间表 * 身份验证快速入门 * 标准计划 (OAuth 2.0) * xs-security.json配置 * 创建作业示例 * Node.js 客户端库 * 速率限制 * 服务行为 * 断电恢复 * 自动停用触发器 * 捆绑资源 * 常见陷阱 * 外部资源 * 更新和维护 ## 概述 SAP Job Scheduling Service 是一种与运行时无关的平台服务，用于在 SAP BTP 上定义和管理一次性和重复性作业或 Cloud Foundry 任务。它可以跨多个超大规模（AWS、Azure、GCP）运行，无需修改应用程序。 **文档来源**： **最后验证** : 2025-11-27 ## 何时使用此技能在以下情况下使用此技能： * **在 Cloud Foundry 或 Kyma 运行时上设置作业调度服务** * **通过 REST API 或仪表板创建和管理作业** * **使用 cron、日期/时间或人类可读格式配置计划** * **为长时间运行的流程实现异步作业执行** * **使用 OAuth 2.0 和 XSUAA 保护操作端点** * **与 SAP Cloud ALM** 或警报通知服务集成 * **使用租户感知作业调度开发多租户应用程序** * **排查作业执行问题**和计划失败 * **使用 Node.js 客户端库** (@sap/jobs-client) ## 快速决策树 ### 什么任务？设置和配置 ├─ 初始设置先决条件→references/setup-guide.md ├─ 创建服务实例 │ ├─ BTP驾驶舱→references/setup-guide.md#cockpit │ ├─ CF CLI → 参考文献/setup-guide.md#cf-cli │ └─ Kyma 仪表板 → 参考文献/setup-guide.md#kyma └─ 配置 XSUAA 范围 →references/security.md 职位管理 ├─ 创建作业→references/rest-api.md#create-job ├─ 配置时间表→references/rest-api.md#schedules ├─ 运行日志与监控→references/rest-api.md#run-logs └─ 仪表板操作→references/operations.md#dashboard 时间表配置 ├─ 一次性与重复→references/concepts.md#schedule-types ├─ Cron 格式→references/concepts.md#cron-format ├─ 日期/时间格式→references/concepts.md#date-formats └─ 人类可读→引用/concepts.md#人类可读异步执行 ├─ 异步模式流程→references/concepts.md#async-mode ├─ 回调实现→references/rest-api.md#update-run-log └─CF任务→references/concepts.md#cf-tasks 安全与认证 ├─ OAuth 2.0 设置→references/security.md#oauth ├─ XSUAA配置→references/security.md#xsuaa └─ 凭证轮换 →references/security.md#rotation 集成 ├─ SAP Cloud ALM →references/integrations.md#cloud-alm └─ 警报通知→references/integrations.md#alert-notification 故障排除 ├─ 常见错误→references/troubleshooting.md#errors ├─ 常见问题解答 → 参考文献/troubleshooting.md#faq └─ 支持：BC-CP-CF-JBS 版本历史和更新 └─ 新增内容（2021-2025）→references/changelog.md ## 核心概念 ### 工作具有操作端点的计划集合。作业在指定时间同步（短操作）或异步（长进程）调用配置的 URL。 ### 时间表工作中的一次性或经常性实体。支持多种格式（cron、日期/时间、人类可读）并具有三种生命周期状态：已计划→正在运行→已完成。 ### 动作端点由应用程序公开的 HTTP/REST 端点，服务在计划触发时调用该端点。在生产中必须受到 OAuth 2.0 保护。 ### Cloud Foundry 任务在自己的容器中独立运行的应用程序或脚本。始终使用可配置的内存分配异步执行。 ## 服务限制约束|价值 ---|--- 最小调度间隔 | 5分钟同步请求超时 | 15秒异步超时（默认）| 30 分钟（最长可配置 7 天） POST 请求正文限制 | 100KB 运行日志保留| 15天服务SLA |距预定时间约 20 分钟 ## 快速参考表 ### 时间表格式格式|示例|使用案例 ---|---|--- 克朗 | `* * * * 10:12 0,30 0` | 10:00-12:00 每 30 分钟一班日期/时间 | `2025-10-20T04:30:00Z` | ISO-8601 一次性执行人类可读 | `明天下午 4 点` |自然语言调度重复间隔 | “2小时”、“5分钟” |以固定时间间隔重复出现重复| `下午 4.40`、`18:40` |每日特定时间 ### Cron 格式（7 个字段）年月日 DayOfWeek 时分钟秒 * * * * * * * * 领域|价值观 |特别 ---|---|--- 年份| 4 位数字 (2025) | * = 任意月 | 1-12 | 1-12 */a = 每第 a 个日 | -31 至 31 |负数 = 从末尾开始星期几 |周一、周二、周三... | a.y = 第 a 次出现小时 | 0-23 | a:b = 范围分钟| 0-59 | a:b/c = 范围内的步长第二 | 0-59 | a,b,c = 多个值 ### 安排生命周期状态相|州 |描述 ---|---|--- 预定|预定|排队等待将来运行跑步 |已触发、ACK_RECVD、ACK_NOT_RECVD |执行中已完成 |成功、错误、请求错误、未知 |完成 ### 作业的 HTTP 方法方法|端点|目的 ---|---|--- 发布 | `/调度程序/作业` |创造就业机会获取 | `/调度程序/作业` |列出所有职位获取 | `/scheduler/jobs/{id}` |获取职位详细信息放置 | `/scheduler/jobs/{id}` |更新作业删除| `/scheduler/jobs/{id}` |删除作业 ## 最佳实践 ### 调度优化 **避开高峰时间：** * ❌ 任意分钟的第 0 秒或第 30 秒 * ❌ 第 0 分钟、第 30 分钟或 5 分钟的倍数 * ❌ 每小时最高点 * ❌ UTC 午夜（最繁忙时间） **使用不规则时间：** * ✅ `01:12:17` 而不是 `01:00:00` * ✅ `01:38:37` 而不是 `01:30:00` ### 异步作业 1. **返回 202 立即接受** \- 不阻止请求 2. **存储请求标头** \- `x-sap-job-id`、`x-sap-job-schedule-id`、`x-sap-job-run-id`、`x-sap-scheduler-host` 3. **完成时更新运行日志** \- 具有最终状态的单个 API 调用 4. **处理超时** \- 默认 30 分钟，可配置最长 7 天 ### 一次性时间表 * 仅用于测试/验证 * 执行后自动停用 * 使用 `"time": "now"` 立即执行 ## 身份验证快速入门 ### 标准计划（OAuth 2.0） # 获取访问令牌卷曲-X POST“/oauth/token”\ -H "授权：基本 $(echo -n ':' | base64)" \ -d“grant_type=client_credentials” # 在 API 调用中使用令牌 curl -X GET "[https://jobscheduler-rest./scheduler/jobs"](https://jobscheduler-rest./scheduler/jobs") \ -H“授权：持有者”\ -H“内容类型：application/json” ### xs-security.json 配置 { "xsappname": "<应用程序名称>", “范围”：[{ “名称”：“$XSAPPNAME.JOBSCHEDULER”， "description": "作业调度程序范围", “授予应用程序权限”：[“$XSSERVICENAME()”] }] } ## 创建作业示例 POST /调度程序/作业 { “姓名”：“我的工作”， "description": "处理每日报告", “行动”：“[https://myapp.cfapps.eu10.hana.ondemand.com/api/process”，]（https://myapp.cfapps.eu10.hana.ondemand.com/api/process”，） “主动”：真实， "httpMethod": "POST", “时间表”：[{ “主动”：真实， "description": "每天早上 6 点", “重复”：“上午 6 点”， "startTime": {"date": "2025-01-01", "format": "YYYY-MM-DD"} }] } ## Node.js 客户端库 **要求**：Node.js 14.x 或更高版本 npm install @sap/jobs-client@1.8.6 const JobSchedulerClient = require('@sap/jobs-client'); const 调度程序 = new JobSchedulerClient.Scheduler(); // 创建作业 Scheduler.createJob({ url: vcapServices.jobscheduler[0].credentials.url }, { 名称：“我的工作”，操作：'[https://myapp.../process',](https://myapp.../process',) 主动：真实， http方法：'GET'，计划：[{ cron: '* * * * 0 0 0', active: true }] }, (err, result) => { /* 句柄 */ }); ## 速率限制限制类型 |响应代码 |标头 ---|---|--- 超出客户端限制 | 429 | 429 “重试时间”（秒）超出绝对限制 | 503 | 503 “节流”（毫秒）限制堆栈 - 两者可以同时应用。 ## 服务行为 ### 断电恢复停电时间|行为 ---|--- < 20 分钟 |所有错过的执行都会立即运行 >= 20 分钟 |仅运行最后一次错过的执行 ### 自动停用触发器 * 一次性执行计划 * 不存在有效的未来日期 * 作业/计划结束时间已达到 * 操作端点超过 10 天无法访问 ## 参考文件 ### 提供详细指南 1. **references/concepts.md** \- 计划类型、格式、生命周期、异步模式、多租户 2. **references/rest-api.md** \- 包含所有端点的完整 REST API 参考 3. **references/setup-guide.md** \-前提条件，服务实例创建 4. **references/security.md** \- OAuth 2.0、XSUAA 范围、凭证轮换 5. **references/integrations.md** \- 云 ALM，警报通知服务 6. **references/troubleshooting.md** \- FAQ、错误场景、监控 7. **references/operations.md** \- 仪表板、备份/恢复、服务行为 8. **references/changelog.md** \- 版本历史、功能更新（2021-2025） ### 可用模板 1. **templates/job-creation.json** \- 职位创建请求模板 2. **templates/xs-security.json** \- XSUAA 配置模板 ## 常见陷阱 **设置：** * ❌ 作业调度绑定之前缺少 XSUAA 绑定 * ❌ 不通过 `grant-as-authority-to-apps` 授予范围 * ❌ 对操作端点使用 HTTP 而不是 HTTPS **日程安排：** * ❌ 使用 Linux cron 格式（服务使用 SAP cron） * ❌高峰时段排班（00:00、00:30等） * ❌ 忘记 UTC 时区（仅支持时区） **异步作业：** * ❌ 不返回 202 立即接受 * ❌ 忘记调用更新运行日志API * ❌ 多个状态更新而不是单个最终更新 **多租户：** * ❌ 将 `tenantId` 过滤器与 SaaS 租户令牌一起使用（返回 400） * ❌ 缺少作业调度作为应用程序依赖项 ## 外部资源 ### SAP 文档 * **SAP 帮助门户**： * **SAP 开发人员中心** : ### 支持 * **组件**：BC-CP-CF-JBS * **SAP Trust Center** ：平台状态验证 * **指导答案**：自助故障排除 ## 更新和维护 **来源**：SAP BTP 作业调度服务文档 **更新此技能**： 1. 检查 GitHub 存储库以获取文档更新 2. 查看“新增内容”部分以了解更改 3.更新受影响的参考文件 4. 如果配置发生变化则更新模板 5.更新“上次验证”日期 **建议每季度审查**：每 3 个月检查一次更新 **下次回顾** : 2026-02-27 ## 捆绑资源 ### 参考文件 1. **references/concepts.md** \- 计划类型、格式、生命周期、异步模式、多租户（12K 行） 2. **references/rest-api.md** \- 包含所有端点的完整 REST API 参考（20K 行） 3. **references/setup-guide.md** \-前提条件，服务实例创建（9K行） 4. **references/security.md** \- OAuth 2.0、XSUAA 范围、凭证轮换（11K 行） 5. **references/integrations.md** \- 云ALM，警报通知服务（8K行） 6. **references/troubleshooting.md** \- FAQ、错误场景、监控（9K行） 7. **references/operations.md** \- 仪表板、备份/恢复、服务行为（8K 行） 8. **references/changelog.md** \- 版本历史、功能更新（2021-2025）（9K 行） ### 模板 1. **templates/job-creation.json** \- 带有示例的作业创建请求模板 2. **templates/xs-security.json** \- OAuth 范围的 XSUAA 配置模板 ** ** **技能版本**：1.0.1 **最后更新**：2025-11-27 **许可证**：GPL-3.0 **维护者**：SAP 技能团队 |

SAP Btp 作业调度

包含技能