PutResourcePolicy - Amazon Comprehend

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

PutResourcePolicy

将基于资源的策略附加到自定义模型。您可以使用此策略授权另一个 AWS 账户中的实体导入自定义模型,该模型将在其账户的 Amazon Comprehend 中复制该模型。

请求语法

{ "PolicyRevisionId": "string", "ResourceArn": "string", "ResourcePolicy": "string" }

请求参数

有关所有操作的通用参数的信息,请参阅常见参数.

请求接受采用 JSON 格式的以下数据。

PolicyRevisionId

亚马逊理解(Amazon Comprehend)分配给您正在更新的政策的修订编号。如果您正在创建没有先前版本的新策略,请不要使用此参数。亚马逊 Comprehend 会为您创建修订编号。

类型: 字符串

长度约束:最大长度为 64。

模式:[0-9A-Fa-f]+

必需:否

ResourceArn

将策略附加到的自定义模型的 Amazon 资源名称 (ARN)。

类型: 字符串

长度约束:长度上限为 256。

模式:arn:aws(-[^:]+)?:comprehend:[a-zA-Z0-9-]*:[0-9]{12}:(document-classifier|entity-recognizer)/[a-zA-Z0-9](-*[a-zA-Z0-9])*(/version/[a-zA-Z0-9](-*[a-zA-Z0-9])*)?

必需:是

ResourcePolicy

附加到自定义模型的基于 JSON 资源的策略。将您的 JSON 作为 UTF-8 编码的字符串提供,且无换行符。要为您的策略提供有效的 JSON,请用双引号将属性名和值括起来。如果 JSON 正文也用双引号括起来,则必须对策略中的双引号进行转义:

"{\"attribute\": \"value\", \"attribute\": [\"value\"]}"

要避免转义引号,您可以使用单引号将策略括起来,并使用双引号将 JSON 名称和值括起来:

'{"attribute": "value", "attribute": ["value"]}'

类型: 字符串

长度约束:最小长度为 1。长度上限为 20000。

模式:[\u0009\u000A\u000D\u0020-\u00FF]+

必需:是

响应语法

{ "PolicyRevisionId": "string" }

响应元素

如果此操作成功,则该服务将会发送回 HTTP 200 响应。

服务以 JSON 格式返回的以下数据。

PolicyRevisionId

策略的修订 ID。每次修改策略时,Amazon Comprehend 都会分配一个新的修订 ID,并删除该策略的先前版本。

类型: 字符串

长度约束:最大长度为 64。

模式:[0-9A-Fa-f]+

错误

有关所有操作共有的错误的信息,请参阅常见错误.

InternalServerException

发生内部服务器错误。重试您的请求。

HTTP 状态代码:500

InvalidRequestException

该请求无效。

HTTP 状态代码:400

ResourceNotFoundException

找不到指定的资源 ARN。检查 ARN 并重试发送您的请求。

HTTP 状态代码:400

示例

适用于自定义模型的基于资源的策略示例

以下示例说明了一个适用于Amazon Comprehend中自定义模型的基于资源的策略。该策略允许另一个 AWS 账户中的实体导入该策略附加到的模型。该策略指定了授权的实体Principal属性,并指定模型版本的 ARNResource属性。

{ "Version": "2017-01-01", "Statement": [ { "Effect": "Allow", "Action": "comprehend:ImportModel", "Resource": [ "arn:aws:comprehend:us-west-2:111122223333:document-classifier/foo/version/*" ], "Principal": { "AWS": "arn:aws:iam::444455556666:root" } } ] }

另请参阅

有关在特定语言的 AWS 软件开发工具包中使用此 API 的更多信息,请参阅以下内容: