Skip to content

Get Revision

qldb_get_revision R Documentation

Returns a revision data object for a specified document ID and block address

Description

Returns a revision data object for a specified document ID and block address. Also returns a proof of the specified revision for verification if DigestTipAddress is provided.

Usage

qldb_get_revision(Name, BlockAddress, DocumentId, DigestTipAddress)

Arguments

Name

[required] The name of the ledger.

BlockAddress

[required] The block location of the document revision to be verified. An address is an Amazon Ion structure that has two fields: strandId and sequenceNo.

For example: ⁠{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:14}⁠.

DocumentId

[required] The UUID (represented in Base62-encoded text) of the document to be verified.

DigestTipAddress

The latest block location covered by the digest for which to request a proof. An address is an Amazon Ion structure that has two fields: strandId and sequenceNo.

For example: ⁠{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:49}⁠.

Value

A list with the following syntax:

list(
  Proof = list(
    IonText = "string"
  ),
  Revision = list(
    IonText = "string"
  )
)

Request syntax

svc$get_revision(
  Name = "string",
  BlockAddress = list(
    IonText = "string"
  ),
  DocumentId = "string",
  DigestTipAddress = list(
    IonText = "string"
  )
)