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
requestIds
Optional. The system generated unique identifier of the data collection request.
To get the unique identifier of a data collection request, open the data collection request. The data collection request page's URL contains the unique identifier.
For example, in the URL
https://{{CDMP_URL}}/datacollectionrequest/6e5964ec-e0aa-4eac-963a-3dae0fa1d639?dtn=Request~9b4d
, the unique identifier is
6e5964ec-e0aa-4eac-963a-3dae0fa1d639
.
To enter more than one value, use the following format:
ids=<value1>&ids=<value2>
userIds
Optional. The system generated unique identifier of the user that requested the new 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
.
status
Optional. The status of the data collection request.
Enter one of the following values:
  • PENDING
  • COMPLETED
  • REJECTED
  • CANCELLED
createdDateFrom
Optional. To find data collection requests that were created between a date range, enter the initial date when the data collection requests 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 collection requests that were created between a date range, enter the latest date when the data collection requests 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 collection requests that were modified between a date range, enter the initial date when the data collection requests 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 collection requests that were modified between a date range, enter the latest date when the data collection requests 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.
referencedDataCollectionIds
Optional. The system generated unique identifier of the data collection based on which the new data collection is to be created.
For more information about how you can use an API to get the unique identifier of a data collection, see Retrieve data collections.
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
.
referencedCategoryIds
Optional. The system generated unique identifier of the category in which the new data collection is to be created.
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
.
offset
Optional. The starting index for the paginated results.
Default value is
0
.
limit
Optional. The maximum number of results.
Default value is
50
.
sortByField
Optional. Sort by various parameters.
To sort the search results, you can enter one of the following values:
  • ID
  • JUSTIFICATION
  • STATUS
  • CREATED_BY
  • CREATED_ON
  • MODIFIED_BY
  • MODIFIED_ON
Default value is
sortByField > 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
.
The API has no payload.

0 COMMENTS

We’d like to hear from you!