# Problembehebung bei AgentCore Zahlungen In diesem Abschnitt finden Sie Lösungen für häufig auftretende Fehler bei der Verwendung von AWS Amazon AgentCore Bedrock-Zahlungen. ## Validierungsfehler Bei der Erstellung oder Aktualisierung von Zahlungsressourcen gibt der Service eine `ValidationException` zurück. In der folgenden Tabelle sind häufig auftretende Validierungsfehler und deren Lösungen aufgeführt. | Fehlermeldung | Auflösung | | --- | --- | | `roleArn must contain a valid account ID` | `roleArn`Es muss sich um einen gültigen IAM-Rollen-ARN mit einer 12-stelligen Konto-ID handeln. Überprüfen Sie das Format:. `arn:aws:iam:::role/` | | `roleArn must belong to your account` | Die eingegebene Konto-ID `roleArn` muss mit dem Konto des Anrufers übereinstimmen. Cross-account Rollen werden nicht unterstützt. | | `Invalid role ARN: {roleArn}` | Das `roleArn` konnte nicht analysiert werden. Überprüfen Sie das ARN-Format. | | `credentialProviderConfigurations list cannot be empty` | Geben Sie mindestens eine Konfiguration des Anmeldeinformationsanbieters an, wenn Sie einen Zahlungskonnektor erstellen oder aktualisieren. | | `credentialProviderArn is required but not found in the request` | Jede Konfiguration des Anmeldeinformationsanbieters muss eine enthalten. `credentialProviderArn` Erstellen Sie zuerst einen mit [Credential Provider erstellen](resource-providers.md). | | `Connector type '{type}' does not match the provided credentialProviderConfiguration` | Die Konfigurationsvariante des Anmeldeinformationsanbieters muss dem Connectortyp entsprechen. Zum Beispiel erfordert ein `CoinbaseCDP` Connector die `coinbaseCDP` Konfiguration, nicht`stripePrivy`. | Einschränkungen bei der Benennung von Feldern werden ebenfalls durchgesetzt: + Namen von Zahlungsmanagern müssen mit einem Buchstaben beginnen und dürfen nur alphanumerische Zeichen (maximal 48 Zeichen) enthalten. + Für Namen von Zahlungsverbindern gelten dieselben Regeln, es sind jedoch auch Unterstriche zulässig. + Beschreibungen erlauben alphanumerische Zeichen und Leerzeichen (maximal 4096 Zeichen). ## Fehler bei der Genehmigung | Fehlermeldung | Auflösung | | --- | --- | | `Access denied due to account security restrictions. Contact AWS Support for assistance.` | Ihr Konto wurde gesperrt. Wenden Sie sich AWS zur Problemlösung an den Support. | | `Access denied for {CREATE\|UPDATE} due to account security restrictions. Contact AWS Support for assistance.` | Ihr Konto befindet sich in einem Zustand mit eingeschränktem Zugriff. Lese- und Listenvorgänge sind zulässig, Erstellungs- und Aktualisierungsvorgänge sind jedoch eingeschränkt, bis die Einschränkung aufgehoben ist. | | Fehler bei der IAM-SigV4-Autorisierung | Stellen Sie sicher, dass der aufrufende Principal über die entsprechenden `bedrock-agentcore:` Berechtigungen verfügt. Der Dienst verwendet die SigV4-Signatur mit dem `bedrock-agentcore` Signaturnamen. | | PassRole Misserfolge | Bei der Bereitstellung von muss der Aufrufer über die `iam:PassRole` Berechtigung für die Rolle verfügen. `roleArn` Die Vertrauensrichtlinie der Rolle muss es `bedrock-agentcore.amazonaws.com` als Dienstprinzipal zulassen. | ## Fehler „Ressource nicht gefunden“ | Fehlermeldung | Auflösung | | --- | --- | | `Payment manager not found: {managerId}` | Der angegebene Zahlungsmanager ist nicht vorhanden. Überprüfen Sie die ID, indem Sie anrufen`ListPaymentManagers`. | | `Payment connector not found: connectorId={connectorId}, managerId={managerId}` | Der angegebene Konnektor ist unter dem angegebenen Manager nicht vorhanden. Überprüfen Sie beide IDs mit`ListPaymentConnectors`. | | Ressource wurde während nicht gefunden `CreatePaymentConnector` | Der übergeordnete Zahlungsmanager ist nicht vorhanden. Erstellen Sie zuerst den Zahlungsmanager. | ## Konfliktfehler Der Dienst gibt a zurück, `ConflictException` wenn zwei Anfragen dieselbe Ressource gleichzeitig ändern oder wenn eine Ressource erstellt wird, die bereits vorhanden ist. Wiederholen Sie die Anforderung. Erstellungs- und Aktualisierungsvorgänge unterstützen a `clientToken` für sichere Wiederholungsversuche. ## Fehler bei den Dienstkontingenten Der Service kehrt zurück`"{limitType} limit exceeded for account {accountId}"`, wenn Sie die maximale Anzahl von Zahlungsmanagern oder Konnektoren für Ihr Konto erreicht haben. Löschen Sie ungenutzte Ressourcen oder wenden Sie sich an den AWS Support, um eine Erhöhung des Limits zu beantragen. ## Drosselungsfehler Der Service kehrt zurück`"Rate exceeded"`, wenn die Anforderungsrate das zulässige Limit überschreitet. Implementieren Sie exponentielles Backoff mit Jitter in Ihre Wiederholungslogik. Wenn Sie ständig an Limits stoßen, wenden Sie sich an den AWS Support. ## Fehler bei der Zahlungsabwicklung Wenn ein externer Zahlungsanbieter die Signaturanfrage ablehnt, gibt der Dienst ein `AccessDeniedException` Oder `ValidationException` zurück. In der folgenden Tabelle sind häufig auftretende Fehler und ihre Lösungen aufgeführt. | Fehlermeldung | Auflösung | | --- | --- | | `Delegated signing grant is not active for the end user wallet. Please redirect end user to the WalletHub to grant the permissions.` | Sie haben die Delegierungsberechtigung, die es Ihrem Agenten ermöglicht, Transaktionen in Ihrem Namen zu unterzeichnen, nicht erteilt, oder Sie haben sie zuvor widerrufen. Um dies zu lösen:[See the AWS documentation website for more details](http://docs.aws.amazon.com/de_de/bedrock-agentcore/latest/devguide/payments-troubleshooting.html)
Weitere Informationen zu einer Frontend-Implementierung, die den Ablauf der Delegationsgewährung abwickelt, finden Sie in der [ AgentCore Coinbase-Vorlage](https://github.com/coinbase/cdp-agentcore-template) auf der GitHub Website. Weitere Informationen zur Finanzierung der Brieftasche finden Sie unter [Finanzierung der](payments-how-it-works.md#payments-how-it-works-funding-wallet) Brieftasche. | | `Delegated signing is not enabled for your Coinbase project. Please enable delegated signing in your Coinbase project policies.` | In Ihrem Coinbase Developer Platform-Projekt ist kein delegiertes Signieren konfiguriert. Um dies zu lösen:[See the AWS documentation website for more details](http://docs.aws.amazon.com/de_de/bedrock-agentcore/latest/devguide/payments-troubleshooting.html)
Sie müssen diesen Schritt abschließen, bevor Ihr Agent Transaktionen im Namen von Benutzern signieren kann. | | `Privy credentials are invalid. Please verify the credential configuration.` | Ihr Anmeldeinformationsanbieter hat ungültige oder abgelaufene Privy-Wallet-Autorisierungsschlüssel. Um dies zu lösen:[See the AWS documentation website for more details](http://docs.aws.amazon.com/de_de/bedrock-agentcore/latest/devguide/payments-troubleshooting.html)
Weitere Informationen zur Konfiguration von Anmeldeinformationen finden Sie im [Privy AgentCore SDK](https://github.com/privy-io/aws-agentcore-sdk) auf der GitHub Website. | ## Serverfehler Der Dienst kehrt bei internen `"Something went wrong in processing your request"` Fehlern zurück. Versuchen Sie die Anfrage nach einer kurzen Verzögerung erneut. Wenn der Fehler weiterhin besteht, wenden Sie sich mit der Anforderungs-ID aus dem `x-amzn-requestid` Antwortheader an den AWS Support.