`asset`

Important: IBM Cloud Pak® for Data Version 4.7 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.7 reaches end of support. For more information, see Upgrading IBM Software Hub in the IBM Software Hub Version 5.1 documentation.

Manage catalog or project assets.

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 task.

Prerequisites

cpd-cli: Before you run any cpd-cli commands, ensure that you downloaded the cpd-cli 13.0.4 command-line utility for your operating system and Cloud Pak for Data edition. For more information, see Installing the Cloud Pak for Data command-line interface (cpd-cli).
Common core services: The asset commands are relevant only when common core services are installed.

Required permissions

The asset command requires cluster administrator or similar roles.

Commands

Table 1. `asset` commands
Command	Description
`asset attachment create`	Create an attachment.
`asset attachment delete`	Delete an attachment.
`asset attachment download`	Download the asset attachment to the local path.
`asset attachment get`	Retrieve an attachment.
`asset attachment mark-complete`	Mark an attachment as transfer complete.
`asset attachment update`	Update attachment metadata.
`asset attribute create`	Create an asset attribute.
`asset attribute delete`	Delete an asset attribute.
`asset attribute get`	Retrieve an asset attribute.
`asset attribute list`	Retrieve all asset attributes.
`asset attribute update`	Update or modify an asset attribute.
`asset create`	Create an asset in the catalog or project.
`asset data-asset create`	Create an asset in the catalog or project.
`asset data-asset get`	Retrieve data asset metadata.
`asset data-asset upload`	Upload the local path as an asset attachment.
`asset delete`	Delete an existing asset property.
`asset export cancel`	Cancel the asset export process with the specified identifier.
`asset export download`	Download the asset export content with the specified identifier.
`asset export get`	Retrieve the asset export with the specified identifier.
`asset export list`	Retrieve the asset export list for the specified space, project, or catalog.
`asset export start`	Start the asset export process for the specified space, project, or catalog.
`asset export wait`	Wait until the asset export completes, fails, or is canceled.
`asset file download`	Stream the content of the specified file with the appropriate HTTP headers for entity tags, file size, and mime type.
`asset file list`	Return a list of file paths (similar to S3 listObjects) for the provided project, catalog, space, or account.
`asset file upload`	Upload bytes into the file, with the provided file name, by using the HTTP multi-part format. The command creates a file if the file is missing or overrides the existing file except when override=false.
`asset get`	Retrieve a catalog or project asset.
`asset import cancel`	Cancel the asset import process with the specified identifier.
`asset import get`	Retrieve the asset import with the specified identifier.
`asset import list`	Retrieve the asset import list for the specified space, project, or catalog.
`asset import start`	Start the asset import process for the specified space, project, or catalog.
`asset import wait`	Wait until the asset import process completes, fails, or is canceled.
`asset promote`	Promote project assets to the space.
`asset script create`	Create a script asset from a local file.
`asset search`	In a specified catalog, search for assets of a generic asset type (asset) or a specific asset type.
`asset type get`	Retrieve a named asset type.
`asset type list`	Retrieve all catalog asset types.
`asset type replace`	Replace asset attributes for the specified asset type or create an asset type when the specified asset type does not exist.
`asset update`	Edit existing asset properties if you have appropriate permissions.