View a markdown version of this page

AgentCore 支払いのトラブルシューティング - Amazon Bedrock AgentCore
検証エラーアクセス許可エラーリソースが見つからないエラー競合エラーサービスクォータエラースロットリングエラー支払い処理エラーサーバーエラー

AgentCore 支払いのトラブルシューティング

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

検証エラー

支払いリソースを作成または更新すると、サービスは を返します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。認証情報プロバイダーの作成を使用して、最初に作成します。

Connector type '{type}' does not match the provided credentialProviderConfiguration

認証情報プロバイダーの設定バリアントは、コネクタタイプと一致する必要があります。たとえば、CoinbaseCDPコネクタには ではなく coinbaseCDP設定が必要ですstripePrivy。

フィールドの命名に関する制約も適用されます。

  • 支払いマネージャー名は文字で始まり、英数字 (最大 48 文字) のみを使用する必要があります。

  • 支払いコネクタ名は同じルールに従いますが、アンダースコアも許可します。

  • 説明では、英数字とスペース (最大 4096 文字) を使用できます。

アクセス許可エラー

エラーメッセージ 解像度

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として許可する必要があります。

リソースが見つからないエラー

エラーメッセージ 解像度

Payment manager not found: {managerId}

指定された支払いマネージャーは存在しません。を呼び出して ID を確認しますListPaymentManagers。

Payment connector not found: connectorId={connectorId}, managerId={managerId}

指定されたコネクタは、指定されたマネージャーの下には存在しません。を使用して両方の IDs を検証しますListPaymentConnectors。

中にリソースが見つかりません CreatePaymentConnector

親支払いマネージャーが存在しません。最初に支払いマネージャーを作成します。

競合エラー

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

サービスクォータエラー

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

スロットリングエラー

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

支払い処理エラー

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

エラーメッセージ 解像度

Delegated signing grant is not active for the end user wallet. Please redirect end user to the WalletHub to grant the permissions.

エージェントがユーザーに代わってトランザクションに署名することを許可する委任許可を付与していないか、以前に取り消しました。解決するには:

  1. CreatePaymentInstrument またはGetPaymentInstrumentレスポンス本文 () から WalletHub URL を取得しますpaymentInstrumentDetails.redirectUrl。

  2. ユーザーを WalletHub にリダイレクトします。

  3. サインインし、エージェントに署名権限を付与します。

委任許可フローを処理するフロントエンド実装の詳細については、GitHub ウェブサイトの Coinbase AgentCore テンプレートを参照してください。ウォレットへの資金供給の詳細については、「ウォレットへの資金供給」を参照してください。

Delegated signing is not enabled for your Coinbase project. Please enable delegated signing in your Coinbase project policies.

Coinbase デベロッパープラットフォームプロジェクトに委任署名が設定されていません。解決するには:

  1. Coinbase ウェブサイトの Coinbase 開発者プラットフォームにサインインします。

  2. プロジェクトのポリシー設定に移動します。

  3. 委任署名トグルを有効にします。

エージェントがユーザーに代わってトランザクションに署名する前に、このステップを完了する必要があります。

Privy credentials are invalid. Please verify the credential configuration.

認証情報プロバイダーに無効または期限切れのプライベートウォレット認可キーがあります。解決するには:

  1. Privy ウェブサイトの Privy Dashboard にサインインします。

  2. アプリの設定に移動し、認可キーがアクティブであることを確認します。

  3. AgentCore Identity の認証情報プロバイダーを現在のキーで更新します。これを行うには、Secrets Manager で AWS シークレットを呼び出すUpdatePaymentConnectorか、更新します。

認証情報設定の詳細については、GitHub ウェブサイトの Privy AgentCore SDK を参照してください。

サーバーエラー

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