Hi, I'm Ask INFA!
What would you like to know?
ASK INFAPreview
Please to access Ask INFA.

Table of Contents

Search

  1. Introduction
  2. Define settings for data collections
  3. Manage Data Marketplace content
  4. Manage data collections
  5. Manage requests, orders and consumer accesses
  6. Miscellaneous APIs
  7. Frequently Asked Questions

API Reference

API Reference

Request

Request

The following table describes the parameters that you enter in the request query:
Parameter
Description
Additional Information
search
Optional. The search term that you want to use to find a data collection.
Ensure that the search term that you enter don't contain an asterisk (*).
fields
Optional. Enter the fields on which the search term applies. The terms that you entered in the
search
field parameter are used to search the fields that you specify here.
Enter the following values:
  • NAME
  • DESCRIPTION
ids
Optional. The system generated unique identifier of the data collection.
To get the unique identifier of a data collection from the
Data Marketplace
interface, open the data collection. The data collection page's URL contains the unique identifier.
For example, in the URL
https://{{CDMP_URL}}/datacollection/25158afc-3dfb-44ef-8f3e-cec1e171d0f1?dtn=&tab=summary
, the unique identifier is
25158afc-3dfb-44ef-8f3e-cec1e171d0f1
.
To enter more than one value, use the following format:
ids=<value1>&ids=<value2>
dataOwners
Optional. The system generated unique identifier of the user account or user group that you want to assign as the Data Owner of the data collection.
  • To get the system generated unique identifier of a user account, navigate to
    My Services > Administrator > Users
    . On the
    Users
    page, click a user account. The user account page's URL contains the unique identifier.
    For example, in the URL
    /cloudUI/products/administer/main/usersAsset/0LH3xBJC9A6haZ26htGZyT
    , the unique identifier is
    0LH3xBJC9A6haZ26htGZyT
    .
  • To get the system generated unique identifier of a user group, navigate to
    My Services > Administrator > User Groups
    . On the
    User Groups
    page, click a user group. The user group page's URL contains the unique identifier.
    For example, in the URL
    /cloudUI/products/administer/main/userGroupsAsset/90uizkSWg0ycuu7hSNXSW4
    , the unique identifier is
    90uizkSWg0ycuu7hSNXSW4
    .
technicalOwners
Optional. The system generated unique identifier of the user account or user group that you want to assign as the Technical Owner of the data collection.
  • To get the system generated unique identifier of a user account, navigate to
    My Services > Administrator > Users
    . On the
    Users
    page, click a user account. The user account page's URL contains the unique identifier.
    For example, in the URL
    /cloudUI/products/administer/main/usersAsset/0LH3xBJC9A6haZ26htGZyT
    , the unique identifier is
    0LH3xBJC9A6haZ26htGZyT
    .
  • To get the system generated unique identifier of a user group, navigate to
    My Services > Administrator > User Groups
    . On the
    User Groups
    page, click a user group. The user group page's URL contains the unique identifier.
    For example, in the URL
    /cloudUI/products/administer/main/userGroupsAsset/90uizkSWg0ycuu7hSNXSW4
    , the unique identifier is
    90uizkSWg0ycuu7hSNXSW4
    .
categoryIds
Optional. The system generated unique identifier of the category that contains the data collection.
For more information about how you can use an API to get the unique identifier of a category, see Retrieve categories.
To get the unique identifier of a category from the
Data Marketplace
interface, open the category. The category page's URL contains the unique identifier.
For example, in the URL
https://{{CDMP_URL}}/category/view?ac=67417f72-e5ab-44f0-add9-a1e412c1ce13&dtn=_AfterEBF%20may20
, the unique identifier is
67417f72-e5ab-44f0-add9-a1e412c1ce13
.
usageContextIds
Optional. The system generated unique identifier of the usage type that you want to use to specify the certified use of the data collection.
For more information about how you can use an API to get the unique identifier of a usage type, see Retrieve usage type.
deliveryTemplateIds
Optional. The system generated unique identifier of the delivery template that was used to create the delivery target of the data collection.
For more information about how you can use an API to get the unique identifier of a delivery template, see Retrieve delivery templates.
deliveryTargetLocations
Optional. The delivery target location.
-
createdDateFrom
Optional. To find data collections that were created between a date range, enter the initial date when the data collections were created.
To specify a date, use the
YYYY-MM-DD
format. The value that you specify is automatically converted and stored in the Coordinated Universal Time (UTC) time standard.
If you have specified a value for the
createdDateFrom
parameter, ensure that you also enter a value for the
createdDateTo
parameter.
createdDateTo
Optional. To find data collections that were created between a date range, enter the latest date when the data collections were created.
To specify a date, use the
YYYY-MM-DD
format. The value that you specify is automatically converted and stored in the Coordinated Universal Time (UTC) time standard.
If you have specified a value for the
createdDateTo
parameter, ensure that you also enter a value for the
createdDateFrom
parameter.
modifiedDateFrom
Optional. To find data collections that were modified between a date range, enter the initial date when the data collections were modified.
To specify a date, use the
YYYY-MM-DD
format. The value that you specify is automatically converted and stored in the Coordinated Universal Time (UTC) time standard.
If you have specified a value for the
modifiedDateFrom
parameter, ensure that you also enter a value for the
modifiedDateTo
parameter.
modifiedDateTo
Optional. To find data collections that were modified between a date range, enter the latest date when the data collections were modified.
To specify a date, use the
YYYY-MM-DD
format. The value that you specify is automatically converted and stored in the Coordinated Universal Time (UTC) time standard.
If you have specified a value for the
modifiedDateTo
parameter, ensure that you also enter a value for the
modifiedDateFrom
parameter.
status
Optional. The status informs you of whether or not the data collection is available to Data Users.
Enter one of the following values:
  • If the status is
    PUBLISHED
    , the data collection is available to Data Users.
  • If the status is
    UNPUBLISHED
    , the data collection is not available to Data Users.
sortByField
Optional. Sort by various parameters.
To sort the search results, you can enter one of the following values:
  • ID
  • NAME
  • STATUS
  • CREATED_BY
  • CREATED_ON
  • MODIFIED_BY
  • MODIFIED_ON
Default value is
MODIFIED_ON
.
sort
Optional. Set the sorting order of the search results.
You can sort the search results in the following order:
  • To sort the search results by ascending order, enter
    ASC
    .
  • To sort the search results by descending order, enter
    DESC
    .
Default value is
DESC
.
offset
Optional. The starting index for the paginated results.
Default value is
0
.
limit
Optional. The maximum number of results.
Default value is
50
.
The API has no payload.

0 COMMENTS

We’d like to hear from you!