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
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 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 lanceResourcePreconditionNotMetException.
Si aucun bloc n'existe avec l'adresse spécifiée, il est lancéInvalidParameterException.
Syntaxe de la demande
POST /ledgers/name/block HTTP/1.1
Content-type: application/json
{
"BlockAddress": {
"IonText": "string"
},
"DigestTipAddress": {
"IonText": "string"
}
}Paramètres de demande URI
La demande utilise les paramètres URI suivants.
- name
-
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
Cette demande accepte les données suivantes au format JSON.
- BlockAddress
-
L'emplacement du bloc que vous souhaitez demander. Une adresse est une structure Amazon Ion qui comporte deux champs :
strandIdetsequenceNo.Par exemple :
{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:14}.Type : objet ValueHolder
Obligatoire : oui
- DigestTipAddress
-
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 :
strandIdetsequenceNo.Par exemple :
{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:49}.Type : objet ValueHolder
Obligatoire : non
Syntaxe de la réponse
HTTP/1.1 200
Content-type: application/json
{
"Block": {
"IonText": "string"
},
"Proof": {
"IonText": "string"
}
}Eléments de réponse
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
-
L'objet de données de bloc au format Amazon Ion.
Type : objet ValueHolder
- Proof
-
L'objet de preuve au format Amazon Ion renvoyé par une
GetBlockdemande. 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
Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Erreurs courantes.
- 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
Pour plus d'informations sur l'utilisation de cette API dans l'un des AWS SDK spécifiques au langage, consultez les pages suivantes :
