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

Bạn đang xem tài liệu về Apigee Edge.
Chuyển đến Tài liệu về Apigee X. thông tin

Tổng quan về các công việc theo lịch biểu

Hoạt động kiếm tiền cung cấp một bộ lập lịch công việc và một nhóm công việc được lên lịch trước để chạy vào thời gian quy đị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 làm việc được lên lịch để chạy (tất cả thời gian được liệt kê đều theo giờ UTC). Danh sách này cũng là yếu tố kích hoạt cho mỗi việc làm.

Ngoài những việc làm được liệt kê ở trên, có những việc làm mà bạn có thể nhận được thông qua 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 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
• Xây dựng biểu thức cron
• Xem các công việc theo lịch biểu bằng API
• Cập nhật các công việc theo lịch bằng API
• Tắt và bật lại một công việc đã lên lịch 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 phần Công việc đã lên lịch trong API tham chiếu.

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

Trình lập lịch biểu dựa vào các điều kiện kích hoạt để thực thi công việc. Một công việc đã lên lịch sẽ thực thi khi được liên kết điều kiện kích hoạt sẽ thực thi. Các thuộc tính của điều kiện kích hoạt sẽ định cấu hình 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 hiện công việc, chẳng hạn như khi một công việc lần thực thi và tần suất thực thi.

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. Điều kiện kích hoạt cron có thuộc tính cronExpression chỉ định một lịch thực thi. Một điều kiện 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 điều kiện kích hoạt có hiệu lực, và 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. Chiến lược phát hành đĩa đơn biểu thức cho một tập hợp thời gian, thường là lịch biểu thực hiện một quy trình. cron biểu thức được chỉ định trong thuộc tính cronExpression của điều kiện kích hoạt sẽ được sử dụng để lên lịch thực thi trình kích hoạt đó.

Trong trường hợp:

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

Dưới đâ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ông việc theo lịch biểu 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 một yêu cầu GET tới /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 công việc cụ thể đã lên lịch bằng cách gửi một yêu cầu GET tới /triggers/{trig_id}, trong đó {trig_id} là thông tin nhận dạng công việc như được mô tả trong Tổng quan về công việc 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 theo lịch bằng API

Bạn có thể cập nhật một công việc đã lên lịch bằng cách thay đổi các thuộc tính của điều kiện kích hoạt công việc đó. 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 công việc kích hoạt cron (tức là các công việc có bao gồm giá trị biểu thức cron), bạn chỉ có thể thay đổi giá trị của cronExpression và các thuộc tính đã bật. Các thay đổi khác là đã bỏ qua. Đối với các 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 công việc đã lên lịch, hãy gửi yêu cầu PUT tới /triggers/{trig_id}, trong đó {trig_id} là thông tin xác định điều kiện kích hoạt công việc, như mô tả trong bài viết Tổng quan về công việc theo lịch biểu. Khi 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 cập nhật biểu thức cron cho Gói giá dành cho nhà phát triển mới Công việc gia hạn sẽ chạy mỗi ngày lúc 5 giờ sáng. 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 công việc đã lên lịch bằng API

Để tắt một công việc đã lên lịch, hãy đặt giá trị thuộc tính enabled của điều kiện 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 điều kiện kích hoạt thành đúng.

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 trong tổ chức của mình và 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 thực hiện trong Đồng bộ hoá Dữ liệu Apigee Edge có bật tính năng kiếm tiền.