DNAnexus Documentation
Downloadsdx CommandsAPI MethodsLegal
Search…
Overview
Getting Started
User
Developer
Developing Portable Pipelines
Interactive Workstations
Apps
Workflows
Ingesting Data
Dataset Management
Apollo Datasets
Creating Custom Viewers
Client Libraries
Walkthroughs
DNAnexus API
Entity IDs
Protocols
Authentication
Regions
Nonces
Users
Organizations
Cloud Account
Data Containers
Data Object Lifecycle
Types
Object Details
Visibility
Data Object Metadata
Data Object Classes
Running Analyses
Search
System Methods
Directory of API Methods
DNAnexus Service Limits
Administrator
Science Corner
Downloads
FAQs
Release Notes
Technical Support
Legal
Powered By GitBook
Object Details
For all types of objects, additional data can be stored in a "details" field using the JSON format. RFC4627 describes what constitutes valid JSON -- for example, the top level element needs to be an object (hash) or an array. Unlike properties, the values stored in the JSON need not be strings, nor will they be examined in any search queries over the objects (with the exception of links which will be discussed shortly). In particular, the details will often store the necessary data to be conformant to a particular type, or convention. Arbitrary JSON can be stored with the exception of reserved strings mentioned below. The contents of an object’s details can be returned via a "getDetails" call.

A particularly useful feature of the details of an object is that a value in the JSON can be a "link" which contains information to refer to another object. For example, a file can contain a hash with the key "index" with the corresponding value set to a link pointing to the index file for that file. The syntax for such a link is a hash with a single key-value pair
{"$dnanexus_link": "<class>-<xxxx>"}
Note that if a project contains the file but not the index file, this link is not particularly helpful. However, if the index file object were to be later cloned into the same project, the link would become valid. These links can also be used to reference genomes that are available in public data sets.
The outgoing links of an object can be queried directly using a "describe" call on the object, and the incoming links can be queried using the /system/findDataObjects method.

Re-sets the content of the object’s details.

  • Any conformant JSON (i.e. a JSON object or array, per RFC4627), which will be the new content.

  • id string ID of the manipulated object

  • ResourceNotFound (the specified object in the URL does not exist)
  • InvalidInput (the string "$dnanexus_link" was found as a key but is not the single key in a hash or has a value which is not a string)
  • PermissionDenied (UPLOAD access required for the project in which the object was created)
  • InvalidState (the object is not in the "open" state)

Retrieves the content of the object’s details.

  • project string (optional) ID of a project that the getDetails call will be scoped to. If the object cannot be found in that project a ResourceNotFound error will be returned.

  • The contents of the object’s details

  • ResourceNotFound (the specified object in the URL does not exist)
  • PermissionDenied (VIEW access required)
Previous
Types
Next
Visibility
Last modified 1yr ago
Export as PDF
Copy link
On this page
Linking
API method: /class-xxxx/setDetails
Specification
Inputs
Outputs
Errors
API method: /class-xxxx/getDetails
Specification