Requirements

Before you create the Platform assets catalog, understand the required permissions and the requirements for storage and duplicate handling.

Required permission

You must have the IAM Administrator role in the IBM Cloud account.

To view your roles, go to Administration > Access (IAM). Then select Roles in the IBM Cloud console.

Storage requirement

You must specify the IBM Cloud Object Storage instance configured during IBM Cloud account setup. If you are not an administrator for the IBM Cloud Object Storage instance, it must be configured to allow catalog creation.

Duplicate asset handling

Assets are considered duplicates if they have the same asset type and the same name.

Select how to handle duplicate assets:

• Update original assets

• Overwrite original assets

• Allow duplicates (default)

• Preserve original assets and reject duplicates

You can change the duplicate handling preferences at any time on the catalog Settings page.

Creating the Platform assets catalog

To create the Platform assets catalog:

1. From the main menu, choose Data > Platform connections.

2. Click Create catalog.

3. Select the IBM Cloud Object Storage service. If you don't have an existing service instance, create a IBM Cloud Object Storage service instance and then refresh the page.

4. Click Create. The Platform assets catalog is created in a dedicated storage bucket. Initially, you are the only collaborator in the catalog.

5. Add collaborators to the catalog. Go to the Access control page in the catalog and add collaborators. You assign each user a role:

   • Assign the Admin role at least one other user so that you are not the only person who can add collaborators.
   • Assign the Editor role to all users who are responsible for adding connections to the catalog.
   • Assign the Viewer role to the users who need to find connections and use them in projects.
     
     

   You can give all the users access to the Platform assets catalog by assigning the Viewer role to the Public Access group. By default, all users in your account are members of the Public Access group. See add collaborators.
   
   

6. Add connections to the catalog. You can delegate this step to other collaborators who have the Admin or Editor role. See Add connections to the Platform assets catalog.