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

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

CreateDatasetExportJob

创建将数据从数据集导出到 Amazon S3 存储桶的作业。要允许 Amazon Personalize 化导出培训数据,您必须指定一个服务相关的 IAM 角色,以授予 Amazon Personalize 化PutObject对于您的 Amazon S3 存储桶的权限。想要了解有关信息,请参阅导出数据集在 Amazon Personalize 化开发者指南中。

状态

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

  • 创建待处理 > 创建进度 > 活动-或-创建失败

要获取导出任务的状态,请致电描述数据集导出作业,然后指定数据集导出任务的 Amazon 资源名称 (ARN)。当状态显示为 ACTIVE 时,数据集导出完成。如果状态显示为 CREATE FAILED,则响应将包含failureReasonkey,它描述了作业失败的原因。

请求语法

{ "datasetArn": "string", "ingestionMode": "string", "jobName": "string", "jobOutput": { "s3DataDestination": { "kmsKeyArn": "string", "path": "string" } }, "roleArn": "string" }

请求参数

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

datasetArn

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

类型: 字符串

约束:长度上限为 256。

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

:必需 是

ingestionMode

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

类型: 字符串

有效值: BULK | PUT | ALL

:必需 否

jobName

数据集导出作业的名称。

类型: 字符串

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

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

:必需 是

jobOutput

用于存储作业输出的 Amazon S3 存储桶的路径。

类型:DatasetExportJobOutput 对象

:必需 是

roleArn

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

类型: 字符串

约束:长度上限为 256。

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

:必需 是

响应语法

{ "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

另请参阅

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