List Ledger Entries - List Ledger Entries

Servizio:

Azure confidential ledger

Versione API:

2022-05-13

Ottiene i movimenti contabili da una raccolta corrispondente a un intervallo.
È possibile specificare facoltativamente un ID raccolta. Verranno restituite solo le voci nella raccolta specificata (o predefinita).

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

Con parametri facoltativi:

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
ledgerEndpoint	path	True	string (url)	URL libro mastro riservato, ad esempio https://contoso.confidentialledger.azure.com
api-version	query	True	string	Versione dell'API da usare con la richiesta HTTP.
collectionId	query		string	ID raccolta.
fromTransactionId	query		string	Specificare il primo ID transazione in un intervallo.
toTransactionId	query		string	Specificare l'ultimo ID transazione in un intervallo.

Risposte

Nome	Tipo	Descrizione
200 OK	PagedLedgerEntries	Movimenti contabili nell'intervallo specificato.
Other Status Codes	ConfidentialLedgerError	Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Esempio

ListLedgerEntries

Esempio di richiesta

HTTP

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

Risposta di esempio

Codice di stato:

200

{
  "state": "Ready",
  "nextLink": "/app/transactions?fromTransactionId=3.15&toTransactionId=3.42&collectionId=0&api-version=0.1-preview",
  "entries": [
    {
      "contents": "Ledger entry contents at transaction id 3.14.",
      "collectionId": "DEFAULT_SUBLEDGER",
      "transactionId": "3.14"
    }
  ]
}

Definizioni

Nome	Descrizione
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.
PagedLedgerEntries	Voci di libro mastro impaginato restituite in risposta a una query.

ConfidentialLedgerError

Object

Risposta di errore da Confidential Ledger.

Nome	Tipo	Descrizione
error	ConfidentialLedgerErrorBody	Risposta di errore da Confidential Ledger.

ConfidentialLedgerErrorBody

Object

Risposta di errore da Confidential Ledger.

Nome	Tipo	Descrizione
code	string	Codice di errore.
message	string	Messaggio di errore.

ConfidentialLedgerQueryState

Enumerazione

Stato di una query libro mastro.

Valore	Descrizione
Loading
Ready

LedgerEntry

Object

Voce nel libro mastro.

Nome	Tipo	Descrizione
collectionId	string
contents	string	Contenuto della voce libro mastro.
transactionId	string	Identificatore univoco per lo stato del libro mastro. Se restituito come parte di un LedgerEntry, indica lo stato da cui è stata letta la voce.

PagedLedgerEntries

Object

Voci di libro mastro impaginato restituite in risposta a una query.

Nome	Tipo	Descrizione
entries	LedgerEntry[]	Matrice di voci mastro.
nextLink	string	Percorso da cui recuperare la pagina successiva dei risultati.
state	ConfidentialLedgerQueryState	Stato di una query libro mastro.