@cumulus/cmr-client v18.2.1

@cumulus/cmr-client

A Node.js client to read from, write to, and delete from NASA's Common Metadata Repository (CMR) API.

API

Classes

CMR

A class to simplify requests to the CMR

Kind: global class

• CMR
  • new CMR(params)
  • .getToken() ⇒ Promise.<string>
  • .getHeaders(params) ⇒ Object
  • .ingestCollection(xml) ⇒ Promise.<Object>
  • .ingestGranule(xml) ⇒ Promise.<Object>
  • .ingestUMMGranule(ummgMetadata) ⇒ Promise.<Object>
  • .deleteCollection(datasetID) ⇒ Promise.<Object>
  • .deleteGranule(granuleUR) ⇒ Promise.<Object>
  • .searchCollections(params, [format]) ⇒ Promise.<Object>
  • .searchGranules(params, [format]) ⇒ Promise.<Object>

new CMR(params)

The constructor for the CMR class

Example

const { CMR } = require('@cumulus/cmr-client');

const cmrClient = new CMR({
 provider: 'my-provider',
 clientId: 'my-clientId',
 username: 'my-username',
 password: 'my-password'
});

cmrClient.getToken() ⇒ Promise.<string>

The method for getting the token

Kind: instance method of CMR
Returns: Promise.<string> - the token

cmrClient.getHeaders(params) ⇒ Object

Return object containing CMR request headers

Kind: instance method of CMR
Returns: Object - CMR headers object

cmrClient.ingestCollection(xml) ⇒ Promise.<Object>

Adds a collection record to the CMR

Kind: instance method of CMR
Returns: Promise.<Object> - the CMR response

cmrClient.ingestGranule(xml) ⇒ Promise.<Object>

Adds a granule record to the CMR

Kind: instance method of CMR
Returns: Promise.<Object> - the CMR response

cmrClient.ingestUMMGranule(ummgMetadata) ⇒ Promise.<Object>

Adds/Updates UMMG json metadata in the CMR

Kind: instance method of CMR
Returns: Promise.<Object> - to the CMR response object.

cmrClient.deleteCollection(datasetID) ⇒ Promise.<Object>

Deletes a collection record from the CMR

Kind: instance method of CMR
Returns: Promise.<Object> - the CMR response

cmrClient.deleteGranule(granuleUR) ⇒ Promise.<Object>

Deletes a granule record from the CMR

Kind: instance method of CMR
Returns: Promise.<Object> - the CMR response

cmrClient.searchCollections(params, format) ⇒ Promise.<Object>

Search in collections

Kind: instance method of CMR
Returns: Promise.<Object> - the CMR response

cmrClient.searchGranules(params, format) ⇒ Promise.<Object>

Search in granules

Kind: instance method of CMR
Returns: Promise.<Object> - the CMR response

CMRSearchConceptQueue

A class to efficiently list all of the concepts (collections/granules) from CMR search, without loading them all into memory at once. Handles paging.

Kind: global class

• CMRSearchConceptQueue
  • new CMRSearchConceptQueue(params)
  • .peek() ⇒ Promise.<Object>
  • .shift() ⇒ Promise.<Object>

new CMRSearchConceptQueue(params)

The constructor for the CMRSearchConceptQueue class

Example

const { CMRSearchConceptQueue } = require('@cumulus/cmr-client');

const cmrSearchConceptQueue = new CMRSearchConceptQueue({
  provider: 'my-provider',
  clientId: 'my-clientId',
  type: 'granule',
  searchParams: {},
  format: 'json'
});

cmrSearchConceptQueue.peek() ⇒ Promise.<Object>

View the next item in the queue

This does not remove the object from the queue. When there are no more items in the queue, returns 'null'.

Kind: instance method of CMRSearchConceptQueue
Returns: Promise.<Object> - an item from the CMR search

cmrSearchConceptQueue.shift() ⇒ Promise.<Object>

Remove the next item from the queue

When there are no more items in the queue, returns null.

Kind: instance method of CMRSearchConceptQueue
Returns: Promise.<Object> - an item from the CMR search

CMR Docs

CMR REST API endpoint documentation is here:

• https://cmr.earthdata.nasa.gov/search/site/search_api_docs.html
• https://cmr.earthdata.nasa.gov/ingest/site/ingest_api_docs.html

What is Cumulus?

Cumulus is a cloud-based data ingest, archive, distribution and management prototype for NASA's future Earth science data streams.

Cumulus Documentation

Test

Test with npm run test.

Contributing

See Cumulus README

Generated automatically using npm run build-docs