本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
ListTasks
返回您创建的AWS DataSync任务的列表。
请求语法
{
"Filters": [
{
"Name": "string
",
"Operator": "string
",
"Values": [ "string
" ]
}
],
"MaxResults": number
,
"NextToken": "string
"
}
请求参数
有关所有操作的通用参数的信息,请参阅常用参数。
请求接受采用 JSON 格式的以下数据。
- Filters
-
您可以使用 API 过滤器来缩小返回的资源列表的范围
ListTasks
。例如,要检索特定源位置上的所有任务,您可以将筛选器名称LocationId
和该位置的 ARNListTasks
Operator Equals
一起使用。类型:TaskFilter 对象数组
必需:否
- MaxResults
-
要返回的任务最大数量。
类型:整数
有效范围:最小值为 0。最大值为 100。
必需:否
- NextToken
-
一个不透明的字符串,表示下一个任务列表的起始位置。
类型:字符串
长度约束:最大长度为 65535。
模式:
[a-zA-Z0-9=_-]+
必需:否
响应语法
{
"NextToken": "string",
"Tasks": [
{
"Name": "string",
"Status": "string",
"TaskArn": "string"
}
]
}
响应元素
如果此操作成功,则该服务将会发送回 HTTP 200 响应。
服务以 JSON 格式返回的以下数据。
- NextToken
-
一个不透明的字符串,表示从哪个位置开始返回下一个任务列表。
类型:字符串
长度约束:最大长度为 65535。
模式:
[a-zA-Z0-9=_-]+
- Tasks
-
返回的所有任务的列表。
类型:TaskListEntry 对象数组
错误
有关所有操作常见错误的信息,请参阅常见错误。
- InternalException
-
当AWS DataSync服务中发生错误时,会抛出此异常。
HTTP 状态代码:500
- InvalidRequestException
-
当客户端提交格式错误的请求时,会引发此异常。
HTTP 状态代码:400
另请参阅
有关在特定语言的 AWS 软件开发工具包中使用此 API 的更多信息,请参阅以下内容: