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

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

CreateJob

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

注意

订购集群任务时仅支持 Snowball; Edge 设备类型。

设备容量是可选的。

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

Snow Family 设备及其容量。
  • Snow Family 设备类型:SNC1_SSD

    • 容量:T14

    • 描述:Snowcone

  • Snow Family 设备类型:SNC1_HDD

    • 容量:T8

    • 描述:Snowcone

  • 设备类型:EDGE_S

    • 容量:T98

    • 描述:Snowball Edge 存储仅针对数据传输进行了优化

  • 设备类型:EDGE_CG

    • 容量:T42

    • 描述:使用 GPU Snowball Edge Compute Optimized

  • 设备类型:EDGE_C

    • 容量:T42

    • 描述:Snowball Edge Compute Optimized 有 GPU

  • 设备类型:EDGE

    • 容量:T100

    • 描述:使用 EC2 计算Snowball Edge Storage Optimized

  • 设备类型:标准

    • 容量:T50

    • 描述:原装 Snowball 设备

      注意

      此设备仅在宁夏、北京和新加坡可用Amazon Web Services 区域

  • 设备类型:标准

    • 容量:T80

    • 描述:原装 Snowball 设备

      注意

      此设备仅在宁夏、北京和新加坡可用Amazon Web Services 区域。

请求语法

{ "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" }, "OnDeviceServiceConfiguration": { "EKSOnDeviceService": { "EKSAnywhereVersion": "string", "KubernetesVersion": "string" }, "NFSOnDeviceService": { "StorageLimit": number, "StorageUnit": "string" }, "TGWOnDeviceService": { "StorageLimit": number, "StorageUnit": "string" } }, "RemoteManagement": "string", "Resources": { "Ec2AmiResources": [ { "AmiId": "string", "SnowballAmiId": "string" } ], "LambdaResources": [ { "EventTriggers": [ { "EventResourceARN": "string" } ], "LambdaArn": "string" } ], "S3Resources": [ { "BucketArn": "string", "KeyRange": { "BeginMarker": "string", "EndMarker": "string" }, "TargetOnDeviceServices": [ { "ServiceName": "string", "TransferOption": "string" } ] } ] }, "RoleARN": "string", "ShippingOption": "string", "SnowballCapacityPreference": "string", "SnowballType": "string", "TaxDocuments": { "IND": { "GSTIN": "string" } } }

请求参数

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

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

AddressId

您要将 Snow 设备配送到的地址的 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}

必需:否

Description

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

类型:字符串

长度限制:最小长度为 1。长度上限为 1024。

模式:.*

必需:否

DeviceConfiguration

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

有关 Snow Family 设备类型的信息,请参阅 Snowcone 用户指南中的 Sno w 系列设备和容量或 Snowb all Edge 用户指南中的 S now 系列设备和容量

类型:DeviceConfiguration 对象

必需:否

ForwardingAddressId

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

类型:字符串

长度限制:固定长度为 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想与工作关联的。 KmsKeyARN是使用 CreateKeyAmazon Key Management Service(KMS) API 操作创建的。

类型:字符串

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

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

必需:否

LongTermPricingId

设备长期定价类型的 ID。

类型:字符串

长度限制:固定长度为 41。

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

必需:否

Notification

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

类型:Notification 对象

必需:否

OnDeviceServiceConfiguration

指定 Snow Family 设备上的一个或多个服务,您传输的数据将从中导出或导入到这些服务。 AmazonSnow Family 支持 Amazon S3 和 NFS(网络文件系统)以及Amazon Storage Gateway 服务磁带网关类型。

类型:OnDeviceServiceConfiguration 对象

必需:否

RemoteManagement

允许您从内部网络外部安全地远程操作和管理 Snowcone 设备。设置为时INSTALLED_AUTOSTART,当设备到达您的位置时,远程管理将自动可用。否则,你需要使用 Snowball 客户端来管理设备。

类型:字符串

有效值: INSTALLED_ONLY | INSTALLED_AUTOSTART

必需:否

Resources

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

对于IMPORT任务,您可以指定将传输的数据导入一个或多个存储桶。

对于EXPORT任务,您可以指定要从哪个或多个存储桶中导出传输的数据。您还可以指定KeyRange值。如果您选择导出范围,则可以通过提供包含值、包含BeginMarker值或同时提供两者来定义范围的长度。EndMarker范围按 UTF-8 二进制排序。

类型:JobResource 对象

必需:否

RoleARN

RoleARN想与工作关联的。 RoleArn是使用 CreateRoleAmazon Identity and Access Management(IAM) API 操作创建的。

类型:字符串

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

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

必需:否

ShippingOption

此任务的运送速度。这个速度并不决定你多久能收到 Snow 设备,而是表示 Snow 设备在运输过程中移动到目的地的速度。区域运输速度如下:

  • 在澳大利亚,您可以使用快递运输。通常,快递运送的 Snow 设备大约在一天内送达。

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

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

  • 在美国,您可以享受一日送达和两日送达。

类型:字符串

有效值: SECOND_DAY | NEXT_DAY | EXPRESS | STANDARD

必需:否

SnowballCapacityPreference

如果你的任务是在美国的一个地区创建的,你可以选择指定你想要什么尺寸的 Snow 设备来完成这项工作。在所有其他地区,Snowballs 的存储容量为 80 TB。

有关 Snow Family 设备类型的信息,请参阅 Snowcone 用户指南中的 Sno w 系列设备和容量或 Snowb all Edge 用户指南中的 S now 系列设备和容量

类型:字符串

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

必需:否

SnowballType

用于此任务的 Snow Family 设备类型。

注意

对于集群作业,SAmazon now Family 目前仅支持EDGE设备类型。

用于此任务的 SnoAmazon w 设备类型。目前,集群任务唯一支持的设备类型为EDGE

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

有关 Snow Family 设备类型的信息,请参阅 Snowcone 用户指南中的 Sno w 系列设备和容量或 Snowb all Edge 用户指南中的 S now 系列设备和容量

类型:字符串

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

必需:否

TaxDocuments

您所需的税务文件Amazon Web Services 区域.

类型:TaxDocuments 对象

必需:否

响应语法

{ "JobId": "string" }

响应元素

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

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

JobId

例如,为任务自动生成的 IDJID123e4567-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}

错误

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

ClusterLimitExceededException

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

HTTP 状态代码:400

Ec2RequestFailedException

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

HTTP 状态代码:400

InvalidInputCombinationException

Job 或集群创建失败。一个或多个输入无效。确认CreateCluster:SnowballType值支持你的CreateJob:JobType,然后重试。

HTTP 状态代码:400

InvalidResourceException

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

HTTP 状态代码:400

KMSRequestFailedException

提供的Amazon Key Management Service密钥缺少执行指定CreateJobUpdateJob操作的权限。

HTTP 状态代码:400

另请参阅

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