翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
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"
}リクエストパラメータ
すべてのアクションに共通のパラメータの詳細については、「共通パラメータ」を参照してください。
リクエストは、次の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}必須: いいえ
- ClusterId
-
更新するクラスターのクラスター 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
-
このクラスターの更新された説明。
型: 文字列
長さの制限: 最小長は 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}必須: いいえ
- Notification
-
新規または更新された Notification オブジェクト。
型: Notification オブジェクト
必須：いいえ
- OnDeviceServiceConfiguration
-
転送されたデータをエクスポートまたはインポートする Snow Family デバイスのサービスを指定します。 AWS Snow Family デバイスクラスターは Amazon S3 と NFS (ネットワークファイルシステム) をサポートしています。
型: OnDeviceServiceConfiguration オブジェクト
必須：いいえ
- Resources
-
更新された S3Resource オブジェクトまたは LambdaResource オブジェクトを含むことができる JobResource オブジェクトの更新された配列。
型: JobResource オブジェクト
必須：いいえ
- RoleARN
-
このクラスターに関連付ける新しいロール Amazon リソースネーム (ARN）。ロール を作成するにはARN、 AWS Identity and Access Management () で CreateRoleAPIアクションを使用しますIAM。
型: 文字列
長さの制限：最大長は 255 です。
パターン:
arn:aws.*:iam::[0-9]{12}:role/.*必須: いいえ
- ShippingOption
-
このクラスターの ShippingDetails オブジェクトの更新された出荷オプションの値。
型: 文字列
有効な値:
SECOND_DAY | NEXT_DAY | EXPRESS | STANDARD必須：いいえ
レスポンス要素
アクションが成功すると、サービスは空のHTTP本文で 200 HTTP レスポンスを返します。
エラー
すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。
- 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、以下を参照してください。
