登录控制台
AWS IoT
开发人员指南
AWS 文档 » AWS IoT » 开发人员指南 » IOT 命令 » ListPrincipalPolicies
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 Amazon AWS 入门。

ListPrincipalPolicies

ListPrincipalPolicies

列出附加到指定委托人的策略。如果您使用 Cognito 身份，ID 必须使用 AmazonCognito 身份格式。

注意：此 API 已弃用。请改用 ListAttachedPolicies。

https

请求语法：

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

范围 - 最大值：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。

错误:

ResourceNotFoundException

指定的资源不存在。

InvalidRequestException

请求的内容无效。例如，UpdateJobExecution 请求包含无效状态详细信息时，将返回此代码。消息包含有关错误的详细信息。

ThrottlingException

速率超过限制。

UnauthorizedException

您没有权限执行此操作。

ServiceUnavailableException

服务暂时不可用。

InternalFailureException

出现意外错误。