Home > User Guide

Finding the details for a IBM Cloud Object Storage bucket

Upload your VM files to IBM Cloud Object Storage.
Record the following information about your IBM Cloud Object Storage bucket:
- Location
- Bucket instance CRN The Cloud Resource Name (CRN) uniquely identifies a resource (in this case the bucket instance) in the IBM Cloud.
- Authentication credentials
  - API key
    
    or
  - HMAC Hash-based Message Authentication Code – A short series of characters used for secure authentication. credentials:
    - Access key
    - Secret access key
To find the location of your bucket instance and CRN
1. From a web browser, sign in to IBM Cloud.
2. Click to display the drop-down menu.
3. In the drop-down menu, click Resource List. The Resource List page displays.
4. Expand the Storage section, and then click on the bucket that contains the LPAR you want to import. The resource page for that bucket displays.
5. Click (Bucket actions) > Configuration. The Bucket details page displays.
  - The Location of the bucket displays. For example: us-south.
  - The CRN of the bucket displays. For example: crn:v1:bluemix:public:cloud-object-storage:global:a/88a8aa8aa88a8888a888aaaaa88a8888:8a88aa88-a888-88aa-a8a8-88aaaa8aa8a8:bucket:cos-standard-676.
To find the authorization credentials for your bucket instance
1. In the main menu, click Service credentials. The Service credentials page displays.
2. Click New credentials. The Add new credential dialog displays.
3. Provide details for the authorization credentials:
  - Name – Type a name for the credential.
  - Role – Select the Reader role from the drop-down menu.
  - Include HMAC Credential – Check this box to include HMAC Access and Secret access keys.
4. Click Add to generate the authorization credentials.
5. After the credentials are generated, click View credentials. The section expands to show the credentials for the bucket instance.
  
  Example:
```
 "apikey": "-AAAb8bb8bAAbbbAb8AAb8bbbAAb8bA-AbAAAb8AAbAb",
 "cos_hmac_keys": {
   "access_key_id": "8b888b8b888b8888b8b8888888bb888b",
   "secret_access_key": "bb8b88b8b888888b8bbbbb88b88b8b88b88888888bbb8b88"
 },
   "endpoints": "https://control.cloud-object-storage.cloud.ibm.com/v2/endpoints",
   "iam_apikey_description": "Auto-generated for key 8b888b8b-888b-8888-b8b8-888888bb888b",
   "iam_apikey_name": "aaa-cos-standard-a88",
   "iam_role_crn": "crn:v1:bluemix:public:iam::::serviceRole:Writer",
   "iam_serviceid_crn": "crn:v1:bluemix:public:iam-identity::a/88b8bb8bb88b8888b888bbbbb88b8888::serviceid:ServiceId-b8b888b8-88bb-888b-b8b8-8888b8b88b8b",
   "resource_instance_id": "crn:v1:bluemix:public:cloud-object-storage:global:a/88b8bb8bb88b8888b888bbbbb88b8888:8b88bb88-b888-88bb-b8b8-88bbbb8bb8b8::"
 }
```