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

# GetBlock
<a name="API_GetBlock"></a>

저널의 지정된 주소에 있는 블록 객체를 반환합니다. 또한 `DigestTipAddress`가 제공된 경우 검증을 위해 지정된 블록의 증명을 반환합니다.

블록의 데이터 콘텐츠에 대한 자세한 내용은 *Amazon QLDB 개발자 안내서*의 [저널 콘텐츠](https://docs.aws.amazon.com/qldb/latest/developerguide/journal-contents.html)를 참조하세요.

지정된 원장이 존재하지 않거나 `DELETING` 상태에 있는 경우 `ResourceNotFoundException`이 발생합니다.

지정된 원장이 `CREATING` 상태에 있으면 `ResourcePreconditionNotMetException`이 발생합니다.

지정된 주소를 가진 블록이 없으면 `InvalidParameterException`이 발생합니다.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

 ** [Block](#API_GetBlock_ResponseSyntax) **   <a name="qldb-GetBlock-response-Block"></a>
Amazon Ion 형식의 블록 데이터 객체입니다.  
유형: [ValueHolder](API_ValueHolder.md)객체

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

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

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

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

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

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

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

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