확인을 위한 일반적인 오류

중요

지원 종료 알림: 기존 고객은 2025년 7월 31일 지원이 종료될 QLDB 때까지 Amazon을 사용할 수 있습니다. 자세한 내용은 아마존 QLDB 원장을 Amazon Aurora SQL Postgre로 마이그레이션을 참조하십시오.

이 섹션에서는 검증 요청 시 QLDB Amazon에서 발생하는 런타임 오류를 설명합니다.

다음은 서비스에서 반환하는 일반적인 예외 목록입니다. 각 예외에는 특정 오류 메시지, 오류가 발생할 수 있는 API 작업, 간단한 설명 및 가능한 해결 방법에 대한 제안이 포함됩니다.

IllegalArgumentException

메시지: 제공된 Ion 값이 유효하지 않아 구문 분석할 수 없습니다.

API작업: GetDigest, GetBlock, GetRevision

요청을 재시도하기 전에 유효한 Amazon Ion 값을 제공했는지 확인하세요.

IllegalArgumentException

메시지: 제공된 블록 주소가 유효하지 않습니다.

API운영: GetDigest, GetBlock, GetRevision

요청을 다시 시도하기 전에 유효한 블록 주소를 입력했는지 확인하세요. 블록 주소는 strandId 및 sequenceNo라는 두 개의 필드를 갖는 Amazon Ion 구조입니다.

예: {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는 입력한 블록 주소에 있어야 합니다. 요청을 재시도하기 전에 이 두 파라미터가 일치하는지 확인하세요.