

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# UpdateJob
<a name="API_UpdateJob"></a>

ジョブの `JobState` 値が `New` であるときは、ジョブに関連付けられた情報の一部を更新できます。ジョブが別のジョブの状態（通常はジョブが作成されてから 60 分以内）に変更されると、このアクションは使用できなくなります。

## リクエストの構文
<a name="API_UpdateJob_RequestSyntax"></a>

```
{
   "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"
}
```

## リクエストパラメータ
<a name="API_UpdateJob_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは、次のJSON形式のデータを受け入れます。

 ** [AddressId](#API_UpdateJob_RequestSyntax) **   <a name="Snowball-UpdateJob-request-AddressId"></a>
更新された [Address](API_Address.md) オブジェクトのID。  
型: 文字列  
長さの制限: 固定長は 40 です。  
パターン: `ADID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}`   
必須: いいえ

 ** [Description](#API_UpdateJob_RequestSyntax) **   <a name="Snowball-UpdateJob-request-Description"></a>
このジョブの [JobMetadata](API_JobMetadata.md) オブジェクトの更新された説明。  
型: 文字列  
長さの制限: 最小長は 1 です。最大長は 1,024 です。  
パターン: `.*`   
必須: いいえ

 ** [ForwardingAddressId](#API_UpdateJob_RequestSyntax) **   <a name="Snowball-UpdateJob-request-ForwardingAddressId"></a>
このフィールドは、お住まいのリージョンではサポートされていません。  
型: 文字列  
長さの制限: 固定長は 40 です。  
パターン: `ADID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}`   
必須: いいえ

 ** [JobId](#API_UpdateJob_RequestSyntax) **   <a name="Snowball-UpdateJob-request-JobId"></a>
更新するジョブのジョブ 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](#API_UpdateJob_RequestSyntax) **   <a name="Snowball-UpdateJob-request-Notification"></a>
新規または更新された [Notification](API_Notification.md) オブジェクト。  
型: [Notification](API_Notification.md) オブジェクト  
必須：いいえ

 ** [OnDeviceServiceConfiguration](#API_UpdateJob_RequestSyntax) **   <a name="Snowball-UpdateJob-request-OnDeviceServiceConfiguration"></a>
転送されたデータをエクスポートまたはインポートする Snow Family デバイスのサービスを指定します。 AWS Snow Family は Amazon S3 と NFS (ネットワークファイルシステム）、および AWS Storage Gateway サービステープゲートウェイタイプをサポートしています。  
型: [OnDeviceServiceConfiguration](API_OnDeviceServiceConfiguration.md) オブジェクト  
必須：いいえ

 ** [PickupDetails](#API_UpdateJob_RequestSyntax) **   <a name="Snowball-UpdateJob-request-PickupDetails"></a>
デバイスを受け取る人を識別する情報。  
型: [PickupDetails](API_PickupDetails.md) オブジェクト  
必須：いいえ

 ** [Resources](#API_UpdateJob_RequestSyntax) **   <a name="Snowball-UpdateJob-request-Resources"></a>
更新された `JobResource` オブジェクト、または更新された [JobResource](API_JobResource.md) オブジェクト。  
型: [JobResource](API_JobResource.md) オブジェクト  
必須：いいえ

 ** [RoleARN](#API_UpdateJob_RequestSyntax) **   <a name="Snowball-UpdateJob-request-RoleARN"></a>
このジョブに関連付ける新しいロール Amazon リソースネーム (ARN）。ロール を作成するにはARN、 [CreateRole](https://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateRole.html) AWS Identity and Access Management (IAM) APIアクションを使用します。  
型: 文字列  
長さの制限：最大長は 255 です。  
パターン: `arn:aws.*:iam::[0-9]{12}:role/.*`   
必須: いいえ

 ** [ShippingOption](#API_UpdateJob_RequestSyntax) **   <a name="Snowball-UpdateJob-request-ShippingOption"></a>
このジョブの [ShippingDetails](API_ShippingDetails.md) オブジェクトの更新された配送オプションの値。  
型: 文字列  
有効な値: `SECOND_DAY | NEXT_DAY | EXPRESS | STANDARD`   
必須：いいえ

 ** [SnowballCapacityPreference](#API_UpdateJob_RequestSyntax) **   <a name="Snowball-UpdateJob-request-SnowballCapacityPreference"></a>
このジョブの [JobMetadata](API_JobMetadata.md) オブジェクトの更新された `SnowballCapacityPreference`。50 TB Snowballは、米国リージョンでのみご利用いただけます。  
Snow ファミリーデバイスの種類については、*Snowcone ユーザーガイド*の[Snow ファミリーのデバイスと容量](https://docs.aws.amazon.com/snowball/latest/snowcone-guide/snow-device-types.html)または*Snowball Edge ユーザーガイド*の[Snow ファミリーのデバイスと容量](https://docs.aws.amazon.com/snowball/latest/developer-guide/snow-device-types.html)を参照してください。  
型: 文字列  
有効な値: `T50 | T80 | T100 | T42 | T98 | T8 | T14 | T32 | NoPreference | T240 | T13`   
必須：いいえ

## レスポンス要素
<a name="API_UpdateJob_ResponseElements"></a>

アクションが成功すると、サービスは空のHTTP本文で 200 HTTP レスポンスを送り返します。

## エラー
<a name="API_UpdateJob_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** ClusterLimitExceededException **   
ジョブ作成に失敗しました。現在、クラスターは 5 つのノードをサポートしています。クラスターのノードが 5 つ未満で、このクラスター用に作成するノードの数がそれより多い場合は、クラスターのノードがちょうど 5 つになるまでジョブを作成し直してください。  
HTTP ステータスコード: 400

 ** Ec2RequestFailedException **   
ユーザーには、試行されたアクションを実行するために必要な Amazon アクセスEC2許可がありません。  
HTTP ステータスコード: 400

 ** InvalidInputCombinationException **   
ジョブまたはクラスターの作成に失敗しました。1 つ以上の入力が無効です。[CreateCluster：SnowballType](API_CreateCluster.md#Snowball-CreateCluster-request-SnowballType) 値が [CreateJob：JobType](API_CreateJob.md#Snowball-CreateJob-request-JobType) をサポートしていることを確認し、再試行してください。  
HTTP ステータスコード: 400

 ** InvalidJobStateException **   
ジョブの現在の状態ではそのアクションの実行が許可されていないため、アクションを実行できません。  
HTTP ステータスコード: 400

 ** InvalidResourceException **   
指定されたリソースが見つかりません。前回のリクエストで入力した情報をチェックし、もう一度お試しください。  
HTTP ステータスコード: 400

 ** KMSRequestFailedException **   
指定された AWS Key Management Service キーには、指定された [CreateJob](API_CreateJob.md)または [UpdateJob](#API_UpdateJob)アクションを実行するアクセス許可がありません。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_UpdateJob_SeeAlso"></a>

言語固有の のいずれかAPIでこれを使用する方法の詳細については AWS SDKs、以下を参照してください。
+  [AWS コマンドラインインターフェイス](https://docs.aws.amazon.com/goto/aws-cli/snowball-2016-06-30/UpdateJob) 
+  [AWS SDK の 。NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/snowball-2016-06-30/UpdateJob)
+  [AWS SDK C\$1\$1 用](https://docs.aws.amazon.com/goto/SdkForCpp/snowball-2016-06-30/UpdateJob) 
+  [AWS SDK Go v2 の場合](https://docs.aws.amazon.com/goto/SdkForGoV2/snowball-2016-06-30/UpdateJob) 
+  [AWS SDK Java V2 用](https://docs.aws.amazon.com/goto/SdkForJavaV2/snowball-2016-06-30/UpdateJob) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/snowball-2016-06-30/UpdateJob) 
+  [AWS SDK PHP V3 用](https://docs.aws.amazon.com/goto/SdkForPHPV3/snowball-2016-06-30/UpdateJob) 
+  [AWS SDK Python 用](https://docs.aws.amazon.com/goto/boto3/snowball-2016-06-30/UpdateJob) 
+  [AWS SDK Ruby V3 用](https://docs.aws.amazon.com/goto/SdkForRubyV3/snowball-2016-06-30/UpdateJob) 