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