cron.edit

编辑一个计划任务.

认证和信息传输

此功能需要进行认证 authentication. I可以通过一般的 HTTP协议或者 HTTPS安全协议。

信息传输方法: HTTP POST.

参数

id 注解 1

计划任务的ID。

name 注解 1

计划任务的名称。使用值: string (255)

url (必选项)

计划任务的链接。使用值: string (2048)

status (可选项)

计划任务的状态。使用值: 1 = enabled / 0 = disabled.系统默认值1

time_out (可选项)

计划任务的超时,以秒计算。 使用值: 30 / 180 / 600 / 1800 / 3600.系统默认值30

login (可选项)

http认证所需要的用户名 (username) 使用值: string(255)

password (可选项)

http认证所需要的密码(password) 。使用值: string(32)

year (可选项)

确定计划任务执行的年份。如果有多于一个的值,值之间用逗号分开。使用值: integer (4) 或 * (= 每年). 系统默认值:*.

month (可选项)

确定计划任务执行的月份 (1 = 一月, 2 = 二月,等等).。如果有多于一个的值,值之间用逗号分开。使用值: integer 1 到 7 或 (= 每月). 系统默认值:*。

weekday (可选项)

确定计划任务执行的在一周里的日子 (1 = 周一, 2 = 周二,等等)。如果有多于一个的值,值之间用逗号分开。使用值: integer 1 到 7 或 * (= 一周力的每一天). 系统默认值:*

day (可选项)

确定计划任务执行的在月份里的日子。如果有多于一个的值,值之间用逗号分开。使用值: integer 1 到 7 或 * (= 一月里的每一天). 系统默认值:*。

hour (可选项)

确定计划任务执行的小时。如果有多于一个的值,值之间用逗号分开。使用值: integer 0 到 23 或 * (= 每小时). 系统默认值:*。

minute (可选项)

确定计划任务执行的分钟。如果有多于一个的值,值之间用逗号分开。使用值: integer 0 到 %( 或 * (= 每分钟). 系统默认值:*。

exec_delay (可选项)

确定计划任务执行的时间。单位为分钟。 此参数不可以和其它时间参数并用。使用值: integer.

 

注解 1: id 和name 可被同时使用。如果此情况出现, id 会被作为关键码来处理。如果您使用name 作为关键码,您将不能更改 name。

查询请求实例

http://api.webcron.org/cron.edit
传输的信息
id=154375&name=changedCron&url=http://www.url.com/myChangedCron.php&time_out=600&
weekday=4,6&hour=5&minute=20

服务器的反馈回答

<rsp status="ok">
   <cron id="154375" modified="2009-04-22 14:23:36" />
</rsp>