query_history: List all content identifiers that have been seen at a given...

Description Usage Arguments Details Value See Also Examples

View source: R/query_history.R

Description

query_history is the complement of query_sources, in that it filters a table of content identifier : url : date entries by the url.

Usage

1

Arguments

url

A URL for a data file

registries

list of registries at which to register the URL

...

additional arguments

Details

query_history() only applies to registries that contain mutable URLs, i.e. hash-archive and local registries which merely record the contents last seen at any URL. Such URLs may have the same or different content at a later date, or may fail to resolve. In contrast, archives such as DataONE or Zenodo that resolve identifiers to source URLs control both the registry and the content storage, and thus only report URLs where content is currently found. While Download URLs from archives may move and old URLs may fail, a download URL never has "history" of different content (e.g. different versions) served from the same access URL.

Value

a data frame with all content identifiers that have been seen at a given URL. If the URL is version-stable, this should be a single identifier. Note that if multiple identifiers are listed, older content may no longer be available, though there is a chance it has been registered to a different url and can be resolved with query_sources.

See Also

sources

Examples

1
2
3
 
query_history(paste0("https://knb.ecoinformatics.org/knb/d1/mn/v2/object/",
"ess-dive-457358fdc81d3a5-20180726T203952542"))

cboettig/contentid documentation built on April 1, 2021, 11:25 p.m.