CreateDatasetExportJob - Amazon Personalize
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

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

CreateDatasetExportJob

创建将数据从数据集导出到 Amazon S3 存储桶的作业。要允许 Amazon Personalize 导出训练数据,您必须指定一个与服务相关的 IAM 角色,以向 Amazon Personalize 提供对 Amazon S3 存储桶的 PutObject 权限。有关信息,请参阅《Amazon Personalize 开发人员指南》中的导出数据集

状态

数据集导出作业可处于以下几种状态之一:

  • CREATE PENDING > CREATE IN_PROGRESS > ACTIVE - 或 - CREATE FAILED

要获取导出作业的状态,请调用 DescribeDatasetExportJob,然后指定数据集导出作业的 Amazon 资源名称 (ARN)。当状态显示为 ACTIVE 时,数据集导出完成。如果状态显示为 CREATE FAILED,则响应中包含一个描述作业失败原因的 failureReason 键。

请求语法

{ "datasetArn": "string", "ingestionMode": "string", "jobName": "string", "jobOutput": { "s3DataDestination": { "kmsKeyArn": "string", "path": "string" } }, "roleArn": "string", "tags": [ { "tagKey": "string", "tagValue": "string" } ] }

请求参数

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

datasetArn

包含要导出的数据的数据集的 Amazon 资源名称 (ARN)。

类型:字符串

长度限制:最大长度为 256。

模式:arn:([a-z\d-]+):personalize:.*:.*:.+

必需:是

ingestionMode

要导出的数据,取决于您导入数据的方式。您可以选择仅导出使用数据集导入作业导入的 BULK 数据,也可以选择仅导出增量导入的 PUT 数据(使用控制台、PutEvents、PutUsers 和 PutItems 操作),或者同时导出这两种类型的 ALL。默认值为 PUT

类型:字符串

有效值:BULK | PUT | ALL

必需:否

jobName

数据集导出作业的名称。

类型:字符串

长度限制:长度下限为 1。最大长度为 63。

模式:^[a-zA-Z0-9][a-zA-Z0-9\-_]*

必需:是

jobOutput

指向存储作业输出的 Amazon S3 存储桶的路径。

类型:DatasetExportJobOutput 对象

必需:是

roleArn

有权向输出 Amazon S3 存储桶添加数据的 IAM 服务角色的 Amazon 资源名称 (ARN)。

类型:字符串

长度限制:最大长度为 256。

模式:arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+

必需:是

tags

要应用于数据集导出作业的标签列表。

类型:Tag 对象数组

数组成员:最少 0 项。最多 200 项。

必需:否

响应语法

{ "datasetExportJobArn": "string" }

响应元素

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

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

datasetExportJobArn

数据集导出作业的 Amazon 资源名称 (ARN)。

类型:字符串

长度限制:最大长度为 256。

模式:arn:([a-z\d-]+):personalize:.*:.*:.+

错误

InvalidInputException

为字段或参数提供有效值。

HTTP 状态代码:400

LimitExceededException

超出每秒请求次数的限制。

HTTP 状态代码:400

ResourceAlreadyExistsException

指定资源已经存在。

HTTP 状态代码:400

ResourceInUseException

指定的资源正在使用中。

HTTP 状态代码:400

ResourceNotFoundException

找不到指定的资源。

HTTP 状态代码:400

TooManyTagsException

您已超出您可以应用到此资源的最大标签数量。

HTTP 状态代码:400

另请参阅

有关在特定语言的 Amazon SDK 中使用此 API 的更多信息,请参阅以下内容: