AWS IoT
开发人员指南
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 Amazon AWS 入门

GetPolicy

GetPolicy

获取具有默认版本策略文档的指定策略的相关信息。

https

请求语法:

GET /policies/policyName

URI 请求参数:

名称

类型

请求?

描述

policyName

PolicyName

策略的名称。

响应语法:

Content-type: application/json { "policyName": "string", "policyArn": "string", "policyDocument": "string", "defaultVersionId": "string" }

响应正文参数:

名称

类型

请求?

描述

policyName

PolicyName

策略名称。

policyArn

PolicyArn

策略 ARN。

policyDocument

PolicyDocument

描述该策略的 JSON 文档。

defaultVersionId

PolicyVersionId

默认策略版本 ID。

错误:

ResourceNotFoundException

指定的资源不存在。

HTTP 响应代码:404

InvalidRequestException

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

HTTP 响应代码:400

ThrottlingException

速率超过限制。

HTTP 响应代码:429

UnauthorizedException

您没有权限执行此操作。

HTTP 响应代码:401

ServiceUnavailableException

服务暂时不可用。

HTTP 响应代码:503

InternalFailureException

出现意外错误。

HTTP 响应代码:500

cli

摘要:

aws iot get-policy \ --policy-name <value> \ [--cli-input-json <value>] \ [--generate-cli-skeleton]

cli-input-json format:

{ "policyName": "string" }

cli-input-json 字段:

名称

类型

描述

policyName

字符串

最大长度:128,最小长度:1

模式:[w+=,.@-]+

策略的名称。

输出:

{ "policyName": "string", "policyArn": "string", "policyDocument": "string", "defaultVersionId": "string" }

cli 输出字段:

名称

类型

描述

policyName

字符串

最大长度:128,最小长度:1

模式:[w+=,.@-]+

策略名称。

policyArn

字符串

策略 ARN。

policyDocument

字符串

描述该策略的 JSON 文档。

defaultVersionId

字符串

模式:[0-9]+

默认策略版本 ID。

错误:

ResourceNotFoundException

指定的资源不存在。

InvalidRequestException

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

ThrottlingException

速率超过限制。

UnauthorizedException

您没有权限执行此操作。

ServiceUnavailableException

服务暂时不可用。

InternalFailureException

出现意外错误。