本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
ListRulesets
列出当前账户中可用的所有规则集或与特定资源(数据集)关联的规则集。
请求语法
GET /rulesets?maxResults=MaxResults
&nextToken=NextToken
&targetArn=TargetArn
HTTP/1.1
URI 请求参数
请求使用以下 URI 参数。
- MaxResults
-
此请求中要返回的最大结果数。
有效范围:最小值为 1。最大值为 100。
- NextToken
-
由生成的令牌 DataBrew ,用于指定在之前的请求被截断时在哪里继续分页。要获取下一组页面,请传入前一页调用的响应对象中的 NextToken 值。
长度限制:长度下限为 1。最大长度为 2000。
- TargetArn
-
资源(数据集)的亚马逊资源名称 (ARN)。使用此参数表示仅返回与指定资源关联的规则集。
长度约束:最小长度为 20。最大长度为 2048。
请求正文
该请求没有请求正文。
响应语法
HTTP/1.1 200
Content-type: application/json
{
"NextToken": "string",
"Rulesets": [
{
"AccountId": "string",
"CreateDate": number,
"CreatedBy": "string",
"Description": "string",
"LastModifiedBy": "string",
"LastModifiedDate": number,
"Name": "string",
"ResourceArn": "string",
"RuleCount": number,
"Tags": {
"string" : "string"
},
"TargetArn": "string"
}
]
}
响应元素
如果此操作成功,则该服务将会发送回 HTTP 200 响应。
服务以 JSON 格式返回以下数据。
- Rulesets
-
清单 RulesetItem. RulesetItem 包含规则集的元数据。
类型:RulesetItem 对象数组
- NextToken
-
可以在后续调用中用来检索下一组结果的令牌。
类型:字符串
长度限制:长度下限为 1。最大长度为 2000。
错误
有关所有操作的常见错误信息,请参阅常见错误。
- ResourceNotFoundException
-
找不到一个或多个资源。
HTTP 状态代码:404
- ValidationException
-
此请求的输入参数未通过验证。
HTTP 状态代码:400
另请参阅
有关在特定语言的 Amazon SDK 中使用此 API 的更多信息,请参阅以下内容: