기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
GetBlock
저널의 지정된 주소에 있는 블록 객체를 반환합니다. 또한 DigestTipAddress가 제공된 경우 검증을 위해 지정된 블록의 증명을 반환합니다.
블록의 데이터 콘텐츠에 대한 자세한 내용은 Amazon QLDB 개발자 안내서의 저널 콘텐츠를 참조하세요.
지정된 원장이 존재하지 않거나 DELETING 상태에 있는 경우 ResourceNotFoundException이 발생합니다.
지정된 원장이 CREATING 상태에 있으면 ResourcePreconditionNotMetException이 발생합니다.
지정된 주소를 가진 블록이 없으면 InvalidParameterException이 발생합니다.
Request Syntax
POST /ledgers/name/block HTTP/1.1
Content-type: application/json
{
"BlockAddress": {
"IonText": "string"
},
"DigestTipAddress": {
"IonText": "string"
}
}URI 요청 파라미터
요청은 다음 URI 파라미터를 사용합니다.
- name
-
원장의 명칭입니다.
길이 제약: 최소 길이 1. 최대 길이 32.
패턴:
(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$필수 사항 여부: Yes
요청 본문
요청은 JSON 형식으로 다음 데이터를 받습니다.
- BlockAddress
-
요청하려는 블록의 위치. 주소는
strandId및sequenceNo라는 두 개의 필드로 구성된 Amazon Ion 구조입니다.예를 들면
{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:14}입니다.유형: ValueHolder객체
필수 여부: 예
- DigestTipAddress
-
증명을 요청할 다이제스트에 포함된 최신 블록 위치. 주소는
strandId및sequenceNo라는 두 개의 필드로 구성된 Amazon Ion 구조입니다.예를 들면
{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:49}입니다.유형: ValueHolder객체
필수 항목 여부: 아니요
응답 구문
HTTP/1.1 200
Content-type: application/json
{
"Block": {
"IonText": "string"
},
"Proof": {
"IonText": "string"
}
}응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
- Block
-
Amazon Ion 형식의 블록 데이터 객체입니다.
유형: ValueHolder객체
- Proof
-
GetBlock요청을 통해 반환된 Amazon Ion 형식의 증명 객체입니다. 증명은 지정된 블록부터 시작하여 Merkle 트리를 사용하여 지정된 다이제스트를 다시 계산하는 데 필요한 해시 값 목록을 포함합니다.유형: ValueHolder객체
Errors
모든 작업에서 발생하는 흔한 오류에 대한 자세한 내용은 일반적인 오류 섹션을 참조하십시오.
- InvalidParameterException
-
요청에서 하나 이상의 파라미터가 유효하지 않습니다.
HTTP 상태 코드: 400
- ResourceNotFoundException
-
지정된 리소스가 존재하지 않습니다.
HTTP 상태 코드: 404
- ResourcePreconditionNotMetException
-
조건이 미리 충족되지 않아 작업이 실패했습니다.
HTTP 상태 코드: 412
참고
언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.
