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.

# GetRevision


Renvoie un objet de données de révision pour un ID de document et une adresse de bloc spécifiés. Renvoie également une preuve de la révision spécifiée pour vérification si elle `DigestTipAddress` est fournie.

## Syntaxe de la demande


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

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

## Paramètres de demande URI


La demande utilise les paramètres URI suivants.

 ** [name](#API_GetRevision_RequestSyntax) **   <a name="qldb-GetRevision-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


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

 ** [BlockAddress](#API_GetRevision_RequestSyntax) **   <a name="qldb-GetRevision-request-BlockAddress"></a>
Emplacement du bloc où se trouve la révision du document à vérifier. 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_GetRevision_RequestSyntax) **   <a name="qldb-GetRevision-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

 ** [DocumentId](#API_GetRevision_RequestSyntax) **   <a name="qldb-GetRevision-request-DocumentId"></a>
L'UUID (représenté dans le texte codé en Base62) du document à vérifier.  
Type : String  
Contraintes de longueur : longueur fixe de 22.  
Modèle : `^[A-Za-z-0-9]+$`   
Obligatoire : oui

## Syntaxe de la réponse


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

{
   "Proof": { 
      "IonText": "string"
   },
   "Revision": { 
      "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.

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

 ** [Revision](#API_GetRevision_ResponseSyntax) **   <a name="qldb-GetRevision-response-Revision"></a>
L'objet de données de révision du document au format Amazon Ion.  
Type : objet [ValueHolder](API_ValueHolder.md)

## Erreurs


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


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/GetRevision) 
+  [AWS SDK pour .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/GetRevision) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/GetRevision) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/GetRevision) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/GetRevision) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/GetRevision) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/GetRevision) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/GetRevision) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/GetRevision) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/GetRevision)