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> |