# AgentCore 支払いのトラブルシューティング
<a name="payments-troubleshooting"></a>

このセクションでは、 AWS Amazon Bedrock AgentCore 支払いを使用する際の一般的なエラーの解決策を示します。

## 検証エラー
<a name="payments-troubleshooting-validation"></a>

支払いリソースを作成または更新すると、サービスは を返します`ValidationException`。次の表に、一般的な検証エラーとその解決策を示します。


| エラーメッセージ | 解像度 | 
| --- | --- | 
|  `roleArn must contain a valid account ID`  | は、12 桁のアカウント ID を持つ有効な IAM ロール ARN `roleArn`である必要があります。形式を確認します: `arn:aws:iam::<accountId>:role/<roleName>`。 | 
|  `roleArn must belong to your account`  | のアカウント ID は、発信者のアカウントと一致する`roleArn`必要があります。クロスアカウントロールはサポートされていません。 | 
|  `Invalid role ARN: {roleArn}`  | を解析`roleArn`できませんでした。ARN 形式を確認します。 | 
|  `credentialProviderConfigurations list cannot be empty`  | 支払いコネクタを作成または更新するときに、少なくとも 1 つの認証情報プロバイダー設定を指定します。 | 
|  `credentialProviderArn is required but not found in the request`  | 各認証情報プロバイダー設定には、 を含める必要があります`credentialProviderArn`。[認証情報プロバイダーの作成を使用して、最初に作成](resource-providers.md)します。 | 
|  `Connector type '{type}' does not match the provided credentialProviderConfiguration`  | 認証情報プロバイダーの設定バリアントは、コネクタタイプと一致する必要があります。たとえば、`CoinbaseCDP`コネクタには ではなく `coinbaseCDP`設定が必要です`stripePrivy`。 | 

フィールドの命名に関する制約も適用されます。
+ 支払いマネージャー名は文字で始まり、英数字 (最大 48 文字) のみを使用する必要があります。
+ 支払いコネクタ名は同じルールに従いますが、アンダースコアも許可します。
+ 説明では、英数字とスペース (最大 4096 文字) を使用できます。

## アクセス許可エラー
<a name="payments-troubleshooting-permissions"></a>


| エラーメッセージ | 解像度 | 
| --- | --- | 
|  `Access denied due to account security restrictions. Contact AWS Support for assistance.`  | アカウントが制限されています。 AWS サポートに連絡して解決してください。 | 
|  `Access denied for {CREATE\|UPDATE} due to account security restrictions. Contact AWS Support for assistance.`  | アカウントは制限付きアクセス状態です。読み取りおよびリストオペレーションは許可されますが、作成および更新オペレーションは制限が解決されるまで制限されます。 | 
| IAM SigV4 認可の失敗 | 呼び出し元のプリンシパルに適切な`bedrock-agentcore:`アクセス許可があることを確認します。このサービスは、署名名で SigV4 `bedrock-agentcore`署名を使用します。 | 
| PassRole の失敗 | を指定する場合`roleArn`、呼び出し元にはロールに対する`iam:PassRole`アクセス許可が必要です。ロールの信頼ポリシーでは、 をサービスプリンシパル`bedrock-agentcore.amazonaws.com`として許可する必要があります。 | 

## リソースが見つからないエラー
<a name="payments-troubleshooting-not-found"></a>


| エラーメッセージ | 解像度 | 
| --- | --- | 
|  `Payment manager not found: {managerId}`  | 指定された支払いマネージャーは存在しません。を呼び出して ID を確認します`ListPaymentManagers`。 | 
|  `Payment connector not found: connectorId={connectorId}, managerId={managerId}`  | 指定されたコネクタは、指定されたマネージャーの下には存在しません。を使用して両方の IDs を検証します`ListPaymentConnectors`。 | 
| 中にリソースが見つかりません `CreatePaymentConnector`  | 親支払いマネージャーが存在しません。最初に支払いマネージャーを作成します。 | 

## 競合エラー
<a name="payments-troubleshooting-conflict"></a>

サービスは、2 つのリクエストが同じリソースを同時に変更`ConflictException`するとき、または既に存在するリソースを作成するときに を返します。リクエストを再試行します。作成および更新オペレーションは、安全な再試行`clientToken`のために をサポートします。

## サービスクォータエラー
<a name="payments-troubleshooting-quota"></a>

アカウントの支払いマネージャーまたはコネクタの最大数`"{limitType} limit exceeded for account {accountId}"`に達すると、サービスは を返します。未使用のリソースを削除するか、 AWS サポートに連絡して制限の引き上げをリクエストしてください。

## スロットリングエラー
<a name="payments-troubleshooting-throttling"></a>

リクエストレートが許容制限を超える`"Rate exceeded"`と、サービスは を返します。再試行ロジックにジッターを含むエクスポネンシャルバックオフを実装します。常に制限に達した場合は、 AWS サポートにお問い合わせください。

## 支払い処理エラー
<a name="payments-troubleshooting-processing"></a>

外部支払いプロバイダーが署名リクエストを拒否すると、サービスは `AccessDeniedException`または を返します`ValidationException`。次の表に、一般的なエラーとその解決策を示します。


| エラーメッセージ | 解像度 | 
| --- | --- | 
|  `Delegated signing grant is not active for the end user wallet. Please redirect end user to the WalletHub to grant the permissions.`  | エージェントがユーザーに代わってトランザクションに署名することを許可する委任許可を付与していないか、以前に取り消しました。解決するには:[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/bedrock-agentcore/latest/devguide/payments-troubleshooting.html)<br />委任許可フローを処理するフロントエンド実装の詳細については、GitHub ウェブサイトの [Coinbase AgentCore テンプレート](https://github.com/coinbase/cdp-agentcore-template)を参照してください。ウォレットへの資金供給の詳細については、[「ウォレットへの資金供給](payments-how-it-works.md#payments-how-it-works-funding-wallet)」を参照してください。 | 
|  `Delegated signing is not enabled for your Coinbase project. Please enable delegated signing in your Coinbase project policies.`  | Coinbase デベロッパープラットフォームプロジェクトに委任署名が設定されていません。解決するには:[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/bedrock-agentcore/latest/devguide/payments-troubleshooting.html)<br />エージェントがユーザーに代わってトランザクションに署名する前に、このステップを完了する必要があります。 | 
|  `Privy credentials are invalid. Please verify the credential configuration.`  | 認証情報プロバイダーに無効または期限切れのプライベートウォレット認可キーがあります。解決するには:[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/bedrock-agentcore/latest/devguide/payments-troubleshooting.html)<br />認証情報設定の詳細については、GitHub ウェブサイトの [Privy AgentCore SDK](https://github.com/privy-io/aws-agentcore-sdk) を参照してください。 | 

## サーバーエラー
<a name="payments-troubleshooting-server"></a>

サービスは内部エラー`"Something went wrong in processing your request"`に対して を返します。しばらくしてからリクエストを再試行してください。エラーが解決しない場合は、`x-amzn-requestid`レスポンスヘッダーのリクエスト ID を使用して AWS サポートにお問い合わせください。