기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# GetRevision
<a name="API_GetRevision"></a>

지정된 문서 ID 및 블록 주소의 수정본 데이터 객체를 반환합니다. 또한 `DigestTipAddress`가 제공된 경우 검증을 위해 지정된 수정본의 증명을 반환합니다.

## Request Syntax
<a name="API_GetRevision_RequestSyntax"></a>

```
POST /ledgers/name/revision HTTP/1.1
Content-type: application/json

{
   "BlockAddress": { 
      "IonText": "string"
   },
   "DigestTipAddress": { 
      "IonText": "string"
   },
   "DocumentId": "string"
}
```

## URI 요청 파라미터
<a name="API_GetRevision_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [name](#API_GetRevision_RequestSyntax) **   <a name="qldb-GetRevision-request-uri-Name"></a>
원장의 명칭입니다.  
길이 제약: 최소 길이 1. 최대 길이 32.  
패턴: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$`   
필수 여부: 예

## 요청 본문
<a name="API_GetRevision_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [BlockAddress](#API_GetRevision_RequestSyntax) **   <a name="qldb-GetRevision-request-BlockAddress"></a>
검증할 문서 수정본의 블록 위치. 주소는 `strandId` 및 `sequenceNo`라는 두 개의 필드로 구성된 Amazon Ion 구조입니다.  
예를 들어 `{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:14}`입니다.  
타입: [ValueHolder](API_ValueHolder.md)객체  
필수 여부: 예

 ** [DigestTipAddress](#API_GetRevision_RequestSyntax) **   <a name="qldb-GetRevision-request-DigestTipAddress"></a>
증명을 요청할 다이제스트에 포함된 최신 블록 위치. 주소는 `strandId` 및 `sequenceNo`라는 두 개의 필드로 구성된 Amazon Ion 구조입니다.  
예를 들어 `{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:49}`입니다.  
유형: [ValueHolder](API_ValueHolder.md)객체  
필수 여부: 아니요

 ** [DocumentId](#API_GetRevision_RequestSyntax) **   <a name="qldb-GetRevision-request-DocumentId"></a>
검증할 문서의 UUID(Base62로 인코딩된 텍스트로 표시).  
유형: 문자열  
길이 제약 조건: 고정 길이는 22입니다.  
패턴: `^[A-Za-z-0-9]+$`   
필수 여부: 예

## 응답 구문
<a name="API_GetRevision_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Proof": { 
      "IonText": "string"
   },
   "Revision": { 
      "IonText": "string"
   }
}
```

## 응답 요소
<a name="API_GetRevision_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [Proof](#API_GetRevision_ResponseSyntax) **   <a name="qldb-GetRevision-response-Proof"></a>
`GetRevision` 요청을 통해 반환된 Amazon Ion 형식의 증명 객체입니다. 증명은 지정된 문서 개정부터 시작하여 Merkle 트리를 사용하여 지정된 다이제스트를 다시 계산하는 데 필요한 해시 값 목록을 포함합니다.  
유형: [ValueHolder](API_ValueHolder.md)객체

 ** [Revision](#API_GetRevision_ResponseSyntax) **   <a name="qldb-GetRevision-response-Revision"></a>
Amazon Ion 형식의 문서 수정본 데이터 객체입니다.  
타입: [ValueHolder](API_ValueHolder.md) 객체

## 오류
<a name="API_GetRevision_Errors"></a>

모든 작업에서 발생하는 흔한 오류에 대한 자세한 내용은 [일반적인 오류](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterException **   
요청에서 하나 이상의 파라미터가 유효하지 않습니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
지정된 리소스가 존재하지 않습니다.  
HTTP 상태 코드: 404

 ** ResourcePreconditionNotMetException **   
조건이 미리 충족되지 않아 작업이 실패했습니다.  
HTTP 상태 코드: 412

## 참고
<a name="API_GetRevision_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/GetRevision) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/GetRevision) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/GetRevision) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/GetRevision) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/GetRevision) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/GetRevision) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/GetRevision) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/GetRevision) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/GetRevision) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/GetRevision)