< Previous | Contents | Next >

Example: Creating a folder

Here’s a sample PUT request that creates a folder named budget_proposals in the r&d folder in the finance bucket. If the r&d folder doesn’t already exist, this request also creates that folder. The request is being made while versioning is enabled for the bucket.


Request with s3curl command line


./s3curl.pl --id=lgreen --put ~ -- -k "https://finance.europe.hcp.example.com/r&d/budget_proposals%2F"

-H "Content-Length:0"


Request headers


PUT /r&d/budget_proposals%2F HTTP/1.1 Host: finance.europe.hcp.example.com Transfer-Encoding: chunked

Date: Tue, 04 Dec 2012 14:40:27 +0000

Authorization: AWS bGdyZWVu:VsSmWFRWwTPWPjH+QEs6Z2Qwf84= Content-Length: 0


Response headers


HTTP/1.1 200 OK

Date: Tue, 04 Dec 2012 14:40:26 GMT Server: HCP V7.0.0.16

x-amz-version-id: 87395113368065

ETag: "d41d8cd98f00b204e9800998ecf8427e" Content-Length: 0


136 Chapter 6: Working with objects

Checking the existence of an object or folder