翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
UpdateJob
ジョブの JobState 値が New であるときは、ジョブに関連付けられた情報の一部を更新できます。ジョブが別のジョブの状態（通常はジョブが作成されてから 60 分以内）に変更されると、このアクションは使用できなくなります。
リクエストの構文
{
"AddressId": "string",
"Description": "string",
"ForwardingAddressId": "string",
"JobId": "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"
},
"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"
}リクエストパラメータ
すべてのアクションに共通のパラメータの詳細については、「共通パラメータ」を参照してください。
リクエストは、次のJSON形式のデータを受け入れます。
- AddressId
-
更新された Address オブジェクトのID。
型: 文字列
長さの制限: 固定長は 40 です。
パターン:
ADID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}必須: いいえ
- Description
-
このジョブの JobMetadata オブジェクトの更新された説明。
型: 文字列
長さの制限: 最小長は 1 です。最大長は 1,024 です。
パターン:
.*必須: いいえ
- ForwardingAddressId
-
このフィールドは、お住まいのリージョンではサポートされていません。
型: 文字列
長さの制限: 固定長は 40 です。
パターン:
ADID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}必須: いいえ
- JobId
-
更新するジョブのジョブ ID。たとえば、
JID123e4567-e89b-12d3-a456-426655440000。型: 文字列
長さの制限: 固定長は 39 です。
Pattern:
(M|J)ID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}必須：はい
- Notification
-
新規または更新された Notification オブジェクト。
型: Notification オブジェクト
必須：いいえ
- OnDeviceServiceConfiguration
-
転送されたデータをエクスポートまたはインポートする Snow Family デバイスのサービスを指定します。 AWS Snow Family は Amazon S3 と NFS (ネットワークファイルシステム）、および AWS Storage Gateway サービステープゲートウェイタイプをサポートしています。
型: OnDeviceServiceConfiguration オブジェクト
必須：いいえ
- PickupDetails
-
デバイスを受け取る人を識別する情報。
型: PickupDetails オブジェクト
必須：いいえ
- Resources
-
更新された
JobResourceオブジェクト、または更新された JobResource オブジェクト。型: JobResource オブジェクト
必須：いいえ
- RoleARN
-
このジョブに関連付ける新しいロール Amazon リソースネーム (ARN）。ロール を作成するにはARN、 CreateRole AWS Identity and Access Management (IAM) APIアクションを使用します。
型: 文字列
長さの制限：最大長は 255 です。
パターン:
arn:aws.*:iam::[0-9]{12}:role/.*必須: いいえ
- ShippingOption
-
このジョブの ShippingDetails オブジェクトの更新された配送オプションの値。
型: 文字列
有効な値:
SECOND_DAY | NEXT_DAY | EXPRESS | STANDARD必須：いいえ
- SnowballCapacityPreference
-
このジョブの JobMetadata オブジェクトの更新された
SnowballCapacityPreference。50 TB Snowballは、米国リージョンでのみご利用いただけます。Snow ファミリーデバイスの種類については、Snowcone ユーザーガイドのSnow ファミリーのデバイスと容量またはSnowball Edge ユーザーガイドのSnow ファミリーのデバイスと容量を参照してください。
型: 文字列
有効な値:
T50 | T80 | T100 | T42 | T98 | T8 | T14 | T32 | NoPreference | T240 | T13必須：いいえ
レスポンス要素
アクションが成功すると、サービスは空のHTTP本文で 200 HTTP レスポンスを送り返します。
エラー
すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。
- ClusterLimitExceededException
-
ジョブ作成に失敗しました。現在、クラスターは 5 つのノードをサポートしています。クラスターのノードが 5 つ未満で、このクラスター用に作成するノードの数がそれより多い場合は、クラスターのノードがちょうど 5 つになるまでジョブを作成し直してください。
HTTP ステータスコード: 400
- Ec2RequestFailedException
-
ユーザーには、試行されたアクションを実行するために必要な Amazon アクセスEC2許可がありません。
HTTP ステータスコード: 400
- InvalidInputCombinationException
-
ジョブまたはクラスターの作成に失敗しました。1 つ以上の入力が無効です。CreateCluster：SnowballType 値が CreateJob：JobType をサポートしていることを確認し、再試行してください。
HTTP ステータスコード: 400
- InvalidJobStateException
-
ジョブの現在の状態ではそのアクションの実行が許可されていないため、アクションを実行できません。
HTTP ステータスコード: 400
- InvalidResourceException
-
指定されたリソースが見つかりません。前回のリクエストで入力した情報をチェックし、もう一度お試しください。
HTTP ステータスコード: 400
- KMSRequestFailedException
-
指定された AWS Key Management Service キーには、指定された CreateJobまたは UpdateJobアクションを実行するアクセス許可がありません。
HTTP ステータスコード: 400
以下の資料も参照してください。
言語固有の のいずれかAPIでこれを使用する方法の詳細については AWS SDKs、以下を参照してください。
