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à.
GetRevision
Restituisce un oggetto dati di revisione per un ID documento e un indirizzo di blocco specificati. Restituisce inoltre una prova della revisione specificata per la verifica, se DigestTipAddress
fornita.
Sintassi della richiesta
POST /ledgers/name
/revision HTTP/1.1
Content-type: application/json
{
"BlockAddress": {
"IonText": "string
"
},
"DigestTipAddress": {
"IonText": "string
"
},
"DocumentId": "string
"
}
Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
- name
-
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
La richiesta accetta i seguenti dati in formato JSON.
- BlockAddress
-
La posizione del blocco della revisione del documento da verificare. Un indirizzo è una struttura Amazon Ion con due campi:
strandId
esequenceNo
.Ad esempio:
{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:14}
.Tipo: oggetto ValueHolder
Campo obbligatorio: sì
- DigestTipAddress
-
L'ultima ubicazione del blocco coperta dal digest per la quale richiedere una prova. Un indirizzo è una struttura Amazon Ion con due campi:
strandId
esequenceNo
.Ad esempio:
{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:49}
.Tipo: oggetto ValueHolder
Campo obbligatorio: no
- DocumentId
-
L'UUID (rappresentato nel testo con codifica Base62) del documento da verificare.
▬Tipo: stringa
Vincoli di lunghezza: lunghezza fissa di 22.
Modello:
^[A-Za-z-0-9]+$
Campo obbligatorio: sì
Sintassi della risposta
HTTP/1.1 200
Content-type: application/json
{
"Proof": {
"IonText": "string"
},
"Revision": {
"IonText": "string"
}
}
Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
- Proof
-
L'oggetto di prova in formato Amazon Ion restituito da una
GetRevision
richiesta. Una bozza contiene l'elenco dei valori hash necessari per ricalcolare il digest specificato utilizzando un albero Merkle, a partire dalla revisione del documento specificata.Tipo: oggetto ValueHolder
- Revision
-
L'oggetto dei dati di revisione del documento in formato Amazon Ion.
Tipo: oggetto ValueHolder
Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.
- 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
Per ulteriori informazioni sull'utilizzo di questa API in uno degli AWS SDK specifici della lingua, consulta quanto segue: