Lên lịch công việc kiếm tiền

Bạn đang xem tài liệu về Apigee Edge.
Truy cập vào tài liệu Apigee X. thông tin

Tổng quan về các công việc đã lên lịch

Tính năng kiếm tiền cung cấp một trình lập lịch công việc và một tập hợp các công việc được lên lịch trước để chạy vào thời gian được chỉ định.

Bảng dưới đây liệt kê các công việc được lên lịch trước do tính năng kiếm tiền cung cấp và thời gian chạy các công việc đó (tất cả thời gian được liệt kê đều theo giờ UTC). Ngoài ra, bạn cũng sẽ thấy điều kiện kích hoạt cho từng công việc.

Ngoài các công việc được liệt kê ở trên, bạn có thể bật các công việc thông qua thông báo sự kiện, như được liệt kê trong bảng sau. Để biết thêm thông tin, hãy xem bài viết Thiết lập thông báo.

Quản lý lịch biểu công việc kiếm tiền bằng API

Các phần sau đây mô tả cách quản lý lịch biểu công việc kiếm tiền bằng API:

• Định cấu hình điều kiện kích hoạt
• Tạo biểu thức cron
• Xem các công việc đã lên lịch bằng API
• Cập nhật các công việc định kỳ bằng API
• Tắt và bật lại một lệnh theo lịch biểu bằng API

Để biết thêm thông tin về các API được mô tả trong phần này, hãy xem Công việc theo lịch trong tài liệu tham khảo API.

Định cấu hình điều kiện kích hoạt

Trình lập lịch dựa vào các trình kích hoạt để thực thi các công việc. Một lệnh theo lịch biểu sẽ thực thi khi điều kiện kích hoạt liên kết của lệnh đó thực thi. Các thuộc tính của một điều kiện kích hoạt sẽ định cấu hình việc thực thi công việc và bằng cách đặt giá trị của các thuộc tính này, bạn có thể kiểm soát các đặc điểm của việc thực thi công việc, chẳng hạn như thời điểm thực thi công việc và tần suất thực hiện.

Hai loại điều kiện kích hoạt phổ biến nhất là điều kiện kích hoạt cron và điều kiện kích hoạt đơn giản. Trình kích hoạt cron có một thuộc tính cronExpression chỉ định lịch thực thi. Trình kích hoạt đơn giản không có thuộc tính cronExpression; bạn chỉ định startTime để cho biết thời điểm trình kích hoạt có hiệu lực và có thể là endTime (không bắt buộc).

Các thuộc tính của điều kiện kích hoạt như sau (tất cả thời gian được liệt kê đều theo giờ UTC):

Tạo biểu thức cron

Biểu thức cron là một chuỗi bao gồm 6 hoặc 7 trường được phân tách bằng khoảng trắng. Biểu thức này biểu thị một tập hợp các thời điểm, thường là dưới dạng lịch biểu để thực thi một quy trình. Các biểu thức Cron được chỉ định trong thuộc tính cronExpression của một điều kiện kích hoạt được dùng để lên lịch thực thi điều kiện kích hoạt đó.

Trong trường hợp:

Các ký tự đặc biệt được xác định như sau:

Sau đây là một số ví dụ về biểu thức cron (tất cả thời gian được liệt kê đều theo giờ UTC):

Xem các công việc đã lên lịch bằng API

Bạn có thể xem tất cả các công việc hiện được lên lịch bằng cách gửi yêu cầu GET đến /triggers?orgid={org_name}.

Ví dụ:

$ curl -H "Accept:application/json" -X GET \ "http://localhost:8080/v1/mint/triggers?orgid={org_name}" \ -u email:password

Sau đây là ví dụ về phản hồi:

[ {
  "createdDate" : 1457924378176,
  "cronExpression" : "3 0 0 * * ?",
  "enabled" : true,
  "group" : "management-server",
  "id" : "MINT.RESET_DEVELOPER_RATE_PLAN_COUNTER@@@management-server@@@DEFAULT@@@management-server@@@DEFAULT",
  "jobId" : "MINT.RESET_DEVELOPER_RATE_PLAN_COUNTER@@@management-server",
  "name" : "MINT.RESET_DEVELOPER_RATE_PLAN_COUNTER@@@management-server@@@DEFAULT",
  "priority" : "1",
  "suiteId" : "DEFAULT",
  "triggerDataMap" : {
    "custom_lock_key" : "mint.scheduler.__ORG_ID__.resetdeveloperrateplancounter@@@management"
  },
  "updatedDate" : 1457924378176
}, {
  "createdDate" : 1457924378014,
  "cronExpression" : "",
  "enabled" : true,
  "group" : "management-server",
  "id" : "MINT.ADHOC_NOTIFY@@@management-server@@@DEFAULT@@@management-server@@@DEFAULT",
  "jobId" : "MINT.ADHOC_NOTIFY@@@management-server",
  "name" : "MINT.ADHOC_NOTIFY@@@management-server@@@DEFAULT",
  "priority" : "4",
  "startTime" : "1372916749000",
  "suiteId" : "DEFAULT",
  "triggerDataMap" : {
    "custom_lock_key" : "mint.scheduler.__ORG_ID__.adhocnotify@@@management"
  },
  "updatedDate" : 1457924378014
}, {
  "createdDate" : 1457924377877,
  "cronExpression" : "0 20 1 * * ?",
  "enabled" : true,
  "group" : "management-server",
  "id" : "MINT.CHARGE_DAILY@@@management-server@@@DEFAULT@@@management-server@@@DEFAULT",
  "jobId" : "MINT.CHARGE_DAILY@@@management-server",
  "name" : "MINT.CHARGE_DAILY@@@management-server@@@DEFAULT",
  "priority" : "1",
  "suiteId" : "DEFAULT",
  "triggerDataMap" : {
    "custom_lock_key" : "mint.scheduler.__ORG_ID__.chargedaily@@@management"
  },
  "updatedDate" : 1457924377877
},
...
]

Bạn cũng có thể xem một lệnh theo lịch biểu cụ thể bằng cách gửi yêu cầu GET đến /triggers/{trig_id}, trong đó {trig_id} là thông tin nhận dạng của điều kiện kích hoạt công việc, như mô tả trong phần Tổng quan về lệnh theo lịch biểu. Ví dụ:

$ curl -X GET \ "http://localhost:8080/v1/mint/triggers/MINT.RENEW_DEV_RATEPLAN@@@management-server@@@DEFAULT@@@management-server@@@DEFAULT" \ -u email:password

Sau đây là ví dụ về phản hồi:

{
    "createdDate" : 1457924377925,
    "cronExpression" : "0 20 2 * * ?",
    "enabled" : true,
    "group" : "management-server",
    "id" : "MINT.RENEW_DEV_RATEPLAN@@@management-server@@@DEFAULT@@@management-server@@@DEFAULT",
    "jobId" : "MINT.RENEW_DEV_RATEPLAN@@@management-server",
    "name" : "MINT.RENEW_DEV_RATEPLAN@@@management-server@@@DEFAULT",
    "priority" : "1",
    "suiteId" : "DEFAULT",
    "triggerDataMap" : {
        "custom_lock_key" : "mint.scheduler.__ORG_ID__.renewydevrateplan@@@management"
    },
    "updatedDate" : 1457924377925
}

Cập nhật các công việc định kỳ bằng API

Bạn có thể cập nhật một lệnh theo lịch biểu bằng cách thay đổi các thuộc tính của trình kích hoạt. Ví dụ: bạn có thể cần thay đổi lịch thực thi của trình kích hoạt.

Đối với các tác vụ kích hoạt cron (tức là các tác vụ có chứa giá trị biểu thức cron), bạn chỉ có thể thay đổi giá trị của các thuộc tính cronExpression và enabled. Các thay đổi khác sẽ bị bỏ qua. Đối với những công việc không chỉ định giá trị biểu thức cron, bạn có thể thay đổi các thuộc tính khác, chẳng hạn như startTime hoặc priority.

Để cập nhật một lệnh theo lịch biểu, hãy gửi yêu cầu PUT đến /triggers/{trig_id}, trong đó {trig_id} là thông tin nhận dạng của trình kích hoạt công việc, như mô tả trong phần Tổng quan về lệnh theo lịch biểu. Khi thực hiện thao tác cập nhật, bạn cần chỉ định trong nội dung yêu cầu các chế độ cài đặt đã cập nhật và mã nhận dạng của điều kiện kích hoạt.

Ví dụ: yêu cầu sau đây sẽ cập nhật biểu thức cron cho tác vụ Gia hạn gói giá mới dành cho nhà phát triển để chạy hằng ngày lúc 5 giờ sáng theo giờ UTC:

$ curl -H "Content-Type: application/json" -X PUT -d \
 '{
    "cronExpression" : "0 0 5 * * ?",
    "enabled" : true,
    "group" : "management-server", 
    "id" : "MINT.RENEW_DEV_RATEPLAN@@@management-server@@@DEFAULT@@@management-server@@@DEFAULT",
    "jobId" : "MINT.RENEW_DEV_RATEPLAN@@@management-server",
    "name" : "MINT.RENEW_DEV_RATEPLAN@@@management-server@@@DEFAULT",
    "priority" : "1",
    "suiteId" : "DEFAULT",
    "triggerDataMap" : {
        "custom_lock_key" : "mint.scheduler.__ORG_ID__.renewydevrateplan@@@management"
    },
}' \
https://localhost:8080/v1/mint/triggers/MINT.RENEW_DEV_RATEPLAN@@@management-server@@@DEFAULT@@@management-server@@@DEFAULT
\
-u email:password

Tắt và bật lại một lệnh theo lịch biểu bằng API

Để tắt một lệnh theo lịch biểu, hãy đặt giá trị thuộc tính enabled của trình kích hoạt thành false. Ví dụ:

$ curl -H "Content-Type: application/json" -X PUT -d \
 '{
    "cronExpression" : "0 0 5 * * ?",
    "enabled" : false,
    "group" : "management-server",
    "id" : "MINT.RENEW_DEV_RATEPLAN@@@management-server@@@DEFAULT@@@management-server@@@DEFAULT",
    "jobId" : "MINT.RENEW_DEV_RATEPLAN@@@management-server",
    "name" : "MINT.RENEW_DEV_RATEPLAN@@@management-server@@@DEFAULT",
    "priority" : "1",
    "suiteId" : "DEFAULT",
    "triggerDataMap" : {
        "custom_lock_key" : "mint.scheduler.__ORG_ID__.renewydevrateplan@@@management"
    },
}' \
https://localhost:8080/v1/mint/triggers/MINT.RENEW_DEV_RATEPLAN@@@management-server@@@DEFAULT@@@management-server@@@DEFAULT
\
-u email:password

Để bật lại một công việc đã tắt, hãy đặt giá trị thuộc tính enabled của trình kích hoạt thành true.

Các bước tiếp theo

Bạn nên định kỳ đồng bộ hoá lại với hoạt động kiếm tiền của tổ chức và mọi nhà phát triển, ứng dụng và sản phẩm mà bạn đã tạo bằng Dịch vụ API Edge. Tìm hiểu cách Đồng bộ hoá dữ liệu Apigee Edge với tính năng kiếm tiền.