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
-
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
-
Emplacement du bloc où se trouve la révision du document à vérifier. 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
- DocumentId
-
L'UUID (représenté dans le texte codé en Base62) du document à vérifier.
Type : chaîne
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
-
L'objet de preuve au format Amazon Ion renvoyé par une
GetRevisiondemande. 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
- Revision
-
L'objet de données de révision du document au format Amazon Ion.
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 :
