Managing Data Marketplace Data Providers via the Command Line
You can use the SAP Datasphere command line interface, datasphere, to manage Data Marketplace data providers, including batch updating properties such as contact email addresses or visibility. You can also list all data providers that a user has access to.
This topic contains the following sections:
Prerequisites
-
Data Warehouse General (-R------) - To access SAP Datasphere.
-
Data Warehouse Data Builder (CRUD---S) - To create, edit and delete data providers.
-
Space Files (CRUD----) - To create, read, update, and delete marketplace objects in your spaces.
-
Spaces (-RU-----) - To modify the space properties.
-
Install the datasphere command line interface (see Install or Update the SAP Datasphere Command Line Interface).
-
Log in to your SAP Datasphere tenant (see Log into the Command Line Interface via an OAuth Client).
datasphere marketplace providers
To get access to a data provider the user needs to be member of the data provider profile. If a contentAggregatorID is given as parameter, only data provider profiles that are managed by that content aggregator are returned.
datasphere marketplace providers list
Returns a simplified list of all data providers that the current user has access to.
datasphere marketplace providers list
If you want a detailed representation of a certain data provider, use the read command.
|
Parameter |
Description |
|---|---|
|
--accept <accept> |
Format to return the content in.
Choices:
|
datasphere marketplace providers read
Reads the metadata of a certain data provider after specifying its UUID or its content aggregator UUID.
datasphere marketplace providers read
Complete the parameters as follows:
datasphere marketplace providers create
|
Parameter |
Description |
|---|---|
|
--provider-identifier <provider-identifier> |
Provider identifier.
You can either:
|
datasphere marketplace providers create
Creates a new data provider or a new managed data provider (managed by a content aggregator) based on a configuration following the data provider definition file format and stored as a .json file. For more information, see the Data Sharing Cockpit
documentation in the SAP Business Accelerator Hub.
datasphere marketplace providers create
Specify the full path to the input .json file, for example C:\temp\mydataproviderdefintion.json.
To create a managed data provider specify the contentAggregatorID in the request body.
|
Parameter |
Description |
|---|---|
|
--file-path <path> |
Enter a path to a file with a .json extension containing your data provider definition. |
|
--input <input> |
Specifies input as string to use for the command (optional). |
datasphere marketplace providers overwrite
Overwrites a data provider based on a configuration following the data provider definition file format and stored as a .json file. For more information, see the Data Sharing Cockpit
documentation in the SAP Business Accelerator Hub.
datasphere marketplace providers overwrite
|
Parameter |
Overwrites all properties of the specified data provider with the provided data inDescription |
|---|---|
|
--file-path <path> |
Enter a path to a file with a .json extension containing your data provider definition. |
|
--provider-identifier <provider-identifier> |
Provider identifier.
You can either:
|
|
--input <input> |
Specifies input as string to use for the command (optional). |
datasphere marketplace providers update
Updates only selected properties of the specified data provider which are defined in the provided data provider definition file. For more information about the definition file, see the Data Sharing Cockpit
documentation in the SAP Business Accelerator Hub.
datasphere marketplace providers update
|
Parameter |
Description |
|---|---|
|
--file-path <path> |
Enter a path to a file with a .json extension containing your data provider definition. |
|
--provider-identifier <provider-identifier> |
Provider identifier.
You can either:
|
|
--input <input> |
Specifies input as string to use for the command (optional). |
datasphere marketplace providers keys generate
Generates activation keys for a specified data provider.
datasphere marketplace providers keys generate
|
Parameter |
Description |
|---|---|
|
--file-path <path> |
Enter a path to a file with a .json extension containing the keys. |
|
--provider-identifier <provider-identifier> |
Provider identifier.
You can either:
|
|
--input <input> |
Specifies input as string to use for the command (optional). |
datasphere marketplace providers assign-users
Assigns and activates data providers for specified users.
datasphere marketplace providers assign-users
|
Parameter |
Description |
|---|---|
|
--provider-identifier <provider-identifier> |
Provider identifier.
You can either:
|
|
--file-path <file> |
Enter a path to a file with a .json extension containing the required information for the users you want to assign (email address, keyUUID, tenant URL).
Sample payload:
[
{
"email" :"john.doe@sap.com",
"keyUUID":"1b9e9f0b-266e-4422-9354-5647c45c5dd5",
"tenantURL": "dwc-master-hc-datama-cons.master.hanacloudservices.cloud.sap"
},
{
"email" :"jane.smith@sap.com",
"keyUUID":"e5faa991-6a16-44a5-8380-a1f168d2b93d",
"tenantURL": "dwc-master-hc-datama-cons2.master.hanacloudservices.cloud.sap"
}
]
|
|
--input <input> |
Specifies input as string to use for the command (optional). |
datasphere marketplace providers keys list
Returns a list of all the existing activation keys for a specified data provider.
datasphere marketplace providers keys list
|
Parameter |
Description |
|---|---|
|
--provider-identifier <provider-identifier> |
Provider identifier.
You can either:
|
datasphere marketplace providers keys delete
Deletes activation keys for a specified data provider.
datasphere marketplace providers keys delete
|
Parameter |
Description |
|---|---|
|
--file-path <path> |
Enter a path to a file with a .json extension containing the keys. |
|
--provider-identifier <provider-identifier> |
Provider identifier.
You can either:
|
|
--input <input> |
Specifies input as string to use for the command (optional). |