Object Storage Provisioning
Oracle Storage Cloud Service (OSCS) enables businesses to store and manage digital content in the cloud. Stored objects can be retrieved directly by external clients or by applications running within Oracle Cloud. A container is just a storage compartment that provides a way to organize the data stored in OSCS.
Oracle Public Cloud (OPC) uses OSCS storage containers to host the artefacts produced by the built-in automated backup feature.
-
Oracle Storage Cloud Service Provisioning via APIs
In this section of the guide we will show how to create a storage container using the OSCS REST APIs that is based on OpenStack Swift.
Request an Authentication Token
Using your preferred tool, submit the REST request in the table below, where:
-
is the identity domain name to which your OPC account belongs
-
and are your OPC account credentials
Resource URL | https://.storage.oraclecloud.com/auth/v1.0 |
Method | GET |
Headers | X-Storage-User: Storage-: X-Storage-Pass: |
If you use cURL, the command syntax would be:
curl \
-v -X GET \
-H X-Storage-User:Storage-: \
-H X-Storage-Pass: \
https://.storage.oraclecloud.com/auth/v1.0
For example, in this example I used the following API call:
curl -v -X GET -H X-Storage-User:Storage-auoracle02747:carlos.rodriguez.iturria@oracle.com -H X-Storage-Pass:PASSWORD_GOES_HERE https://auoracle02747.storage.oraclecloud.com/auth/v1.0 |
Note: In bold, there are the sections that you will have to replace based on your Identity domain and account details.
The authentication token, that is valid during the next 30 minutes, is delivered as an X-Auth-Token HTTP response header. In the command output locate the line that starts with X-Auth-Token.
For example, something like: < X-Auth-Token: AUTH_tk456c26d5cd07fba11a470cee403ae692
Create the Storage Container
Using your preferred tool, submit the REST request in the table below, where:
-
is the identity domain name to which your OPC account belongs
-
is just the container unique identifier
-
is the authentication token you got from previous step
Resource URL | https://.storage.oraclecloud.com/v1/Storage-/ |
Method | PUT |
Headers | X-Auth-Token: |
The cURL command syntax would be:
curl \
-v -X PUT \
-H X-Auth-Token: \
https://.storage.oraclecloud.com/v1/Storage-/
For example, in this example I used the following API call:
curl -v -X PUT -H X-Auth-Token:AUTH_tk456c26d5cd07fba11a470cee403ae692 https://auoracle02747.storage.oraclecloud.com/v1/Storage-auoracle02747/dafwaContainer1 |
Note: In bold, there are the sections that you will have to replace based on your Identity domain and account details.
In the command output verify that the HTTP status code is 201 Created
… < HTTP/1.1 201 Created
…
If you want to validate that your container was successfully created, you can run another APi to list all containers:
curl -v -X GET -H “X-Auth-Token:AUTH_tk83d5d5df6b89c19ec2a4748a761c0202” -H “Accept: application/json” https://auoracle52459.storage.oraclecloud.com/v1/Storage-auoracle52459 |
Note: In bold, there are the sections that you will have to replace based on your Identity domain and account details.
-
Oracle Storage Cloud Service Provisioning via OpenStack GUIs
Since Oracle Storage Cloud Service is based on OpenStack specifications, you can use a third party GUI that complies with such standard. For example, CloudBerry on Windows or CyberDuck in iOS.
This section will make use of CloudBerry to illustrate how to use it.
- The first thing you have to do is to download CloudBerry for OpenStack http://www.cloudberrylab.com/free-openstack-storage-explorer.aspx
- Once you download and install the software, open it.
-
If automatically asks to create a connection, select a “New Oracle Cloud Storage Account”. Otherwise, once it is open, select File > New Oracle Cloud Account
- Fill in the details according to your environment details, where:
- Display Name: Whatever name you want
- User Name: Storage-[identity domain]:[user name]
- Password: Your Oracle Cloud Account Password
- Authentication Service: https://%5Bidentity domain].storage.oraclecloud.com/auth/v1.0
- Account Location: Select your Availability zone, most likely it will be us2
- Keystone version: Keep it as “Do not use“, as you are already specifying the identity domain as part of the Authentication service.
For example this is how I filled mine:
-
Test the connection and make sure you get a successful connection
-
By default it should be selected in the source drop down menu. Otherwise select it.
-
It will show any existing containers as if they were simple folders. This tool allows you to create, update or delete containers, as well as to move object files from your hard drive or any other Cloud Storage instance (right pane), into the left pane, as if it was any other FTP tool.
-
In order to create a new container, simply click on the blue box icon
-
Then provide a name and click OK
-
CloudBerry will show the new container
-
Open up the new container and search in your hard drive (right pane) a file to drag and drop into the container.
…. If using CyberDuck on MAC, it would look like this:
Hey Guys, things are becoming easier all the time. The provisioning of storage prior to provisioning the Oracle SOA Cloud Service is not required any more. You have the option (if you need to) to create the storage as part of the Oracle SOA Cloud Service provisioning wizard. So, not need to use curl, postmac, cyberduck or cloudberry to provision the storage before you get started.
LikeLike
Jason, thanks … We developed the content early this year but it has taken a while to publish it. As with all things cloud the landscape is rapidly changing.
LikeLike