IBM Cloud Object Storage

IBM Cloud® Object Storage stores encrypted and dispersed data across multiple geographic locations.

watsonx.data on IBM Software Hub

watsonx.data Developer edition

You can create an IBM Cloud Object Storage by creating an instance. For more information, see Create an instance. If you select IBM Cloud Object Storage from the Storage section, configure the following details:

Field	Description
Display name	Enter the name to be displayed. (The following special characters are not allowed: ! @ # $ % ^ & * ( ) = + : { } < > ? ' \ ; `).
Bucket name	Enter your existing object storage bucket name. If you do not have an existing bucket then you can create a new bucket. For more information, see Create bucket.
Region	Select the region where the storage is available.
Endpoint	Enter the Endpoint URL. Test connection is enabled when the endpoint is provided. You can fetch the Endpoint by completing the following steps: Go to IBM Cloud Console. Select the service as IBM Cloud Object storage> Select your bucket. Go to the Configuration tab> Click Endpoints. Copy the Public endpoint address. Note: Endpoints are created when a bucket is configured. For more information, see Endpoints.
Input method Note: This field is available only when use of secrets from an external vault (HashiCorp) is configured for your connections.	Choose the credential input method: Enter credential manually Use secret from vault To use secrets from an external vault, select the Use secret from vault option and complete the following steps: Click Select secret. Select one or more secrets and click Select.
Access key Secret key	If you are using secrets from vault, select the Access key and Secret key from the respective drop-down lists. Otherwise, enter your Access key and Secret key in the respective fields. You can fetch the credentials by completing the following steps: From the Resource list page, select the name of the service to open the service details page. Click Service credentials. Expand the row for the required access key and secret key credential. For more information, see Viewing a credential. If you do not have the credentials, you can create the credentials by completing the following steps: Create credentials for a bucket. For more information, see Service credentials. Enable the HMAC toggle switch to get the Access Key and Secret Key paired for use with S3-compatible tools. For more information, see Using HMAC credentials.
Connection status	Click the Test connection link to test the storage connection. If the storage connection is successful, a success message appears.
Console UI Designate this bucket as the ACL store	Console UI Use the toggle switch to designate this bucket as the ACL store. If you enable the toggle switch,An Enable Access Control List (ACL)? dialog appears, Click Enable. Note: This feature applies to watsonx.data Premium. For more information on how to use this feature, see Governance through Access Controlled Lists (ACL). If you enable the toggle switch, the Associate catalog option is selected by default, with the Apache Iceberg data source per-selected. You cannot choose a different catalog for ACLs. You can designate only one storage as the ACL store per instance. After a storage is designated, this option will no longer be visible or available.
Console UI Associate catalog	Console UI Select the checkbox to associate a catalog to the data source. This catalog is automatically associated with your data source and serves as your query interface with the data stored within.
Catalog type / Type	Console UI Catalog type: Select the catalog type from the list. The recommended catalog is Apache Iceberg. The other option for catalog is Apache Hive. Platform UI Type: Select the database type from the list. The recommended database is Apache Iceberg. The other option for database is Apache Hive.
Catalog name / Name	Console UI Catalog name: Enter the name of the catalog. Platform UI Name: Enter the name of the database associated with your data source. The database serves as your query interface with the data stored within. Note: The following special characters are not allowed: ! @ # $ % ^ & * ( ) = + : { } < > ? ' \ ; `.
Base path (optional) Note: This field appears only when you select Apache Iceberg as the data source type.	Enter the base path for the catalog in the object storage. This allows you to associate multiple Iceberg data sources with a single storage. Note: You cannot share a storage between Iceberg and non-Iceberg data sources.
Associate	Click Associate to create the storage.