Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Access to tags is granted through the TAG_GROUP system object identity.  In MMT, users are granted this access by being added to the permissions group "Tagging Group SYS."  If you need tagging access, contact CMR or Earthdata Search devops.

  2. If you do not already have one, generate an ECHO token.  (Note: the id field in the response to the following command is your new token.)

    Code Block
    curl -XPOST \
      https://cmr.earthdata.nasa.gov/legacy-services/rest/tokens \
      -H 'cache-control: no-cache' \
      -H 'content-type: application/xml' \
      -d '<token>
        <username>my_earthdata-username</username>
        <password>my_earthdata_password</password>
        <client_id>client_id_of_my_choosing</client_id>
        <user_ip_address>valid_ip_address_of_my_choosing_example_127.0.0.1</user_ip_address>
    </token>’
  3. Tag each collection to be limited with the edsc.limited_collections tag, setting desired the order limit:

    --- Example: to tag a single collection C12345-DAAC_NAME with the edsc.limited_collections tag and set the order limit to 2000 granules, create a tag association as follows:

    Code Block
    curl -XPOST \
     -i \
     -H "Content-Type: application/json" \ 
     -H "Echo-Token: <token from first step>" \
     https://cmr.earthdata.nasa.gov/search/tags/edsc.limited_collections/associations \
     -d '[{"concept_id":"C12345-DAAC_NAME", "data":{"limit":2000}}]'

    ---to tag multiple collections and set limits,

    Code Block
    curl -XPOST \
     -i \
     -H "Content-Type: application/json" \ 
     -H "Echo-Token: <token from first step>" \
     https://cmr.earthdata.nasa.gov/search/tags/edsc.limited_collections/associations \
     -d '[{"concept_id":"C00001-DAAC_NAME", "data":{"limit":2000}}, \
     "C00002-DAAC_NAME", "data":{"limit":2000}}, \
     "C00003-DAAC_NAME", "data":{"limit":1000}}, \
     "C00004-DAAC_NAME", "data":{"limit":3000}}, \ 
     "C00005-DAAC_NAME", "data":{"limit":2300}}, \
     "C00006-DAAC_NAME", "data":{"limit":100}}, \
     "C00007-DAAC_NAME", "data":{"limit":2000}}, \
     "C00008-DAAC_NAME", "data":{"limit":5000}}, \
     "C00009-DAAC_NAME", "data":{"limit":500}}, \
     "C00010-DAAC_NAME", "data":{"limit":800}}]'
    


    see examples in ticket 

    Jira
    serverEarthdata Ticketing System
    serverId9a2ac141-7181-31f1-a247-ccbc66e20158
    keyEDSC-1591


Note

To show all tags for a given collection (tags will be returned in the field labeled "tags"):

Code Block
curl -s "https://cmr.earthdata.nasa.gov/search/collections.json?include_tags=*&concept_id=C12345-DAAC_NAME"
Note

To show all collections that have the order limit tag "edsc.limited_collections":

Code Block
curl "https://cmr.earthdata.nasa.gov/search/collections?tag_key=edsc.limited_collections" 

...