ImportModel - Amazon Comprehend

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

ImportModel

创建复制您导入的源自定义模型的新自定义模型。源模型可以在您的 AWS 账户或其他账户中。

如果源模型位于另一个 AWS 账户中,则它必须具有授权您导入该模型的基于资源的策略。

源模型必须与您导入时使用的同一 AWS 区域。您无法导入位于其他区域的模型。

请求语法

{ "DataAccessRoleArn": "string", "ModelKmsKeyId": "string", "ModelName": "string", "SourceModelArn": "string", "Tags": [ { "Key": "string", "Value": "string" } ], "VersionName": "string" }

请求参数

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

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

DataAccessRoleArn

Amazon Identity and Service (IAM) 角色的 Amazon 资源名称 (ARN),该角色允许 Amazon Key Management Service (KMS) 来加密您的自定义模型的 Amazon 资源名称 (ARN)。

类型: 字符串

长度约束: 最小长度为 20。长度上限为 2048。

模式:arn:aws(-[^:]+)?:iam::[0-9]{12}:role/.+

必需 否

ModelKmsKeyId

AWS Key Management Service (KMS) 密钥的 Amazon Key Management Service 这些区域有: ModelKmsKeyId 可以是以下任一格式之一:

  • KMS 密钥 ID:"1234abcd-12ab-34cd-56ef-1234567890ab"

  • KMS 密钥的 Amazon 资源名称 (ARN)"arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab"

类型: 字符串

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

模式:^\p{ASCII}+$

必需 否

ModelName

分配给通过此导入在 Amazon Comprehend 中创建的自定义模型的名称。

类型: 字符串

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

模式:^[a-zA-Z0-9](-*[a-zA-Z0-9])*$

必需 否

SourceModelArn

要导入的自定义模型的 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])*)?

必需 是

Tags

要与通过此导入创建的自定义模型关联的标签。标签是一个键值对,它作为元数据添加到 Amazon 资源的 Amazon Comprehend。例如,可以将以 “Sales” 作为密钥的标签添加到资源中,以指示销售部门使用该标签。

类型: 数组的Tag对象

必需 否

VersionName

此导入创建的自定义模型的版本名称。版本名称最多可包含 256 个字符。字母数字字符、连字符 (-) 和下划线 (-) 和下划线 (_) 和下划线 (_) 和下划线 版本名称在账户/AWS 区域中具有相同分类符名称的所有模型中必须是唯一的。

类型: 字符串

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

模式:^[a-zA-Z0-9](-*[a-zA-Z0-9])*$

必需 否

响应语法

{ "ModelArn": "string" }

响应元素

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

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

ModelArn

要导入的自定义模型的 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])*)?

错误

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

InternalServerException

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

HTTTTTS 状态代码:500

InvalidRequestException

该请求无效。

HTTTTTS 状态代码:400

KmsKeyValidationException

无法验证输入的 KMS 客户管理密钥 (CMK)。验证密钥并重新输入。

HTTTTTS 状态代码:400

ResourceInUseException

指定的资源名称已在使用中。使用其他名称,然后重试发送您的请求。

HTTTTTS 状态代码:400

ResourceLimitExceededException

已超过每个账户的最大资源数。检查资源,然后重试发送您的请求。

HTTTTTS 状态代码:400

ResourceNotFoundException

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

HTTTTTS 状态代码:400

ResourceUnavailableException

指定的资源不可用。检查资源并重试发送您的请求。

HTTTTTS 状态代码:400

TooManyRequestsException

请求数超过了限制。稍后重新提交您的请求。

HTTTTTS 状态代码:400

TooManyTagsException

该请求包含的标签多于可以与资源关联的标签(每个资源 50 个标签)。标签的最大数量包括现有标签和当前请求中包含的标签。

HTTTTTS 状态代码:400

另请参阅

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