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à.
GetBlock
Restituisce un oggetto blocco a un indirizzo specificato in un diario. Restituisce inoltre una prova del blocco specificato per la verifica, se DigestTipAddress fornita.
Per informazioni sul contenuto dei dati in un blocco, consulta i contenuti del Journal nella Amazon QLDB Developer Guide.
Se il registro specificato non esiste o è in DELETING stato, viene generato. ResourceNotFoundException
Se il registro specificato è in CREATING stato, viene generato. ResourcePreconditionNotMetException
Se non esiste alcun blocco con l'indirizzo specificato, viene generato. InvalidParameterException
Sintassi della richiesta
POST /ledgers/name/block HTTP/1.1
Content-type: application/json
{
"BlockAddress": {
"IonText": "string"
},
"DigestTipAddress": {
"IonText": "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 che desideri richiedere. Un indirizzo è una struttura Amazon Ion con due campi:
strandIdesequenceNo.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:
strandIdesequenceNo.Ad esempio:
{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:49}.Tipo: oggetto ValueHolder
Campo obbligatorio: no
Sintassi della risposta
HTTP/1.1 200
Content-type: application/json
{
"Block": {
"IonText": "string"
},
"Proof": {
"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.
- Block
-
L'oggetto di dati a blocchi in formato Amazon Ion.
Tipo: oggetto ValueHolder
- Proof
-
L'oggetto di prova in formato Amazon Ion restituito da una
GetBlockrichiesta. Una dimostrazione contiene l'elenco dei valori hash necessari per ricalcolare il digest specificato utilizzando un albero Merkle, a partire dal blocco specificato.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:
