翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # UpdateCluster クラスターの設定を変更します。この操作では、設定と新しい値を指定することで、1 つ以上のクラスター設定の設定内容を変更できます。 ## リクエストの構文 ``` { "ACLName": "string", "ClusterName": "string", "Description": "string", "Engine": "string", "EngineVersion": "string", "IpDiscovery": "string", "MaintenanceWindow": "string", "NodeType": "string", "ParameterGroupName": "string", "ReplicaConfiguration": { "ReplicaCount": number }, "SecurityGroupIds": [ "string" ], "ShardConfiguration": { "ShardCount": number }, "SnapshotRetentionLimit": number, "SnapshotWindow": "string", "SnsTopicArn": "string", "SnsTopicStatus": "string" } ``` ## リクエストパラメーターすべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。リクエストは以下のデータを JSON 形式で受け入れます。 ** [ACLName](#API_UpdateCluster_RequestSyntax) ** クラスターに関連付けられているアクセスコントロールリスト。タイプ: 文字列長さの制約: 最小長は 1 です。パターン: `[a-zA-Z][a-zA-Z0-9\-]*` 必須: いいえ ** [ClusterName](#API_UpdateCluster_RequestSyntax) ** 更新するクラスターの名前。タイプ: 文字列必須: はい ** [Description](#API_UpdateCluster_RequestSyntax) ** 更新するクラスターの説明。タイプ: 文字列必須: いいえ ** [Engine](#API_UpdateCluster_RequestSyntax) ** クラスターに使用するエンジンの名前。タイプ: 文字列必須: いいえ ** [EngineVersion](#API_UpdateCluster_RequestSyntax) ** ノードで実行されるエンジンのアップグレードバージョン。より新しいエンジンバージョンにアップグレードできますが、以前のエンジンバージョンにダウングレードすることはできません。以前のエンジンバージョンを使用する場合は、既存のクラスターを削除し、新たにそれを以前のエンジンバージョンで作成する必要があります。タイプ: 文字列必須: いいえ ** [IpDiscovery](#API_UpdateCluster_RequestSyntax) ** クラスター検出プロトコルの IP アドレスを検出するメカニズム。有効な値は「ipv4」または「ipv6」です。「ipv4」に設定すると、クラスタースロット、クラスターシャード、クラスターノードなどのクラスター検出関数は、クラスターノードの IPv4 アドレスを返します。「ipv6」に設定すると、クラスター検出関数はクラスターノードの IPv6 アドレスを返します。値は NetworkType パラメータと互換性がある必要があります。指定しない場合、デフォルトは「ipv4」です。型: 文字列有効な値：`ipv4 | ipv6` 必須：いいえ ** [MaintenanceWindow](#API_UpdateCluster_RequestSyntax) ** クラスターの週次メンテナンスを実行する時間範囲を指定します。範囲は ddd:hh24:mi-ddd:hh24:mi (UTC 24 時間制) の形式で指定します。最短メンテナンス期間は 60 分です。 `ddd` の有効値は、次のとおりです。 + `sun` + `mon` + `tue` + `wed` + `thu` + `fri` + `sat` 例: `sun:23:00-mon:01:30` タイプ: 文字列必須: いいえ ** [NodeType](#API_UpdateCluster_RequestSyntax) ** このクラスターをスケールアップまたはスケールダウンする有効なノードタイプ。タイプ: 文字列必須: いいえ ** [ParameterGroupName](#API_UpdateCluster_RequestSyntax) ** 更新するグループの名前。タイプ: 文字列必須: いいえ ** [ReplicaConfiguration](#API_UpdateCluster_RequestSyntax) ** 各シャードに存在するレプリカの数。型: [ReplicaConfigurationRequest](API_ReplicaConfigurationRequest.md) オブジェクト必須: いいえ ** [SecurityGroupIds](#API_UpdateCluster_RequestSyntax) ** 更新する SecurityGroupIds。型: 文字列の配列必須: いいえ ** [ShardConfiguration](#API_UpdateCluster_RequestSyntax) ** クラスター内のシャードの数。型: [ShardConfigurationRequest](API_ShardConfigurationRequest.md) オブジェクト必須: いいえ ** [SnapshotRetentionLimit](#API_UpdateCluster_RequestSyntax) ** MemoryDB によって自動クラスタースナップショットが保持される日数。この日数を超えると、自動スナップショットは削除されます。例えば、SnapshotRetentionLimit を 5 に設定すると、今日取得したスナップショットは 5 日間保持され、その後削除されます。タイプ: 整数必須: いいえ ** [SnapshotWindow](#API_UpdateCluster_RequestSyntax) ** MemoryDB が、クラスターの毎日のスナップショットの取得を開始する毎日の時間範囲 (UTC)。タイプ: 文字列必須: いいえ ** [SnsTopicArn](#API_UpdateCluster_RequestSyntax) ** 更新する SNS トピック ARN。タイプ: 文字列必須: いいえ ** [SnsTopicStatus](#API_UpdateCluster_RequestSyntax) ** Amazon SNS 通知トピックのステータス。通知はステータスがアクティブな場合にのみ送信されます。タイプ: 文字列必須: いいえ ## レスポンスの構文 ``` { "Cluster": { "ACLName": "string", "ARN": "string", "AutoMinorVersionUpgrade": boolean, "AvailabilityMode": "string", "ClusterEndpoint": { "Address": "string", "Port": number }, "DataTiering": "string", "Description": "string", "Engine": "string", "EnginePatchVersion": "string", "EngineVersion": "string", "IpDiscovery": "string", "KmsKeyId": "string", "MaintenanceWindow": "string", "MultiRegionClusterName": "string", "Name": "string", "NetworkType": "string", "NodeType": "string", "NumberOfShards": number, "ParameterGroupName": "string", "ParameterGroupStatus": "string", "PendingUpdates": { "ACLs": { "ACLToApply": "string" }, "Resharding": { "SlotMigration": { "ProgressPercentage": number } }, "ServiceUpdates": [ { "ServiceUpdateName": "string", "Status": "string" } ] }, "SecurityGroups": [ { "SecurityGroupId": "string", "Status": "string" } ], "Shards": [ { "Name": "string", "Nodes": [ { "AvailabilityZone": "string", "CreateTime": number, "Endpoint": { "Address": "string", "Port": number }, "Name": "string", "Status": "string" } ], "NumberOfNodes": number, "Slots": "string", "Status": "string" } ], "SnapshotRetentionLimit": number, "SnapshotWindow": "string", "SnsTopicArn": "string", "SnsTopicStatus": "string", "Status": "string", "SubnetGroupName": "string", "TLSEnabled": boolean } } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [Cluster](#API_UpdateCluster_ResponseSyntax) ** 更新されたクラスター。型: [Cluster](API_Cluster.md) オブジェクト ## エラーすべてのアクションに共通のエラーについては、[一般的なエラータイプ](CommonErrors.md) を参照してください。 ** ACLNotFoundFault ** HTTP ステータスコード: 400 ** ClusterNotFoundFault ** HTTP ステータスコード: 400 ** ClusterQuotaForCustomerExceededFault ** HTTP ステータスコード: 400 ** InvalidACLStateFault ** HTTP ステータスコード: 400 ** InvalidClusterStateFault ** HTTP ステータスコード: 400 ** InvalidKMSKeyFault ** HTTP ステータスコード: 400 ** InvalidNodeStateFault ** HTTP ステータスコード: 400 ** InvalidParameterCombinationException ** HTTP ステータスコード: 400 ** InvalidParameterValueException ** HTTP ステータスコード: 400 ** InvalidVPCNetworkStateFault ** HTTP ステータスコード: 400 ** NodeQuotaForClusterExceededFault ** HTTP ステータスコード: 400 ** NodeQuotaForCustomerExceededFault ** HTTP ステータスコード: 400 ** NoOperationFault ** HTTP ステータスコード: 400 ** ParameterGroupNotFoundFault ** HTTP ステータスコード: 400 ** ServiceLinkedRoleNotFoundFault ** HTTP ステータスコード: 400 ** ShardsPerClusterQuotaExceededFault ** HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/memorydb-2021-01-01/UpdateCluster) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/memorydb-2021-01-01/UpdateCluster) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/memorydb-2021-01-01/UpdateCluster) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/memorydb-2021-01-01/UpdateCluster) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/memorydb-2021-01-01/UpdateCluster) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/memorydb-2021-01-01/UpdateCluster) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/memorydb-2021-01-01/UpdateCluster) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/memorydb-2021-01-01/UpdateCluster) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/memorydb-2021-01-01/UpdateCluster) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/memorydb-2021-01-01/UpdateCluster)