Multipart Write Example

Following is an example of the entire multipart object uploading POST process, using CURL (with line breaks for ease of reading).

CLUSTER or <cluster> in a URL stands for <host>[:<port>], where host is a fully qualified domain name or IP address, plus a port number if other than 80. If the Host header does not match the domain name, override it with the domain= argument.

Start the upload with a 0-byte POST. Set the encoding (&encoding=2:1) if there is no default encoding or you need a non-default setting:
Initiate the upload
```
curl -i 
	"${cluster}/
	?uploads" 
	-XPOST
```

In the response, locate the headers for the UploadID and the Content-UUID, which is the new object being created:

Returned headers

Castor-System-UploadID: 
	c88fe8a5daf98f7ce84dc4947238f5c1d0b0b42b8ce464e4566cc2c080ecf401d0b0b42b8ce464e4566cc2c080ecf4010P 
Content-UUID: 
	c88fe8a5daf98f7ce84dc4947238f5c1

Write the first part using the UploadID and Content-UUID and partNumber=1:

Upload the first part

curl -i 
	"${cluster}/c88fe8a5daf98f7ce84dc4947238f5c1
	?partNumber=1
	&uploadid=c88fe8a5daf98f7ce84dc4947238f5c1d0b0b42b8ce464e4566cc2c080ecf401d0b0b42b8ce464e4566cc2c080ecf4010P" 
	-XPOST 
	--data-binary 
	"part 1 data"

You will use the Content-UUID returned by this post in the manifest to complete the upload.

Start the second part using the UploadID and Content-UUID and partNumber=2:

Upload the second part

curl -i 
	"${cluster}/c88fe8a5daf98f7ce84dc4947238f5c1
	?partNumber=2
	&uploadid=c88fe8a5daf98f7ce84dc4947238f5c1d0b0b42b8ce464e4566cc2c080ecf401d0b0b42b8ce464e4566cc2c080ecf4010P" 
	-XPOST 
	--data-binary 
	"part 2 data"

Again, you will use the Content-UUID returned by this post in the manifest to complete the upload.

Complete the upload with the UploadID and a part manifest:

Note

Follow this usage of double quotes.

Complete the upload

curl -i 
	"${cluster}/c88fe8a5daf98f7ce84dc4947238f5c1
	?uploadid=c88fe8a5daf98f7ce84dc4947238f5c1d0b0b42b8ce464e4566cc2c080ecf401d0b0b42b8ce464e4566cc2c080ecf4010P" 
	-XPOST 
	--data-binary '{
	   "parts":[
	      {
	         "partNumber":1,
	         "uuid":"9b149f0959839cee2c915dedfa8d7e25"
	      },
	      {
	         "partNumber":2,
	         "uuid":"76e7f0c7c417b7bca7daedbe3e18bf40"
	      }
	   ]
	}'

The response code on the complete will indicate success. To verify the completed object, you can HEAD the object:
Verify completed object
```
curl --head "${cluster}/c88fe8a5daf98f7ce84dc4947238f5c1"
```