翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # UpdateCluster クラスターの `ClusterState` 値が `AwaitingQuorum` 状態にあるときは、クラスターに関連付けられた情報の一部を更新できます。クラスターが別のジョブの状態（通常はクラスターを作成した 60 分後）に変更されると、このアクションは使用できなくなります。 ## リクエストの構文 ``` { "AddressId": "string", "ClusterId": "string", "Description": "string", "ForwardingAddressId": "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" } }, "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" } ``` ## リクエストパラメータ すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。 リクエストは、次のJSON形式のデータを受け入れます。 ** [AddressId](#API_UpdateCluster_RequestSyntax) ** 更新された [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}` 必須: いいえ ** [ClusterId](#API_UpdateCluster_RequestSyntax) ** 更新するクラスターのクラスター ID。たとえば、`CID123e4567-e89b-12d3-a456-426655440000`。 型: 文字列 長さの制限: 固定長は 39 です。 Pattern: `CID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}` 必須：はい ** [Description](#API_UpdateCluster_RequestSyntax) ** このクラスターの更新された説明。 型: 文字列 長さの制限: 最小長は 1 です。最大長は 1,024 です。 パターン: `.*` 必須: いいえ ** [ForwardingAddressId](#API_UpdateCluster_RequestSyntax) ** このフィールドは、お住まいのリージョンではサポートされていません。 型: 文字列 長さの制限: 固定長は 40 です。 パターン: `ADID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}` 必須: いいえ ** [Notification](#API_UpdateCluster_RequestSyntax) ** 新規または更新された [Notification](API_Notification.md) オブジェクト。 型: [Notification](API_Notification.md) オブジェクト 必須：いいえ ** [OnDeviceServiceConfiguration](#API_UpdateCluster_RequestSyntax) ** 転送されたデータをエクスポートまたはインポートする Snow Family デバイスのサービスを指定します。 AWS Snow Family デバイスクラスターは Amazon S3 と NFS (ネットワークファイルシステム) をサポートしています。 型: [OnDeviceServiceConfiguration](API_OnDeviceServiceConfiguration.md) オブジェクト 必須：いいえ ** [Resources](#API_UpdateCluster_RequestSyntax) ** 更新された [S3Resource](API_S3Resource.md) オブジェクトまたは [LambdaResource](API_LambdaResource.md) オブジェクトを含むことができる [JobResource](API_JobResource.md) オブジェクトの更新された配列。 型: [JobResource](API_JobResource.md) オブジェクト 必須：いいえ ** [RoleARN](#API_UpdateCluster_RequestSyntax) ** このクラスターに関連付ける新しいロール Amazon リソースネーム (ARN）。ロール を作成するにはARN、 AWS Identity and Access Management () で [CreateRole](https://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateRole.html)APIアクションを使用しますIAM。 型: 文字列 長さの制限：最大長は 255 です。 パターン: `arn:aws.*:iam::[0-9]{12}:role/.*` 必須: いいえ ** [ShippingOption](#API_UpdateCluster_RequestSyntax) ** このクラスターの [ShippingDetails](API_ShippingDetails.md) オブジェクトの更新された出荷オプションの値。 型: 文字列 有効な値: `SECOND_DAY | NEXT_DAY | EXPRESS | STANDARD` 必須：いいえ ## レスポンス要素 アクションが成功すると、サービスは空のHTTP本文で 200 HTTP レスポンスを返します。 ## エラー すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。 ** 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.md)アクションを実行するアクセス許可がありません。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。 言語固有の のいずれかAPIでこれを使用する方法の詳細については AWS SDKs、以下を参照してください。 + [AWS コマンドラインインターフェイス](https://docs.aws.amazon.com/goto/aws-cli/snowball-2016-06-30/UpdateCluster) + [AWS SDK の 。NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/snowball-2016-06-30/UpdateCluster) + [AWS SDK C\$1\$1 用](https://docs.aws.amazon.com/goto/SdkForCpp/snowball-2016-06-30/UpdateCluster) + [AWS SDK Go v2 の場合](https://docs.aws.amazon.com/goto/SdkForGoV2/snowball-2016-06-30/UpdateCluster) + [AWS SDK Java V2 用](https://docs.aws.amazon.com/goto/SdkForJavaV2/snowball-2016-06-30/UpdateCluster) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/snowball-2016-06-30/UpdateCluster) + [AWS SDK PHP V3 用](https://docs.aws.amazon.com/goto/SdkForPHPV3/snowball-2016-06-30/UpdateCluster) + [AWS SDK Python 用](https://docs.aws.amazon.com/goto/boto3/snowball-2016-06-30/UpdateCluster) + [AWS SDK Ruby V3 用](https://docs.aws.amazon.com/goto/SdkForRubyV3/snowball-2016-06-30/UpdateCluster)