6.5 HP StoreAll OS User Guide

the errno value, where 0 (zero) means that sync was done successfully and any other value indicates
sync did not complete and durability is not guaranteed. The tutorial below will catch those cases.
Tutorial for using the HTTP StoreAll REST API object mode
Follow this procedure to set up and use HTTP StoreAll REST API object mode.
1. Create a container.
When you first create a container, the account directory, named as the numeric user ID of the
user creating the container, is automatically created as a subdirectory of the root of the HTTP
share.
See “Terminology for StoreAll REST API object mode” (page 203) for a list of requirements for
creating the container name.
The curl format for this command is the following:
NOTE:
• If secure HTTP is configured, replace the http with https.
• Enter the following command on one line.
curl -X PUT http://<IP_address:port>/<urlpath>/<account_name>/
<container_name> -u <username>:<password> [--header "Sync-Requested:
1"]
In this command:
• The <IP_address:port> is the IP address and port of the virtual host for the HTTP
share.
• The <account_name> is the name of the account under which you want to create the
container, for example, jsmith.
• The <container_name> is the name of the container you want to create.
• The <username> is the user name of the account creating the container. Only the account
owner can create a container, so <account_name> and <username> must be the
same.
• The <password> the password of your account.
• The optional “Sync-Requested: 1” header makes the operation durable on disk. A
sync command is done in the segments that the file and created parent directories are
located. It means that when a successful HTTP response is returned to the user, the container
has been created and is durable on disk.
The account and user name is either a StoreAll local user, an Active Directory user, or an
LDAP user. The user must be one that can authenticate to use the HTTP share. Use the
ibrix_localusers command to create a local user. See the HP StoreAll OS CLI Reference
Guide for more information.
For example, for a local user:
curl -X PUT http://192.168.2.2/obj/localuser1/
container-a -u localuser1:mypassword
HTTP version of the command
PUT /<urlpath>/<account_name>/<container_name> HTTP/1.1 [x-ibrix-addomain:<domain_name>]
[ync-Requested: 1]
CURL version of the command for Active Directory users
You can use any of the following formats for Active Directory users:
Using the HTTP StoreAll REST API object mode 205