Chuyển tới nội dung chính

Preview cron

POST/api/automation/rules/cron-preview
Quản trị viên

Quy tắc theo lịch và quy tắc nhắc trước chỉ nhận những action chỉ để thông báo cho mọi người — Slack, email và Microsoft Teams: không có ai theo dõi khi chúng chạy. Quy tắc theo lịch lấy project từ release mà nó lặp lại. Xem lần chạy tới trên trang, hoặc POST /api/automation/rules/cron-preview, cho biết khi nào một biểu thức sẽ chạy lần tới, trước khi quy tắc nào lưu nó.

Đọc thêm: Quy tắcMã nguồn: AutomationRuleApiController#previewCron(mở trong thẻ mới)

Request body​

application/json

TrườngKiểuBắt buộcGhi chú
cronExpressionstringBắt buộc
cronTimeZonestringBắt buộc

Response​

Thành công: 200

TrườngKiểuBắt buộcGhi chú
nextFireAtstring (date-time)Tùy chọn

Lỗi​

Trạng tháiMãÁp dụng cho
400validation_failedthiếu trường hoặc giá trị nằm ngoài khoảng cho phépMọi endpoint
400malformed_requestkhông đọc được bodyMọi endpoint
400invalid_parametermột tham số trên đường dẫn hoặc query bị thiếu hoặc không chuyển đổi được, chẳng hạn một ID không phải UUIDMọi endpoint
401authentication_requiredchưa có phiên đăng nhậpMọi endpoint
403access_deniedendpoint dành cho quản trị viên, hoặc CSRF token thiếu hay đã cũMọi endpoint
404not_foundkhông có địa chỉ đóMọi endpoint
405method_not_allowedđịa chỉ không nhận phương thức đóMọi endpoint
415unsupported_media_typeđịa chỉ không đọc body thuộc kiểu đóMọi endpoint
500internal_errormột lỗi ReleaseFlow không lường trước; body không bao giờ chứa exception gây ra nóMọi endpoint
400, 404, 409Xem hướng dẫnKhu vực Automation

Request

bash
# Sign in first and keep the session cookie in cookies.txt (see Sessions and CSRF).
# CSRF_HEADER and CSRF_TOKEN are the headerName and token GET /api/csrf returned.
curl -X POST "http://localhost:8080/api/automation/rules/cron-preview" \
-b cookies.txt -c cookies.txt \
-H "$CSRF_HEADER: $CSRF_TOKEN" \
-H "Content-Type: application/json" \
--data '{
"cronExpression": "<string>",
"cronTimeZone": "<string>"
}'

Request body là ví dụ dựng từ schema; thay mọi giá trị giữ chỗ trước khi gửi.

Response

200

Ví dụ

{
  "nextFireAt": "<date-time>"
}