As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# GetDigest
<a name="API_GetDigest"></a>

Retorna o resumo de um ledger no último bloco confirmado no diário. A resposta inclui um valor de hash de 256 bits e um endereço do bloco.

## Sintaxe da Solicitação
<a name="API_GetDigest_RequestSyntax"></a>

```
POST /ledgers/name/digest HTTP/1.1
```

## Parâmetros da Solicitação de URI
<a name="API_GetDigest_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [name](#API_GetDigest_RequestSyntax) **   <a name="qldb-GetDigest-request-uri-Name"></a>
O nome do ledger.  
Restrições de comprimento: tamanho mínimo de 1. Comprimento máximo de 32.  
Padrão: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$`   
Exigido: Sim

## Corpo da Solicitação
<a name="API_GetDigest_RequestBody"></a>

Essa solicitação não tem corpo.

## Sintaxe da resposta
<a name="API_GetDigest_ResponseSyntax"></a>

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

{
   "Digest": blob,
   "DigestTipAddress": { 
      "IonText": "string"
   }
}
```

## Elementos de Resposta
<a name="API_GetDigest_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [Digest](#API_GetDigest_ResponseSyntax) **   <a name="qldb-GetDigest-response-Digest"></a>
O valor de hash de 256 bits que representa o resumo retornado por uma solicitação. `GetDigest`  
Tipo: Objeto de dados binários codificado em Base64  
Restrições de comprimento: comprimento fixo de 32.

 ** [DigestTipAddress](#API_GetDigest_ResponseSyntax) **   <a name="qldb-GetDigest-response-DigestTipAddress"></a>
O último local do bloco coberto pelo resumo que você solicitou. Um endereço é uma estrutura Amazon Ion que tem dois campos: `strandId` e `sequenceNo`.  
Tipo: objeto [ValueHolder](API_ValueHolder.md)

## Erros
<a name="API_GetDigest_Errors"></a>

Para obter informações sobre os erros que são comuns a todas as ações, consulte [Erros comuns](CommonErrors.md).

 ** InvalidParameterException **   
Um ou mais parâmetros na solicitação não são válidos.  
Código de status HTTP: 400

 ** ResourceNotFoundException **   
O recurso especificado não existe.  
Código de status HTTP: 404

 ** ResourcePreconditionNotMetException **   
A operação falhou porque uma condição não foi satisfeita com antecedência.  
Código de status HTTP: 412

## Consulte também
<a name="API_GetDigest_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/GetDigest) 
+  [AWS SDK para .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/GetDigest) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/GetDigest) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/GetDigest) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/GetDigest) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/GetDigest) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/GetDigest) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/GetDigest) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/GetDigest) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/GetDigest)