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

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

CreateJob

创建作业以在 Amazon S3 和您的本地数据中心之间导入或导出数据。您的 AWS 账户必须具有正确的信任策略和权限,才能为 Snow 设备创建作业。如果要为群集中的节点创建作业,则只需提供clusterId值;其他作业属性将从群集继承。

注意

订购群集作业时,仅支持 Snowball; Edge 设备类型。

设备容量是可选的。

设备类型的可用性因 AWS 区域而异。有关区域可用性的更多信息,请参阅AWS 区域服务

AWS Snow 系列设备类型及其容量。

  • 雪系列设备类型:支持硬盘

    • 容量:T8

    • 描述:Snowcone

  • 设备类型:边缘

    • 容量:T98

    • 描述:Snowball Edge Storage Optimized Ottimized

  • 设备类型:边-CG

    • 容量:T42

    • 描述:Snowball Edge Compute Optimized with GPU

  • 设备类型:边缘 C

    • 容量:T42

    • 描述:Snowball Edge Compute Optimized

  • 设备类型:边缘

    • 容量:T100

    • 描述:Snowball Edge Storage Optimized Octimized

  • 设备类型:STANDARD

    • 容量:T50

    • 描述:原装 Snowball 设备

      注意

      此设备仅适用于宁夏、北京和新加坡 AWS 区域。

  • 设备类型:STANDARD

    • 容量:T80

    • 描述:原装 Snowball 设备

      注意

      此设备仅适用于宁夏、北京和新加坡 AWS 区域。

请求语法

{ "AddressId": "string", "ClusterId": "string", "Description": "string", "DeviceConfiguration": { "SnowconeDeviceConfiguration": { "WirelessConnection": { "IsWifiEnabled": boolean } } }, "ForwardingAddressId": "string", "JobType": "string", "KmsKeyARN": "string", "LongTermPricingId": "string", "Notification": { "JobStatesToNotify": [ "string" ], "NotifyAll": boolean, "SnsTopicARN": "string" }, "Resources": { "Ec2AmiResources": [ { "AmiId": "string", "SnowballAmiId": "string" } ], "LambdaResources": [ { "EventTriggers": [ { "EventResourceARN": "string" } ], "LambdaArn": "string" } ], "S3Resources": [ { "BucketArn": "string", "KeyRange": { "BeginMarker": "string", "EndMarker": "string" } } ] }, "RoleARN": "string", "ShippingOption": "string", "SnowballCapacityPreference": "string", "SnowballType": "string", "TaxDocuments": { "IND": { "GSTIN": "string" } } }

请求参数

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

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

AddressId

Snowte Snowized Notification Notification 的地址的 ID。

类型: 字符串

长度约束:固定长度为 40。

模式:ADID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}

:必需 否

ClusterId

集群的 ID。如果要为群集中的节点创建作业,则只需提供此clusterId值。其他作业属性是从群集继承的。

类型: 字符串

长度约束:固定长度为 39。

模式:CID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}

:必需 否

描述

定义此特定作业的可选描述,例如Important Photos 2016-08-11

类型: 字符串

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

:必需 否

DeviceConfiguration

定义 AWS Snowcone 作业的设备配置。

有关 SnowSnow Storage Notification 的信息,请参阅雪系列设备和容量中的Snowcone 用户指南或者雪系列设备和容量中的Snowball Edge 用户指南

类型:DeviceConfiguration 对象

:必需 否

转发地址 d

您所在区域内不支持此字段。

类型: 字符串

长度约束:固定长度为 40。

模式:ADID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}

:必需 否

JobType

定义要创建的作业类型。

类型: 字符串

有效值: IMPORT | EXPORT | LOCAL_USE

:必需 否

KmsKeyARN

这些区域有:KmsKeyARN您希望与此作业关联的对象键。KmsKeyARNs 是使用CreateKeyAWS Key Management Service (KMS) API 操作。

类型: 字符串

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

模式:arn:aws.*:kms:.*:[0-9]{12}:key/.*

:必需 否

长期价格信息

设备的长期定价类型的 ID。

类型: 字符串

长度约束:固定长度为 41。

模式:LTPID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}

:必需 否

通知

定义此任务的 Amazon Simple Notification Service (Amazon SNS) 通知设置。

类型:Notification 对象

:必需 否

资源

定义与此任务关联的 Amazon S3 存储桶。

IMPORT作业中,您可以指定将传输的数据导入到的一个或多个存储桶。

EXPORT作业时,您可以指定将传输数据从中导出的一个或多个存储桶。或者,也可以指定KeyRange值。如果您选择导出特定范围的对象键,您可以通过提供包含范围的大小,来定义范围的大小。BeginMarker值,一个包容性EndMarker值,或者两者。范围按 UTF-8 二进制排序。

类型:JobResource 对象

:必需 否

RoleARN

这些区域有:RoleARN您希望与此作业关联的对象键。RoleArns 是使用CreateRoleAWS Identity and Access Management (IAM) API 操作。

类型: 字符串

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

模式:arn:aws.*:iam::[0-9]{12}:role/.*

:必需 否

ShippingOption

此作业的配送速度。此速度并不决定您将多久获得 Snow 设备,而是代表 Snow 设备在运输途中移动到目的地的速度。区域配送速度如下所示:

  • 在澳大利亚,您可以使用快递运输。通常,SnowEdge Storage Notification 大约需要一天时间。

  • 在欧盟 (EU),您可以使用快递运输。通常,SnowEdge Storage Notification 大约需要一天时间。此外,欧盟的大多数国家/地区还可以使用标准运输,通常单程需要的时间不超过一周。

  • 在印度,雪设备在一到七天内交付。

  • 在美国,您可以选择一日送达和两日送达。

类型: 字符串

有效值: SECOND_DAY | NEXT_DAY | EXPRESS | STANDARD

:必需 否

SnowballCapacityPreference

如果您的作业是在美国某个地区创建的,您可以选择为此作业指定希望使用的 Snow 设备大小。在所有其他地区,雪球都有 80 TB 的存储容量。

有关 SnowSnow Storage Notification 的信息,请参阅雪系列设备和容量中的Snowcone 用户指南或者雪系列设备和容量中的Snowball Edge 用户指南

类型: 字符串

有效值: T50 | T80 | T100 | T42 | T98 | T8 | T14 | NoPreference

:必需 否

SnowballType

用于此任务的 AWS Snow 系列设备的类型。

注意

对于集群作业,AWS Snow 系列目前仅支持EDGE设备类型。

用于此任务的 AWS Snow 设备的类型。目前,群集作业唯一支持的设备类型是EDGE

有关更多信息,请参阅 。Snowball Edge 设备选项在 Snowball Edge 开发人员指南中。

有关 SnowSnow Storage Notification 的信息,请参阅雪系列设备和容量中的Snowcone 用户指南或者雪系列设备和容量中的Snowball Edge 用户指南

类型: 字符串

有效值: STANDARD | EDGE | EDGE_C | EDGE_CG | EDGE_S | SNC1_HDD | SNC1_SSD

:必需 否

税务文件

您的 AWS 区域所需的税务文件。

类型:TaxDocuments 对象

:必需 否

响应语法

{ "JobId": "string" }

响应元素

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

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

JobId

自动生成的作业 ID,例如JID123e4567-e89b-12d3-a456-426655440000

类型: 字符串

长度约束:固定长度为 39。

模式:(M|J)ID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}

Errors

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

集群限制性贴身感觉

创建 Job 失败。目前,群集支持五个节点。如果您的集群有少于五个节点,并且要为此群集创建更多节点,请重试并创建作业,直到您的集群正好有五个节点为止。

HTTP 状态代码:400

EC2 请求失败操作

您的 IAM 用户缺乏执行尝试操作所需的 Amazon EC2 权限。

HTTP 状态代码:400

无效的输入组合异常

Job 或集群创建失败。一个或多个输入无效。确认创作群集:雪球型值支持您的创建作业:作业类型,然后重试。

HTTP 状态代码:400

无效资源异常

找不到指定的资源。请检查您在上次请求中提供的信息,然后重试。

HTTP 状态代码:400

KMS 请求失败程序

提供的 AWS Key Management Service 密钥缺乏执行指定CreateJob或者UpdateJobaction.

HTTP 状态代码:400