Amazon ElastiCache 用 AWS CloudFormation の使用時に発生する「400 Error Code」エラーのトラブルシューティング方法を教えてください。
Amazon ElastiCache 用 AWS CloudFormation の使用時に発生する「400 Error Code」エラーをトラブルシューティングしたいです。
簡単な説明
AWS API リクエストを直接開始するか、CloudFormation スタックを使用して開始すると、AWS は初期構文チェックを実行します。これらのチェックでは、リクエストが完全であり、すべての必須パラメータが含まれていることを検証します。チェックに合格しなかった場合、エラーが発生します。
400 Error Code の各種エラーおよび、ElastiCache に対する API リクエストを送信した際にエラーが発生する要因を次に示します。
- API リクエストスロットリングが原因でリクエストが拒否された場合、Throttling エラーが発生します。
- AWS にリクエストを完了するために十分なキャパシティがない場合、InsufficientCacheClusterCapacity エラーが発生します。
- 削除しようとしたサブネットにインスタンスが関連付けられている場合、SubnetInUse エラーが発生します。
- 使用したパラメータ値が無効であったり、サポートされていなかったり、当該リクエストでは使用できなかったりした場合、InvalidParameterValue エラーが発生します。
- リクエストのパラメーターの組み合わせが誤っているか、パラメーターが不足している場合、InvalidParameterCombination エラーが発生します。
400 Error Code のエラーを解決するには、発生した特定の ElastiCache invoke API エラーを特定し、適切な手順を実行します。
注: 発生する可能性のあるエラーとその説明のリストについては、「一般的なエラー」を参照してください。
解決策
Throttling
次のエラーメッセージが表示されます。
「Rate exceeded (Service: AmazonElastiCache; Status Code: 400; Error Code: Throttling; Request ID: ###)」
AWS アカウントレベルの API コールのクォータは、サービス固有のものではありません。特定の API コールにおけるクォータを増やしたり変更したりすることはできません。API コールは、アプリケーション、コマンドラインインターフェイス (CLI)、または AWS マネジメントコンソールからの呼び出しであっても、許容された最大の API リクエストレートを超えることはできません。
このエラーを解決するには、次の操作を行います。
- ジッター付きのエクスポネンシャルバックオフを使用して呼び出しを再試行します。
- API コールを時間の経過とともに均等に分散します。短期間に複数の API コールを行わないようにしてください。
InsufficientCacheClusterCapacity
次のエラーメッセージが表示されます。
「Cache.### (VPC) is not currently supported in the availability zone ###.Retry the launch with no availability zone or target: ###.(Service: AmazonElastiCache; Status Code: 400; Error Code: InsufficientCacheClusterCapacity; Request ID: ###)」
このエラーを解決するには、次の操作を行います。
- キャパシティは頻繁に変わるため、数分待ってからリクエストを再送信します。
- 別のキャッシュノードタイプを使用し、リクエストを再送信します。
- 別のサブネットとアベイラビリティーゾーンを使用し、リクエストを再送信します。
詳細については、「エラーメッセージ: InsufficientCacheClusterCapacity」を参照してください。
SubnetInUse
次のエラーメッセージが表示されます。
「The subnet ID subnet-### is in use (Service: AmazonElastiCache; Status Code: 400; Error Code: SubnetInUse; Request ID: ###)」
このエラーを解決するには、関連するリソースをすべてサブネットから削除してから、リクエストを再送信します。詳細については、「例」を参照してください。
InvalidParameterValue
リクエストコールの各パラメータを確認します。使用したパラメータ値が無効であったり、サポートされていなかったり、当該リクエストでは使用できなかったりした場合は、次のいずれかのエラーメッセージが表示されます。
「Invalid AuthToken provided.(Service: AmazonElastiCache; Status Code: 400; Error Code: InvalidParameterValue"; Request ID: ###)」
上記のエラーを解決するには、ElastiCache for Redis で AUTH を使用する際に、auth-token の設定が制約を満たしていることを確認してください。詳細については、「Valkey および Redis OSS の AUTH コマンドによる認証」を参照してください。
「The snapshot window and maintenance window must not overlap.(Service: AmazonElastiCache; Status Code: 400; Error Code: InvalidParameterValue; Request ID: ###)」
上記のエラーを解決するには、スナップショット期間とメンテナンス期間を別々の期間に分けてください。スナップショット期間とメンテナンス期間は、同時に設定することはできません。
「The number of replicas per node group must be within 0 and 5.(Service: AmazonElastiCache; Status Code: 400; Error Code: InvalidParameterValue; Request ID: ###)」
上記のエラーを解決するには、追加するレプリカノードを 5 個以内にします。ElastiCache for Redisは、シャードごとに 1 個のプライマリノードと、0 ～ 5 個のレプリカノードをサポートします。詳細については、「Valkey と Redis OSS のレプリケーションについて」を参照してください。
InvalidParameterCombination
リクエスト呼び出しに含まれるパラメーターの組み合わせが正しくないか、パラメーターが欠けている場合、次のエラーメッセージのいずれかが表示されることがあります。
「Cannot find version 5.0.0 for redis (Service: AmazonElastiCache; Status Code: 400; Error Code: InvalidParameterCombination; Request ID: ###)」
このエラーは、リクエスト呼び出しに含まれる Redis のバージョンがサポートされていないことを示しています。詳細については、「サポートされている Redis OSS バージョン」と「サポートされている Memcached バージョン」を参照してください。
「Cannot restore redis from 6.0.5 to 5.0.6.(Service: AmazonElastiCache; Status Code: 400; Error Code: InvalidParameterCombination; Request ID: ###)」
上記のエラーを解決するには、お使いの Redis エンジンのバージョンが現行のエンジンバージョンと同じかそれより新しいことを確認してください。ElastiCache for Redis は、バックアップを使用して新しい Redis クラスターを作成する際に、Redis エンジンバージョンのダウングレードをサポートしません。また、Redis 用 ElastiCache は、実行中の Redis クラスターの Redis エンジンをダウングレードすることはありません。詳細については、「Valkey、Memcached、および Redis OSS での独自設計キャッシュの比較」を参照してください。
「When using automatic failover, there must be at least 2 cache clusters in the replication group.(Service: AmazonElastiCache; Status Code: 400; Error Code: InvalidParameterCombination; Request ID: ###)」
上記のエラーを解決するには、1 個以上のリードレプリカが使用可能な Redis クラスターで自動フェイルオーバーを有効にします。Redis レプリケーショングループに複数のレプリカノードがあることを確認してから、リクエストを再送信してください。詳細については、「Valkey および Redis OSS でマルチ AZ を使用して ElastiCache のダウンタイムを最小化する」を参照してください。
関連情報
- 言語
- 日本語
