Create new Bucket

Put Bucket operation creates a new bucket in QueryIO cluster. To create a new bucket, you must be a registered user and must authenticate to QueryIO server.

Create new Bucket using S3 Compatible REST API

Following code creates a new bucket using S3 compatible api's.

A HttpURLConnection object is used to create a PUT request to create new bucket. Java URL is created by appending the bucket name at the end of serverURL and assigned to HttpURLConnection's object.


import org.apache.http.HttpStatus;

public class BucketOperations {

	 * This program creates a new bucket.
	 * @param serverURL: URL of S3 Compatible REST server(http://<S3 server IP> : <S3 server port> /queryio/). For example:
	 * @param token: authorization token.
	 * @bucketName: Name of the bucket to be created.
	public void putBucket(String serverURL, String token, String bucketName)
			throws Exception {
		URL url = null;
		HttpURLConnection httpCon = null;
		InputStream is = null;
		try {
			/* append "/" at end of serverURL */
			if (!serverURL.endsWith("/")) {
				serverURL = serverURL + "/";
			url = new URL(serverURL + bucketName);	//creates a URL with appending bucket name at end

			//Returns a URLConnection object that represents a connection to the remote object referred to by the URL.
			httpCon = (HttpURLConnection) url.openConnection();
			httpCon.setDoOutput(true);		// to use the URL connection for output
			httpCon.setRequestMethod("PUT");	//PUT request is used.

			httpCon.setRequestProperty("authorization", token);	 	//Provides token for authorization

			httpCon.connect(); 	//Opens a communications link to the resource reference by the URL
			if (httpCon.getResponseCode() == HttpStatus.SC_OK) {		//Check for OK response code
				is = httpCon.getInputStream();	//response of PUT bucket operation
				// Process response here
				StringWriter writer = new StringWriter();                 
				IOUtils.copy(is, writer, "UTF-8");                 
				System.out.println(writer.toString());	//Displaying response
		} finally {		//close all streams
			try {
				if (is != null)
			} catch (IOException e) {
			if (httpCon != null) {

  • Contact Us
  • Contact Us
  • 2018 QueryIO Corporation. All Rights Reserved.

    QueryIO, "Big Data Intelligence" and the QueryIO Logo are trademarks of QueryIO Corporation. Apache, Hadoop and HDFS are trademarks of The Apache Software Foundation.