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

To manage marketplace objects on the command line, you must have a scoped role that grants you access to a space with the following privileges:
  • 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.

The DW Space Administrator role template, for example, grants these privileges.For more information, see Privileges and Permissions and Standard Roles Delivered with SAP Datasphere.
You must, in addition: To browse the available commands, enter the following and press Return:
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:
  • application/vnd.sap.marketplace.providers.list+json (default)

  • application/vnd.sap.marketplace.providers.details+json

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:
  • Provide the UUID of the data provider or of the content aggregator.

  • Provide the UUID of a content aggregator and a contentAggregatorProviderID separated by a colon.

    Example: List [ "0b0dfe8e-f974-407d-8987-6d863b2c5e83", "f97dfe8e-f9a4-4d2d-8187-ed863bdc5e88:rubix-b2b-risk-assessment-amp-monitoring-solutions-all-cou-rubix-data-sciences" ]”

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 CockpitInformation published on SAP site 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 CockpitInformation published on SAP site 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:
  • Provide the UUID of the data provider or of the content aggregator.

  • Provide the UUID of a content aggregator and a contentAggregatorProviderID separated by a colon.

    Example: List [ "0b0dfe8e-f974-407d-8987-6d863b2c5e83", "f97dfe8e-f9a4-4d2d-8187-ed863bdc5e88:rubix-b2b-risk-assessment-amp-monitoring-solutions-all-cou-rubix-data-sciences" ]”

--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 CockpitInformation published on SAP site 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:
  • Provide the UUID of the data provider or of the content aggregator.

  • Provide the UUID of a content aggregator and a contentAggregatorProviderID separated by a colon.

    Example: List [ "0b0dfe8e-f974-407d-8987-6d863b2c5e83", "f97dfe8e-f9a4-4d2d-8187-ed863bdc5e88:rubix-b2b-risk-assessment-amp-monitoring-solutions-all-cou-rubix-data-sciences" ]”

--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:
  • Provide the UUID of the data provider or of the content aggregator.

  • Provide the UUID of a content aggregator and a contentAggregatorProviderID separated by a colon.

    Example: List [ "0b0dfe8e-f974-407d-8987-6d863b2c5e83", "f97dfe8e-f9a4-4d2d-8187-ed863bdc5e88:rubix-b2b-risk-assessment-amp-monitoring-solutions-all-cou-rubix-data-sciences" ]”

--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:
  • Provide the UUID of the data provider or of the content aggregator.

  • Provide the UUID of a content aggregator and a contentAggregatorProviderID separated by a colon.

    Example: List [ "0b0dfe8e-f974-407d-8987-6d863b2c5e83", "f97dfe8e-f9a4-4d2d-8187-ed863bdc5e88:rubix-b2b-risk-assessment-amp-monitoring-solutions-all-cou-rubix-data-sciences" ]”

--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:
  • Provide the UUID of the data provider or of the content aggregator.

  • Provide the UUID of a content aggregator and a contentAggregatorProviderID separated by a colon.

    Example: List [ "0b0dfe8e-f974-407d-8987-6d863b2c5e83", "f97dfe8e-f9a4-4d2d-8187-ed863bdc5e88:rubix-b2b-risk-assessment-amp-monitoring-solutions-all-cou-rubix-data-sciences" ]”

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:
  • Provide the UUID of the data provider or of the content aggregator.

  • Provide the UUID of a content aggregator and a contentAggregatorProviderID separated by a colon.

    Example: List [ "0b0dfe8e-f974-407d-8987-6d863b2c5e83", "f97dfe8e-f9a4-4d2d-8187-ed863bdc5e88:rubix-b2b-risk-assessment-amp-monitoring-solutions-all-cou-rubix-data-sciences" ]”

--input <input>

Specifies input as string to use for the command (optional).