本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
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+=,.@\-_/]+必需：是
-
要应用于数据集导出作业的标签列表。
类型：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
另请参阅
有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容：
