ListPrincipalPolicies
列出附加到指定委托人的策略。如果您使用 Cognito 身份,ID 必须使用 AmazonCognito 身份格式。
注意:此 API 已弃用。请改用 ListAttachedPolicies。
请求语法:
GET /principal-policies?marker=
marker
&pageSize=pageSize
&isAscendingOrder=ascendingOrder
x-amzn-iot-principal:principal
URI 请求参数:
名称 |
类型 |
请求? |
描述 |
---|---|---|---|
principal |
委托人 |
是 |
委托人。 |
标记 |
Marker |
否 |
用于获取下一组结果的标记。 |
pageSize |
PageSize |
否 |
结果页面大小。 |
ascendingOrder |
AscendingOrder |
否 |
指定结果的顺序。如果为 True,结果按创建顺序的升序返回。 |
响应语法:
Content-type: application/json { "policies": [ { "policyName": "string", "policyArn": "string" } ], "nextMarker": "string" }
响应正文参数:
名称 |
类型 |
请求? |
描述 |
---|---|---|---|
策略 |
策略 |
否 |
策略。 |
nextMarker |
Marker |
否 |
下一组结果的标记,没有更多结果时为 null。 |
错误:
ResourceNotFoundException
-
指定的资源不存在。
HTTP 响应代码:404
InvalidRequestException
-
请求的内容无效。例如,UpdateJobExecution 请求包含无效状态详细信息时,将返回此代码。消息包含有关错误的详细信息。
HTTP 响应代码:400
ThrottlingException
-
速率超过限制。
HTTP 响应代码:429
UnauthorizedException
-
您没有权限执行此操作。
HTTP 响应代码:401
ServiceUnavailableException
-
服务暂时不可用。
HTTP 响应代码:503
InternalFailureException
-
出现意外错误。
HTTP 响应代码:500
CLI
摘要:
aws iot list-principal-policies \ --principal <value> \ [--marker <value>] \ [--page-size <value>] \ [--ascending-order | --no-ascending-order] \ [--cli-input-json <value>] \ [--generate-cli-skeleton]
cli-input-json
format:
{ "principal": "string", "marker": "string", "pageSize": "integer", "ascendingOrder": "boolean" }
cli-input-json
字段:
名称 |
类型 |
描述 |
---|---|---|
principal |
字符串 |
委托人。 |
标记 |
字符串 模式:[A-Za-z0-9+/]+={0,2} |
用于获取下一组结果的标记。 |
pageSize |
integer java 类:java.lang.Integer 范围 - 最大值:250,最小值:1 |
结果页面大小。 |
ascendingOrder |
布尔值 |
指定结果的顺序。如果为 True,结果按创建顺序的升序返回。 |
输出:
{ "policies": [ { "policyName": "string", "policyArn": "string" } ], "nextMarker": "string" }
cli 输出字段:
名称 |
类型 |
描述 |
---|---|---|
策略 |
列表 成员:Policy java 类:java.util.List |
策略。 |
策略 |
策略 |
|
policyName |
字符串 最大长度:128,最小长度:1 模式:[w+=,.@-]+ |
策略名称。 |
policyArn |
字符串 |
策略 ARN。 |
nextMarker |
字符串 模式:[A-Za-z0-9+/]+={0,2} |
下一组结果的标记,没有更多结果时为 null。 |