beautypg.com

HP StoreAll Storage User Manual

Page 205

background image

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://///

-u : [--header "Sync-Requested:

1"]

In this command:

The is the IP address and port of the virtual host for the HTTP
share.

The is the name of the account under which you want to create the
container, for example, jsmith.

The is the name of the container you want to create.

The is the user name of the account creating the container. Only the account
owner can create a container, so and must be the
same.

The 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 /// HTTP/1.1 [x-ibrix-addomain:]
[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