全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 阿里云办公 培训与认证 物联网
弹性伸缩

查询定时任务

更新时间:2017-06-07 13:26:11

描述

查询定时任务的信息。

查询时可以指定定时触发的操作(ScheduledAction)来查询关联的定时任务。

请求参数

名称 类型 是否必须 描述
Action String 操作接口名,系统规定参数,取值:DescribeScheduledTasks。
RegionId String 定时任务所属的region。
ScheduledTaskId.N String 定时任务的ID,最多可以输入20个。查询结果会忽略失效的定时任务ID,并且不报错。
ScheduledTaskName.N String 定时任务的显示名称,最多可以输入20个。查询结果会忽略失效的定时任务名称,并且不报错。
ScheduledAction.N String 定时任务触发时需要执行的操作,最多可以输入20个。查询结果会忽略失效的操作,并且不报错。
PageNumber Integer 定时任务列表的页码,起始值为1,默认值为1。
PageSize Integer 分页查询时设置的每页行数,最大值50行,默认值为10。

返回参数

名称 类型 描述
TotalCount Integer 定时任务总数
PageNumber Integer 当前页码
PageSize Integer 每页行数
ScheduledTasks ScheduledTaskSetType 定时任务信息组成的集合

ScheduledTaskSetType是由ScheduledTaskItemType类型组成的集合:

名称 类型 描述
ScheduledTask ScheduledTaskItemType 定时任务信息

ScheduledTaskItemType类型的属性如下:

名称 类型 描述
ScheduledTaskId String 定时任务ID
ScheduledTaskName String 定时任务名称
Description String 定时任务的描述信息
ScheduledAction String 定时任务触发时需要执行的操作
LaunchTime String 定时任务触发的时间点
LaunchExpirationTime Integer 定时任务触发操作失败后,在此时间内重试
RecurrenceType String 重复执行定时任务的类型
RecurrenceValue String 重复执行定时任务的数值
RecurrenceEndTime String 重复执行定时任务的结束时间
TaskEnabled Bool 是否启动定时任务

错误码

关于所有接口的通用性错误,请参考客户端错误表服务器端错误表

示例

请求示例
  1. http://ess.aliyuncs.com/?Action=DescribeScheduledTasks
  2. &RegionId=cn-qingdao
  3. &ScheduledTaskId.1=edRtShc57WGXdt8TlPbrjsnV
  4. &PageSize=50
  5. &<公共请求参数>
返回示例

XML格式:

  1. <DescribeScheduledTasksResponse>
  2. <RequestId>B9B498DA-E836-45FF-83C7-1930492FDD5A</RequestId>
  3. <TotalCount>1</TotalCount>
  4. <PageNumber>1</PageNumber>
  5. <PageSize>50</PageSize>
  6. <ScheduledTasks>
  7. <ScheduledTask>
  8. <Description/>
  9. <LaunchExpirationTime>600</LaunchExpirationTime>
  10. <LaunchTime>2014-08-18T10:52Z</LaunchTime>
  11. <RecurrenceEndTime>2014-08-20T16:55Z</RecurrenceEndTime>
  12. <RecurrenceType>Daily</RecurrenceType>
  13. <RecurrenceValue>1</RecurrenceValue>
  14. <ScheduledAction>
  15. ari:acs:ess:cn-qingdao:1344371:scalingrule/cCBpdYdQuBe2cUxOdu6piOk
  16. </ScheduledAction>
  17. <ScheduledTaskId>edRtShc57WGXdt8TlPbrjsnV</ScheduledTaskId>
  18. <ScheduledTaskName>edRtShc57WGXdt8TlPbrjsnV</ScheduledTaskName>
  19. <TaskEnabled>true</TaskEnabled>
  20. </ScheduledTask>
  21. </ScheduledTasks>
  22. </DescribeScheduledTasksResponse>

JSON格式:

  1. {
  2. "RequestId": "43434132-91C4-4264-8343-681130760A5C",
  3. "TotalCount": 1,
  4. "PageSize": 1,
  5. "PageNumber": 1,
  6. "ScheduledTasks": {
  7. "ScheduledTask": [
  8. {
  9. "TaskEnabled": true,
  10. "ScheduledTaskId": "b27CLSc8T478c2iqHr6fqbF",
  11. "Description": "ditingshigechunqingchunan",
  12. "ScheduledTaskName": "9906a33f-14eb-42b8-8bdb-ee8cdf912706",
  13. "LaunchExpirationTime": 120,
  14. "RecurrenceType": "Daily",
  15. "RecurrenceEndTime": "2014-08-13T19:19Z",
  16. "LaunchTime": "2014-08-12T17:55Z",
  17. "RecurrenceValue": "1",
  18. "ScheduledAction": "ari:acs:ess:cn-qingdao:1344371:scalingrule/qGx9feK1giadmp3XKer94cD"
  19. }
  20. ]
  21. }
  22. }
本文导读目录