Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

Renvoie un objet de type bloc à une adresse spécifiée dans un journal. Renvoie également une preuve du bloc spécifié pour vérification si elle `DigestTipAddress` est fournie.

Pour plus d'informations sur le contenu des données d'un bloc, consultez le [contenu du journal](https://docs.aws.amazon.com/qldb/latest/developerguide/journal-contents.html) dans le manuel *Amazon QLDB Developer Guide*.

Si le registre spécifié n'existe pas ou est en `DELETING` état, il est lancé. `ResourceNotFoundException`

Si le registre spécifié est en `CREATING` état, il lance`ResourcePreconditionNotMetException`.

Si aucun bloc n'existe avec l'adresse spécifiée, il est lancé`InvalidParameterException`.

## Syntaxe de la demande
<a name="API_GetBlock_RequestSyntax"></a>

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

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

## Paramètres de demande URI
<a name="API_GetBlock_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [name](#API_GetBlock_RequestSyntax) **   <a name="qldb-GetBlock-request-uri-Name"></a>
Nom du registre.  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 32.  
Modèle : `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$`   
Obligatoire : oui

## Corps de la demande
<a name="API_GetBlock_RequestBody"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [BlockAddress](#API_GetBlock_RequestSyntax) **   <a name="qldb-GetBlock-request-BlockAddress"></a>
L'emplacement du bloc que vous souhaitez demander. Une adresse est une structure Amazon Ion qui comporte deux champs : `strandId` et`sequenceNo`.  
Par exemple : `{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:14}`.  
Type : objet [ValueHolder](API_ValueHolder.md)  
Obligatoire : oui

 ** [DigestTipAddress](#API_GetBlock_RequestSyntax) **   <a name="qldb-GetBlock-request-DigestTipAddress"></a>
Le dernier emplacement du bloc couvert par le résumé pour lequel une preuve doit être demandée. Une adresse est une structure Amazon Ion qui comporte deux champs : `strandId` et`sequenceNo`.  
Par exemple : `{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:49}`.  
Type : objet [ValueHolder](API_ValueHolder.md)  
Obligatoire : non

## Syntaxe de la réponse
<a name="API_GetBlock_ResponseSyntax"></a>

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

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

## Eléments de réponse
<a name="API_GetBlock_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [Block](#API_GetBlock_ResponseSyntax) **   <a name="qldb-GetBlock-response-Block"></a>
L'objet de données de bloc au format Amazon Ion.  
Type : objet [ValueHolder](API_ValueHolder.md)

 ** [Proof](#API_GetBlock_ResponseSyntax) **   <a name="qldb-GetBlock-response-Proof"></a>
L'objet de preuve au format Amazon Ion renvoyé par une `GetBlock` demande. Une preuve contient la liste des valeurs de hachage requises pour recalculer le condensé spécifié à l'aide d'un arbre Merkle, en commençant par le bloc spécifié.  
Type : objet [ValueHolder](API_ValueHolder.md)

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

Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md).

 ** InvalidParameterException **   
Un ou plusieurs paramètres de la demande ne sont pas valides.  
Code d’état HTTP : 400

 ** ResourceNotFoundException **   
La ressource spécifiée n’existe pas.  
Code d’état HTTP : 404

 ** ResourcePreconditionNotMetException **   
L'opération a échoué car une condition n'était pas satisfaite à l'avance.  
Code d’état HTTP : 412

## consultez aussi
<a name="API_GetBlock_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [Interface de ligne de commande AWS](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/GetBlock) 
+  [AWS SDK pour .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/GetBlock) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/GetBlock) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/GetBlock) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/GetBlock) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/GetBlock) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/GetBlock) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/GetBlock) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/GetBlock) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/GetBlock)