CreateJob

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

注意

订购群集作业时，仅支持 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 Storage Storage Storage Optimized
设备类型：EDGE_CG
- 容量：T42
- 描述：Snowball Edge Compute Optimized with GPU
设备类型：EDGE_C
- 容量：T42
- 描述：无需 GPU Snowball Edge Compute Optimized
设备类型：边缘
- 容量：T100
- 描述：借助 EC2 计算 Snowball Edge Storage Optimized S
设备类型：标准
- 容量：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": { 
      "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 设备类型的信息，请参阅Snow 系列设备和容量中的Snowcone 用户指南要么Snow 系列设备和容量中的Snowball Edge 用户指南.

类型：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你要关联到这份工作。KmsKeyARNs 是使用CreateKey Amazon 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

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

类型：Notification 对象

：必需否

OnDeviceServiceConfiguration

指定 Snow Family 设备上将传输的数据导出或导入到的服务。AmazonSnow Family 支持 Amazon S3 和 NFS（网络文件系统）和AmazonStorage Gateway 服务磁带网关类型。

类型：OnDeviceServiceConfiguration 对象

：必需否

RemoteManagement

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

类型: 字符串

有效值: INSTALLED_ONLY | INSTALLED_AUTOSTART

：必需否

Resources

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

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

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

类型：JobResource 对象

：必需否

RoleARN

这些区域有：RoleARN你要关联到这份工作。RoleArns 是使用CreateRole Amazon Identity and Access Management(IAM) API 操作。

类型: 字符串

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

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

：必需否

ShippingOption

这项工作的运输速度。这种速度并不决定您多久将获得 Snow 设备，而是代表 Snow 设备在运输过程中移动到目的地的速度。区域运输速度如下所示：

在澳大利亚，您可以使用快递。通常，快递运输的 Snowball 设备大约需要一天时间。
在欧盟（EU），您可以使用快递。通常，快递运输的 Snowball 设备大约需要一天时间。此外，欧盟的大多数国家/地区还可以使用标准运输，通常单程需要的时间不超过一周。
在印度，Snow 设备在一到七天内交付。
在美国，您可以选择一日送达和两日送达。

类型: 字符串

有效值: SECOND_DAY | NEXT_DAY | EXPRESS | STANDARD

：必需否

SnowballCapacityPreference

如果您的作业是在其中一个美国地区创建的，那么您可以选择为此作业指定想要的 Snow 设备的尺寸。在所有其他地区，Snowball 的存储容量为 80 TB。

有关 Snow Family 设备类型的信息，请参阅Snow 系列设备和容量中的Snowcone 用户指南要么Snow 系列设备和容量中的Snowball Edge 用户指南.

类型: 字符串

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

：必需否

SnowballType

用于此作业的 Snow Family 设备的类型。

注意

对于群集作业，AmazonSnowball Family 目前仅支持EDGE设备类型。

类型Amazon用于此工作的 Snow 设备。目前群集作业唯一支持的设备类型为EDGE.

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

有关 Snow Family 设备类型的信息，请参阅Snow 系列设备和容量中的Snowcone 用户指南要么Snow 系列设备和容量中的Snowball Edge 用户指南.

类型: 字符串

：必需否

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

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

HTTP 状态代码：400

InvalidInputCombinationException

创建 Job 或群集失败。一个或多个输入无效。确认创建群集：雪球类型值支持创建职位：职位类型，然后重试。

HTTP 状态代码：400

InvalidResourceException

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

HTTP 状态代码：400

KMSRequestFailedException

提供的Amazon Key Management Servicekey 缺乏执行指定的权限CreateJob要么UpdateJobaction.

HTTP 状态代码：400

另请参阅

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

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

CreateCluster

CreateLongTermPricing