Get Ledger Entry - Get Ledger Entry

Ottiene la voce libro mastro in corrispondenza dell'ID transazione specificato. Facoltativamente, è possibile specificare un ID raccolta per indicare la raccolta da cui recuperare il valore.
Per restituire voci contabili meno recenti, le sezioni pertinenti del libro mastro devono essere lette dal disco e convalidate. Per impedire il blocco all'interno dell'enclave, la risposta indicherà se la voce è pronta e parte della risposta o se il caricamento è ancora in corso.

GET {ledgerEndpoint}/app/transactions/{transactionId}?api-version=2022-05-13
GET {ledgerEndpoint}/app/transactions/{transactionId}?api-version=2022-05-13&collectionId={collectionId}

Parametri dell'URI

Name In Required Type Description
ledgerEndpoint
path True
  • string
url

URL libro mastro riservato, ad esempio https://contoso.confidentialledger.azure.com

transactionId
path True
  • string

Identifica una transazione di scrittura.

api-version
query True
  • string

Versione dell'API da usare con la richiesta HTTP.

collectionId
query
  • string

ID raccolta.

Risposte

Name Type Description
200 OK

Risultato dell'esecuzione di una query sul Libro mastro riservato.

Other Status Codes

Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Esempio

GetLedgerEntry

Sample Request

GET {ledgerEndpoint}/app/transactions/3.14?api-version=2022-05-13

Sample Response

{
  "state": "Ready",
  "entry": {
    "contents": "Ledger entry contents at transaction id 3.14.",
    "collectionId": "DEFAULT_SUBLEDGER",
    "transactionId": "3.14"
  }
}

Definizioni

ConfidentialLedgerError

Risposta di errore da Confidential Ledger.

ConfidentialLedgerErrorBody

Risposta di errore da Confidential Ledger.

ConfidentialLedgerQueryState

Stato di una query libro mastro.

LedgerEntry

Voce nel libro mastro.

LedgerQueryResult

Risultato dell'esecuzione di query per una voce libro mastro da un ID transazione precedente. La voce libro mastro è disponibile nella risposta solo se lo stato restituito è Pronto.

ConfidentialLedgerError

Risposta di errore da Confidential Ledger.

Name Type Description
error

Risposta di errore da Confidential Ledger.

ConfidentialLedgerErrorBody

Risposta di errore da Confidential Ledger.

Name Type Description
code
  • string

Codice di errore.

message
  • string

Messaggio di errore.

ConfidentialLedgerQueryState

Stato di una query libro mastro.

Name Type Description
Loading
  • string
Ready
  • string

LedgerEntry

Voce nel libro mastro.

Name Type Description
collectionId
  • string
contents
  • string

Contenuto della voce libro mastro.

transactionId
  • string

Identificatore univoco dello stato del libro mastro. Se restituito come parte di un LedgerEntry, indica lo stato da cui è stata letta la voce.

LedgerQueryResult

Risultato dell'esecuzione di query per una voce libro mastro da un ID transazione precedente. La voce libro mastro è disponibile nella risposta solo se lo stato restituito è Pronto.

Name Type Description
entry

Voce libro mastro trovata come risultato della query. Questa opzione è disponibile solo se la query è in stato Pronto.

state

Stato di una query libro mastro.