Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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

Restituisce un oggetto blocco a un indirizzo specificato in un diario. Restituisce inoltre una prova del blocco specificato per la verifica, se `DigestTipAddress` fornita.

Per informazioni sul contenuto dei dati in un blocco, consulta i [contenuti del Journal](https://docs.aws.amazon.com/qldb/latest/developerguide/journal-contents.html) nella *Amazon QLDB Developer Guide*.

Se il registro specificato non esiste o è in `DELETING` stato, viene generato. `ResourceNotFoundException`

Se il registro specificato è in `CREATING` stato, viene generato. `ResourcePreconditionNotMetException`

Se non esiste alcun blocco con l'indirizzo specificato, viene generato. `InvalidParameterException`

## Sintassi della richiesta
<a name="API_GetBlock_RequestSyntax"></a>

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

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

## Parametri della richiesta URI
<a name="API_GetBlock_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [name](#API_GetBlock_RequestSyntax) **   <a name="qldb-GetBlock-request-uri-Name"></a>
Il nome del libro mastro.  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 32 caratteri.  
Modello: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$`   
Campo obbligatorio: sì

## Corpo della richiesta
<a name="API_GetBlock_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [BlockAddress](#API_GetBlock_RequestSyntax) **   <a name="qldb-GetBlock-request-BlockAddress"></a>
La posizione del blocco che desideri richiedere. Un indirizzo è una struttura Amazon Ion con due campi: `strandId` e`sequenceNo`.  
Ad esempio: `{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:14}`.  
Tipo: oggetto [ValueHolder](API_ValueHolder.md)  
Campo obbligatorio: sì

 ** [DigestTipAddress](#API_GetBlock_RequestSyntax) **   <a name="qldb-GetBlock-request-DigestTipAddress"></a>
L'ultima ubicazione del blocco coperta dal digest per la quale richiedere una prova. Un indirizzo è una struttura Amazon Ion con due campi: `strandId` e`sequenceNo`.  
Ad esempio: `{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:49}`.  
Tipo: oggetto [ValueHolder](API_ValueHolder.md)  
Campo obbligatorio: no

## Sintassi della risposta
<a name="API_GetBlock_ResponseSyntax"></a>

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

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

## Elementi di risposta
<a name="API_GetBlock_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [Block](#API_GetBlock_ResponseSyntax) **   <a name="qldb-GetBlock-response-Block"></a>
L'oggetto di dati a blocchi in formato Amazon Ion.  
Tipo: oggetto [ValueHolder](API_ValueHolder.md)

 ** [Proof](#API_GetBlock_ResponseSyntax) **   <a name="qldb-GetBlock-response-Proof"></a>
L'oggetto di prova in formato Amazon Ion restituito da una `GetBlock` richiesta. Una dimostrazione contiene l'elenco dei valori hash necessari per ricalcolare il digest specificato utilizzando un albero Merkle, a partire dal blocco specificato.  
Tipo: oggetto [ValueHolder](API_ValueHolder.md)

## Errori
<a name="API_GetBlock_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** InvalidParameterException **   
Uno o più parametri nella richiesta non sono validi.  
Codice di stato HTTP: 400

 ** ResourceNotFoundException **   
La risorsa specificata non esiste.  
Codice di stato HTTP: 404

 ** ResourcePreconditionNotMetException **   
L'operazione non è riuscita perché una condizione non era soddisfatta in anticipo.  
Codice di stato HTTP: 412

## Vedi anche
<a name="API_GetBlock_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [Interfaccia a riga di comando AWS](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/GetBlock) 
+  [AWS SDK per.NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/GetBlock) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/GetBlock) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/GetBlock) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/GetBlock) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/GetBlock) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/GetBlock) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/GetBlock) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/GetBlock) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/GetBlock)