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 设备及其容量。

  • 设备类型：SNC1_SSD

    • 容量：T14

    • 描述：Snowcone

  • 设备类型：SNC1_HDD

    • 容量：T8

    • 描述：Snowcone

  • 设备类型：EDGE_S

    • 容量：T98

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

  • 设备类型：EDGE_CG

    • 容量：T42

    • 描述：使用 GPU 优化的 Snowball Edge 计算

  • 设备类型：EDGE_C

    • 容量：T42

    • 描述：Snowball Edge 计算在没有 GPU

  • 设备类型：边缘

    • 容量：T100

    • 描述：使用 EC2 计算优化的 Snowball 边缘存储

    注意

    此设备已被 T98 取代。

  • 设备类型：标准

    • 容量：T50

    • 描述：原装 Snowball 设备

      注意

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

  • 设备类型：标准

    • 容量：T80

    • 描述：原装 Snowball 设备

      注意

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

  • Snow Family 设备类型：RACK_5U_C

    • 容量：T13

    • 描述：雪刃。

  • 设备类型：V3_5S

    • 容量：T240

    • 描述：Snowball Edge 存储优化版 210TB

请求语法

{
   "AddressId": "string",
   "ClusterId": "string",
   "Description": "string",
   "DeviceConfiguration": { 
      "SnowconeDeviceConfiguration": { 
         "WirelessConnection": { 
            "IsWifiEnabled": boolean
         }
      }
   },
   "ForwardingAddressId": "string",
   "ImpactLevel": "string",
   "JobType": "string",
   "KmsKeyARN": "string",
   "LongTermPricingId": "string",
   "Notification": { 
      "DevicePickupSnsTopicARN": "string",
      "JobStatesToNotify": [ "string" ],
      "NotifyAll": boolean,
      "SnsTopicARN": "string"
   },
   "OnDeviceServiceConfiguration": { 
      "EKSOnDeviceService": { 
         "EKSAnywhereVersion": "string",
         "KubernetesVersion": "string"
      },
      "NFSOnDeviceService": { 
         "StorageLimit": number,
         "StorageUnit": "string"
      },
      "S3OnDeviceService": { 
         "FaultTolerance": number,
         "ServiceSize": number,
         "StorageLimit": number,
         "StorageUnit": "string"
      },
      "TGWOnDeviceService": { 
         "StorageLimit": number,
         "StorageUnit": "string"
      }
   },
   "PickupDetails": { 
      "DevicePickupId": "string",
      "Email": "string",
      "IdentificationExpirationDate": number,
      "IdentificationIssuingOrg": "string",
      "IdentificationNumber": "string",
      "Name": "string",
      "PhoneNumber": "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 系列设备和容量在里面《雪球边缘》用户指南。

类型：DeviceConfiguration 对象

必需：否

ForwardingAddressId

您所在的地区不支持此字段。

类型：字符串

长度限制：固定长度为 40。

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

必需：否

ImpactLevel

将在设备上存储或处理的数据的最高影响等级，在创建任务时提供。

类型：字符串

有效值：IL2 | IL4 | IL5 | IL6 | IL99

必需：否

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 SNS) 通知设置。

类型：Notification 对象

必需：否

OnDeviceServiceConfiguration

在 Snow Family 设备上指定 Snow Family 设备上的一个或多个服务，您传输的数据将从中导出或导入到这些服务。AmazonSnow Family 支持亚马逊 S3 和 NFS（网络文件系统）以及Amazon存储网关服务磁带网关类型。

类型：OnDeviceServiceConfiguration 对象

必需：否

PickupDetails

识别拿起设备的人的信息。

类型：PickupDetails 对象

必需：否

RemoteManagement

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

类型：字符串

有效值：INSTALLED_ONLY | INSTALLED_AUTOSTART | NOT_INSTALLED

必需：否

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 设备在运输过程中移动到目的地的速度。区域配送速度如下：

  • 在澳大利亚，您可以使用特快配送。通常，快递发货的 Snow 设备大约在一天内送达。

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

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

  • 在美国，您可以享受次日达和隔日达服务。

类型：字符串

有效值：SECOND_DAY | NEXT_DAY | EXPRESS | STANDARD

必需：否

SnowballCapacityPreference

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

有关 Snow Family 设备类型的信息，请参见Snow 系列设备和容量在里面Snowcone 用户指南要么Snow 系列设备和容量在里面《雪球边缘》用户指南。

类型：字符串

有效值：T50 | T80 | T100 | T42 | T98 | T8 | T14 | T32 | NoPreference | T240 | T13

必需：否

SnowballType

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

注意

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

的类型AmazonSnow 设备可以用来完成这项工作。当前，集群作业唯一支持的设备类型是EDGE。

有关更多信息，请参见Snowball edge 设备选项在 Snowball Edge 开发者指南中。

有关 Snow Family 设备类型的信息，请参见Snow 系列设备和容量在里面Snowcone 用户指南要么Snow 系列设备和容量在里面《雪球边缘》用户指南。

类型：字符串

有效值：STANDARD | EDGE | EDGE_C | EDGE_CG | EDGE_S | SNC1_HDD | SNC1_SSD | V3_5C | V3_5S | RACK_5U_C

必需：否

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

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

HTTP 状态代码：400

Ec2RequestFailedException

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

HTTP 状态代码：400

InvalidInputCombinationException

任务或集群创建失败。一个或多个输入无效。确认CreateCluster:SnowballType价值支持你的CreateJob:JobType，然后再试一次。

HTTP 状态代码：400

InvalidResourceException

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

HTTP 状态代码：400

KMSRequestFailedException

提供的Amazon Key Management Servicekey 缺少执行指定操作的权限CreateJob要么UpdateJob行动。

HTTP 状态代码：400

另请参阅

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