AWS IoT
开发人员指南
AWS 服务或AWS文档中描述的功能,可能因地区/位置而异。请点击 Amazon AWS 入门,可查看中国地区的具体差异

CreatePolicyVersion

创建指定 AWS IoT 策略的新版本。要更新策略,请创建新策略版本。一个托管策略最多可以有五个版本。如果策略有五个版本,则在创建新版本之前,必须使用 DeletePolicyVersion 删除一个现有版本。

(可选) 您可以将新版本设置为策略的默认版本。默认版本是有效版本 (即,该版本对策略所附加到的证书生效)。

请求语法:

POST /policies/policyName/version?setAsDefault=setAsDefault Content-type: application/json { "policyDocument": "string" }

URI 请求参数:

名称

类型

请求?

描述

policyName

PolicyName

策略名称。

setAsDefault

SetAsDefault

指定是否将策略版本设置为默认版本。当此参数为 true 时,新策略版本将成为有效版本 (即,该版本对策略所附加到的证书生效)。

请求正文参数:

名称

类型

请求?

描述

policyDocument

PolicyDocument

描述该策略的 JSON 文档。最小长度为 1。最大长度为 2048,不包括空格。

响应语法:

Content-type: application/json { "policyArn": "string", "policyDocument": "string", "policyVersionId": "string", "isDefaultVersion": "boolean" }

响应正文参数:

名称

类型

请求?

描述

policyArn

PolicyArn

策略 ARN。

policyDocument

PolicyDocument

描述该策略的 JSON 文档。

policyVersionId

PolicyVersionId

策略版本 ID。

isDefaultVersion

IsDefaultVersion

指定策略版本是否为默认版本。

错误:

ResourceNotFoundException

指定的资源不存在。

HTTP 响应代码:404

MalformedPolicyException

策略文档无效。

HTTP 响应代码:400

VersionsLimitExceededException

策略版本数超过了限制。

HTTP 响应代码:409

InvalidRequestException

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

HTTP 响应代码:400

ThrottlingException

速率超过限制。

HTTP 响应代码:429

UnauthorizedException

您没有权限执行此操作。

HTTP 响应代码:401

ServiceUnavailableException

服务暂时不可用。

HTTP 响应代码:503

InternalFailureException

出现意外错误。

HTTP 响应代码:500

CLI

摘要:

aws iot create-policy-version \ --policy-name <value> \ --policy-document <value> \ [--set-as-default | --no-set-as-default] \ [--cli-input-json <value>] \ [--generate-cli-skeleton]

cli-input-json format:

{ "policyName": "string", "policyDocument": "string", "setAsDefault": "boolean" }

cli-input-json 字段:

名称

类型

描述

policyName

字符串

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

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

策略名称。

policyDocument

字符串

描述该策略的 JSON 文档。最小长度为 1。最大长度为 2048,不包括空格。

setAsDefault

布尔值

指定是否将策略版本设置为默认版本。当此参数为 true 时,新策略版本将成为有效版本 (即,该版本对策略所附加到的证书生效)。

输出:

{ "policyArn": "string", "policyDocument": "string", "policyVersionId": "string", "isDefaultVersion": "boolean" }

cli 输出字段:

名称

类型

描述

policyArn

字符串

策略 ARN。

policyDocument

字符串

描述该策略的 JSON 文档。

policyVersionId

字符串

模式:[0-9]+

策略版本 ID。

isDefaultVersion

布尔值

指定策略版本是否为默认版本。

本页内容: