用於驗證的常見錯誤 - Amazon Quantum Ledger 資料庫 (Amazon QLDB)

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

用於驗證的常見錯誤

重要

支援終止通知:現有客戶將可以使用 Amazon,QLDB直到 07/31/2025 的支援結束為止。如需詳細資訊,請參閱將 Amazon QLDB Ledger 遷移至 Amazon Aurora Postgre。SQL

本節說明 Amazon 針對驗證請求擲回QLDB的執行期錯誤。

以下是 服務傳回的常見例外清單。每個例外狀況都包含特定的錯誤訊息,接著是可擲回訊息API的操作、簡短描述,以及可能的解決方案建議。

IllegalArgumentException

訊息:提供的 Ion 值無效,無法剖析。

API 操作: GetDigest, GetBlock, GetRevision

在重試請求之前,請確定您提供有效的 Amazon Ion 值。

IllegalArgumentException

訊息:提供的區塊地址無效。

API 操作: GetDigest, GetBlock, GetRevision

在重試請求之前,請確定您提供了有效的區塊地址。區塊地址是具有兩個欄位的 Amazon Ion 結構: strandIdsequenceNo

例如:{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:14}

IllegalArgumentException

訊息:提供的摘要提示地址的序號超過了股的最新遞交記錄。

API 操作: GetDigest, GetBlock, GetRevision

您提供的摘要提示地址的序號必須小於或等於日誌股最新遞交記錄的序號。在重試請求之前,請確定您提供具有有效序號的摘要提示地址。

IllegalArgumentException

訊息:所提供區塊地址的字串 ID 無效。

API 操作: GetDigest, GetBlock, GetRevision

您提供的區塊地址必須具有與日誌的字串 ID 相符的字串 ID。在重試請求之前,請確定您提供具有有效 股 ID 的區塊地址。

IllegalArgumentException

訊息:所提供區塊地址的序號超過了股的最新遞交記錄。

API 操作: GetBlock, GetRevision

您提供的區塊地址的序號必須小於或等於股的最新遞交記錄的序號。在重試請求之前,請確定您提供具有有效序號的區塊地址。

IllegalArgumentException

訊息:所提供區塊地址的字串 ID 必須與所提供摘要提示地址的字串 ID 相符。

API 操作: GetBlock, GetRevision

如果文件修訂或區塊與您提供的摘要存在於相同的日誌鏈中,則只能驗證文件修訂或區塊。

IllegalArgumentException

訊息:提供的區塊地址序號不得大於提供的摘要提示地址序號。

API 操作: GetBlock, GetRevision

只有當文件修訂或區塊涵蓋在您提供的摘要中時,您才能驗證文件修訂或區塊。這表示它在摘要提示地址之前已遞交至日誌。

IllegalArgumentException

訊息:在指定的區塊地址的區塊中找不到提供的文件 ID。

API 操作: GetRevision

您提供的文件 ID 必須存在於您提供的區塊地址中。在重試您的請求之前,請確定這兩個參數一致。