Managing object storage

Gathering storage bucket details

Gather the following information from your cloud administrator or see the resource column to know the process of gathering the required bucket details.

1. To retrieve the IBM Cloud Object Storage bucket configuration, use the following steps.
   1. Log in to your IBM Cloud account.
   2. If a bucket is not created yet, create an object storage bucket. For more information, see Create a new Object Storage bucket.
   3. Click Navigation Menu and select the Resource list.
   4. Expand the Storage section and select your storage instance. For example, cloud object storage-ik
   5. Click the bucket name in the bucket list.
   6. Click the Configuration tab and make a note of the following values:
      • Bucket name
      • Bucket instance CRN
      • Location
      • Private endpoint
   7. If not created yet, create service credentials that include API key. For more information, see Service credentials and Creating an API key for a service ID.
      Note:

      • Copy the API key or download it. After the key is generated, it is displayed for 292 seconds. If you fail to copy or download, generate a key again and then upload it to Envizi Supply Chain Intelligence.
      • Make sure that you assign write access to an individual bucket. For more information, see Granting access to a Service ID.
2. To retrieve the AWS object storage bucket configuration, use the following steps.
   1. Log in to your AWS cloud account.
   2. If a bucket is not created yet, create a bucket. For more information, see Create your first S3 bucket.
      Note: Make sure that you allow read and write access to objects in an S3 Bucket. For more information, see Allows read and write access to objects in an S3 Bucket
   3. Click Services and select S3.
   4. From the side navigation menu, choose Buckets.

      List of the available buckets appears.

   5. Click the name of the bucket for which you want to retrieve the configuration and also make a note of the bucket name.
   6. On the Properties tab, make a note of the AWS region.

Assigning an API key name

You need to register your API key or Secret access key with Envizi Supply Chain Intelligence and assign a unique API key name only once and then you can use the same API key name while registering one or more object storage buckets or API endpoints.

Use the following procedure to create an API key name.

1. From the side navigation menu, click Data management.
2. In the Integrate and Automate section, click Create new bucket.
3. Assign a unique name to your bucket and select the storage provider from the list.
4. Click Configure and click the Click here link.
5. Assign a unique API key name, enter the API key or secret access key.
6. To update the API key, follow the steps 1 to 4 and enter the API key or secret access key.
7. Click Save.

Registering object storage buckets

Use the following procedure to register an object storage bucket for your import and export jobs.

1. From the side navigation menu, click Data management.
2. In the Integrate and Automate section, click Create new bucket.
3. Assign a unique name to your bucket and select the storage provider from the list.
4. Click Configure and add data to the following fields:

   Bucket region

   The location of the object storage bucket.

   Bucket name

   The name of the object storage bucket.

   Bucket location endpoint

   The endpoint of the object storage bucket.

   Note: If the bucket location does not appear in the drop-down menu, you can add it by updating the JSON configuration.

   Public (only for IBM Cloud Object Storage)

   Public or private endpoint

   Bucket location instance ID (only for IBM Cloud Object Storage)

   A Cloud Resource Name (CRN) of IBM Cloud Object Storage bucket.

   Bucket access key ID (only for Amazon Cloud Object Storage (AWS-S3))

   A unique identifier that is associated with an IAM user or role.

   Default file location

   The location that maps to the prefix in object storage.

   API key name

   A name of the API key. If you have not registered your API key and assigned a name yet or want to update the API key, see Assigning an API key name.

   Note: After you register the API key or secret access key, in the API key name field, make sure that you enter the API key name that you assigned during the creation. If you do not enter, you might not be able to save the bucket configuration.

5. Click Test and Manage and then click Click here link to test connectivity to your bucket.

   If you see the following message, check your bucket configuration and permissions. Allow all the necessary permissions and test the connection again.

   Unable to read from the bucket  
   Imports and some exports will not be able to function without permission to read from the bucket.

   Note: Encountering this error does not indicate failure. It signifies that the provided credentials lack write permissions.
6. Click Save.

Configuring the default bucket

Use the following procedure to set the default bucket for your import and export jobs.

1. From the side navigation menu, click Data management.
2. In the Integrate and Automate section, click View buckets.
3. Select a bucket and click Set as default.

The selected bucket is now set as the default bucket and the Default tag appears after the bucket name.