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