`connection`

Important: IBM Cloud Pak® for Data Version 4.6 will reach end of support (EOS) on 31 July, 2025. For more information, see the Discontinuance of service announcement for IBM Cloud Pak for Data Version 4.X.

Upgrade to IBM Software Hub Version 5.1 before IBM Cloud Pak for Data Version 4.6 reaches end of support. For more information, see Upgrading IBM Software Hub in the IBM Software Hub Version 5.1 documentation.

Manage connections.

Extended description

Before you can complete certain Cloud Pak for Data setup and management tasks, you must create a profile so that you can run the appropriate cpd-cli commands. A profile enables the cpd-cli to verify that you are a Cloud Pak for Data user and that you have the appropriate administrator permissions to complete a given task.

Prerequisites

cpd-cli: Before you run any cpd-cli commands, ensure that you downloaded the cpd-cli 12.0.6 command line utility for your operating system and Cloud Pak for Data edition from: https://github.com/IBM/cpd-cli/releases.
Common core services: The connection commands are relevant only when common core services are installed.

Required permissions

The connection command requires cluster administrator or similar roles.

Commands

Command	Description
`connection create`	Create a connection with shared credentials.
`connection datasource-type get`	Retrieve the data source type details.
`connection datasource-type list`	List all defined data source types.
`connection delete`	Delete a connection definition.
`connection discover`	Discover assets from the data source that is accessed through the connection.
`connection discover-adhoc`	Discover assets from the data source that is accessed through a connection description.
`connection discover-data-asset`	Discover a data asset.
`connection get`	Retrieve details for a specific connection definition.
`connection list`	List defined connections.
`connection list-actions`	List all supported connection actions.
`connection perform-action`	Perform an action on the data source, which is accessed through the connection.
`connection update`	Update the connection definition.